GetCalendarDateFormatEx-Funktion

Veraltet. Ruft eine ordnungsgemäß formatierte Datumszeichenfolge für das angegebene Gebietsschema unter Verwendung des angegebenen Datums und Kalenders ab. Der Benutzer kann das kurze Datumsformat, das lange Datumsformat, das Format des Jahresmonats oder ein benutzerdefiniertes Formatmuster angeben.

Hinweis

Diese Funktion kann Daten abrufen, die sich zwischen Releases ändern, z. B. aufgrund eines benutzerdefinierten Gebietsschemas. Wenn Ihre Anwendung Daten beibehalten oder übertragen muss, finden Sie weitere Informationen unter Verwenden von persistenten Gebietsschemadaten.

Syntax

BOOL GetCalendarDateFormatEx(
  _In_        LPCWSTR       lpszLocale,
  _In_        DWORD         dwFlags,
  _In_  const LPCALDATETIME lpCalDateTime,
  _In_        LPCWSTR       lpFormat,
  _Out_       LPWSTR        lpDateStr,
  _In_        int           cchDate
);

Parameter

lpszLocale [ In]

Zeiger auf einen Gebietsschemanamen oder einen der folgenden vordefinierten Werte.

dwFlags [ In]

Flags, die Datumsformatoptionen angeben. Wenn lpFormat nicht auf NULL festgelegt ist, muss dieser Parameter auf 0 festgelegt werden. Wenn lpFormat auf NULL festgelegt ist, kann die Anwendung eine Kombination der folgenden Werte und LOCALE _ NOUSEROVERRIDEangeben.

Wert Bedeutung
DATE _ SHORTDATE
Verwenden Sie das kurze Datumsformat. Dies ist die Standardoption. Dieser Wert kann nicht mit DATE _ LONGDATE oder DATE _ YEARMONTH verwendet werden.
DATE _ LONGDATE
Verwenden Sie das Lange Datumsformat. Dieser Wert kann nicht mit DATE _ SHORTDATE oder DATE _ YEARMONTH verwendet werden.
DATE _ YEARMONTH
Verwenden Sie das Format Jahr/Monat. Dieser Wert kann nicht mit DATE _ SHORTDATE oder DATE _ LONGDATE verwendet werden.
DATE _ LTRREADING
Fügen Sie Markierungen für das Leselayout von links nach rechts hinzu. Dieser Wert kann nicht mit DATE _ RTLREADING verwendet werden.
DATE _ RTLREADING
Fügen Sie Markierungen für das Leselayout von rechts nach links hinzu. Dieser Wert kann nicht mit DATE LTRREADING verwendet werden. _

lpCalDateTime [ In]

Zeiger auf eine CALDATETIME-Struktur, die die zu formatierten Datums- und Kalenderinformationen enthält.

lpFormat [ In]

Zeiger auf eine Formatbildzeichenfolge, die zum Bilden der Datumszeichenfolge verwendet wird. Mögliche Werte für die Formatbildzeichenfolge sind in Day, Month, Year und Era Format Picturesdefiniert.

Die Formatbildzeichenfolge muss NULL-terminiert sein. Die Funktion verwendet das Gebietsschema nur für Informationen, die nicht in der Formatbildzeichenfolge angegeben sind, z. B. die Namen von Tag und Monat für das Gebietsschema. Die Anwendung legt diesen Parameter auf NULL fest, wenn die Funktion das Datumsformat des angegebenen Gebietsschemas verwenden soll.

lpDateStr [ out]

Zeiger auf einen Puffer, in dem diese Funktion die formatierte Datumszeichenfolge empfängt.

cchDate [ In]

Größe des lpDateStr-Puffers in Zeichen. Alternativ kann die Anwendung diesen Parameter auf 0 festlegen. In diesem Fall gibt die Funktion die Anzahl der Zeichen zurück, die zum Speichern der formatierten Datumszeichenfolge erforderlich sind, und der lpDateStr-Parameter wird nicht verwendet.

Rückgabewert

Gibt die Anzahl der Zeichen zurück, die bei Erfolg in den lpDateStr-Puffer geschrieben wurden. Wenn der cchDate-Parameter auf 0 festgelegt ist, gibt die Funktion die Anzahl der Zeichen zurück, die zum Speichern der formatierten Datumszeichenfolge erforderlich sind, einschließlich des abschließenden NULL-Zeichens.

Diese Funktion gibt 0 zurück, wenn sie nicht erfolgreich ist. Um erweiterte Fehlerinformationen abzurufen, kann die Anwendung GetLastErroraufrufen, wodurch einer der folgenden Fehlercodes zurückgegeben werden kann:

  • FEHLERDATUM _ _ LIEGT AUßERHALB DES _ _ BEREICHS. Das angegebene Datum lag außerhalb des Bereichs.
  • FEHLER: _ _ UNZUREICHENDER PUFFER. Eine angegebene Puffergröße war nicht groß genug, oder sie wurde fälschlicherweise auf NULL festgelegt.
  • FEHLER: _ UNGÜLTIGE _ FLAGS. Die für Flags angegebenen Werte waren ungültig.
  • FEHLER: _ UNGÜLTIGER _ PARAMETER. Jeder der Parameterwerte war ungültig.

Bemerkungen

Das früheste von dieser Funktion unterstützte Datum ist der 1. Januar 1601.

Dieser Funktion ist keine Header- oder Bibliotheksdatei zugeordnet. Die Anwendung kann LoadLibrary mit dem DLL-Namen (Kernel32.dll) aufrufen, um ein Modulhandle abzurufen. Anschließend kann GetProcAddress mit diesem Modulhandle und dem Namen dieser Funktion aufgerufen werden, um die Funktionsadresse abzurufen.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows [Nur Vista-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2008-Desktop-Apps]
DLL
Kernel32.dll

Weitere Informationen

Unterstützung für nationale Sprachen

Unterstützungsfunktionen für nationale Sprachen

Bilder im Format "Day", "Month", "Year" und "Era"

NLS: Beispiel für namensbasierte APIs

EnumDateFormatsExEx

GetDateFormat

GetDateFormatEx

CALDATETIME