COleDateTimeSpan, klasa
Reprezentuje względny czas, przedział czasu.
Składnia
class COleDateTimeSpan
Elementy członkowskie
Konstruktory publiczne
Nazwa/nazwisko | opis |
---|---|
COleDateTimeSpan::COleDateTimeSpan | COleDateTimeSpan Tworzy obiekt. |
Metody publiczne
Nazwa/nazwisko | opis |
---|---|
COleDateTimeSpan::Format | Generuje sformatowaną reprezentację COleDateTimeSpan ciągu obiektu. |
COleDateTimeSpan::GetDays | Zwraca część dnia zakresu reprezentowanego przez ten COleDateTimeSpan obiekt. |
COleDateTimeSpan::GetHours | Zwraca część godzinną tego COleDateTimeSpan obiektu. |
COleDateTimeSpan::GetMinutes | Zwraca część minuty zakresu, który reprezentuje ten COleDateTimeSpan obiekt. |
COleDateTimeSpan::GetSeconds | Zwraca drugą część zakresu reprezentowanego przez ten COleDateTimeSpan obiekt. |
COleDateTimeSpan::GetStatus | Pobiera stan (ważność) tego COleDateTimeSpan obiektu. |
COleDateTimeSpan::GetTotalDays | Zwraca liczbę dni reprezentowanych przez ten COleDateTimeSpan obiekt. |
COleDateTimeSpan::GetTotalHours | Zwraca liczbę godzin reprezentowanych przez ten COleDateTimeSpan obiekt. |
COleDateTimeSpan::GetTotalMinutes | Zwraca liczbę minut reprezentowanych przez ten COleDateTimeSpan obiekt. |
COleDateTimeSpan::GetTotalSeconds | Zwraca liczbę sekund reprezentowanych przez ten COleDateTimeSpan obiekt. |
COleDateTimeSpan::SetDateTimeSpan | Ustawia wartość tego COleDateTimeSpan obiektu. |
COleDateTimeSpan::SetStatus | Ustawia stan (ważność) tego COleDateTimeSpan obiektu. |
Operatory publiczne
Nazwa/nazwisko | opis |
---|---|
operator +, - | Dodaj, odejmij i zmień znak dla COleDateTimeSpan wartości. |
operator +=, -= | Dodaj i odejmij COleDateTimeSpan wartość z tej COleDateTimeSpan wartości. |
operator = | Kopiuje COleDateTimeSpan wartość. |
operator ==, <, <= | Porównaj dwie COleDateTimeSpan wartości. |
operator podwójny | Konwertuje tę COleDateTimeSpan wartość na wartość double . |
Publiczne elementy członkowskie danych
Nazwa/nazwisko | opis |
---|---|
COleDateTimeSpan::m_span | Zawiera element bazowy double dla tego COleDateTimeSpan obiektu. |
COleDateTimeSpan::m_status | Zawiera stan tego COleDateTimeSpan obiektu. |
Uwagi
COleDateTimeSpan
nie ma klasy bazowej.
Czas COleDateTimeSpan
utrzymuje się w dniach.
COleDateTimeSpan
jest używany z jej klasy towarzyszącej COleDateTime. COleDateTime
Hermetyzuje DATE
typ danych automatyzacji OLE. COleDateTime
reprezentuje bezwzględne wartości czasu. Wszystkie COleDateTime
obliczenia obejmują COleDateTimeSpan
wartości. Relacja między tymi klasami jest analogiczna do relacji między CTime i CTimeSpan.
Aby uzyskać więcej informacji na COleDateTime
temat klas i COleDateTimeSpan
, zobacz artykuł Data i godzina: obsługa automatyzacji.
Wymagania
Nagłówek: ATLComTime.h
Operatory relacyjne COleDateTimeSpan
Operatory porównania.
bool operator==(const COleDateTimeSpan& dateSpan) const throw();
bool operator!=(const COleDateTimeSpan& dateSpan) const throw();
bool operator<(const COleDateTimeSpan& dateSpan) const throw();
bool operator>(const COleDateTimeSpan& dateSpan) const throw();
bool operator<=(const COleDateTimeSpan& dateSpan) const throw();
bool operator>=(const COleDateTimeSpan& dateSpan) const throw();
Parametry
dateSpan
Element COleDateTimeSpan
do porównania.
Wartość zwracana
Te operatory porównują dwie wartości zakresu daty/godziny i zwracają wartość TRUE, jeśli warunek ma wartość true; w przeciwnym razie FAŁSZ.
Uwagi
Uwaga
Jeśli którykolwiek operand jest nieprawidłowy, wystąpi atlasSERT.
Przykład
COleDateTimeSpan spanOne(3, 12, 0, 0); // 3 days and 12 hours
COleDateTimeSpan spanTwo(spanOne); // 3 days and 12 hours
BOOL b;
b = spanOne == spanTwo; // TRUE
b = spanOne < spanTwo; // FALSE, same value
b = spanOne > spanTwo; // FALSE, same value
b = spanOne <= spanTwo; // TRUE, same value
b = spanOne >= spanTwo; // TRUE, same value
spanTwo.SetStatus(COleDateTimeSpan::invalid);
b = spanOne == spanTwo; // FALSE, different status
b = spanOne != spanTwo; // TRUE, different status
COleDateTimeSpan ts1(100.0); // one hundred days
COleDateTimeSpan ts2(110.0); // ten more days
ASSERT((ts1 != ts2) && (ts1 < ts2) && (ts1 <= ts2));
COleDateTimeSpan::COleDateTimeSpan
COleDateTimeSpan
Tworzy obiekt.
COleDateTimeSpan() throw();
COleDateTimeSpan(double dblSpanSrc) throw();
COleDateTimeSpan(LONG lDays, int nHours, int nMins, int nSecs) throw();
Parametry
dblSpanSrc
Liczba dni do skopiowania do nowego COleDateTimeSpan
obiektu.
lDays, nHours, nMins, nSecs
Wskaż wartości dnia i godziny, które mają zostać skopiowane do nowego COleDateTimeSpan
obiektu.
Uwagi
Wszystkie te konstruktory tworzą nowe COleDateTimeSpan
obiekty zainicjowane do określonej wartości. Krótki opis każdego z tych konstruktorów jest następujący:
COleDateTimeSpan( ) Tworzy
COleDateTimeSpan
obiekt zainicjowany do 0.COleDateTimeSpan(
dblSpanSrc
) TworzyCOleDateTimeSpan
obiekt z wartości zmiennoprzecinkowej.COleDateTimeSpan(
lDays
,nHours
,nMins
nSecs
) TworzyCOleDateTimeSpan
obiekt zainicjowany do określonych wartości liczbowych.
Stan nowego COleDateTimeSpan
obiektu jest ustawiony na prawidłowy.
Aby uzyskać więcej informacji na temat granic COleDateTimeSpan
wartości, zobacz artykuł Data i godzina: obsługa automatyzacji.
Przykład
COleDateTimeSpan spanOne(2.75); // 2 days and 18 hours
COleDateTimeSpan spanTwo(2, 18, 0, 0); // 2 days and 18 hours
COleDateTimeSpan spanThree(3, -6, 0, 0); // 2 days and 18 hours
COleDateTimeSpan ts1; // Uninitialized time value
COleDateTimeSpan ts2a(ts1); // Copy constructor
COleDateTimeSpan ts2b = ts1; // Copy constructor again
COleDateTimeSpan ts3(100.0); // 100 days
COleDateTimeSpan ts4(0, 1, 5, 12); // 1 hour, 5 minutes, and 12 seconds
COleDateTimeSpan::Format
Generuje sformatowaną reprezentację COleDateTimeSpan
ciągu obiektu.
CString Format(LPCTSTR pFormat) const;
CString Format(UINT nID) const;
Parametry
PFormat
Ciąg formatowania podobny do printf
ciągu formatowania. Kody formatowania poprzedzone znakiem procentowym (%
) są zastępowane przez odpowiedni COleDateTimeSpan
składnik. Inne znaki w ciągu formatowania są kopiowane bez zmian do zwracanego ciągu. Poniżej wymieniono wartość i znaczenie kodów formatowania dla Format
:
%H Godziny w bieżącym dniu
%M Min w bieżącej godzinie
%S Sekundy w bieżącej minucie
%% Znak procentu
Cztery kody formatu wymienione powyżej to jedyne kody, które będą akceptowane przez format.
-
Nid
Identyfikator zasobu dla ciągu kontrolki formatu.
Wartość zwracana
Element CString
, który zawiera sformatowaną wartość zakresu daty/godziny.
Uwagi
Wywołaj te funkcje, aby utworzyć sformatowaną reprezentację wartości przedziału czasu. Jeśli stan tego COleDateTimeSpan
obiektu ma wartość null, wartość zwracana jest pustym ciągiem. Jeśli stan jest nieprawidłowy, ciąg zwracany jest określony przez zasób ciągu IDS_INVALID_DATETIMESPAN.
Krótki opis formularzy dla tej funkcji jest następujący:
Format( pFormat )
Ten formularz formatuje wartość przy użyciu ciągu formatu zawierającego specjalne kody formatowania poprzedzone znakiem procentowym (%), tak jak w pliku printf
. Ciąg formatowania jest przekazywany jako parametr do funkcji.
Format( nID )
Ten formularz formatuje wartość przy użyciu ciągu formatu zawierającego specjalne kody formatowania poprzedzone znakiem procentowym (%), tak jak w pliku printf
. Ciąg formatowania jest zasobem. Identyfikator tego zasobu ciągu jest przekazywany jako parametr.
Przykład
// get the current time
COleDateTime tmStart = COleDateTime::GetCurrentTime();
// waste some time
CString str;
::Sleep(3000);
// get the current time again
COleDateTime tmFinish = COleDateTime::GetCurrentTime();
// find the difference
COleDateTimeSpan tmSpan = tmFinish - tmStart;
// tell the user
str = tmSpan.Format(_T("%S seconds elapsed"));
_tprintf_s(_T("%s\n"), (LPCTSTR) str);
COleDateTimeSpan::GetDays
Pobiera część dnia tej wartości zakresu daty/godziny.
LONG GetDays() const throw();
Wartość zwracana
Część dnia tej wartości zakresu daty/godziny.
Uwagi
Zwracane wartości z tego zakresu funkcji wahają się od około - 3 615 000 do 3615 000.
W przypadku innych funkcji, które wysyłają zapytania o wartość COleDateTimeSpan
obiektu, zobacz następujące funkcje składowe:
Przykład
COleDateTimeSpan ts(3, 1, 5, 12); // 3 days, 1 hour, 5 min, and 12 sec
ASSERT(ts.GetDays() == 3);
COleDateTimeSpan::GetHours
Pobiera część godziny tej wartości zakresu daty/godziny.
LONG GetHours() const throw();
Wartość zwracana
Część godzin tej wartości zakresu daty/godziny.
Uwagi
Zwracane wartości z tego zakresu funkcji z zakresu od - 23 do 23.
W przypadku innych funkcji, które wysyłają zapytania o wartość COleDateTimeSpan
obiektu, zobacz następujące funkcje składowe:
Przykład
COleDateTimeSpan ts(3, 1, 5, 12); // 3 days, 1 hour, 5 min, and 12 sec
ASSERT(ts.GetHours() == 1);
COleDateTimeSpan::GetMinutes
Pobiera część minuty tej wartości zakresu daty/godziny.
LONG GetMinutes() const throw();
Wartość zwracana
Część minut tej wartości zakresu daty/godziny.
Uwagi
Zwracane wartości z tego zakresu funkcji z zakresu od - 59 do 59.
W przypadku innych funkcji, które wysyłają zapytania o wartość COleDateTimeSpan
obiektu, zobacz następujące funkcje składowe:
Przykład
COleDateTimeSpan ts(3, 1, 5, 12); // 3 days, 1 hour, 5 min, and 12 sec
ASSERT(ts.GetMinutes() == 5);
COleDateTimeSpan::GetSeconds
Pobiera drugą część tej wartości zakresu daty/godziny.
LONG GetSeconds() const throw();
Wartość zwracana
Część sekund tej wartości zakresu daty/godziny.
Uwagi
Zwracane wartości z tego zakresu funkcji z zakresu od - 59 do 59.
W przypadku innych funkcji, które wysyłają zapytania o wartość COleDateTimeSpan
obiektu, zobacz następujące funkcje składowe:
Przykład
COleDateTimeSpan ts(3, 1, 5, 12); // 3 days, 1 hour, 5 min, and 12 sec
ASSERT(ts.GetSeconds() == 12);
COleDateTimeSpan::GetStatus
Pobiera stan (ważność) tego COleDateTimeSpan
obiektu.
DateTimeSpanStatus GetStatus() const throw();
Wartość zwracana
Stan tej COleDateTimeSpan
wartości.
Uwagi
Wartość zwracana jest definiowana DateTimeSpanStatus
przez wyliczony typ, który jest zdefiniowany w COleDateTimeSpan
klasie.
enum DateTimeSpanStatus{
valid = 0,
invalid = 1,
null = 2,
};
Aby zapoznać się z krótkim opisem tych wartości stanu, zobacz następującą listę:
COleDateTimeSpan::valid
Wskazuje, że tenCOleDateTimeSpan
obiekt jest prawidłowy.COleDateTimeSpan::invalid
Wskazuje, że tenCOleDateTimeSpan
obiekt jest nieprawidłowy. Oznacza to, że jego wartość może być niepoprawna.COleDateTimeSpan::null
Wskazuje, że tenCOleDateTimeSpan
obiekt ma wartość null, czyli że dla tego obiektu nie podano żadnej wartości. (Jest to wartość "null" w sensie bazy danych "bez wartości", w przeciwieństwie do wartości NULL języka C++).
Stan COleDateTimeSpan
obiektu jest nieprawidłowy w następujących przypadkach:
Jeśli ten obiekt napotkał przepełnienie lub niedopełnienie podczas operacji przypisania arytmetycznego, a mianowicie
+=
lub-=
.Jeśli do tego obiektu przypisano nieprawidłową wartość.
Jeśli stan tego obiektu został jawnie ustawiony na nieprawidłowy przy użyciu polecenia
SetStatus
.
Aby uzyskać więcej informacji na temat operacji, które mogą ustawić stan na nieprawidłowy, zobacz COleDateTimeSpan::operator +, - i COleDateTimeSpan::operator +=, -=.
Aby uzyskać więcej informacji na temat granic COleDateTimeSpan
wartości, zobacz artykuł Data i godzina: obsługa automatyzacji.
COleDateTimeSpan::GetTotalDays
Pobiera tę wartość daty/przedziału czasu wyrażoną w dniach.
double GetTotalDays() const throw();
Wartość zwracana
Ta wartość zakresu daty/godziny wyrażona w dniach. Mimo że ta funkcja jest prototypowana w celu zwrócenia wartości podwójnej, zawsze zwraca wartość całkowitą.
Uwagi
Zwracane wartości z tego zakresu funkcji wahają się od około - 3,65e6 do 3,65e6.
W przypadku innych funkcji, które wysyłają zapytania o wartość COleDateTimeSpan
obiektu, zobacz następujące funkcje składowe:
Przykład
COleDateTimeSpan ts(3, 1, 5, 12); // 3 days, 1 hour, 5 min, and 12 sec
ASSERT(ts.GetTotalDays() == 3);
ASSERT(ts.GetTotalHours() == 73);
ASSERT(ts.GetTotalMinutes() == 4385);
ASSERT(ts.GetTotalSeconds() == 263112);
COleDateTimeSpan::GetTotalHours
Pobiera tę wartość zakresu daty/godziny wyrażoną w godzinach.
double GetTotalHours() const throw();
Wartość zwracana
Ta wartość zakresu daty/godziny wyrażona w godzinach. Mimo że ta funkcja jest prototypowana w celu zwrócenia wartości podwójnej, zawsze zwraca wartość całkowitą.
Uwagi
Wartości zwracane z tego zakresu funkcji wahają się od około - 8,77e7 do 8,77e7.
W przypadku innych funkcji, które wysyłają zapytania o wartość COleDateTimeSpan
obiektu, zobacz następujące funkcje składowe:
Przykład
Zobacz przykład getTotalDays.
COleDateTimeSpan::GetTotalMinutes
Pobiera tę wartość daty/przedziału czasu wyrażoną w minutach.
double GetTotalMinutes() const throw();
Wartość zwracana
Ta wartość zakresu daty/godziny wyrażona w minutach. Mimo że ta funkcja jest prototypowana w celu zwrócenia wartości podwójnej, zawsze zwraca wartość całkowitą.
Uwagi
Zwracane wartości z tego zakresu funkcji wahają się od około do 5,26e9 do 5,26e9.
W przypadku innych funkcji, które wysyłają zapytania o wartość COleDateTimeSpan
obiektu, zobacz następujące funkcje składowe:
Przykład
Zobacz przykład getTotalDays.
COleDateTimeSpan::GetTotalSeconds
Pobiera tę wartość daty/przedziału czasu wyrażoną w sekundach.
double GetTotalSeconds() const throw();
Wartość zwracana
Ta wartość zakresu daty/godziny wyrażona w sekundach. Mimo że ta funkcja jest prototypowana w celu zwrócenia wartości podwójnej, zawsze zwraca wartość całkowitą.
Uwagi
Wartości zwracane z tego zakresu funkcji z zakresu od około - 3,16e11 do 3,16e11.
W przypadku innych funkcji, które wysyłają zapytania o wartość COleDateTimeSpan
obiektu, zobacz następujące funkcje składowe:
Przykład
Zobacz przykład getTotalDays.
COleDateTimeSpan::m_span
Wartość bazowa double
dla tego COleDateTime
obiektu.
double m_span;
Uwagi
Ta wartość wyraża okres daty/godziny w dniach.
Uwaga
Zmiana wartości w elemencie double
członkowskim danych spowoduje zmianę wartości tego COleDateTimeSpan
obiektu. Nie zmienia on stanu tego COleDateTimeSpan
obiektu.
COleDateTimeSpan::m_status
Typ dla tego elementu członkowskiego danych to wyliczony typ DateTimeSpanStatus
, który jest zdefiniowany w COleDateTimeSpan
klasie.
DateTimeSpanStatus m_status;
Uwagi
enum DateTimeSpanStatus{
valid = 0,
invalid = 1,
null = 2,
};
Aby zapoznać się z krótkim opisem tych wartości stanu, zobacz następującą listę:
COleDateTimeSpan::valid
Wskazuje, że tenCOleDateTimeSpan
obiekt jest prawidłowy.COleDateTimeSpan::invalid
Wskazuje, że tenCOleDateTimeSpan
obiekt jest nieprawidłowy. Oznacza to, że jego wartość może być niepoprawna.COleDateTimeSpan::null
Wskazuje, że tenCOleDateTimeSpan
obiekt ma wartość null, czyli że dla tego obiektu nie podano żadnej wartości. (Jest to wartość "null" w sensie bazy danych "bez wartości", w przeciwieństwie do wartości NULL języka C++).
Stan COleDateTimeSpan
obiektu jest nieprawidłowy w następujących przypadkach:
Jeśli ten obiekt napotkał przepełnienie lub niedopełnienie podczas operacji przypisania arytmetycznego, a mianowicie
+=
lub-=
.Jeśli do tego obiektu przypisano nieprawidłową wartość.
Jeśli stan tego obiektu został jawnie ustawiony na nieprawidłowy przy użyciu parametru SetStatus.
Aby uzyskać więcej informacji na temat operacji, które mogą ustawić stan na nieprawidłowy, zobacz COleDateTimeSpan::operator +, - i COleDateTimeSpan::operator +=, -=.
Uwaga
Ten element członkowski danych jest przeznaczony dla zaawansowanych sytuacji programistycznych. Należy użyć wbudowanych funkcji składowych GetStatus i SetStatus. Zobacz SetStatus
, aby uzyskać dodatkowe ostrzeżenia dotyczące jawnego ustawiania tego elementu członkowskiego danych.
Aby uzyskać więcej informacji na temat granic COleDateTimeSpan
wartości, zobacz artykuł Data i godzina: obsługa automatyzacji.
COleDateTimeSpan::operator =
Kopiuje COleDateTimeSpan
wartość.
COleDateTimeSpan& operator=(double dblSpanSrc) throw();
Uwagi
Ten przeciążony operator przypisania kopiuje wartość daty/godziny źródłowej do tego COleDateTimeSpan
obiektu.
COleDateTimeSpan::operator +, -
Dodaj, odejmij i zmień znak dla COleDateTimeSpan
wartości.
COleDateTimeSpan operator+(const COleDateTimeSpan& dateSpan) const throw();
COleDateTimeSpan operator-(const COleDateTimeSpan& dateSpan) const throw();
COleDateTimeSpan operator-() const throw();
Uwagi
Pierwsze dwa operatory umożliwiają dodawanie i odejmowanie wartości daty/przedziału czasu. Trzeci umożliwia zmianę znaku wartości daty/przedziału czasu.
Jeśli jeden z operandów ma wartość null, stan wynikowej COleDateTimeSpan
wartości ma wartość null.
Jeśli jeden z operandów jest nieprawidłowy, a drugi nie ma wartości null, stan wynikowej COleDateTimeSpan
wartości jest nieprawidłowy.
Aby uzyskać więcej informacji na temat prawidłowych, nieprawidłowych i null wartości stanu, zobacz zmienną składową m_status .
Przykład
COleDateTimeSpan ts1(3, 1, 5, 12); // 3 days, 1 hour, 5 min, and 12 sec
COleDateTimeSpan ts2(100.0 / (24 * 3600.0)); // 100 seconds
COleDateTimeSpan ts3 = ts1 + ts2;
ASSERT(ts3.GetSeconds() == 52); // 6 mins, 52 secs
COleDateTimeSpan::operator +=, -=
Dodaj i odejmij COleDateTimeSpan
wartość z tej COleDateTimeSpan
wartości.
COleDateTimeSpan& operator+=(const COleDateTimeSpan dateSpan) throw();
COleDateTimeSpan& operator-=(const COleDateTimeSpan dateSpan) throw();
Uwagi
Te operatory umożliwiają dodawanie i odejmowanie wartości daty/godziny z tego COleDateTimeSpan
obiektu. Jeśli jeden z operandów ma wartość null, stan wynikowej COleDateTimeSpan
wartości ma wartość null.
Jeśli jeden z operandów jest nieprawidłowy, a drugi nie ma wartości null, stan wynikowej COleDateTimeSpan
wartości jest nieprawidłowy.
Aby uzyskać więcej informacji na temat prawidłowych, nieprawidłowych i null wartości stanu, zobacz zmienną składową m_status .
Przykład
COleDateTimeSpan ts1(10.0); // 10 days
COleDateTimeSpan ts2(100.0); // 100 days
ts2 -= ts1;
ASSERT(ts2.GetTotalDays() == 90);
COleDateTimeSpan::operator double
Konwertuje tę COleDateTimeSpan
wartość na wartość double
.
operator double() const throw();
Uwagi
Ten operator zwraca wartość tej COleDateTimeSpan
wartości jako liczbę dni zmiennoprzecinkowych.
COleDateTimeSpan::SetDateTimeSpan
Ustawia wartość tej wartości zakresu daty/godziny.
void SetDateTimeSpan(LONG lDays, int nHours, int nMins, int nSecs) throw();
Parametry
lDays, nHours, nMins, nSecs
Określ wartości zakresu daty i zakresu czasu, które mają zostać skopiowane do tego COleDateTimeSpan
obiektu.
Uwagi
W przypadku funkcji, które wysyłają zapytania o wartość COleDateTimeSpan
obiektu, zobacz następujące funkcje składowe:
Przykład
COleDateTimeSpan spanOne;
COleDateTimeSpan spanTwo;
spanOne.SetDateTimeSpan(0, 2, 45, 0); // 2 hours and 45 seconds
spanTwo.SetDateTimeSpan(0, 3, -15, 0); // 2 hours and 45 seconds
COleDateTimeSpan::SetStatus
Ustawia stan (ważność) tego COleDateTimeSpan
obiektu.
void SetStatus(DateTimeSpanStatus status) throw();
Parametry
status
Nowa wartość stanu dla tego COleDateTimeSpan
obiektu.
Uwagi
Wartość parametru Status jest definiowana DateTimeSpanStatus
przez wyliczony typ, który jest zdefiniowany w COleDateTimeSpan
klasie.
enum DateTimeSpanStatus{
valid = 0,
invalid = 1,
null = 2,
};
Aby zapoznać się z krótkim opisem tych wartości stanu, zobacz następującą listę:
COleDateTimeSpan::valid
Wskazuje, że tenCOleDateTimeSpan
obiekt jest prawidłowy.COleDateTimeSpan::invalid
Wskazuje, że tenCOleDateTimeSpan
obiekt jest nieprawidłowy. Oznacza to, że jego wartość może być niepoprawna.COleDateTimeSpan::null
Wskazuje, że tenCOleDateTimeSpan
obiekt ma wartość null, czyli że dla tego obiektu nie podano żadnej wartości. (Jest to wartość "null" w sensie bazy danych "bez wartości", w przeciwieństwie do wartości NULL języka C++).Uwaga
Ta funkcja jest przeznaczony dla zaawansowanych sytuacji programistycznych. Ta funkcja nie zmienia danych w tym obiekcie. Będzie ona najczęściej używana do ustawiania stanu na wartość null lub jest nieprawidłowa. Należy pamiętać, że operator przypisania (operator =) i SetDateTimeSpan ustawiają stan obiektu na podstawie wartości źródłowych.
Przykład
// if the person is not still in school, set days to graduation to null
if (!m_bStillInSchool || m_dtDateOfGraduation.GetStatus() == COleDateTime::null)
m_dtsDaysToGraduation.SetStatus(COleDateTimeSpan::null);
Zobacz też
COleDateTime, klasa
CTime, klasa
CTimeSpan, klasa
Wykres hierarchii
Klasy udostępnione ATL/MFC