strftime, , wcsftime_strftime_l_wcsftime_l

Formatieren einer Zeitzeichenfolge

Syntax

size_t strftime(
   char *strDest,
   size_t maxsize,
   const char *format,
   const struct tm *timeptr
);
size_t _strftime_l(
   char *strDest,
   size_t maxsize,
   const char *format,
   const struct tm *timeptr,
   _locale_t locale
);
size_t wcsftime(
   wchar_t *strDest,
   size_t maxsize,
   const wchar_t *format,
   const struct tm *timeptr
);
size_t _wcsftime_l(
   wchar_t *strDest,
   size_t maxsize,
   const wchar_t *format,
   const struct tm *timeptr,
   _locale_t locale
);

Parameter

strDest
Ausgabezeichenfolge.

maxsize
Größe des strDest-Puffers in Zeichen (char oder wchar_t).

format
Formatsteuerzeichenfolge.

timeptr
tm-Datenstruktur.

locale
Das zu verwendende Gebietsschema.

Rückgabewert

strftime gibt die Anzahl der in strDest platzierten Daten zurück, und wcsftime gibt die entsprechende Anzahl von Breitzeichen zurück.

Wenn die Gesamtzahl der Zeichen, einschließlich des abschließende NULL-Zeichens, größer als maxsize ist, geben strftime und wcsftime 0 zurück, und der Inhalt von strDest ist unbestimmt.

Die Anzahl von Zeichen in strDest ist gleich der Anzahl von Literalzeichen in format, sowie allen Zeichen, die über Formatierungscodes hinzugefügt format werden können. Das Beenden von NULL einer Zeichenfolge wird nicht im Rückgabewert gezählt.

Hinweise

Die strftime und wcsftime Funktionen formatieren den tm Zeitwert timeptr entsprechend dem angegebenen format Argument und speichern das Ergebnis im Puffer strDest. Höchstens maxsize Zeichen werden in die Zeichenfolge gestellt. Eine Beschreibung der Felder in der timeptr Struktur finden Sie unter asctime. wcsftime ist die Breitzeichenentsprechung von strftime; ihr Zeichenfolgenargument zeigt auf eine Breitzeichenfolge. Anderenfalls verhalten sich diese Funktionen identisch.

Diese Funktion überprüft ihre Parameter. Wenn strDestdie formattimeptr tm adressierte Datenstruktur timeptr ungültig ist (z. B. wenn sie außerhalb von Bereichswerten für die Uhrzeit oder das Datum enthält) oder wenn die format Zeichenfolge einen ungültigen Formatierungscode enthält, wird der ungültige Parameterhandler aufgerufen, wie in der Parameterüberprüfung beschrieben. Wenn die weitere Ausführung zugelassen wird, gibt die Funktion 0 zurück und stellt errno auf EINVAL ein.

Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Wie Sie dieses Verhalten ändern, erfahren Sie unter Globaler Status in der CRT.

Mapping generischer Textroutinen

Das format-Argument besteht aus mindestens einem Code; wie in printf ist den Formatierungscodes ein Prozentzeichen (%) vorangestellt. Zeichen, mit % denen nicht begonnen wird, werden unverändert strDestkopiert. Die LC_TIME-Kategorie des aktuellen Gebietsschemas wirkt sich auf die Ausgabeformatierung von strftime aus. (Weitere Informationen LC_TIMEfinden Sie unter setlocale.) Die strftime Und wcsftime Funktionen verwenden das aktuell festgelegte Gebietsschema. Die Und _wcsftime_l Versionen _strftime_l dieser Funktionen sind identisch, mit der Ausnahme, dass sie das Gebietsschema als Parameter verwenden und anstelle des aktuell festgelegten Gebietsschemas verwenden. Weitere Informationen finden Sie unter Locale.

Die strftime Funktionen unterstützen diese Formatierungscodes:

Wie in der printf-Funktion, wird das #-Flag möglicherweise dem Formatierungscode vorangestellt. In diesem Fall wird die Bedeutung des Formatcodes wie folgt geändert.

Die ISO 8601-Woche und das wochenbasierte Jahr, das von %V, %gund %G, verwendet eine Woche, die am Montag beginnt. Woche 1 ist die Woche, die den vierten Januartag enthält, der die erste Woche ist, die mindestens vier Tage des Jahres enthält. Wenn der erste Montag des Jahres der 2., der 3. oder der 4. ist, sind die vorherigen Tage Teil der letzten Woche des vorhergehenden Jahres. Für diese Tage %V wird durch 53 ersetzt, und beide %g werden %G durch die Ziffern des vorherigen Jahres ersetzt.

Anforderungen

Die _strftime_l Funktionen sind _wcsftime_l microsoftspezifisch. Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Beispiel

Ein Beispiel hierfür finden Sie unter time.

Siehe auch

Gebietsschema
Zeitverwaltung
Zeichenfolgenbearbeitung
localeconv
setlocale, _wsetlocale
strcoll -Funktionen
strxfrm, , wcsxfrm_strxfrm_l_wcsxfrm_l