COleDateTime::GetStatus
Pobiera stan (ważność) danego COleDateTime obiektu.
DateTimeStatus GetStatus( ) const throw( );
Wartość zwracana
Zwraca stan to COleDateTime wartości.Jeśli zadzwonisz GetStatus na COleDateTime obiektu zbudowane z domyślnym, będzie zwracać prawidłowy.Jeśli zadzwonisz GetStatus na COleDateTime obiektu zainicjowany z zestawem konstruktora NULL, GetStatus zwróci wartość null.Zobacz uwagi Aby uzyskać więcej informacji.
Uwagi
Wartość zwracana jest zdefiniowany przez DateTimeStatus wyliczone typu, który jest zdefiniowany w COleDateTime klasy.
enum DateTimeStatus
{
error = -1,
valid = 0,
invalid = 1, // Invalid date (out of range, etc.)
null = 2, // Literally has no value
};
Krótki opis tych wartości stanu listę:
COleDateTime::errorWskazuje, że wystąpił błąd podczas próby uzyskania część wartości daty i godziny.
COleDateTime::valid wskazuje że COleDateTime obiektu jest nieprawidłowy.
COleDateTime::invalid wskazuje że COleDateTime obiektu jest nieprawidłowy; oznacza to, że jego wartość mogą być nieprawidłowe.
COleDateTime::null wskazuje że COleDateTime obiekt jest null, oznacza to, że wartość nie zostały dostarczone dla tego obiektu.(Jest to "null" w rozumieniu bazy danych "posiadające żadnej wartości" a nie C++ NULL.)
Stan COleDateTime obiektu jest nieprawidłowy w następujących przypadkach:
Jeśli jego wartość jest z WARIANTU lub COleVariant wartość, która nie można przekonwertować wartości daty i godziny.
Jeśli jego wartość jest z time_t, SYSTEMTIME, lub FILETIME wartość, która nie może być konwertowana na wartość nieprawidłowa data/godzina.
Jeśli jego wartość jest ustawiana SetDateTime z wartościami nieprawidłowy parametr.
Jeśli ten obiekt napotkał przepełnienie lub niedomiar podczas operacji arytmetycznych przydziału, a mianowicie += lub -=.
Jeśli nieprawidłowa wartość został przypisany do tego obiektu.
Jeśli stan ten obiekt jawnie ustawiono nieprawidłową za pomocą SetStatus.
Aby uzyskać więcej informacji na temat operacji, które może ustawić stan nieprawidłowy, zobacz następujące funkcje składowe:
Aby uzyskać więcej informacji na temat granic dla COleDateTime wartości, zobacz artykuł datę i godzinę: automatyzacja obsługi.
Przykład
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);
Wymagania
Nagłówek: atlcomtime.h