SHFormatDateTimeA-Funktion (shlwapi.h)

[SHFormatDateTime ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Erzeugt eine Zeichenfolgendarstellung einer Zeit, die als FILETIME-Struktur angegeben ist.

Syntax

int SHFormatDateTimeA(
  [in]                const FILETIME *pft,
  [in, out, optional] DWORD          *pdwFlags,
  [out]               LPSTR          pszBuf,
                      UINT           cchBuf
);

Parameter

[in] pft

Typ: const 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 0 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 flag FDTF_DEFAULT festgelegt ist.

FDTF_SHORTTIME (0x00000001)

0x00000001. Formatiert die Tageszeit, wie in der Anwendung Regional- und Sprachoptionen angegeben, in Systemsteuerung, jedoch ohne Sekunden. Dieses Flag 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 Anwendung Regional- und Sprachoptionen in Systemsteuerung. Dieses Flag 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 Anwendung Regional- und Sprachoptionen in Systemsteuerung. Dieses Flag kann nicht mit FDTF_SHORTDATE kombiniert werden.

Das lange Datum wurde erfolgreich formatiert.

FDTF_LONGTIME (0x00000008)

0x00000008. Formatiert die Tageszeit, wie von der Anwendung Regional- und Sprachoptionen in Systemsteuerung angegeben, einschließlich Sekunden. Dieses Flag 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.

Für das Datum wurde die relative Notation verwendet.

FDTF_LTRDATE (0x00000100)

0x00000100. Fügt Markierungen für das Leselayout von links nach rechts hinzu. Dieses Flag kann nicht mit FDTF_RTLDATE kombiniert werden.

FDTF_RTLDATE (0x00000200)

0x00000200. Fügt Markierungen für das Leselayout von rechts nach links hinzu. Dieses Flag kann nicht mit FDTF_LTRDATE kombiniert werden.

FDTF_NOAUTOREADINGORDER (0x00000400)

0x00000400. Es werden keine Lesereihenfolgemarken eingefügt. Normalerweise bestimmt SHFormatDateTime in Abwesenheit des FDTF_LTRDATE- oder FDTF_RTLDATE-Flags die Lesereihenfolge aus dem Standardgebietsschema des Benutzers, fügt Lesereihenfolgemarkierungen ein und aktualisiert den pdwFlags-Ausgabewert entsprechend. Dieses Flag verhindert, dass dieser Prozess auftritt. Es wird am häufigsten von Legacyaufrufern von SHFormatDateTime verwendet. Dieses Flag kann nicht mit FDTF_RTLDATE oder FDTF_LTRDATE kombiniert werden.

Windows Server 2003 und Windows XP: Dieser Wert ist nicht verfügbar.

Wenn die Funktion zurückgibt, 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 formatierte Uhrzeit empfängt. Der Puffer muss groß genug sein, um die anzahl der vom cchBuf-Parameter angegebenen TCHAR-Zeichen zu enthalten, einschließlich eines beendenden NULL-Zeichens.

cchBuf

Typ: UINT

Die Anzahl der TCHARs, die vom Puffer enthalten sein können, auf den pszBuf verweist.

Rückgabewert

Typ: int

Gibt die Anzahl der in den Puffer geschriebenen TCHARs zurück, einschließlich des beendenden NULL-Zeichens. Bei Einem Fehler ist dieser Wert 0.

Hinweise

Hinweis

Der shlwapi.h-Header 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 nicht codierungsneutralem Code 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 XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlwapi.h
Bibliothek Shlwapi.lib
DLL Shlwapi.dll (Version 5.0 oder höher)

Weitere Informationen

GetDateFormat

GetTimeFormat