[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 Преобразование даты и времени в строку

Функция strftime(3C) помещает символы в массив с указателем s, в
формате, определенном в string. Форматная строка содержит директивы и
обычные символы. Все обычные символы, включая завершающий нуль,
копируются без изменений в массив. В массив помещается не более чем
maxsize символов. Если формат является нулевым указателем,
используется формат по умолчанию ("%c"). Каждая директива замещается
соответствующими символами. Эти символы определены категорией LC_TIME
программной локали и значениями, на которые указывает timeptr.
Несколько этих директив приведено ниже. Обратитесь к соответствующей
странице руководства для получения полной информации.
          %a   сокращенное имя дня недели локали
          %A   полное имя дня недели локали
          %b   сокращенное имя месяца локали
          %B   полное имя месяца локали
          %c   принятое в локали представление даты и времени
          %d   день месяца (01-31)
          %D   день в форме %m/%d/%y
          %e   день месяца (1-31; пробел перед одиночными цифрами)
          %H   час (00-23)
          %I   час (00-12)
          %j   номер дня в году (001-366)
          %m   номер месяца (01-12)
          %M   минуты (00-59)
          %p   эквивалент локали для AM/PM
          %r   время в форме %I:%M:%S
          %R   время в форме %H:%M
          %S   секунды (00-59)

Если общее число символов, включая завершающий нуль, не больше чем
maxsize, strftime(3C) возвращает число символов, помещенных в s,
исключая завершающий нуль. Иначе возвращается нуль и состояние массива
неопределено.
cftime(3C) и ascftime(3C) описаны на странице руководства по
strftime(3C). cftime(3C) и ascftime(3C) обеспечивают возможности
ctime(3C) и asctime(3C) соответственно, а также некоторые
дополнительные возможности. ascftime(3C) позволяет то же, что и
strftime(3C), за исключением того, что strftime(3C) предотвращает
переполнение массива с добавочным аргументом maxsize. strftimr(3C)
рекомендуется к употреблению взамен cftime(3C) или ascftime(3C).
                ПРЕОБРАЗОВАНИЕ ДАТЫ И ВРЕМЕНИ В СТРОКУ
strftime(3C)

ИМЯ

      strftime - преобразование даты и времени в строку

ИСПОЛЬЗОВАНИЕ

      #include <time.h>

      size_t * strftime( char *s,
          size_t maxsize,
               const char * format,
                    const struct tm * timeptr);

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

      успех - количество символов, помещенное в массив, исключая
      завершающий нулевой символ

      неуспех - 0