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

См. также