Getdateformatwrapw-Funktion
[Getdateformatwrapw ist für die Verwendung in Windows XP verfügbar. Sie wird in nachfolgenden Versionen nicht verfügbar sein. Sie sollten getdateformatw an seiner Stelle verwenden.]
Formatiert ein Datum als Datums Zeichenfolge für ein angegebenes Gebiets Schema. Die-Funktion formatiert entweder ein bestimmtes Datum oder das lokale Systemdatum.
Hinweis
Getdateformatwrapw ist ein Wrapper für die getdateformatw -Funktion. Weitere Hinweise zur Verwendung finden Sie auf der Seite " getDateFormat ".
Syntax
int GetDateFormatWrapW(
_In_ LCID Locale,
_In_ DWORD dwFlags,
_In_ const SYSTEMTIME *lpDate,
_In_ LPCWSTR pwzFormat,
_Out_ LPWSTR pwzDateStr,
_In_ int cchDate
);
Parameter
-
Gebiets Schema [ in]
-
Typ: LCID
Das Gebiets Schema, für das die Datums Zeichenfolge formatiert werden soll. Wenn pwzformat den Wert null hat, formatiert die Funktion die Zeichenfolge gemäß dem Datumsformat für dieses Gebiets Schema. Wenn pwzformat nicht null ist, verwendet die Funktion das Gebiets Schema nur für Informationen, die nicht in der Format Bild Zeichenfolge angegeben sind (z. b. die Tages-und Monatsnamen des Gebiets Schemas).
Bei diesem Parameter kann es sich um einen vom MAKELCID -Makro erstellten Gebiets Schema Bezeichner oder einen der folgenden vordefinierten Werte handeln.
-
Standard für Gebiets Schema _ System _
-
Standardsystem Gebiets Schema.
-
_Standardbenutzer Name für locale _
-
Standardbenutzer Gebiets Schema.
dwFlags [ in]
Typ: DWORD
Gibt verschiedene Funktions Optionen an. Wenn pwzformat nicht null ist, muss dieser Parameter NULL sein. Wenn pwzformat null ist, können Sie eine Kombination der folgenden Werte angeben. Wenn Sie weder Date _ yearMonth, Date _ SHORTDATE noch Date _ longDate angeben und pwzformat den Wert null hat, _ wird Date SHORTDATE als Standardwert verwendet.
Gebiets Schema _ nouseroverride
Wenn festgelegt, formatiert die Funktion die Zeichenfolge unter Verwendung des Standard Datums Formats des Systems für das angegebene Gebiets Schema. Wenn nicht festgelegt, formatiert die Funktion die Zeichenfolge mithilfe von Benutzer Überschreibungen für das Standard Datumsformat des Gebiets Schemas.
Gebiets Schema _ verwenden _ CP _ ACP
Verwendet die ANSI-Codepage des Systems für die Zeichen folgen Übersetzung anstelle der Codepage des Gebiets Schemas.
Datum/ _ kurzdatum
Verwendet das kurze Datumsformat. Dieser Wert kann nicht mit Date _ longDate oder Date _ yearMonth verwendet werden.
Datum _ longDate
Verwendet das lange Datumsformat. Dieser Wert kann nicht mit Date _ SHORTDATE oder Date _ yearMonth verwendet werden.
Datum des _ Monats
Verwendet das Format Jahr/Monat. Dieser Wert kann nicht mit Date _ SHORTDATE oder Date _ longDate verwendet werden.
Datum der _ Verwendung des _ alt- _ Kalenders
Verwendet den alternativen Kalender, falls vorhanden, um die Datums Zeichenfolge zu formatieren. Wenn dieses Flag festgelegt ist, verwendet die Funktion das Standardformat für diesen alternativen Kalender anstelle von Benutzer Überschreibungen. Die Benutzer Überschreibungen werden nur in dem Fall verwendet, dass kein Standardformat für den angegebenen alternativen Kalender vorhanden ist.
Datums- _ ltrreading
Fügt Markierungen für das Lese Layout von links nach rechts hinzu. Dieser Wert kann nicht mit Date _ RtlReading verwendet werden.
Datum _ RtlReading
Fügt Markierungen für das Lese Layout von rechts nach Links hinzu. Dieser Wert kann nicht mit dem Datum _ ltrreading verwendet werden.
lpdate [ in]
Typ: * Konstante SYSTEMTIME * _
Ein Zeiger auf eine _ SYSTEMTIME * -Struktur, die die Datumsinformationen enthält, die formatiert werden sollen. Wenn dieser Zeiger null ist, verwendet die Funktion das aktuelle lokale Systemdatum.
pwzformat [ in]
Typ: LPCWSTR
Ein Zeiger auf ein Format Bild, das zum bilden der Datums Zeichenfolge verwendet werden soll. Wenn pwzformat den Wert null hat, verwendet die Funktion das Datumsformat des angegebenen Gebiets Schemas. Weitere Informationen finden Sie unter " getDateFormat ".
pwzdatestr [ vorgenommen]
Typ: LPWSTR
Ein Zeiger auf einen Puffer, der die formatierte Datums Zeichenfolge empfängt.
cchdate [ in]
Typ: int
Gibt die Größe des pwzdatestr -Puffers in Zeichen an. Wenn cchdate NULL ist, gibt die Funktion die Anzahl von Zeichen zurück, die für die formatierte Datums Zeichenfolge erforderlich ist, und der Puffer, auf den pwzdatestr zeigt, wird nicht verwendet.
Rückgabewert
Typ: int
Wenn die Funktion erfolgreich ausgeführt wird, ist der Rückgabewert die Anzahl der Zeichen, die in den Puffer geschrieben werden, auf den pwzdatestr zeigt. Wenn der cchdate -Parameter 0 (null) ist, ist der Rückgabewert die Anzahl von Zeichen, die für die formatierte Datums Zeichenfolge erforderlich ist. Die Anzahl schließt das abschließende Null Zeichen ein.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. " GetLastError " kann einen der folgenden Fehlercodes zurückgeben.
-
Fehler _ beim _ Puffer.
-
_ungültige _ Flags.
-
Fehler bei _ ungültigem _ Parameter
Bemerkungen
Getdateformatwrapw bietet die Möglichkeit, Unicode-Zeichen folgen in älteren Betriebssystemen als Windows XP zu verwenden. Die bevorzugte Methode ist die Verwendung von getdateformatw in Verbindung mit der Microsoft-Schicht für Unicode (MSLU).
Getdateformatwrapw muss direkt aus Shlwapi.dll aufgerufen werden, und zwar mithilfe von Ordnungszahl 311.
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional, Windows XP [ Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Nur Windows Server 2003 [ -Desktop-Apps] |
| DLL |
|