strftime

size_t strftime( char* str, size_t count,
                 const char* format, const struct tm* tp );

size_t strftime( char* restrict str, size_t count,
                 const char* restrict format, const struct tm* restrict tp );

Преобразует информацию о дате и времени из заданного календарного времени tp в строку многобайтовых символов с нулевым завершителем str в соответствии с строкой формата format. Записывается до count байтов.

Параметры

Строка формата

Строка формата состоит из нуля или более спецификаторов преобразования и обычных символов (кроме %). Все обычные символы, включая завершающий нулевой символ, копируются в выходную строку без изменений. Каждая спецификация преобразования начинается с символа %, за которым может следовать модификатор E или O (игнорируется, если не поддерживается локалью), а затем символ, определяющий поведение спецификатора. Доступны следующие спецификаторы формата:

Возвращаемое значение

Количество байтов, записанных в массив символов, на который указывает str, не включая завершающий '\0', в случае успеха. Если count было достигнуто до того, как вся строка могла быть сохранена, возвращается 0, а содержимое не определено.

Пример

#include <locale.h>
#include <stdio.h>
#include <time.h>

int main(void)
{
    char buff[70];
    struct tm my_time =
    {
        .tm_year = 112, // = year 2012
        .tm_mon = 9,    // = 10th month
        .tm_mday = 9,   // = 9th day
        .tm_hour = 8,   // = 8 hours
        .tm_min = 10,   // = 10 minutes
        .tm_sec = 20    // = 20 secs
    };

    if (strftime(buff, sizeof buff, "%A %c", &my_time))
        puts(buff);
    else
        puts("strftime failed");

    setlocale(LC_TIME, "el_GR.utf8");

    if (strftime(buff, sizeof buff, "%A %c", &my_time))
        puts(buff);
    else
        puts("strftime failed");
}

Sunday Sun Oct  9 08:10:20 2012
Κυριακή Κυρ 09 Οκτ 2012 08:10:20 πμ EST

Ссылки

См. также