wcsftime

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

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

Параметры

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

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

Результат

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

Пример

#include <stdio.h>
#include <time.h>
#include <wchar.h>
#include <locale.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秒

Ссылки

• Стандарт 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)

См. также