std::wcsftime

std::size_t wcsftime( wchar_t* str, std::size_t count, const wchar_t* format, const std::tm* time );

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

Параметры

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

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

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

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

Пример

#include <ctime>
#include <cwchar>
#include <iostream>
#include <locale>

int main()
{
    std::locale::global(std::locale("ja_JP.utf8"));
    std::time_t t = std::time(nullptr);
    wchar_t wstr[100];
    if (std::wcsftime(wstr, 100, L"%A %c", std::localtime(&t)))
        std::wcout << wstr << '\n';
}

火曜日 2011年12月27日 17時43分13秒

См. также