COleDateTime::ParseDateTime

Artikel
02/26/2013

Analysiert eine Zeichenfolge, um einen Datums-/Uhrzeitwert zu lesen.

bool ParseDateTime(
   LPCTSTR lpszDate,
   DWORD dwFlags = 0,
   LCID lcid = LANG_USER_DEFAULT 
) throw( );

Parameter

lpszDate
Ein Zeiger auf eine auf NULL endende Zeichenfolge, die analysiert werden soll.Details finden Sie Hinweise.
dwFlags
Gibt Flags für Gebietsschemaeinstellungen und -Analyse an.Eine oder mehrere der folgenden Flags:
- LOCALE_NOUSEROVERRIDE verwendet die Systemstandard-Gebietsschemaeinstellungen, anstatt benutzerdefinierte Benutzereinstellungen.
- VAR_TIMEVALUEONLY ignorieren den Datumsteil während der Analyse.
- VAR_DATEVALUEONLY ignorieren den Zeitteil während der Analyse.
lcid
Gibt Gebietsschema-ID an, die für die Konvertierung zu verwenden.

Rückgabewert

Gibt true, wenn die Zeichenfolge erfolgreich in einen Datums-/Uhrzeitwert konvertiert wurde; andernfalls false zurück.

Hinweise

Wenn die Zeichenfolge erfolgreich in einen Datums-/Uhrzeitwert konvertiert wurde, wird der Wert dieses COleDateTime-Objekts zu diesem Wert und den Status zu gültigem festgelegt.

Hinweis
Werte für das Jahr müssen zwischen 100 und 9999 liegen, einschließlich.

Der lpszDate-Parameter kann eine Vielzahl von Formaten akzeptieren.Beispielsweise enthalten die folgenden Zeichenfolgen akzeptable Datum/Uhrzeit-Formate:

"25 January 1996"

"8:30:00"

"20:30:00"

"January 25, 1996 8:30:00"

"8:30:00 Jan. 25, 1996"

"1/25/1996 8:30:00" // always specify the full year,

// even in a 'short date' format

Beachten Sie, dass die Gebietsschema-ID auch beeinflussen, ob das Zeichenfolgenformat für die Konvertierung in einen Datums-/Uhrzeitwert zulässig ist.

Bei VAR_DATEVALUEONLY wird der Zeitwert festgelegt, um 0 oder Zeit Mitternacht bewerten.Bei VAR_TIMEVALUEONLY wird der Datumswert bis jetzt 0 und am 30. Dezember 1899 bedeutet.

Wenn die Zeichenfolge nicht in einen Datums-/Uhrzeitwert konvertiert werden kann, oder wenn es einen numerischen Überlauf hat, ist der Status dieses COleDateTime-Objekts ungültig.

Weitere Informationen über die Grenzen und Implementierung für COleDateTime-Werte, finden Sie im Artikel Datum und Uhrzeit: Automatisierungs-Unterstützung.