COleDateTime, klasa

Artykuł
04/03/2023

Hermetyzuje DATE typ danych używany w automatyzacji OLE.

Składnia

class COleDateTime

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko	opis
COleDateTime::COleDateTime	`COleDateTime` Tworzy obiekt.

Metody publiczne

Nazwa/nazwisko	opis
COleDateTime::Format	Generuje sformatowaną reprezentację `COleDateTime` ciągu obiektu.
COleDateTime::GetAsDBTIMESTAMP	Wywołaj tę metodę, aby uzyskać czas w `COleDateTime` obiekcie jako `DBTIMESTAMP` strukturę danych.
COleDateTime::GetAsSystemTime	Wywołaj tę metodę, aby uzyskać czas w `COleDateTime` obiekcie jako strukturę danych SYSTEMTIME .
COleDateTime::GetAsUDATE	Wywołaj tę metodę, aby uzyskać czas w `COleDateTime` strukturze `UDATE` danych.
COleDateTime::GetCurrentTime	Tworzy `COleDateTime` obiekt reprezentujący bieżący czas (statyczna funkcja składowa).
COleDateTime::GetDay	Zwraca dzień reprezentujący ten `COleDateTime` obiekt (od 1 do 31).
COleDateTime::GetDayOfWeek	Zwraca dzień tygodnia, który reprezentuje ten `COleDateTime` obiekt (niedziela = 1).
COleDateTime::GetDayOfYear	Zwraca dzień roku, który reprezentuje ten `COleDateTime` obiekt (1 stycznia = 1).
COleDateTime::GetHour	Zwraca godzinę reprezentującą ten `COleDateTime` obiekt (od 0 do 23).
COleDateTime::GetMinute	Zwraca minutę reprezentującą ten `COleDateTime` obiekt (od 0 do 59).
COleDateTime::GetMonth	Zwraca miesiąc reprezentujący ten `COleDateTime` obiekt (od 1 do 12).
COleDateTime::GetSecond	Zwraca drugą reprezentację tego `COleDateTime` obiektu (0–59).
COleDateTime::GetStatus	Pobiera stan (ważność) tego `COleDateTime` obiektu.
COleDateTime::GetYear	Zwraca rok reprezentowany przez ten `COleDateTime` obiekt.
COleDateTime::P arseDateTime	Odczytuje wartość daty/godziny z ciągu i ustawia wartość `COleDateTime`.
COleDateTime::SetDate	Ustawia wartość tego `COleDateTime` obiektu na określoną wartość tylko dla daty.
COleDateTime::SetDateTime	Ustawia wartość tego `COleDateTime` obiektu na określoną wartość daty/godziny.
COleDateTime::SetStatus	Ustawia stan (ważność) tego `COleDateTime` obiektu.
COleDateTime::SetTime	Ustawia wartość tego `COleDateTime` obiektu na określoną wartość tylko czasową.

Operatory publiczne

Nazwa/nazwisko	opis
COleDateTime::operator ==, COleDateTime::operator <itp.	Porównaj dwie `COleDateTime` wartości.
COleDateTime::operator +, COleDateTime::operator —	Dodawanie i odejmowanie `COleDateTime` wartości.
COleDateTime::operator +=, COleDateTime::operator -=	Dodaj i odejmij `COleDateTime` wartość z tego `COleDateTime` obiektu.
COleDateTime::operator =	Kopiuje `COleDateTime` wartość.
COleDateTime::operator DATE, COleDateTime::operator Date*	Konwertuje `COleDateTime` wartość na wartość `DATE` `DATE*`lub .

Publiczne elementy członkowskie danych

Nazwa/nazwisko	opis
COleDateTime::m_dt	Zawiera element bazowy `DATE` dla tego `COleDateTime` obiektu.
COleDateTime::m_status	Zawiera stan tego `COleDateTime` obiektu.

Uwagi

COleDateTime nie ma klasy bazowej.

Jest to jeden z możliwych typów danych WARIANT automatyzacji OLE. Wartość COleDateTime reprezentuje bezwzględną wartość daty i godziny.

Typ DATE jest implementowany jako wartość zmiennoprzecinkowa. Dni są mierzone od 30 grudnia 1899 r., o północy. W poniższej tabeli przedstawiono niektóre daty i skojarzone z nimi wartości:

Data	Wartość
29 grudnia 1899, północ	-1,0
29 grudnia 1899, 6:00	-1.25
30 grudnia 1899, północ	0,0
31 grudnia 1899, północ	1.0
1 stycznia 1900, 6:00	2,25

Uwaga

W powyższej tabeli wartości dnia stają się ujemne przed północą 30 grudnia 1899 r., ale wartości godziny dnia nie są. Na przykład wartość 6:00 jest zawsze reprezentowana przez wartość ułamkową 0,25 niezależnie od tego, czy liczba całkowita reprezentująca dzień jest dodatnia (po 30 grudnia 1899 r.) lub ujemna (przed 30 grudnia 1899 r.). Oznacza to, że proste porównanie zmiennoprzecinkowe błędnie posortuje wartość reprezentującą COleDateTime 6:00 w dniu 12/29/1899 jako późniejszą niż jedna reprezentująca 7:00 w tym samym dniu.

Klasa COleDateTime obsługuje daty od 1 stycznia 100 do 31 grudnia 9999. Klasa COleDateTime używa kalendarza gregoriańskiego; nie obsługuje dat juliana. COleDateTime ignoruje czas letni. (Zobacz Data i godzina: Obsługa automatyzacji).

Uwaga

Możesz użyć %y formatu , aby pobrać dwucyfrowy rok tylko dla dat rozpoczynających się od 1900 roku. Jeśli używasz %y formatu przed 1900 r., kod generuje błąd ASSERT.

Ten typ służy również do reprezentowania wartości tylko daty lub godziny. Zgodnie z konwencją data 0 (30 grudnia 1899) jest używana dla wartości tylko czasu, a godzina 00:00 (północ) jest używana dla wartości tylko daty.

Jeśli utworzysz COleDateTime obiekt przy użyciu daty mniejszej niż 100, data zostanie zaakceptowana, ale kolejne wywołania metody GetYear, , GetMonthGetDayGetHour, GetMinute, i GetSecond kończą się niepowodzeniem i zwracają wartość -1. Wcześniej można było użyć dwucyfrowych dat, ale daty muszą być 100 lub większe w MFC 4.2 i nowszych.

Aby uniknąć problemów, określ datę czterocyfrową. Na przykład:

COleDateTime mytime(1996, 1, 1, 0, 0, 0);

Podstawowe operacje arytmetyczne dla COleDateTime wartości używają klasy towarzyszącej COleDateTimeSpan. COleDateTimeSpan wartości definiują interwał czasu. Relacja między tymi klasami jest podobna do relacji między CTime i CTimeSpan.

Aby uzyskać więcej informacji na temat COleDateTime klas i COleDateTimeSpan , zobacz artykuł Data i godzina: obsługa automatyzacji.

Wymagania

Nagłówek: ATLComTime.h

Operatory relacyjne COleDateTime

Operatory porównania.

bool operator==(const COleDateTime& date) const throw();
bool operator!=(const COleDateTime& date) const throw();
bool operator<(const COleDateTime& date) const throw();
bool operator>(const COleDateTime& date) const throw();
bool operator<=(const COleDateTime& date) const throw();
bool operator>=(const COleDateTime& date) const throw();

Parametry

data
Obiekt COleDateTime do porównania.

Uwagi

Uwaga

Jeśli jeden z dwóch operandów jest nieprawidłowy, wystąpi atlasSERT.

Przykłady

COleDateTime dateOne(1995, 3, 15, 12, 0, 0); // 15 March 1995 12 noon
COleDateTime dateTwo(dateOne);             // 15 March 1995 12 noon
BOOL b;
b = dateOne == dateTwo;                    // TRUE
b = dateOne < dateTwo;                     // FALSE, same value
b = dateOne > dateTwo;                     // FALSE, same value
b = dateOne <= dateTwo;                    // TRUE, same value
b = dateOne >= dateTwo;                    // TRUE, same value   

dateTwo.SetStatus(COleDateTime::invalid);
b = dateOne == dateTwo;                    // FALSE, different status
b = dateOne != dateTwo;                    // TRUE, different status

Operatory >=, =, ><i <, będą potwierdzać, czy COleDateTime obiekt ma wartość null.

VARIANT v = {};
v.vt = VT_NULL;
COleDateTime t1(v);
COleDateTime t2(v);
t1 = t1 + t2;

COleDateTime::COleDateTime

COleDateTime Tworzy obiekt.

COleDateTime() throw();
COleDateTime(const VARIANT& varSrc) throw();
COleDateTime(DATE dtSrc) throw();
COleDateTime(time_t timeSrc) throw();
COleDateTime(__time64_t timeSrc) throw();
COleDateTime(const SYSTEMTIME& systimeSrc) throw();
COleDateTime(const FILETIME& filetimeSrc) throw();

COleDateTime(int nYear,
    int nMonth,
    int nDay,
    int nHour,
    int nMin,
    int nSec) throw();

COleDateTime(WORD wDosDate,
    WORD wDosTime) throw();
COleDateTime(const DBTIMESTAMP& timeStamp) throw();

Parametry

dateSrc
Istniejący COleDateTime obiekt, który ma zostać skopiowany do nowego COleDateTime obiektu.

varSrc
Istniejąca VARIANT struktura danych (prawdopodobnie COleVariant obiekt) do przekonwertowania na wartość daty/godziny (VT_DATE) i skopiowana do nowego COleDateTime obiektu.

dtSrc
Wartość daty/godziny (DATE) do skopiowania do nowego COleDateTime obiektu.

timeSrc
Wartość time_t lub __time64_t , która ma zostać przekonwertowana na wartość daty/godziny i skopiowana do nowego COleDateTime obiektu.

systimeSrc
Struktura SYSTEMTIME , która ma zostać przekonwertowana na wartość daty/godziny i skopiowana do nowego COleDateTime obiektu.

filetimeSrc
Struktura FILETIME , która ma zostać przekonwertowana na wartość daty/godziny i skopiowana do nowego COleDateTime obiektu. Obiekt FILETIME używa uniwersalnego czasu koordynowanego (UTC), więc jeśli przejdziesz czas lokalny w strukturze, wyniki będą niepoprawne. Aby uzyskać więcej informacji, zobacz Czasy plików w zestawie Windows SDK.

nYear, nMonth, nDay, nHour, nMin, nSec
Wskaż wartości daty i godziny, które mają zostać skopiowane do nowego COleDateTime obiektu.

wDosDate, wDosTime
Wartości daty i godziny MS-DOS, które mają zostać przekonwertowane na wartość daty/godziny i skopiowane do nowego COleDateTime obiektu.

Sygnatury czasowej
Odwołanie do struktury DBTimeStamp zawierającej bieżący czas lokalny.

Uwagi

Wszystkie te konstruktory tworzą nowe COleDateTime obiekty zainicjowane do określonej wartości. W poniższej tabeli przedstawiono prawidłowe zakresy dla każdego składnika daty i godziny:

Składnik daty/godziny	Prawidłowy zakres
rok	100 - 9999
miesiąca	0 - 12
dzień	0 - 31
godzina	0 - 23
min.	0 - 59
drugi	0 - 59

Należy pamiętać, że rzeczywista górna granica składnika day różni się w zależności od składników miesiąca i roku. Aby uzyskać szczegółowe informacje, zobacz SetDate funkcje składowe lub SetDateTime .

Poniżej przedstawiono krótki opis każdego konstruktora:

COleDateTime() COleDateTime Tworzy obiekt zainicjowany do 0 (północ, 30 grudnia 1899).
COleDateTime(dateSrc ) COleDateTime Tworzy obiekt z istniejącego COleDateTime obiektu.
COleDateTime(varSrc ) COleDateTime Tworzy obiekt. Próbuje przekonwertować VARIANT strukturę lub obiekt COleVariant na wartość daty/godziny ( VT_DATE). Jeśli ta konwersja zakończy się pomyślnie, przekonwertowana wartość zostanie skopiowana do nowego COleDateTime obiektu. Jeśli tak nie jest, wartość COleDateTime obiektu jest ustawiona na 0 (północ, 30 grudnia 1899) i jej stan na nieprawidłowy.
COleDateTime(dtSrc ) COleDateTime Tworzy obiekt z DATE wartości.
COleDateTime(timeSrc ) COleDateTime Tworzy obiekt z time_t wartości.
COleDateTime(systimeSrc ) COleDateTime Tworzy obiekt z SYSTEMTIME wartości.
COleDateTime(filetimeSrc ) COleDateTime Tworzy obiekt z FILETIME wartości. . Obiekt FILETIME używa uniwersalnego czasu koordynowanego (UTC), więc jeśli przejdziesz czas lokalny w strukturze, wyniki będą niepoprawne. Aby uzyskać więcej informacji, zobacz Czasy plików w zestawie Windows SDK.
COleDateTime(nYear, , , nHournMonthnDay, , nSec nMin) tworzy COleDateTime obiekt z określonych wartości liczbowych.
COleDateTime(wDosDate, ) wDosTime COleDateTime Tworzy obiekt z określonych wartości daty i godziny MS-DOS.

Aby uzyskać więcej informacji na time_t temat typu danych, zobacz funkcję time w dokumentacji biblioteki czasu wykonywania.

Aby uzyskać więcej informacji, zobacz struktury SYSTEMTIME i FILETIME w zestawie Windows SDK.

Aby uzyskać więcej informacji na temat granic COleDateTime wartości, zobacz artykuł Data i godzina: obsługa automatyzacji.

Uwaga

Konstruktor używający DBTIMESTAMP parametru jest dostępny tylko wtedy, gdy jest dołączony obiekt OLEDB.h.

Przykład

time_t osBinaryTime;   // C run-time time (defined in <time.h>)
time(&osBinaryTime);   // Get the current time from the 
                     // operating system.

COleDateTime time1;   // initialized to 00:00am, 30 December 1899
                     // (and m_nStatus is valid!)

COleDateTime time2 = time1; // Copy constructor
COleDateTime time3(osBinaryTime);   // from time_t
COleDateTime time4(1999, 3, 19, 22, 15, 0); // 10:15PM March 19, 1999

SYSTEMTIME sysTime;   // Win32 time information
GetSystemTime(&sysTime);

COleDateTime time5(sysTime);

COleDateTime::Format

Tworzy sformatowaną reprezentację wartości daty/godziny.

CString Format(DWORD dwFlags = 0,  LCID lcid = LANG_USER_DEFAULT) const;
CString Format(LPCTSTR lpszFormat) const;
CString Format(UINT nFormatID) const;

Parametry

dwFlags
Wskazuje jedną z następujących flag ustawień regionalnych:

LOCALE_NOUSEROVERRIDE Użyj domyślnych ustawień regionalnych systemu, a nie niestandardowych ustawień użytkownika.
VAR_TIMEVALUEONLY Ignoruj część daty podczas analizowania.
VAR_DATEVALUEONLY Ignoruj część czasu podczas analizowania.

lcid
Wskazuje identyfikator ustawień regionalnych do użycia na potrzeby konwersji. Aby uzyskać więcej informacji na temat identyfikatorów języków, zobacz Identyfikatory języka.

lpszFormat
Ciąg formatowania podobny do printf ciągu formatowania. Każdy kod formatowania poprzedzony znakiem procentu ( %) jest zastępowany przez odpowiedni COleDateTime składnik. Inne znaki w ciągu formatowania są kopiowane bez zmian do zwracanego ciągu. Aby uzyskać więcej informacji, zobacz strftime funkcji czasu wykonywania. Wartość i znaczenie kodów formatowania dla Format elementu to:

%H Godziny w bieżącym dniu
%M Minuty w bieżącej godzinie
%S Sekundy w bieżącej minucie
%% Znak procentu

nFormatID
Identyfikator zasobu dla ciągu kontrolki formatu.

Wartość zwracana

Element CString zawierający sformatowaną wartość daty/godziny.

Uwagi

Jeśli stan tego COleDateTime 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 ATL_IDS_DATETIME_INVALID.

Krótki opis trzech formularzy dla tej funkcji jest następujący:

Format( dwFlags, lcid)
Ten formularz formatuje wartość przy użyciu specyfikacji języka (identyfikatorów ustawień regionalnych) dla daty i godziny. Przy użyciu parametrów domyślnych ten formularz wyświetli datę i godzinę, chyba że część godziny to 0 (północ), w takim przypadku będzie drukować tylko datę lub część daty to 0 (30 grudnia 1899 r.), w takim przypadku będzie drukować tylko raz. Jeśli wartość daty/godziny to 0 (30 grudnia 1899 r., północ), ten formularz z domyślnymi parametrami wyświetli północ.

Format( lpszFormat)
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. Aby uzyskać więcej informacji na temat kodów formatowania, zobacz strftime, wcsftime w dokumentacji biblioteki czasu wykonywania.

Format( nFormatID)
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. Aby uzyskać więcej informacji na temat kodów formatowania, zobacz strftime, wcsftime w dokumentacji biblioteki czasu wykonywania.

Przykład

COleDateTime t(1999, 3, 19, 22, 15, 0);

CString str = t.Format(_T("%A, %B %d, %Y"));
ASSERT(str == _T("Friday, March 19, 1999"));

COleDateTime::GetAsDBTIMESTAMP

Wywołaj tę metodę, aby uzyskać czas w COleDateTime obiekcie jako DBTIMESTAMP strukturę danych.

bool GetAsDBTIMESTAMP(DBTIMESTAMP& timeStamp) const throw();

Parametry

Sygnatury czasowej
Odwołanie do struktury DBTimeStamp .

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0.

Uwagi

Przechowuje wynikowy czas w strukturze sygnatury czasowej, do której odwołuje się odwołanie. Struktura DBTIMESTAMP danych zainicjowana przez tę funkcję będzie mieć jej fraction składową ustawioną na zero.

Przykład

COleDateTime t = COleDateTime::GetCurrentTime();
DBTIMESTAMP ts;
t.GetAsDBTIMESTAMP(ts); // retrieves the time in t into the ts structure

COleDateTime::GetAsSystemTime

Wywołaj tę metodę, aby uzyskać czas w COleDateTime obiekcie jako SYSTEMTIME strukturę danych.

bool GetAsSystemTime(SYSTEMTIME& sysTime) const throw();

Parametry

sysTime
Odwołanie do struktury SYSTEMTIME w celu odbierania przekonwertowanej wartości daty/godziny z COleDateTime obiektu.

Wartość zwracana

Zwraca wartość TRUE, jeśli operacja powiedzie się; FAŁSZ, jeśli konwersja nie powiedzie się lub jeśli COleDateTime obiekt ma wartość NULL lub jest nieprawidłowy.

Uwagi

GetAsSystemTime przechowuje wynikowy czas w odwołaniu do obiektu sysTime . Struktura SYSTEMTIME danych zainicjowana przez tę funkcję będzie mieć jej wMilliseconds składową ustawioną na zero.

Aby uzyskać więcej informacji na temat informacji o stanie przechowywanych COleDateTime w obiekcie, zobacz GetStatus.

COleDateTime::GetAsUDATE

Wywołaj tę metodę, aby uzyskać czas w COleDateTime obiekcie jako UDATE strukturę danych.

bool GetAsUDATE(UDATE& uDate) const throw();

Parametry

Data uDate
Odwołanie do UDATE struktury odbieranej przekonwertowanej wartości daty/godziny z COleDateTime obiektu.

Wartość zwracana

Zwraca wartość TRUE, jeśli operacja powiedzie się; FAŁSZ, jeśli konwersja nie powiedzie się lub jeśli COleDateTime obiekt ma wartość NULL lub jest nieprawidłowy.

Uwagi

Struktura UDATE reprezentuje datę "rozpakowaną".

COleDateTime::GetCurrentTime

Wywołaj tę statyczną funkcję składową, aby zwrócić bieżącą wartość daty/godziny.

static COleDateTime WINAPI GetCurrentTime() throw();

Przykład

// example for COleDateTime::GetCurrentTime
COleDateTime dateTest;
   // dateTest value = midnight 30 December 1899

dateTest = COleDateTime::GetCurrentTime();
   // dateTest value = current date and time

// a second example for COleDateTime::GetCurrentTime
// Since GetCurrentTime() is a static member, you can use it in
// a constructor:

COleDateTime t1 = COleDateTime::GetCurrentTime();
COleDateTime t2(COleDateTime::GetCurrentTime());

// Or in a normal assignment operator

COleDateTime t3;
t3 = COleDateTime::GetCurrentTime();

// or even in an expression

 if (COleDateTime::GetCurrentTime().GetDayOfWeek() == 6)
    _tprintf(_T("Thank Goodness it is Friday!\n\n"));

COleDateTime::GetDay

Pobiera dzień miesiąca reprezentowanego przez tę wartość daty/godziny.

int GetDay() const throw();

Wartość zwracana

Dzień miesiąca reprezentowany przez wartość tego COleDateTime obiektu lub COleDateTime::error jeśli nie można uzyskać dnia.

Uwagi

Prawidłowy zakres wartości zwracanych z zakresu od 1 do 31.

Aby uzyskać informacje o innych funkcjach składowych, które wysyłają zapytania o wartość tego COleDateTime obiektu, zobacz następujące funkcje składowe:

GetMonth
GetYear
GetHour
GetMinute
GetSecond
GetDayOfWeek
GetDayOfYear

Przykład

COleDateTime t(1999, 3, 19, 22, 15, 0);  // 10:15PM March 19, 1999
ASSERT(t.GetDay() == 19);
ASSERT(t.GetMonth() == 3);
ASSERT(t.GetYear() == 1999);

COleDateTime::GetDayOfWeek

Pobiera dzień tygodnia reprezentowany przez tę wartość daty/godziny.

int GetDayOfWeek() const throw();

Wartość zwracana

Dzień tygodnia reprezentowany przez wartość tego COleDateTime obiektu lub COleDateTime::error jeśli nie można uzyskać dnia tygodnia.

Uwagi

Prawidłowy zakres wartości zwracanych z zakresu od 1 do 7, gdzie 1 =niedziela, 2 =poniedziałek itd.

Aby uzyskać informacje o innych funkcjach składowych, które wysyłają zapytania o wartość tego COleDateTime obiektu, zobacz następujące funkcje składowe:

GetDay
GetMonth
GetYear
GetHour
GetMinute
GetSecond
GetDayOfYear

Przykład

COleDateTime t(1999, 3, 19, 22, 15, 0); // 10:15PM March 19, 1999
ASSERT(t.GetDayOfWeek() == 6);          // it's a Friday

COleDateTime::GetDayOfYear

Pobiera dzień roku reprezentowany przez tę wartość daty/godziny.

int GetDayOfYear() const throw();

Wartość zwracana

Dzień roku reprezentowany przez wartość tego COleDateTime obiektu lub COleDateTime::error dzień roku nie można uzyskać.

Uwagi

Prawidłowy zakres wartości zwracanych z zakresu od 1 do 366, gdzie 1 stycznia = 1.

Aby uzyskać informacje o innych funkcjach składowych, które wysyłają zapytania o wartość tego COleDateTime obiektu, zobacz następujące funkcje składowe:

GetDay
GetMonth
GetYear
GetHour
GetMinute
GetSecond
GetDayOfWeek

Przykład

COleDateTime t(1999, 3, 19, 22, 15, 0); // 10:15PM March 19, 1999
ASSERT(t.GetDayOfYear() == 78);         // 78th day of that year

COleDateTime::GetHour

Pobiera godzinę reprezentowaną przez tę wartość daty/godziny.

int GetHour() const throw();

Wartość zwracana

Godzina reprezentowana przez wartość tego COleDateTime obiektu lub COleDateTime::error jeśli nie można uzyskać godziny.

Uwagi

Prawidłowy zakres wartości zwracanych z zakresu od 0 do 23.

Aby uzyskać informacje o innych funkcjach składowych, które wysyłają zapytania o wartość tego COleDateTime obiektu, zobacz następujące funkcje składowe:

GetDay
GetMonth
GetYear
GetMinute
GetSecond
GetDayOfWeek
GetDayOfYear

Przykład

COleDateTime t(1999, 3, 19, 22, 15, 0);  // 10:15PM March 19, 1999
ASSERT(t.GetSecond() == 0);
ASSERT(t.GetMinute() == 15);
ASSERT(t.GetHour() == 22);

COleDateTime::GetMinute

Pobiera minutę reprezentowaną przez tę wartość daty/godziny.

int GetMinute() const throw();

Wartość zwracana

Minuta reprezentowana przez wartość tego COleDateTime obiektu lub COleDateTime::error jeśli minuta nie może zostać uzyskana.

Uwagi

Prawidłowy zakres wartości zwracanych z zakresu od 0 do 59.

Aby uzyskać informacje o innych funkcjach składowych, które wysyłają zapytania o wartość tego COleDateTime obiektu, zobacz następujące funkcje składowe:

GetDay
GetMonth
GetYear
GetHour
GetSecond
GetDayOfWeek
GetDayOfYear

Przykład

Zobacz przykład getHour.

COleDateTime::GetMonth

Pobiera miesiąc reprezentowany przez tę wartość daty/godziny.

int GetMonth() const throw();

Wartość zwracana

Miesiąc reprezentowany przez wartość tego COleDateTime obiektu lub COleDateTime::error jeśli nie można uzyskać miesiąca.

Uwagi

Prawidłowy zakres wartości zwracanych z zakresu od 1 do 12.

Aby uzyskać informacje o innych funkcjach składowych, które wysyłają zapytania o wartość tego COleDateTime obiektu, zobacz następujące funkcje składowe:

GetDay
GetYear
GetHour
GetMinute
GetSecond
GetDayOfWeek
GetDayOfYear

Przykład

Zobacz przykład dla polecenia GetDay.

COleDateTime::GetSecond

Pobiera sekundę reprezentowaną przez tę wartość daty/godziny.

int GetSecond() const throw();

Wartość zwracana

Drugi reprezentowany przez wartość tego COleDateTime obiektu lub COleDateTime::error jeśli nie można uzyskać drugiego obiektu.

Uwagi

Prawidłowy zakres wartości zwracanych z zakresu od 0 do 59.

Uwaga

Klasa COleDateTime nie obsługuje sekund przestępnych.

Aby uzyskać więcej informacji na temat implementacji programu COleDateTime, zobacz artykuł Data i godzina: obsługa automatyzacji.

Aby uzyskać informacje o innych funkcjach składowych, które wysyłają zapytania o wartość tego COleDateTime obiektu, zobacz następujące funkcje składowe:

GetDay
GetMonth
GetYear
GetHour
GetMinute
GetDayOfWeek
GetDayOfYear

Przykład

Zobacz przykład getHour.

COleDateTime::GetStatus

Pobiera stan (ważność) danego COleDateTime obiektu.

DateTimeStatus GetStatus() const throw();

Wartość zwracana

Zwraca stan tej COleDateTime wartości. Jeśli wywołasz GetStatus COleDateTime obiekt skonstruowany z wartością domyślną, zostanie zwrócony prawidłowy. Jeśli wywołasz GetStatus wywołanie obiektu COleDateTime zainicjowanego za pomocą konstruktora ustawionego na wartość null, GetStatus zwróci wartość null.

Uwagi

Wartość zwracana jest definiowana DateTimeStatus przez wyliczony typ, który jest zdefiniowany w COleDateTime klasie.

enum DateTimeStatus
{
   error = -1,
   valid = 0,
   invalid = 1,    // Invalid date (out of range, etc.)
   null = 2,       // Literally has no value
};

Aby zapoznać się z krótkim opisem tych wartości stanu, zobacz następującą listę:

COleDateTime::error Wskazuje, że wystąpił błąd podczas próby uzyskania części wartości daty/godziny.
COleDateTime::valid Wskazuje, że ten COleDateTime obiekt jest prawidłowy.
COleDateTime::invalid Wskazuje, że ten COleDateTime obiekt jest nieprawidłowy. Oznacza to, że jego wartość może być niepoprawna.
COleDateTime::null Wskazuje, że ten COleDateTime 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 COleDateTime obiektu jest nieprawidłowy w następujących przypadkach:

Jeśli jego wartość jest ustawiona z VARIANT wartości lub COleVariant , która nie może zostać przekonwertowana na wartość daty/godziny.
Jeśli jego wartość jest ustawiona na podstawie time_twartości , SYSTEMTIMElub FILETIME , która nie może zostać przekonwertowana na prawidłową wartość daty/godziny.
Jeśli jego wartość jest ustawiana za pomocą SetDateTime nieprawidłowych wartości parametrów.
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 następujące funkcje składowe:

COleDateTime
SetDateTime
operator +, -
operator +=, -=

Aby uzyskać więcej informacji na temat granic COleDateTime wartości, zobacz artykuł Data i godzina: obsługa automatyzacji.

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);

COleDateTime::GetYear

Pobiera rok reprezentowany przez tę wartość daty/godziny.

int GetYear() const throw();

Wartość zwracana

Rok reprezentowany przez wartość tego COleDateTime obiektu lub COleDateTime::error jeśli nie można uzyskać roku.

Uwagi

Prawidłowy zakres wartości zwracanych z zakresu od 100 do 9999, który obejmuje stulecie.

Aby uzyskać informacje o innych funkcjach składowych, które wysyłają zapytania o wartość tego COleDateTime obiektu, zobacz następujące funkcje składowe:

GetDay
GetMonth
GetHour
GetMinute
GetSecond
GetDayOfWeek
GetDayOfYear

Aby uzyskać więcej informacji na temat granic COleDateTime wartości, zobacz artykuł Data i godzina: obsługa automatyzacji.

Przykład

Zobacz przykład dla polecenia GetDay.

COleDateTime::m_dt

DATE Podstawowa struktura dla tego COleDateTime obiektu.

DATE m_dt;

Uwagi

Uwaga

Zmiana wartości w DATE obiekcie, do których uzyskuje dostęp wskaźnik zwrócony przez tę funkcję, spowoduje zmianę wartości tego COleDateTime obiektu. Nie zmienia on stanu tego COleDateTime obiektu.

Aby uzyskać więcej informacji na temat implementacji DATE obiektu, zobacz artykuł Data i godzina: obsługa automatyzacji.

COleDateTime::m_status

Zawiera stan tego COleDateTime obiektu.

DateTimeStatus m_status;

Uwagi

Typ tego elementu członkowskiego danych jest wyliczonym typem DateTimeStatus, który jest zdefiniowany w COleDateTime klasie . Aby uzyskać więcej informacji, zobacz COleDateTime::GetStatus.

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.

COleDateTime::operator =

Kopiuje COleDateTime wartość.

COleDateTime& operator=(const VARIANT& varSrc) throw();
COleDateTime& operator=(DATE dtSrc) throw();
COleDateTime& operator=(const time_t& timeSrc) throw();
COleDateTime& operator=(const __time64_t& timeSrc) throw();
COleDateTime& operator=(const SYSTEMTIME& systimeSrc) throw();
COleDateTime& operator=(const FILETIME& filetimeSrc) throw();
COleDateTime& operator=(const UDATE& uDate) throw();

Uwagi

Te przeciążone operatory przypisania kopiują wartość daty/godziny źródłowej do tego COleDateTime obiektu. Krótki opis każdego z tych przeciążonych operatorów przypisania jest następujący:

operator =( dateSrc ) Wartość i stan operandu są kopiowane do tego COleDateTime obiektu.
operator =( varSrc ) Jeśli konwersja wartości VARIANT (lub obiektu COleVariant ) na datę/godzinę (VT_DATE) zakończy się pomyślnie, przekonwertowana wartość zostanie skopiowana do tego COleDateTime obiektu, a jego stan jest ustawiony na prawidłowy. Jeśli konwersja nie powiedzie się, wartość tego obiektu jest ustawiona na zero (30 grudnia 1899, północ) i jego stan na nieprawidłowy.
operator =( dtSrc ) Wartość DATE jest kopiowana do tego COleDateTime obiektu, a jego stan jest ustawiony na prawidłowy.
operator =( timeSrc ) Wartość time_t or __time64_t jest konwertowana i kopiowana do tego COleDateTime obiektu. Jeśli konwersja zakończy się pomyślnie, stan tego obiektu jest ustawiony na prawidłowy; jeśli nie powiedzie się, jest ona ustawiona na nieprawidłową.
operator =( systimeSrc ) Wartość SYSTEMTIME jest konwertowana i kopiowana do tego COleDateTime obiektu. Jeśli konwersja zakończy się pomyślnie, stan tego obiektu jest ustawiony na prawidłowy; jeśli nie powiedzie się, jest ona ustawiona na nieprawidłową.
operator =( uDate ) Wartość UDATE jest konwertowana i kopiowana do tego COleDateTime obiektu. Jeśli konwersja zakończy się pomyślnie, stan tego obiektu jest ustawiony na prawidłowy; jeśli nie powiedzie się, jest ona ustawiona na nieprawidłową. Struktura UDATE reprezentuje datę "rozpakowaną". Aby uzyskać więcej informacji, zobacz funkcję VarDateFromUdate.
operator =( filetimeSrc ) Wartość FILETIME jest konwertowana i kopiowana do tego COleDateTime obiektu. Jeśli konwersja zakończy się pomyślnie, stan tego obiektu jest ustawiony na prawidłowy; w przeciwnym razie jest ustawiona na nieprawidłową. FILETIME używa uniwersalnego czasu koordynowanego (UTC), więc jeśli przejdziesz czas UTC w strukturze, wyniki zostaną przekonwertowane z czasu UTC na czas lokalny i będą przechowywane jako czas wariantu. To zachowanie jest takie samo jak w programach Visual C++ 6.0 i Visual C++.NET 2003 SP2. Aby uzyskać więcej informacji, zobacz Czasy plików w zestawie Windows SDK.

Aby uzyskać więcej informacji, zobacz wpis VARIANT w zestawie Windows SDK.

Aby uzyskać więcej informacji na time_t temat typu danych, zobacz funkcję time w dokumentacji biblioteki czasu wykonywania.

Aby uzyskać więcej informacji, zobacz struktury SYSTEMTIME i FILETIME w zestawie Windows SDK.

Aby uzyskać więcej informacji na temat granic COleDateTime wartości, zobacz artykuł Data i godzina: obsługa automatyzacji.

COleDateTime::operator +, -

Dodawanie i odejmowanie ColeDateTime wartości.

COleDateTime operator+(COleDateTimeSpan dateSpan) const throw();
COleDateTime operator-(COleDateTimeSpan dateSpan) const throw();
COleDateTimeSpan operator-(const COleDateTime& date) const throw();

Uwagi

COleDateTime obiekty reprezentują bezwzględne czasy. Obiekty COleDateTimeSpan reprezentują czasy względne. Pierwsze dwa operatory umożliwiają dodawanie i odejmowanie COleDateTimeSpan COleDateTime wartości z wartości. Trzeci operator umożliwia odejmowanie jednej COleDateTime wartości od innej w celu uzyskania COleDateTimeSpan wartości.

Jeśli jeden z operandów ma wartość null, stan wynikowej COleDateTime wartości ma wartość null.

Jeśli wynikowa COleDateTime wartość wykracza poza granice dopuszczalnych wartości, stan tej COleDateTime wartości jest nieprawidłowy.

Jeśli jeden z operandów jest nieprawidłowy, a drugi nie ma wartości null, stan wynikowej COleDateTime wartości jest nieprawidłowy.

Operatory + i - będą potwierdzać, czy COleDateTime obiekt jest ustawiony na wartość null. Zobacz przykład COleDateTime Relational Operators (Operatory relacyjne COleDateTime).

Aby uzyskać więcej informacji na temat prawidłowych, nieprawidłowych i null wartości stanu, zobacz zmienną składową m_status .

Aby uzyskać więcej informacji na temat granic COleDateTime wartości, zobacz artykuł Data i godzina: obsługa automatyzacji.

Przykład

COleDateTime t1(1999, 3, 19, 22, 15, 0); // 10:15PM March 19, 1999
COleDateTime t2(1999, 3, 20, 22, 15, 0); // 10:15PM March 20, 1999

// Subtract 2 COleDateTimes
COleDateTimeSpan ts = t2 - t1;

// one day is 24 * 60 * 60 == 86400 seconds
ASSERT(ts.GetTotalSeconds() == 86400L);

// Add a COleDateTimeSpan to a COleDateTime.
ASSERT((t1 + ts) == t2);

// Subtract a COleDateTimeSpan from a COleDateTime.
ASSERT((t2 - ts) == t1);

COleDateTime::operator +=, -=

Dodaj i odejmij ColeDateTime wartość z tego COleDateTime obiektu.

COleDateTime& operator+=(COleDateTimeSpan dateSpan) throw();
COleDateTime& operator-=(COleDateTimeSpan dateSpan) throw();

Uwagi

Te operatory umożliwiają dodawanie i odejmowanie COleDateTimeSpan wartości do i z tego elementu COleDateTime. Jeśli jeden z operandów ma wartość null, stan wynikowej COleDateTime wartości ma wartość null.

Jeśli wynikowa COleDateTime wartość wykracza poza granice dopuszczalnych wartości, stan tej COleDateTime wartości jest ustawiony na nieprawidłowy.

Jeśli jeden z operandów jest nieprawidłowy, a inny nie ma wartości null, stan wynikowej COleDateTime 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 .

Operatory += i -= będą potwierdzać, czy COleDateTime obiekt jest ustawiony na wartość null. Zobacz przykład COleDateTime Relational Operators (Operatory relacyjne COleDateTime).

Aby uzyskać więcej informacji na temat granic COleDateTime wartości, zobacz artykuł Data i godzina: obsługa automatyzacji.

COleDateTime::operator DATE

Konwertuje ColeDateTime wartość na wartość DATE.

operator DATE() const throw();

Uwagi

Ten operator zwraca DATE obiekt, którego wartość jest kopiowana z tego COleDateTime obiektu. Aby uzyskać więcej informacji na temat implementacji DATE obiektu, zobacz artykuł Data i godzina: obsługa automatyzacji.

Operator DATE potwierdzi, czy COleDateTime obiekt jest ustawiony na wartość null. Zobacz przykład COleDateTime Relational Operators (Operatory relacyjne COleDateTime).

COleDateTime::P arseDateTime

Analizuje ciąg w celu odczytania wartości daty/godziny.

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

Parametry

lpszDate
Wskaźnik do ciągu zakończonego wartością null, który ma zostać przeanalizowany. Aby uzyskać szczegółowe informacje, zobacz Uwagi.

dwFlags
Wskazuje flagi ustawień regionalnych i analizowania. Co najmniej jedna z następujących flag:

LOCALE_NOUSEROVERRIDE Użyj domyślnych ustawień regionalnych systemu, a nie niestandardowych ustawień użytkownika.
VAR_TIMEVALUEONLY Ignoruj część daty podczas analizowania.
VAR_DATEVALUEONLY Ignoruj część czasu podczas analizowania.

lcid
Wskazuje identyfikator ustawień regionalnych do użycia na potrzeby konwersji.

Wartość zwracana

Zwraca wartość TRUE, jeśli ciąg został pomyślnie przekonwertowany na wartość daty/godziny, w przeciwnym razie wartość FALSE.

Uwagi

Jeśli ciąg został pomyślnie przekonwertowany na wartość daty/godziny, wartość tego COleDateTime obiektu jest ustawiona na tę wartość i jej stan na prawidłowy.

Uwaga

Wartości roku muszą należeć do przedziału od 100 do 9999 włącznie.

Parametr lpszDate może przyjmować różne formaty. Na przykład następujące ciągi zawierają dopuszczalne formaty daty/godziny:

"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

Identyfikator ustawień regionalnych będzie również mieć wpływ na to, czy format ciągu jest akceptowalny do konwersji na wartość daty/godziny.

W przypadku VAR_DATEVALUEONLY wartość godziny jest ustawiona na godzinę 0 lub północ. W przypadku VAR_TIMEVALUEONLY wartość daty jest ustawiona na datę 0, co oznacza 30 grudnia 1899 r.

Jeśli nie można przekonwertować ciągu na wartość daty/godziny lub jeśli wystąpił przepełnienie liczbowe, stan tego COleDateTime obiektu jest nieprawidłowy.

Aby uzyskać więcej informacji na temat granic i implementacji COleDateTime wartości, zobacz artykuł Data i godzina: obsługa automatyzacji.

COleDateTime::SetDate

Ustawia datę tego COleDateTime obiektu.

int SetDate(
    int nYear,
    int nMonth,
    int nDay) throw();

Parametry

nYear
Wskazuje rok do skopiowania do tego COleDateTime obiektu.

nMonth
Wskazuje miesiąc do skopiowania do tego COleDateTime obiektu.

nDay
Wskazuje dzień kopiowania do tego COleDateTime obiektu.

Wartość zwracana

Zero, jeśli wartość tego COleDateTime obiektu została ustawiona pomyślnie; w przeciwnym razie 1. Ta wartość zwracana jest oparta na wyliczonym typie DateTimeStatus . Aby uzyskać więcej informacji, zobacz funkcję składową SetStatus .

Uwagi

Data jest ustawiona na określone wartości. Godzina jest ustawiona na godzinę 0, północ.

Poniższa tabela zawiera ograniczenia dla wartości parametrów:

Parametr	Granice
nYear	100 - 9999
nMonth	1 - 12
nDay	0 - 31

Jeśli dzień miesiąca przepełnia się, jest konwertowany na prawidłowy dzień następnego miesiąca, a miesiąc i/lub rok są odpowiednio zwiększane. Wartość dnia zero wskazuje ostatni dzień poprzedniego miesiąca. Zachowanie jest takie samo jak SystemTimeToVariantTime.

Jeśli wartość daty określona przez parametry jest nieprawidłowa, stan tego obiektu jest ustawiony na COleDateTime::invalidwartość . Użyj polecenia GetStatus , aby sprawdzić ważność DATE wartości i nie należy zakładać, że wartość m_dt pozostanie niezmodyfikowana.

Oto kilka przykładów wartości daty:

nYear	nMonth	nDay	Wartość
2000	2	29	29 lutego 2000 r.
1776	7	100	4 lipca 1776 r.
1925	100	35	35 kwietnia 1925 r. (nieprawidłowa data)
10 000	1	1	1 stycznia 10000 (nieprawidłowa data)

Aby ustawić zarówno datę, jak i godzinę, zobacz COleDateTime::SetDateTime.

Aby uzyskać informacje o funkcjach składowych, które wysyłają zapytania o wartość tego COleDateTime obiektu, zobacz następujące funkcje składowe:

GetDay
GetMonth
GetYear
GetHour
GetMinute
GetSecond
GetDayOfWeek
GetDayOfYear

Aby uzyskać więcej informacji na temat granic COleDateTime wartości, zobacz artykuł Data i godzina: obsługa automatyzacji.

Przykład

// set only the date, time set to midnight
dt.SetDate(1999, 3, 19);
ASSERT(dt.GetYear() == 1999);
ASSERT(dt.GetDay() == 19);
ASSERT(dt.GetMonth() == 3);
ASSERT(dt.GetHour() == 0);
ASSERT(dt.GetMinute() == 0);
ASSERT(dt.GetSecond() == 0);

// setting the time only resets the date to 1899!
dt.SetTime(22, 15, 0);
ASSERT(dt.GetYear() == 1899);
ASSERT(dt.GetDay() == 30);
ASSERT(dt.GetMonth() == 12);
ASSERT(dt.GetHour() == 22);
ASSERT(dt.GetMinute() == 15);
ASSERT(dt.GetSecond() == 0);

COleDateTime::SetDateTime

Ustawia datę i godzinę tego COleDateTime obiektu.

int SetDateTime(
    int nYear,
    int nMonth,
    int nDay,
    int nHour,
    int nMin,
    int nSec) throw();

Parametry

nYear, nMonth, nDay, nHour, nMin, nSec
Wskaż składniki daty i godziny, które mają zostać skopiowane do tego COleDateTime obiektu.

Wartość zwracana

Uwagi

Poniższa tabela zawiera ograniczenia dla wartości parametrów:

Parametr	Granice
nYear	100 - 9999
nMonth	1 - 12
nDay	0 - 31
nHour	0 - 23
nMin	0 - 59
Nsec	0 - 59

Jeśli wartość daty lub godziny określona przez parametry jest nieprawidłowa, stan tego obiektu jest ustawiony na nieprawidłowy i wartość tego obiektu nie zostanie zmieniona.

Oto kilka przykładów wartości czasu:

nHour	nMin	Nsec	Wartość
1	3	3	01:03:03
23	45	0	23:45:00
25	30	0	Nieprawidłowy
9	60	0	Nieprawidłowy

Oto kilka przykładów wartości daty:

nYear	nMonth	nDay	Wartość
1995	100	15	15 kwietnia 1995 r.
1789	7	14	17 lipca 1789 r.
1925	2	30	Nieprawidłowy
10 000	1	1	Nieprawidłowy

Aby ustawić tylko datę, zobacz COleDateTime::SetDate. Aby ustawić tylko czas, zobacz COleDateTime::SetTime.

Aby uzyskać informacje o funkcjach składowych, które wysyłają zapytania o wartość tego COleDateTime obiektu, zobacz następujące funkcje składowe:

GetDay
GetMonth
GetYear
GetHour
GetMinute
GetSecond
GetDayOfWeek
GetDayOfYear

Aby uzyskać więcej informacji na temat granic COleDateTime wartości, zobacz artykuł Data i godzina: obsługa automatyzacji.

Przykład

Zobacz przykład getStatus.

COleDateTime::SetStatus

Ustawia stan tego COleDateTime obiektu.

void SetStatus(DateTimeStatus status) throw();

Parametry

status
Nowa wartość stanu dla tego COleDateTime obiektu.

Uwagi

Wartość parametru stanu jest definiowana DateTimeStatus przez wyliczony typ, który jest zdefiniowany w COleDateTime klasie. Aby uzyskać szczegółowe informacje, zobacz COleDateTime::GetStatus .

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. Operator przypisania (operator =) i SetDateTime ustawiają stan obiektu na podstawie wartości źródłowych.

Przykład

Zobacz przykład getStatus.

COleDateTime::SetTime

Ustawia czas tego COleDateTime obiektu.

int SetTime(
    int nHour,
    int nMin,
    int nSec) throw();

Parametry

nHour, nMin, nSec
Wskaż składniki czasu, które mają zostać skopiowane do tego COleDateTime obiektu.

Wartość zwracana

Uwagi

Czas jest ustawiony na określone wartości. Data jest ustawiona na 0, co oznacza 30 grudnia 1899 r.

Poniższa tabela zawiera ograniczenia dla wartości parametrów:

Parametr	Granice
nHour	0 - 23
nMin	0 - 59
Nsec	0 - 59

Jeśli wartość czasu określona przez parametry jest nieprawidłowa, stan tego obiektu jest ustawiony na nieprawidłowy i wartość tego obiektu nie zostanie zmieniona.

Oto kilka przykładów wartości czasu:

nHour	nMin	Nsec	Wartość
1	3	3	01:03:03
23	45	0	23:45:00
25	30	0	Nieprawidłowy
9	60	0	Nieprawidłowy

Aby ustawić zarówno datę, jak i godzinę, zobacz COleDateTime::SetDateTime.

Aby uzyskać informacje o funkcjach składowych, które wysyłają zapytania o wartość tego COleDateTime obiektu, zobacz następujące funkcje składowe:

GetDay
GetMonth
GetYear
GetHour
GetMinute
GetSecond
GetDayOfWeek
GetDayOfYear

Aby uzyskać więcej informacji na temat granic COleDateTime wartości, zobacz artykuł Data i godzina: obsługa automatyzacji.

Przykład

Zobacz przykład dla parametru SetDate.

Zobacz też

Klasa COleVariant
CTime, klasa
CTimeSpan, klasa
Wykres hierarchii
Klasy udostępnione ATL/MFC

Udostępnij za pośrednictwem

COleDateTime, klasa

Składnia

Elementy członkowskie

Konstruktory publiczne

Metody publiczne

Operatory publiczne

Publiczne elementy członkowskie danych

Uwagi

Wymagania

Operatory relacyjne COleDateTime

Parametry

Uwagi

Przykłady

COleDateTime::COleDateTime

Parametry

Uwagi

Przykład

COleDateTime::Format

Parametry

Wartość zwracana

Uwagi

Przykład

COleDateTime::GetAsDBTIMESTAMP

Parametry

Wartość zwracana

Uwagi

Przykład

COleDateTime::GetAsSystemTime

Parametry

Wartość zwracana

Uwagi

COleDateTime::GetAsUDATE

Parametry

Wartość zwracana

Uwagi

COleDateTime::GetCurrentTime

Przykład

COleDateTime::GetDay

Wartość zwracana

Uwagi

Przykład

COleDateTime::GetDayOfWeek

Wartość zwracana

Uwagi

Przykład

COleDateTime::GetDayOfYear

Wartość zwracana

Uwagi

Przykład

COleDateTime::GetHour

Wartość zwracana

Uwagi

Przykład

COleDateTime::GetMinute

Wartość zwracana

Uwagi

Przykład

COleDateTime::GetMonth

Wartość zwracana

Uwagi

Przykład

COleDateTime::GetSecond

Wartość zwracana

Uwagi

Przykład

COleDateTime::GetStatus

Wartość zwracana

Uwagi

Przykład

COleDateTime::GetYear

Wartość zwracana

Uwagi

Przykład

COleDateTime::m_dt

Uwagi

COleDateTime::m_status

Uwagi

COleDateTime::operator =

Uwagi