wcsftime

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

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

Параметры

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

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

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

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

Пример

#include <locale.h>
#include <stdio.h>
#include <time.h>
#include <wchar.h>

int main(void)
{
    wchar_t buff[40];
    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 (wcsftime(buff, sizeof buff, L"%A %c", &my_time))
        printf("%ls\n", buff);
    else
        puts("wcsftime failed");

    setlocale(LC_ALL, "ja_JP.utf8");

    if (wcsftime(buff, sizeof buff, L"%A %c", &my_time))
        printf("%ls\n", buff);
    else
        puts("wcsftime failed");
}

Sunday Sun Oct  9 08:10:20 2012
日曜日 2012年10月09日 08時10分20秒

Ссылки

• Стандарт C23 (ISO/IEC 9899:2024):
• 7.29.5.1 Функция wcsftime (стр.: TBD)
• Стандарт C17 (ISO/IEC 9899:2018):
• 7.29.5.1 Функция wcsftime (стр.: 230-231)
• Стандарт C11 (ISO/IEC 9899:2011):
• 7.29.5.1 Функция wcsftime (стр.: 439-440)
• Стандарт C99 (ISO/IEC 9899:1999):
• 7.24.5.1 Функция wcsftime (стр.: 385-386)

См. также