SHFormatDateTimeA-Funktion (shlwapi.h)
[SHFormatDateTime steht für die Verwendung in den im Abschnitt "Anforderungen" angegebenen Betriebssystemen zur Verfügung. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]
Erzeugt eine Zeichenfolgendarstellung einer als FILETIME- Struktur angegebenen Zeit.
Syntax
int SHFormatDateTimeA(
[in] const FILETIME *pft,
[in, out, optional] DWORD *pdwFlags,
[out] LPSTR pszBuf,
UINT cchBuf
);
Parameter
[in] pft
Typ: FILETIME UNALIGNED*
Ein Zeiger auf die FILETIME- Struktur, deren Zeit in eine Zeichenfolge konvertiert werden soll.
[in, out, optional] pdwFlags
Typ: DWORD*-
Ein Zeiger auf einen DWORD--Wert, der bitweise Flags enthält, die das Datums- und Uhrzeitformat angeben.
Wenn Sie die Funktion aufrufen, können Sie null oder mehr der folgenden Flags mit Ausnahmen kombinieren, wie angegeben. Sie können diesen Parameter auch auf NULL-festlegen. In diesem Fall geht die Funktion davon aus, dass das FDTF_DEFAULT Flag festgelegt ist.
FDTF_SHORTTIME (0x00000001)
0x00000001. Formatiert die Tageszeit gemäß der Angabe der Regions- und Sprachoptionen Anwendung in der Systemsteuerung, jedoch ohne Sekunden. Dieses Kennzeichen kann nicht mit FDTF_LONGTIME kombiniert werden.
Die kurze Zeit wurde erfolgreich formatiert.
FDTF_SHORTDATE (0x00000002)
0x00000002. Formatiert das Datum gemäß dem kurzen Datumsformat in der Regions- und Sprachoptionen Anwendung in der Systemsteuerung. Dieses Kennzeichen kann nicht mit FDTF_LONGDATE kombiniert werden.
Das kurze Datum wurde erfolgreich formatiert.
FDTF_DEFAULT
Entspricht FDTF_SHORTDATE | FDTF_SHORTTIME.
FDTF_LONGDATE (0x00000004)
0x00000004. Formatiert das Datum gemäß dem langen Datumsformat in der Regions- und Sprachoptionen Anwendung in der Systemsteuerung. Dieses Kennzeichen kann nicht mit FDTF_SHORTDATE kombiniert werden.
Das lange Datum wurde erfolgreich formatiert.
FDTF_LONGTIME (0x00000008)
0x00000008. Formatiert die Tageszeit gemäß den Regionalen und Sprachoptionen Anwendung in der Systemsteuerung, einschließlich Sekunden. Dieses Kennzeichen kann nicht mit FDTF_SHORTTIME kombiniert werden.
Die lange Zeit wurde erfolgreich formatiert.
FDTF_RELATIVE (0x00000010)
0x00000010. Wenn das FDTF_LONGDATE-Flag festgelegt ist und das Datum in der FILETIME- Struktur dasselbe Datum ist, an dem SHFormatDateTime aufgerufen wird, wird der Wochentag (sofern vorhanden) in "Heute" geändert. Wenn das Datum in der Struktur der vorherige Tag ist, wird der Wochentag (sofern vorhanden) in "Gestern" geändert.
Die relative Schreibweise wurde für das Datum verwendet.
FDTF_LTRDATE (0x00000100)
0x00000100. Fügt Markierungen für das Leselayout von links nach rechts hinzu. Dieses Kennzeichen kann nicht mit FDTF_RTLDATE kombiniert werden.
FDTF_RTLDATE (0x00000200)
0x00000200. Fügt Markierungen für das Leselayout von rechts nach links hinzu. Dieses Kennzeichen kann nicht mit FDTF_LTRDATE kombiniert werden.
FDTF_NOAUTOREADINGORDER (0x00000400)
0x00000400. Es werden keine Lesereihenfolgenmarken eingefügt. In FDTF_RTLDATE FDTF_LTRDATE der Regel bestimmt
Windows Server 2003 und Windows XP: Dieser Wert ist nicht verfügbar.
Wenn die Funktion zurückgegeben wird, kann der DWORD- Wert, auf den dieser Parameter verweist, null oder mehr der folgenden Flags enthalten.
[out] pszBuf
Typ: LPTSTR-
Ein Zeiger auf einen Puffer, der das formatierte Datum und die Uhrzeit empfängt. Der Puffer muss groß genug sein, um die Anzahl der TCHAR-Zeichen zu enthalten, die durch den cchBuf--Parameter angegeben werden, einschließlich eines endenden Nullzeichens.
cchBuf
Typ: UINT-
Die Anzahl der TCHARs, die durch den Puffer enthalten sein können, auf den pszBufverweist.
Rückgabewert
Typ: int
Gibt die Anzahl der TCHARs zurück, die in den Puffer geschrieben wurden, einschließlich des endenden Nullzeichens. Bei Einem Fehler ist dieser Wert 0.
Bemerkungen
Anmerkung
Der Header "shlwapi.h" definiert SHFormatDateTime 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 |
|---|---|
| mindestens unterstützte Client- | Windows XP [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2003 [Nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | shlwapi.h |
| Library | Shlwapi.lib |
| DLL- | Shlwapi.dll (Version 5.0 oder höher) |