std::strftime

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

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

Параметры

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

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

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

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

Пример

#include <ctime>
#include <iostream>
#include <iterator>
#include <locale>

void utcExample()
{
    // Example of the very popular RFC 3339 format UTC time
    std::time_t time = std::time({});
    char timeString[std::size("yyyy-mm-ddThh:mm:ssZ")];
    std::strftime(std::data(timeString), std::size(timeString),
                  "%FT%TZ", std::gmtime(&time));
    std::cout << timeString << '\n';
}

int main()
{
    std::time_t t = std::time(nullptr);
    char mbstr[100];
    
    if (std::strftime(mbstr, sizeof(mbstr), "%A %c", std::localtime(&t)))
        std::cout << mbstr << '\n';

    std::locale::global(std::locale("ja_JP.utf8"));
    if (std::strftime(mbstr, sizeof(mbstr), "%A %c", std::localtime(&t)))
        std::cout << mbstr << '\n';

    utcExample();
}

Tuesday Tue Sep  7 19:40:35 2021
火曜日 2021年09月07日 19時40分35秒
2021-09-07T19:40:35Z

См. также