COleDateTime::GetStatus

Artikel
06/09/2015

Ruft den Status (Gültigkeit) eines angegebenen COleDateTime-Objekts ab.

DateTimeStatus GetStatus( ) const throw( );

Rückgabewert

Gibt den Status dieses COleDateTime-Werts zurück. Wenn Sie GetStatus auf einem COleDateTime-Objekt aufrufen, das mit dem Standard erstellt wird, gibt er gültiges zurück. Wenn Sie GetStatus auf einem COleDateTime-Objekt aufrufen, das mit dem Konstruktor initialisiert wird, der auf NULL festgelegt wird, gibt GetStatus NULL zurück. Siehe Remarks weitere Informationen.

Hinweise

Der Rückgabewert wird durch den DateTimeStatus Aufzählungstyp definiert, der in COleDateTime-Klasse definiert ist.

enum DateTimeStatus

{

error = -1,

valid = 0,

invalid = 1, // Invalid date (out of range, etc.)

null = 2, // Literally has no value

};

Eine kurze Beschreibung dieser Statuswerte, finden Sie in der folgenden Liste:

COleDateTime::error gibt an, dass ein Fehler beim Versuch, zu erhalten Teil des Datums-/Uhrzeitwert aufgetreten ist.
COleDateTime::valid gibt an, dass dieses COleDateTime-Objekt gültig ist.
COleDateTime::invalid gibt an, dass dieses Objekt COleDateTime ungültig ist; das heißt, ist möglicherweise falsch sein Wert.
COleDateTime::null gibt an, dass dieses Objekt COleDateTime h. NULL ist dass kein Wert für dieses Objekt angegeben wurde. (Dies ist "NULL" in Datenbanksinn "des Darin keinen Wert," im Gegensatz zu C++ NULL.)

Der Status eines Objekts COleDateTime ist in folgenden Fällen ungültig:

Wenn der Wert von einem VARIANT oder COleVariant-Wert festgelegt wird, der nicht in einen Datums-/Uhrzeitwert konvertiert werden konnte.
Wenn der Wert von time_t, von SYSTEMTIME oder von FILETIME-Wert festgelegt wird, der nicht auf einen gültigen Datums-/Uhrzeitwert konvertiert werden konnte.
Wenn der Wert durch SetDateTime mit ungültigen Parameterwerten festgelegt ist.
Wenn dieses Objekt einen Überlauf oder einen Unterlauf während eines arithmetischen Zuweisungsvorgangs, nämlich, += oder -= erfahren verfügt.
Wenn ein ungültiger Wert für dieses Objekt zugewiesen wurde.
Wenn der Status dieses Objekts explizit den Aufruf mit SetStatus festgelegt wurde.

Weitere Informationen über die Vorgänge, die den Status zu ungültigem festlegen, finden Sie in den Memberfunktionen:

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

Beispiel

COleDateTime t;

// this one is a leap year
t.SetDateTime(2000, 2, 29, 5, 0, 0);
ASSERT(t.GetStatus() == COleDateTime::valid);

// this date isn't valid
t.SetDateTime(1925, 2, 30, 5, 0, 0);
ASSERT(t.GetStatus() == COleDateTime::invalid);

// the only way to set null is to set null!
t.SetStatus(COleDateTime::null);
ASSERT(t.GetStatus() == COleDateTime::null);