wcsftime

Wandelt die Datums- und Zeitinformationen aus einer gegebenen Kalenderzeit time in einen nullterminierten Breitzeichen-String str gemäß der Formatzeichenkette format um. Bis zu count Bytes werden geschrieben.

Parameter

Formatzeichenkette

Die Formatzeichenfolge besteht aus null oder mehr Konvertierungsspezifizierern und gewöhnlichen Zeichen (außer % ). Alle gewöhnlichen Zeichen, einschließlich des abschließenden Nullzeichens, werden unverändert in die Ausgabezeichenfolge kopiert. Jede Konvertierungsspezifikation beginnt mit dem % -Zeichen, optional gefolgt von einem E - oder O -Modifikator (wird ignoriert, wenn er von der Locale nicht unterstützt wird), gefolgt von dem Zeichen, das das Verhalten der Spezifizierung bestimmt. Die folgenden Formatspezifizierer sind verfügbar:

Rückgabewert

Anzahl der in das Breitzeichen-Array geschriebenen Breitzeichen, auf das str zeigt, ohne das abschließende L ' \0 ' bei Erfolg. Wenn count erreicht wurde, bevor der gesamte String gespeichert werden konnte, wird ​ 0 ​ zurückgegeben und die Inhalte sind undefiniert.

Beispiel

#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, // = Jahr 2012
        .tm_mon = 9,    // = 10. Monat
        .tm_mday = 9,   // = 9. Tag
        .tm_hour = 8,   // = 8 Stunden
        .tm_min = 10,   // = 10 Minuten
        .tm_sec = 20    // = 20 Sekunden
    };
    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秒

Referenzen

Siehe auch