wcsftime

Converts the date and time information from a given calendar time time to a null-terminated wide character string str according to format string format . Up to count bytes are written.

Parameters

Format string

The format string consists of zero or more conversion specifiers and ordinary characters (except % ). All ordinary characters, including the terminating null character, are copied to the output string without modification. Each conversion specification begins with % character, optionally followed by E or O modifier (ignored if unsupported by the locale), followed by the character that determines the behavior of the specifier. The following format specifiers are available:

Return value

Number of wide characters written into the wide character array pointed to by str not including the terminating L ' \0 ' on success. If count was reached before the entire string could be stored, ​ 0 ​ is returned and the contents are undefined.

Example

#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秒

References

See also