EnumDateFormatsW-Funktion (winnls.h)

Artikel
08/27/2023

Listet die Formate für langes Datum, kurzes Datum oder Jahr/Monat auf, die für ein angegebenes Gebietsschema verfügbar sind.

Hinweis Um zusätzlich zu den Datumsformatinformationen einen Kalenderbezeichner zu erhalten, sollte die Anwendung die EnumDateFormatsEx-Funktion verwenden. Ein weiterer Grund für die Bevorzugung dieser Funktion ist, dass Microsoft aus Gründen der Interoperabilität zur Verwendung von Gebietsschemanamen anstelle von Gebietsschemabezeichnern für neue Gebietsschemas migriert.

Hinweis Jede Anwendung, die nur unter Windows Vista oder höher ausgeführt wird, sollte EnumDateFormatsEx vor EnumDateFormats verwenden.

Syntax

BOOL EnumDateFormatsW(
  [in] DATEFMT_ENUMPROCW lpDateFmtEnumProc,
  [in] LCID              Locale,
  [in] DWORD             dwFlags
);

Parameter

[in] lpDateFmtEnumProc

Zeiger auf eine anwendungsdefinierte Rückruffunktion. Weitere Informationen finden Sie unter EnumDateFormatsProc.

[in] Locale

Gebietsschemabezeichner , der das Gebietsschema angibt, für das Datumsformatinformationen abgerufen werden sollen. Sie können das MAKELCID-Makro verwenden, um einen Bezeichner zu erstellen oder einen der folgenden vordefinierten Werte zu verwenden.

[in] dwFlags

Flag, das Datumsformate angibt. Ausführliche Definitionen finden Sie im dwFlags-Parameter von EnumDateFormatsExEx.

Rückgabewert

Gibt bei erfolgreicher Ausführung einen Wert ungleich 0 zurück, andernfalls 0. Um erweiterte Fehlerinformationen zu erhalten, kann die Anwendung GetLastError aufrufen, wodurch einer der folgenden Fehlercodes zurückgegeben werden kann:

ERROR_INVALID_FLAGS. Die für Flags angegebenen Werte waren ungültig.
ERROR_INVALID_PARAMETER. Jeder der Parameterwerte war ungültig.

Hinweise

Hinweis Diese API wird aktualisiert, um die Änderung der japanischen Ära vom Mai 2019 zu unterstützen. Wenn Ihre Anwendung den japanischen Kalender unterstützt, sollten Sie überprüfen, ob die neue Ära ordnungsgemäß behandelt wird. Weitere Informationen finden Sie unter Vorbereiten Ihrer Anwendung für die Änderung der japanischen Ära .

Ausführliche Informationen zum Betrieb dieser Funktion finden Sie unter Hinweise in EnumDateFormatsEx.

Hinweis Um die Datumsformate für Gebietsschemas mit alternativen Kalendern aufzulisten, sollte die Anwendung EnumDateFormatsEx verwenden.

Hinweis

Der winnls.h-Header definiert EnumDateFormats als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winnls.h (windows.h einschließen)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

EnumDateFormatsEx

EnumDateFormatsProc

Unterstützung für landessprachliche Sprachen

Unterstützungsfunktionen für nationalsprachliche Sprachen

Freigeben über