Klasa COleDateTime

Artykuł
02/27/2013

Hermetyzuje DATE typ danych, który jest używany w automatyzacji OLE.

class COleDateTime

Członkowie

Publiczne konstruktory

Nazwa	Opis
COleDateTime::COleDateTime	Konstrukcje COleDateTime obiektu.

Metody publiczne

Nazwa	Opis
COleDateTime::Format	Generuje reprezentację sformatowany ciąg COleDateTime obiektu.
COleDateTime::GetAsDBTIMESTAMP	Wywołanie tej metody, aby uzyskać czas w COleDateTime obiektu jako odcisk CZASOWY struktury danych.
COleDateTime::GetAsSystemTime	Wywołanie tej metody, aby uzyskać czas w COleDateTime obiektu jako SYSTEMTIME struktury danych.
COleDateTime::GetAsUDATE	Wywołanie tej metody, aby uzyskać czas w COleDateTime jako UDATE struktury danych.
COleDateTime::GetCurrentTime	Tworzy COleDateTime obiekt, który reprezentuje bieżący czas (funkcja członka statycznego).
COleDateTime::GetDay	Zwraca dzień, to COleDateTime reprezentuje obiekt (1-31).
COleDateTime::GetDayOfWeek	Zwraca dzień tygodnia, to COleDateTime obiekt reprezentuje (niedziela = 1).
COleDateTime::GetDayOfYear	Zwraca dzień roku, to COleDateTime obiekt reprezentuje (Jan 1 = 1).
COleDateTime::GetHour	Zwraca godzinę, to COleDateTime obiekt reprezentuje (0-23).
COleDateTime::GetMinute	Zwraca minutę, to COleDateTime obiekt reprezentuje (0-59).
COleDateTime::GetMonth	Zwraca miesiąc, to COleDateTime (1-12) reprezentuje obiekt.
COleDateTime::GetSecond	Zwraca sekundę, to COleDateTime obiekt reprezentuje (0-59).
COleDateTime::GetStatus	Pobiera stan (ważność) to COleDateTime obiektu.
COleDateTime::GetYear	Zwraca rok, to COleDateTime obiekt reprezentuje.
COleDateTime::ParseDateTime	Odczytuje wartości daty i godziny z ciągiem i ustawia wartość COleDateTime.
COleDateTime::SetDate	Ustawia wartość tego COleDateTime obiektu do określonej wartości tylko data.
COleDateTime::SetDateTime	Ustawia wartość tego COleDateTime obiektu do wartości określonej daty i czasu.
COleDateTime::SetStatus	Ustawia stan (ważność) to COleDateTime obiektu.
COleDateTime::SetTime	Ustawia wartość tego COleDateTime obiektu do określonej wartości tylko do czasu.

Operatory publiczne

Nazwa	Opis
COleDateTime::operator == COleDateTime::operator < itd.	Porównanie dwóch COleDateTime wartości.
COleDateTime::operator + COleDateTime::operator-	Dodawanie i odejmowanie COleDateTime wartości.
+= COleDateTime::operator, COleDateTime::operator-=	Dodawanie i odejmowanie COleDateTime wartość z tego COleDateTime obiektu.
COleDateTime::operator =	Kopie COleDateTime wartość.
COleDateTime::operator Data, Data COleDateTime::operator *	Converts a COleDateTime value into a DATE or a DATE*.

Publiczne danych członków

Nazwa	Opis
COleDateTime::m_dt	Zawiera podstawową Data to COleDateTime obiektu.
COleDateTime::m_status	Zawiera informacje o stanie tego COleDateTime obiektu.

Uwagi

COleDateTimenie ma klasy podstawowej.

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

DATE Typu jest zaimplementowany jako wartości zmiennoprzecinkowe.Dni są mierzone od 30 grudnia 1899 roku o północy.W poniższej tabeli przedstawiono niektóre terminy i związanych z nimi wartości:

Data	Wartość
29 Grudnia 1899 roku o północy.	-1.0
29 Grudnia 1899, przedpołudnie 6	-1.25
30 Grudnia 1899 roku o północy.	0.0
O północy 31 grudnia 1899 roku,	1.0
1 Stycznia 1900, 6 A.M.	2.25

Przestroga
Uwaga w powyższej tabeli, że chociaż ujemnych wartości dni przed północą 30 grudnia 1899 roku, wartości w czasie dnia nie.Na przykład 6: 00 AM zawsze jest reprezentowana przez wartość ułamkową 0,25 niezależnie od tego czy całkowitą reprezentującą dzień pozytywne (po 30 grudnia 1899) lub ujemny (przed 30 grudnia 1899 roku).Oznacza to, błędnie układać proste porównanie ruchomy punkt COleDateTime reprezentujące 6: 00 w dniu 12/29/1899 jako później niż jeden reprezentujących: 7: 00 AM tego samego dnia.

Uwaga w powyższej tabeli, że chociaż ujemnych wartości dni przed północą 30 grudnia 1899 roku, wartości w czasie dnia nie.Na przykład 6: 00 AM zawsze jest reprezentowana przez wartość ułamkową 0,25 niezależnie od tego czy całkowitą reprezentującą dzień pozytywne (po 30 grudnia 1899) lub ujemny (przed 30 grudnia 1899 roku).Oznacza to, błędnie układać proste porównanie ruchomy punkt COleDateTime reprezentujące 6: 00 w dniu 12/29/1899 jako później niż jeden reprezentujących: 7: 00 AM tego samego dnia.

COleDateTime Klasy obsługuje dat od 1 stycznia 100 do 31 grudnia 9999.COleDateTime Klasy korzysta z kalendarza gregoriańskiego; nie obsługuje dat w formacie juliańskim.COleDateTimeignoruje zmiany czasu.(Zobacz datę i godzinę: automatyzacja obsługi.)

[!UWAGA]

Można użyć %y format, aby pobrać dwucyfrowy rok tylko dla dat od 1900.Jeśli korzystasz z %y format daty przed rokiem 1900 kod generuje błąd potwierdzenia.

Tego typu jest również używany do reprezentowania wartości tylko datę lub tylko do czasu.Umownie Data 0 (30 grudnia 1899) jest używana w czasie tylko wartości i godzina 00: 00 (północ) jest używany dla wartości tylko data.

Jeśli tworzysz COleDateTime obiektu przy użyciu daty mniej niż 100, data jest akceptowane, ale kolejne wywołania GetYear, GetMonth, GetDay, GetHour, GetMinute, i GetSecond się nie powieść i zwrócić wartość -1.Wcześniej można użyć daty dwóch cyfr, ale daty muszą być 100 lub większej w MFC 4.2 i później.

Aby uniknąć problemów, należy określić datę czterech cyfr.Na przykład:

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

Podstawowe operacje arytmetyczne na COleDateTime wartości należy użyć klasy companion COleDateTimeSpan.COleDateTimeSpanwartości definiującego interwał czasu.Relacja między tych klas jest podobny do jednego między CTime i CTimeSpan.

Aby uzyskać więcej informacji o COleDateTime i COleDateTimeSpan klas, zobacz artykuł datę i godzinę: automatyzacja obsługi.