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

Ссылки

• Стандарт C23 (ISO/IEC 9899:2024):
• 7.27.3.5 Функция strftime (стр.: TBD)
• Стандарт C17 (ISO/IEC 9899:2018):
• 7.27.3.5 Функция strftime (стр.: 288-291)
• Стандарт C11 (ISO/IEC 9899:2011):
• 7.27.3.5 Функция strftime (стр.: 394-397)
• Стандарт C99 (ISO/IEC 9899:1999):
• 7.23.3.5 Функция strftime (стр.: 343-347)
• Стандарт C89/C90 (ISO/IEC 9899:1990):
• 4.12.3.5 Функция strftime

См. также