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:2023):
• 7.27.3.5 Функция strftime (c: 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

См. также