COleDateTime Sınıfı

Makale
10/12/2023

OLE otomasyonunda DATE kullanılan veri türünü kapsüller.

Sözdizimi

class COleDateTime

Üyeler

Ortak Oluşturucular

Ad	Tanım
COleDateTime::COleDateTime	Bir `COleDateTime` nesne oluşturur.

Genel Yöntemler

Ad	Tanım
COleDateTime::Format	Bir nesnenin biçimlendirilmiş dize gösterimini `COleDateTime` oluşturur.
COleDateTime::GetAsDBTIMESTAMP	Nesnedeki `COleDateTime` zamanı veri `DBTIMESTAMP` yapısı olarak almak için bu yöntemi çağırın.
COleDateTime::GetAsSystemTime	Nesnedeki `COleDateTime` zamanı systemtime veri yapısı olarak almak için bu yöntemi çağırın.
COleDateTime::GetAsUDATE	içindeki zamanı `COleDateTime` veri `UDATE` yapısı olarak almak için bu yöntemi çağırın.
COleDateTime::GetCurrentTime	Geçerli saati (statik üye işlevi) temsil eden bir `COleDateTime` nesne oluşturur.
COleDateTime::GetDay	Bu `COleDateTime` nesnenin temsil ettiği günü döndürür (1 - 31).
COleDateTime::GetDayOfWeek	Bu `COleDateTime` nesnenin temsil ettiği haftanın gününü döndürür (Pazar = 1).
COleDateTime::GetDayOfYear	Bu `COleDateTime` nesnenin temsil ettiği yılın gününü döndürür (1 Ocak = 1).
COleDateTime::GetHour	Bu `COleDateTime` nesnenin temsil ettiği saati döndürür (0 - 23).
COleDateTime::GetMinute	Bu `COleDateTime` nesnenin temsil ettiği dakikayı döndürür (0 - 59).
COleDateTime::GetMonth	Bu `COleDateTime` nesnenin temsil ettiği ayı döndürür (1 - 12).
COleDateTime::GetSecond	Bu `COleDateTime` nesnenin temsil ettiği saniyeyi döndürür (0 - 59).
COleDateTime::GetStatus	Bu `COleDateTime` nesnenin durumunu (geçerliliğini) alır.
COleDateTime::GetYear	Bu `COleDateTime` nesnenin temsil ettiği yılı döndürür.
COleDateTime::P arseDateTime	Dizeden bir tarih/saat değeri okur ve değerini `COleDateTime`ayarlar.
COleDateTime::SetDate	Bu `COleDateTime` nesnenin değerini belirtilen yalnızca tarih değerine ayarlar.
COleDateTime::SetDateTime	Bu `COleDateTime` nesnenin değerini belirtilen tarih/saat değerine ayarlar.
COleDateTime::SetStatus	Bu `COleDateTime` nesnenin durumunu (geçerliliğini) ayarlar.
COleDateTime::SetTime	Bu `COleDateTime` nesnenin değerini belirtilen yalnızca saat değerine ayarlar.

Ortak İşleçler

Ad	Tanım
COleDateTime::operator ==, COleDateTime::operator <, vb.	İki `COleDateTime` değeri karşılaştırın.
COleDateTime::operator +, COleDateTime::operator -	Değerleri ekleyin ve çıkarın `COleDateTime` .
COleDateTime::operator +=, COleDateTime::operator -=	Bu `COleDateTime` nesneden bir `COleDateTime` değer ekleyin ve çıkarın.
COleDateTime::operator =	Bir `COleDateTime` değeri kopyalar.
COleDateTime::operator DATE, COleDateTime::operator Date*	Bir `COleDateTime` değeri veya `DATE*`değerine `DATE` dönüştürür.

Ortak Veri Üyeleri

Ad	Tanım
COleDateTime::m_dt	Bu `COleDateTime` nesne için temel alınanı `DATE` içerir.
COleDateTime::m_status	Bu `COleDateTime` nesnenin durumunu içerir.

Açıklamalar

COleDateTime temel sınıfına sahip değildir.

OLE otomasyonunun VARIANT veri türü için olası türlerden biridir. Değer COleDateTime , mutlak bir tarih ve saat değerini temsil eder.

Tür DATE , kayan nokta değeri olarak uygulanır. Gün sayısı 30 Aralık 1899'dan gece yarısına kadar ölçülür. Aşağıdaki tabloda bazı tarihler ve bunların ilişkili değerleri gösterilmektedir:

Date	Değer
29 Aralık 1899, gece yarısı	-1,0
29 Aralık 1899, 06:00	-1.25
30 Aralık 1899, gece yarısı	0,0
31 Aralık 1899, gece yarısı	1.0
1 Ocak 1900, 06:00	2,25

Dikkat

Yukarıdaki tabloda, gün değerleri 30 Aralık 1899'da gece yarısından önce negatif olsa da, günün saati değerleri değildir. Örneğin, 06:00 her zaman günü temsil eden tamsayının pozitif (30 Aralık 1899'den sonra) veya negatif (30 Aralık 1899'den önce) olmasına bakılmaksızın 0,25 kesirli değerle gösterilir. Bu, basit bir kayan nokta karşılaştırmasının 29.12.1899 tarihinde saat 06:00'yı aynı gün saat 07:00'yi temsil eden birden daha geç olacak şekilde hatalı bir şekilde sıralanacağını COleDateTime gösterir.

COleDateTime sınıfı 1 Ocak 100 ile 31 Aralık 9999 tarihleri işler. sınıfı COleDateTime Gregoryen takvimi kullanır; Jülyen tarihlerini desteklemez. COleDateTime Yaz Saati'ne göre değil. (Bkz. Tarih ve Saat: Otomasyon Desteği.)

Dekont

biçimini kullanarak %y yalnızca 1900'den başlayan tarihler için iki basamaklı bir yıl alabilirsiniz. Biçimi 1900'e kadar olan bir tarihte kullanırsanız %y kod bir ASSERT hatası oluşturur.

Bu tür, yalnızca tarih veya yalnızca saat değerlerini temsil etmek için de kullanılır. Kurala göre, yalnızca saat değerleri için 0 (30 Aralık 1899) tarihi kullanılır ve yalnızca tarih değerleri için saat 00:00 (gece yarısı) kullanılır.

100'den küçük bir tarih kullanarak bir COleDateTime nesne oluşturursanız, tarih kabul edilir, ancak sonraki çağrılar GetYear, GetMonth, GetDay, GetHour, GetMinuteve GetSecond başarısız olur ve -1 döndürür. Daha önce iki basamaklı tarihleri kullanabilirsiniz, ancak MFC 4.2 ve sonraki sürümlerde tarihlerin 100 veya daha büyük olması gerekir.

Sorunlardan kaçınmak için dört basamaklı bir tarih belirtin. Örnek:

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

Değerler için COleDateTime temel aritmetik işlemler COleDateTimeSpan eşlikçi sınıfını kullanır. COleDateTimeSpan değerler bir zaman aralığı tanımlar. Bu sınıflar arasındaki ilişki, CTime ile CTimeSpan arasındaki ilişkiye benzer.

ve COleDateTimeSpan sınıfları hakkında COleDateTime daha fazla bilgi için Tarih ve Saat: Otomasyon Desteği makalesine bakın.

Gereksinimler

Üst bilgi: ATLComTime.h

COleDateTime İlişkisel İşleçleri

Karşılaştırma işleçleri.

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

Parametreler

Tarih
Karşılaştırılacak COleDateTime nesne.

Açıklamalar

Dekont

İki işlenenden biri geçersizse bir ATLASSERT oluşur.

Örnekler

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

=, =, <>ve <işleçleri >nesne null olarak ayarlanırsa COleDateTime onaylar.

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

COleDateTime::COleDateTime

Bir COleDateTime nesne oluşturur.

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

Parametreler

dateSrc
Yeni COleDateTime nesneye kopyalanacak mevcut COleDateTime bir nesne.

varSrc
Bir tarih/saat değerine (VT_DATE) dönüştürülecek ve yeni COleDateTime nesneye kopyalanacak mevcut VARIANT bir veri yapısı (büyük olasılıkla COleVariant bir nesne).

dtSrc
Yeni COleDateTime nesneye kopyalanacak tarih/saat (DATE) değeri.

timeSrc
Tarihtime_t/saat değerine dönüştürülecek ve yeni COleDateTime nesneye kopyalanacak bir veya __time64_t değeri.

systimeSrc
Tarih SYSTEMTIME /saat değerine dönüştürülecek ve yeni COleDateTime nesneye kopyalanacak bir yapı.

filetimeSrc
Tarih FILETIME /saat değerine dönüştürülecek ve yeni COleDateTime nesneye kopyalanacak bir yapı. A FILETIME , Evrensel Eşgüdümlü Saat (UTC) kullanır, bu nedenle yapıda yerel bir saat geçirirseniz sonuçlarınız yanlış olur. Daha fazla bilgi için bkz . Windows SDK'sında Dosya Süreleri .

nYear, nMonth, nDay, nHour, nMin, nSec
Yeni COleDateTime nesneye kopyalanacak tarih ve saat değerlerini belirtin.

wDosDate, wDosTime
BIR tarih/saat değerine dönüştürülecek ve yeni COleDateTime nesneye kopyalanacak MS-DOS tarih ve saat değerleri.

Zaman damgası
Geçerli yerel saati içeren bir DBTimeStamp yapısına başvuru.

Açıklamalar

Tüm bu oluşturucular, belirtilen değere başlatılan yeni COleDateTime nesneler oluşturur. Aşağıdaki tabloda her tarih ve saat bileşeni için geçerli aralıklar gösterilmektedir:

Tarih/saat bileşeni	Geçerli aralık
yıl	100 - 9999
aya	0 - 12
gün	0 - 31
saat	0 - 23
dakika	0 - 59
Ikinci	0 - 59

Gün bileşeni için gerçek üst sınırın ay ve yıl bileşenlerine göre değiştiğini unutmayın. Ayrıntılar için veya SetDateTime üye işlevlerine SetDate bakın.

Her oluşturucunun kısa bir açıklaması aşağıdadır:

COleDateTime() 0 (gece yarısı, 30 Aralık 1899) olarak başlatılan bir COleDateTime nesne oluşturur.
COleDateTime(dateSrc) Varolan COleDateTime bir COleDateTime nesneden nesne oluşturur.
COleDateTime(varSrc) Nesne oluşturur COleDateTime . Bir VARIANT yapıyı veya COleVariant nesnesini tarih/saat ( VT_DATE) değerine dönüştürmeye çalışır. Bu dönüştürme başarılı olursa, dönüştürülen değer yeni COleDateTime nesneye kopyalanır. Değilse, nesnenin COleDateTime değeri 0 (gece yarısı, 30 Aralık 1899) ve durumu geçersiz olarak ayarlanır.
COleDateTime(dtSrc) Bir COleDateTime değerden DATE nesne oluşturur.
COleDateTime(timeSrc) Bir COleDateTime değerden time_t nesne oluşturur.
COleDateTime(systimeSrc) Bir COleDateTime değerden SYSTEMTIME nesne oluşturur.
COleDateTime(filetimeSrc) Bir COleDateTime değerden FILETIME nesne oluşturur. . A FILETIME , Evrensel Eşgüdümlü Saat (UTC) kullanır, bu nedenle yapıda yerel bir saat geçirirseniz sonuçlarınız yanlış olur. Daha fazla bilgi için bkz . Windows SDK'sında Dosya Süreleri .
COleDateTime(nYear, nMonth, nDay, nHour, , nMin,nSec ) Belirtilen sayısal değerlerden bir COleDateTime nesne oluşturur.
COleDateTime(wDosDate, wDosTime) Belirtilen MS-DOS tarih ve saat değerlerinden bir COleDateTime nesne oluşturur.

Veri türü hakkında time_t daha fazla bilgi için Çalışma Zamanı Kitaplığı Başvurusu'ndaki time işlevine bakın.

Daha fazla bilgi için bkz. Windows SDK'sında SYSTEMTIME ve FILETIME yapıları.

Değerlerin sınırları hakkında daha fazla bilgi için COleDateTime Tarih ve Saat: Otomasyon Desteği makalesine bakın.

Dekont

parametresini kullanan DBTIMESTAMP oluşturucu yalnızca OLEDB.h eklendiğinde kullanılabilir.

Örnek

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

Tarih/saat değerinin biçimlendirilmiş bir gösterimini oluşturur.

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

Parametreler

Dwflags
Aşağıdaki yerel ayar bayraklarından birini gösterir:

LOCALE_NOUSEROVERRIDE Özel kullanıcı ayarları yerine sistem varsayılan yerel ayarı ayarlarını kullanın.
VAR_TIMEVALUEONLY Ayrıştırma sırasında tarih bölümünü yoksayın.
VAR_DATEVALUEONLY Ayrıştırma sırasında zaman bölümünü yoksayın.

lcid
Dönüştürme için kullanılacak yerel ayar kimliğini gösterir. Dil tanımlayıcıları hakkında daha fazla bilgi için bkz . Dil Tanımlayıcıları.

lpszFormat
Biçimlendirme dizesine printf benzer bir biçimlendirme dizesi. Yüzde ( %) işaretinden önce gelen her biçimlendirme kodunun yerini ilgili COleDateTime bileşen alır. Biçimlendirme dizesindeki diğer karakterler döndürülen dizeye değiştirilmeden kopyalanır. Daha fazla bilgi için bkz. çalışma zamanı işlevi strftime. biçimlendirme kodlarının Format değeri ve anlamı şunlardır:

%H Geçerli gündeki saatler
%M Geçerli saat içindeki dakika sayısı
%S Geçerli dakikadaki saniye sayısı
%% Yüzde işareti

nFormatID
Biçim denetimi dizesinin kaynak kimliği.

İade Değeri

CString Biçimlendirilmiş tarih/saat değerini içeren bir.

Açıklamalar

Bu COleDateTime nesnenin durumu null ise, dönüş değeri boş bir dizedir. Durum geçersizse, dönüş dizesi dize kaynağı ATL_IDS_DATETIME_INVALID tarafından belirtilir.

Bu işlev için üç formun kısa bir açıklaması aşağıdadır:

Format( dwFlags, lcid)
Bu form, tarih ve saat için dil belirtimlerini (yerel ayar kimlikleri) kullanarak değeri biçimlendirmektedir. Varsayılan parametreleri kullanarak, saat bölümü 0 (gece yarısı) olmadığı sürece, bu form tarih ve saati yazdırır; bu durumda yalnızca tarihi yazdırır veya tarih bölümü 0 (30 Aralık 1899) olur ve bu durumda yalnızca saati yazdırır. Tarih/saat değeri 0 (30 Aralık 1899, gece yarısı) ise, varsayılan parametreleri içeren bu form gece yarısı yazdırılır.

Format( lpszFormat)
Bu form değeri, içinde olduğu gibi yüzde işareti (%) işaretinden önce gelen özel biçimlendirme kodları içeren biçim dizesini kullanarak biçimlendiriyor printf. Biçimlendirme dizesi işleve parametre olarak geçirilir. Biçimlendirme kodları hakkında daha fazla bilgi için Çalışma Zamanı Kitaplığı Başvurusu'nda strftime, wcsftime bölümüne bakın.

Format( nFormatID)
Bu form değeri, içinde olduğu gibi yüzde işareti (%) işaretinden önce gelen özel biçimlendirme kodları içeren biçim dizesini kullanarak biçimlendiriyor printf. Biçimlendirme dizesi bir kaynaktır. Bu dize kaynağının kimliği parametre olarak geçirilir. Biçimlendirme kodları hakkında daha fazla bilgi için Çalışma Zamanı Kitaplığı Başvurusu'nda strftime, wcsftime bölümüne bakın.

Örnek

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

Nesnedeki COleDateTime zamanı veri DBTIMESTAMP yapısı olarak almak için bu yöntemi çağırın.

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

Parametreler

Zaman damgası
DBTimeStamp yapısına başvuru.

İade Değeri

Başarılı olursa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Sonuçta elde edilen süreyi başvuruda bulunan timeStamp yapısında depolar. Bu DBTIMESTAMP işlev tarafından başlatılan veri yapısının fraction üyesi sıfır olarak ayarlanır.

Örnek

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

COleDateTime::GetAsSystemTime

Nesnedeki COleDateTime zamanı veri SYSTEMTIME yapısı olarak almak için bu yöntemi çağırın.

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

Parametreler

sysTime
Nesneden dönüştürülen tarih/saat değerini almak için systemtime yapısına başvuruCOleDateTime.

İade Değeri

Başarılı olursa DOĞRU döndürür; Dönüştürme başarısız olursa veya nesne NULL veya geçersizse COleDateTime YANLIŞ.

Açıklamalar

GetAsSystemTime , sonuçta elde edilen süreyi başvuruda bulunan sysTime nesnesinde depolar. Bu SYSTEMTIME işlev tarafından başlatılan veri yapısının wMilliseconds üyesi sıfır olarak ayarlanır.

Bir COleDateTime nesnede tutulan durum bilgileri hakkında daha fazla bilgi için bkz . GetStatus.

COleDateTime::GetAsUDATE

Nesnedeki COleDateTime zamanı veri UDATE yapısı olarak almak için bu yöntemi çağırın.

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

Parametreler

Udate
Nesneden dönüştürülen tarih/saat değerini almak için bir UDATE yapı başvurusu COleDateTime .

İade Değeri

Başarılı olursa DOĞRU döndürür; Dönüştürme başarısız olursa veya nesne NULL veya geçersizse COleDateTime YANLIŞ.

Açıklamalar

Yapı UDATE , "paketlenmemiş" bir tarihi temsil eder.

COleDateTime::GetCurrentTime

Geçerli tarih/saat değerini döndürmek için bu statik üye işlevini çağırın.

static COleDateTime WINAPI GetCurrentTime() throw();

Örnek

// 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

Bu tarih/saat değeriyle gösterilen ayın gününü alır.

int GetDay() const throw();

İade Değeri

Bu COleDateTime nesnenin değeriyle temsil edilen ayın günü veya COleDateTime::error günün alınamadığı gün.

Açıklamalar

1 ile 31 arasında geçerli dönüş değerleri aralığı.

Bu COleDateTime nesnenin değerini sorgulayan diğer üye işlevleri hakkında bilgi için aşağıdaki üye işlevlerine bakın:

GetMonth
GetYear
GetHour
GetMinute
GetSecond
GetDayOfWeek
Getdayofyear

Örnek

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

Bu tarih/saat değeriyle gösterilen haftanın gününü alır.

int GetDayOfWeek() const throw();

İade Değeri

Bu COleDateTime nesnenin değeriyle temsil edilen haftanın günü veya COleDateTime::error haftanın günü alınamadı.

Açıklamalar

Geçerli dönüş değerleri 1 ile 7 arasında değişir; burada 1=Pazar, 2=Pazartesi vb.

Bu COleDateTime nesnenin değerini sorgulayan diğer üye işlevleri hakkında bilgi için aşağıdaki üye işlevlerine bakın:

GetDay
GetMonth
GetYear
GetHour
GetMinute
GetSecond
Getdayofyear

Örnek

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

COleDateTime::GetDayOfYear

Bu tarih/saat değeriyle gösterilen yılın gününü alır.

int GetDayOfYear() const throw();

İade Değeri

Bu COleDateTime nesnenin değeriyle temsil edilen yılın günü veya COleDateTime::error yılın günü alınamadıysa.

Açıklamalar

Geçerli dönüş değerleri 1 ile 366 arasında değişir; burada 1 Ocak = 1.

Bu COleDateTime nesnenin değerini sorgulayan diğer üye işlevleri hakkında bilgi için aşağıdaki üye işlevlerine bakın:

GetDay
GetMonth
GetYear
GetHour
GetMinute
GetSecond
GetDayOfWeek

Örnek

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

COleDateTime::GetHour

Bu tarih/saat değeriyle temsil edilen saati alır.

int GetHour() const throw();

İade Değeri

Bu COleDateTime nesnenin değeriyle temsil edilen saat veya COleDateTime::error saat alınamadı.

Açıklamalar

0 ile 23 arasında geçerli dönüş değerleri aralığı.

Bu COleDateTime nesnenin değerini sorgulayan diğer üye işlevleri hakkında bilgi için aşağıdaki üye işlevlerine bakın:

GetDay
GetMonth
GetYear
GetMinute
GetSecond
GetDayOfWeek
Getdayofyear

Örnek

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

Bu tarih/saat değeriyle temsil edilen dakikayı alır.

int GetMinute() const throw();

İade Değeri

Bu COleDateTime nesnenin değeriyle temsil edilen dakika veya COleDateTime::error dakika alınamadıysa.

Açıklamalar

0 ile 59 arasında geçerli dönüş değerleri aralığı.

Bu COleDateTime nesnenin değerini sorgulayan diğer üye işlevleri hakkında bilgi için aşağıdaki üye işlevlerine bakın:

GetDay
GetMonth
GetYear
GetHour
GetSecond
GetDayOfWeek
Getdayofyear

Örnek

GetHour örneğine bakın.

COleDateTime::GetMonth

Bu tarih/saat değeriyle temsil edilen ayı alır.

int GetMonth() const throw();

İade Değeri

Bu COleDateTime nesnenin değeriyle temsil edilen ay veya COleDateTime::error ay alınamadı.

Açıklamalar

Geçerli dönüş değerleri 1 ile 12 arasında değişir.

Bu COleDateTime nesnenin değerini sorgulayan diğer üye işlevleri hakkında bilgi için aşağıdaki üye işlevlerine bakın:

GetDay
GetYear
GetHour
GetMinute
GetSecond
GetDayOfWeek
Getdayofyear

Örnek

GetDay örneğine bakın.

COleDateTime::GetSecond

Bu tarih/saat değeriyle temsil edilen ikinci değeri alır.

int GetSecond() const throw();

İade Değeri

Bu COleDateTime nesnenin değeriyle temsil edilen ikinci nesne veya COleDateTime::error ikinci alınamadı.

Açıklamalar

0 ile 59 arasında geçerli dönüş değerleri aralığı.

Dekont

COleDateTime sınıfı artık saniyeleri desteklemez.

uygulaması hakkında daha fazla bilgi için COleDateTimeTarih ve Saat: Otomasyon Desteği makalesine bakın.

Bu COleDateTime nesnenin değerini sorgulayan diğer üye işlevleri hakkında bilgi için aşağıdaki üye işlevlerine bakın:

GetDay
GetMonth
GetYear
GetHour
GetMinute
GetDayOfWeek
Getdayofyear

Örnek

GetHour örneğine bakın.

COleDateTime::GetStatus

Belirli COleDateTime bir nesnenin durumunu (geçerliliğini) alır.

DateTimeStatus GetStatus() const throw();

İade Değeri

Bu COleDateTime değerin durumunu döndürür. GetStatusCOleDateTime Varsayılan değerle oluşturduğunuzda nesne geçerli olarak döndürülecektir. Oluşturucu null olarak ayarlanmış bir COleDateTime nesnede çağrısı GetStatus yaparsanız null GetStatus döndürür.

Açıklamalar

Dönüş değeri, sınıfı içinde DateTimeStatusCOleDateTime tanımlanan numaralandırılmış tür tarafından tanımlanır.

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

Bu durum değerlerinin kısa bir açıklaması için aşağıdaki listeye bakın:

COleDateTime::error Tarih/saat değerinin bir kısmını elde etmeye çalışırken bir hata oluştuğunun göstergesidir.
COleDateTime::valid Bu COleDateTime nesnenin geçerli olduğunu gösterir.
COleDateTime::invalid Bu COleDateTime nesnenin geçersiz olduğunu gösterir; yani değeri yanlış olabilir.
COleDateTime::null Bu COleDateTime nesnenin null olduğunu, yani bu nesne için hiçbir değer sağlanmamış olduğunu gösterir. (Bu, C++ NULL yerine veritabanı açısından "değer içermeyen" bir "null"tır.)

Aşağıdaki durumlarda nesnenin COleDateTime durumu geçersizdir:

Değeri, tarih/saat değerine dönüştürülemeyen bir VARIANT veya COleVariant değerinden ayarlanırsa.
Değeri, geçerli bir tarih/saat değerine dönüştürülemeyen bir time_t, SYSTEMTIMEveya FILETIME değerinden ayarlandıysa.
Değeri tarafından geçersiz parametre değerleriyle ayarlanırsa SetDateTime .
Bu nesne aritmetik atama işlemi sırasında taşma veya taşmayla karşılaşmışsa( += veya -=).
Bu nesneye geçersiz bir değer atandıysa.
Bu nesnenin durumu açıkça kullanılarak SetStatusgeçersiz olarak ayarlandıysa.

Durumu geçersiz olarak ayarlayabilen işlemler hakkında daha fazla bilgi için aşağıdaki üye işlevlerine bakın:

Coledatetime
Setdatetime
işleç +, -
işleç +=, -=

Değerlerin sınırları hakkında daha fazla bilgi için COleDateTime Tarih ve Saat: Otomasyon Desteği makalesine bakın.

Örnek

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

Bu tarih/saat değeriyle temsil edilen yılı alır.

int GetYear() const throw();

İade Değeri

Bu COleDateTime nesnenin değeriyle temsil edilen yıl veya COleDateTime::error yıl alınamadı.

Açıklamalar

Geçerli dönüş değerleri 100 ile 9999 arasında değişir ve bu da yüzyılı içerir.

Bu COleDateTime nesnenin değerini sorgulayan diğer üye işlevleri hakkında bilgi için aşağıdaki üye işlevlerine bakın:

GetDay
GetMonth
GetHour
GetMinute
GetSecond
GetDayOfWeek
Getdayofyear

Değerlerin sınırları hakkında daha fazla bilgi için COleDateTime Tarih ve Saat: Otomasyon Desteği makalesine bakın.

Örnek

GetDay örneğine bakın.

COleDateTime::m_dt

Bu COleDateTime nesnenin temel yapısıDATE.

DATE m_dt;

Açıklamalar

Dikkat

Bu işlev tarafından döndürülen işaretçi tarafından erişilen nesnedeki DATE değerin değiştirilmesi, bu COleDateTime nesnenin değerini değiştirir. Bu COleDateTime nesnenin durumunu değiştirmez.

Nesnesinin uygulanması DATE hakkında daha fazla bilgi için Tarih ve Saat: Otomasyon Desteği makalesine bakın.

COleDateTime::m_status

Bu COleDateTime nesnenin durumunu içerir.

DateTimeStatus m_status;

Açıklamalar

Bu veri üyesinin türü, sınıfı içinde COleDateTime tanımlanan numaralandırılmış türüdürDateTimeStatus. Daha fazla bilgi için bkz . COleDateTime::GetStatus.

Dikkat

Bu veri üyesi gelişmiş programlama durumlarını ifade eder. Satır içi üye işlevlerini GetStatus ve SetStatus kullanmanız gerekir. Bu veri üyesini açıkça ayarlama konusunda daha fazla uyarı için bkz SetStatus .

COleDateTime::operator =

Bir COleDateTime değeri kopyalar.

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

Açıklamalar

Bu aşırı yüklenmiş atama işleçleri kaynak tarih/saat değerini bu COleDateTime nesneye kopyalar. Bu aşırı yüklenmiş atama işleçlerinin her birinin kısa bir açıklaması şunlardır:

işleci =(dateSrc) İşlenenin değeri ve durumu bu COleDateTime nesneye kopyalanır.
operator =(varSrc) VARIANT değerinin (veya COleVariant nesnesinin) tarih/saate (VT_DATE) dönüştürülmesi başarılı olursa, dönüştürülen değer bu COleDateTime nesneye kopyalanır ve durumu geçerli olarak ayarlanır. Dönüştürme başarılı olmazsa, bu nesnenin değeri sıfıra (30 Aralık 1899, gece yarısı) ve durumu geçersiz olarak ayarlanır.
işleci =(dtSrc) Değer DATE bu COleDateTime nesneye kopyalanır ve durumu geçerli olarak ayarlanır.
=(timeSrc)time_t işleci veya __time64_t değeri dönüştürülür ve bu COleDateTime nesneye kopyalanır. Dönüştürme başarılı olursa, bu nesnenin durumu geçerli olarak ayarlanır; başarısız olursa geçersiz olarak ayarlanır.
operator =(systimeSrc)SYSTEMTIME değeri dönüştürülür ve bu COleDateTime nesneye kopyalanır. Dönüştürme başarılı olursa, bu nesnenin durumu geçerli olarak ayarlanır; başarısız olursa geçersiz olarak ayarlanır.
=(uDate)UDATE işleci değer dönüştürülür ve bu COleDateTime nesneye kopyalanır. Dönüştürme başarılı olursa, bu nesnenin durumu geçerli olarak ayarlanır; başarısız olursa geçersiz olarak ayarlanır. Yapı UDATE , "paketlenmemiş" bir tarihi temsil eder. Daha fazla bilgi için bkz. VarDateFromUdate işlevi.
=(filetimeSrc)işleci FILETIME değeri dönüştürülür ve bu COleDateTime nesneye kopyalanır. Dönüştürme başarılı olursa, bu nesnenin durumu geçerli olarak ayarlanır; aksi takdirde geçersiz olarak ayarlanır. FILETIME Evrensel Eşgüdümlü Saat (UTC) kullanır, bu nedenle yapıda utc saati geçirirseniz sonuçlarınız UTC saatinden yerel saate dönüştürülür ve değişken saat olarak depolanır. Bu davranış, Visual C++ 6.0 ve Visual C++.NET 2003 SP2 ile aynıdır. Daha fazla bilgi için bkz . Windows SDK'sında Dosya Süreleri .

Daha fazla bilgi için Windows SDK'sında VARIANT girdisine bakın.

Veri türü hakkında time_t daha fazla bilgi için Çalışma Zamanı Kitaplığı Başvurusu'ndaki time işlevine bakın.

Daha fazla bilgi için bkz. Windows SDK'sında SYSTEMTIME ve FILETIME yapıları.

Değerlerin sınırları hakkında daha fazla bilgi için COleDateTime Tarih ve Saat: Otomasyon Desteği makalesine bakın.

COleDateTime::operator +, -

Değerleri ekleyin ve çıkarın ColeDateTime .

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

Açıklamalar

COleDateTime nesneler mutlak saatleri temsil eder. COleDateTimeSpan nesneleri göreli saatleri temsil eder. İlk iki işleç, bir COleDateTimeSpan değer eklemenize ve bir değerden COleDateTime çıkarmanıza olanak sağlar. Üçüncü işleç, bir değeri vermek için bir COleDateTime değeri başka bir COleDateTimeSpan değerden çıkarmanıza olanak tanır.

İşlenenlerden biri null ise, sonuçta COleDateTime elde edilen değerin durumu null olur.

Sonuçta COleDateTime elde edilen değer kabul edilebilir değerlerin sınırlarının dışında kalırsa, bu COleDateTime değerin durumu geçersizdir.

İşlenenlerden biri geçersizse ve diğeri null değilse, sonuçta elde COleDateTime edilen değerin durumu geçersizdir.

+ nesne null olarak ayarlanırsa COleDateTime ve - işleçleri onaylar. Bir örnek için bkz . COleDateTime İlişkisel İşleçleri .

Geçerli, geçersiz ve null durum değerleri hakkında daha fazla bilgi için m_status üye değişkenine bakın.

Değerlerin sınırları hakkında daha fazla bilgi için COleDateTime Tarih ve Saat: Otomasyon Desteği makalesine bakın.

Örnek

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 +=, -=

Bu COleDateTime nesneden bir ColeDateTime değer ekleyin ve çıkarın.

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

Açıklamalar

Bu işleçler, bu COleDateTimeöğesine ve içinden bir COleDateTimeSpan değer eklemenize ve çıkarmanıza olanak sağlar. İşlenenlerden biri null ise, sonuçta COleDateTime elde edilen değerin durumu null olur.

Sonuçta COleDateTime elde edilen değer kabul edilebilir değerlerin sınırlarının dışında kalırsa, bu COleDateTime değerin durumu geçersiz olarak ayarlanır.

İşlenenlerden biri geçersizse ve diğeri null değilse, sonuçta elde edilen COleDateTime değerin durumu geçersizdir.

Geçerli, geçersiz ve null durum değerleri hakkında daha fazla bilgi için m_status üye değişkenine bakın.

+= nesne null olarak ayarlanırsa COleDateTime ve -= işleçleri onaylar. Bir örnek için bkz . COleDateTime İlişkisel İşleçleri .

Değerlerin sınırları hakkında daha fazla bilgi için COleDateTime Tarih ve Saat: Otomasyon Desteği makalesine bakın.

COleDateTime::operator DATE

Bir ColeDateTime değeri değerine DATEdönüştürür.

operator DATE() const throw();

Açıklamalar

Bu işleç, değeri bu COleDateTime nesneden kopyalanan bir DATE nesne döndürür. Nesnesinin uygulanması DATE hakkında daha fazla bilgi için Tarih ve Saat: Otomasyon Desteği makalesine bakın.

İşleç, DATE nesne null olarak ayarlanırsa COleDateTime onaylar. Bir örnek için bkz . COleDateTime İlişkisel İşleçleri .

COleDateTime::P arseDateTime

Tarih/saat değerini okumak için dizeyi ayrıştırır.

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

Parametreler

lpszDate
Ayrıştırılacak null ile sonlandırılan dizeye yönelik bir işaretçi. Ayrıntılar için bkz. Açıklamalar.

Dwflags
Yerel ayar ayarları ve ayrıştırma bayraklarını gösterir. Aşağıdaki bayraklardan biri veya daha fazlası:

LOCALE_NOUSEROVERRIDE Özel kullanıcı ayarları yerine sistem varsayılan yerel ayarı ayarlarını kullanın.
VAR_TIMEVALUEONLY Ayrıştırma sırasında tarih bölümünü yoksayın.
VAR_DATEVALUEONLY Ayrıştırma sırasında zaman bölümünü yoksayın.

lcid
Dönüştürme için kullanılacak yerel ayar kimliğini gösterir.

İade Değeri

Dize başarılı bir şekilde tarih/saat değerine dönüştürüldüyse TRUE döndürür, aksi takdirde YANLIŞ döndürür.

Açıklamalar

Dize başarılı bir şekilde tarih/saat değerine dönüştürüldüyse, bu COleDateTime nesnenin değeri bu değere ve durumu geçerli olarak ayarlanır.

Dekont

Yıl değerleri dahil olmak üzere 100 ile 9999 arasında olmalıdır.

lpszDate parametresi çeşitli biçimler alabilir. Örneğin, aşağıdaki dizeler kabul edilebilir tarih/saat biçimleri içerir:

"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

Yerel ayar kimliği, dize biçiminin tarih/saat değerine dönüştürülmek üzere kabul edilebilir olup olmadığını da etkiler.

VAR_DATEVALUEONLY durumunda, saat değeri saat 0 veya gece yarısı olarak ayarlanır. VAR_TIMEVALUEONLY durumunda, tarih değeri 30 Aralık 1899 anlamına gelen 0 tarihine ayarlanır.

Dize bir tarih/saat değerine dönüştürülemezse veya sayısal bir taşma varsa, bu COleDateTime nesnenin durumu geçersizdir.

Değerler için sınırlar ve uygulama hakkında daha fazla bilgi için COleDateTime Tarih ve Saat: Otomasyon Desteği makalesine bakın.

COleDateTime::SetDate

Bu COleDateTime nesnenin tarihini ayarlar.

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

Parametreler

nYear
Bu COleDateTime nesneye kopyalanacak yılı gösterir.

nMonth
Bu COleDateTime nesneye kopyalanacak ayı gösterir.

nDay
Bu COleDateTime nesneye kopyalanacak günü gösterir.

İade Değeri

Bu COleDateTime nesnenin değeri başarıyla ayarlandıysa sıfır; aksi takdirde 1. Bu dönüş değeri numaralandırılmış türü temel alır DateTimeStatus . Daha fazla bilgi için bkz . SetStatus üye işlevi.

Açıklamalar

Tarih, belirtilen değerlere ayarlanır. Saat saat 0, gece yarısı olarak ayarlanır.

Parametre değerlerinin sınırları için aşağıdaki tabloya bakın:

Parametre	Sınır -ları
nYear	100 - 9999
nMonth	1 - 12
nDay	0 - 31

Ayın günü taşıyorsa, sonraki ayın doğru gününe dönüştürülür ve ay ve/veya yıl buna göre artırılır. Sıfır olan bir gün değeri, önceki ayın son gününü gösterir. Davranış ile aynıdır SystemTimeToVariantTime.

Parametreler tarafından belirtilen tarih değeri geçerli değilse, bu nesnenin durumu olarak COleDateTime::invalidayarlanır. Değerin geçerliliğini DATE denetlemek için GetStatus kullanmalısınız ve m_dt değerinin değiştirilmediğini varsaymamalısınız.

Tarih değerlerine bazı örnekler aşağıda verilmiştir:

nYear	nMonth	nDay	Değer
2000	2	29	29 Şubat 2000
1776	7	4	4 Temmuz 1776
1925	4	35	35 Nisan 1925 (geçersiz tarih)
10000	Kategori 1	Kategori 1	1 Ocak 10000 (geçersiz tarih)

Hem tarih hem de saat ayarlamak için bkz . COleDateTime::SetDateTime.

Bu COleDateTime nesnenin değerini sorgulayan üye işlevleri hakkında bilgi için aşağıdaki üye işlevlerine bakın:

GetDay
GetMonth
GetYear
GetHour
GetMinute
GetSecond
GetDayOfWeek
Getdayofyear

Değerlerin sınırları hakkında daha fazla bilgi için COleDateTime Tarih ve Saat: Otomasyon Desteği makalesine bakın.

Örnek

// 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

Bu COleDateTime nesnenin tarih ve saatini ayarlar.

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

Parametreler

nYear, nMonth, nDay, nHour, nMin, nSec
Bu COleDateTime nesneye kopyalanacak tarih ve saat bileşenlerini belirtin.

İade Değeri

Açıklamalar

Parametre değerlerinin sınırları için aşağıdaki tabloya bakın:

Parametre	Sınır -ları
nYear	100 - 9999
nMonth	1 - 12
nDay	0 - 31
nHour	0 - 23
nMin	0 - 59
Nsec	0 - 59

Ayın günü taşıyorsa, sonraki ayın doğru gününe dönüştürülür ve ay ve/veya yıl buna göre artırılır. Sıfır olan bir gün değeri, önceki ayın son gününü gösterir. Davranış, SystemTimeToVariantTime ile aynıdır.

Parametreler tarafından belirtilen tarih veya saat değeri geçerli değilse, bu nesnenin durumu geçersiz olarak ayarlanır ve bu nesnenin değeri değiştirilmez.

Zaman değerlerine bazı örnekler aşağıda verilmiştir:

nHour	nMin	Nsec	Değer
1	3	3	01:03:03
23	45	0	23:45:00
25	30	0	Geçersiz
9	60	0	Geçersiz

Tarih değerlerine bazı örnekler aşağıda verilmiştir:

nYear	nMonth	nDay	Değer
1995	4	15	15 Nisan 1995
1789	7	14	17 Temmuz 1789
1925	2	30	Geçersiz
10000	Kategori 1	Kategori 1	Geçersiz

Yalnızca tarihi ayarlamak için bkz . COleDateTime::SetDate. Yalnızca saati ayarlamak için bkz . COleDateTime::SetTime.

Bu COleDateTime nesnenin değerini sorgulayan üye işlevleri hakkında bilgi için aşağıdaki üye işlevlerine bakın:

GetDay
GetMonth
GetYear
GetHour
GetMinute
GetSecond
GetDayOfWeek
Getdayofyear

Değerlerin sınırları hakkında daha fazla bilgi için COleDateTime Tarih ve Saat: Otomasyon Desteği makalesine bakın.

Örnek

GetStatus örneğine bakın.

COleDateTime::SetStatus

Bu COleDateTime nesnenin durumunu ayarlar.

void SetStatus(DateTimeStatus status) throw();

Parametreler

status
Bu COleDateTime nesne için yeni durum değeri.

Açıklamalar

durum parametresi değeri, sınıfı içinde DateTimeStatusCOleDateTime tanımlanan numaralandırılmış tür tarafından tanımlanır. Ayrıntılar için bkz . COleDateTime::GetStatus .

Dikkat

Bu işlev gelişmiş programlama durumlarını kapsar. Bu işlev bu nesnedeki verileri değiştirmez. Çoğu zaman durumu null veya geçersiz olarak ayarlamak için kullanılır. Atama işleci (işleç =) ve SetDateTime , nesnenin durumunu kaynak değerlere göre ayarlar.

Örnek

GetStatus örneğine bakın.

COleDateTime::SetTime

Bu COleDateTime nesnenin zamanını ayarlar.

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

Parametreler

nHour, nMin, nSec
Bu COleDateTime nesneye kopyalanacak zaman bileşenlerini belirtin.

İade Değeri

Açıklamalar

Zaman, belirtilen değerlere ayarlanır. Tarih, 30 Aralık 1899 anlamına gelen 0. tarihe ayarlanır.

Parametre değerlerinin sınırları için aşağıdaki tabloya bakın:

Parametre	Sınır -ları
nHour	0 - 23
nMin	0 - 59
Nsec	0 - 59

Parametreler tarafından belirtilen saat değeri geçerli değilse, bu nesnenin durumu geçersiz olarak ayarlanır ve bu nesnenin değeri değiştirilmez.

Zaman değerlerine bazı örnekler aşağıda verilmiştir:

nHour	nMin	Nsec	Değer
1	3	3	01:03:03
23	45	0	23:45:00
25	30	0	Geçersiz
9	60	0	Geçersiz

Hem tarih hem de saat ayarlamak için bkz . COleDateTime::SetDateTime.

Bu COleDateTime nesnenin değerini sorgulayan üye işlevleri hakkında bilgi için aşağıdaki üye işlevlerine bakın:

GetDay
GetMonth
GetYear
GetHour
GetMinute
GetSecond
GetDayOfWeek
Getdayofyear

Değerlerin sınırları hakkında daha fazla bilgi için COleDateTime Tarih ve Saat: Otomasyon Desteği makalesine bakın.

Örnek

SetDate örneğine bakın.

Ayrıca bkz.

COleVariant Sınıfı
CTime Sınıfı
CTimeSpan Sınıfı
Hiyerarşi Grafiği
ATL/MFC Paylaşılan Sınıfları

Aracılığıyla paylaş

COleDateTime Sınıfı

Sözdizimi

Üyeler

Ortak Oluşturucular

Genel Yöntemler

Ortak İşleçler

Ortak Veri Üyeleri

Açıklamalar

Gereksinimler

COleDateTime İlişkisel İşleçleri

Parametreler

Açıklamalar

Örnekler

COleDateTime::COleDateTime

Parametreler

Açıklamalar

Örnek

COleDateTime::Format

Parametreler

İade Değeri

Açıklamalar

Örnek

COleDateTime::GetAsDBTIMESTAMP

Parametreler

İade Değeri

Açıklamalar

Örnek

COleDateTime::GetAsSystemTime

Parametreler

İade Değeri

Açıklamalar

COleDateTime::GetAsUDATE

Parametreler

İade Değeri

Açıklamalar

COleDateTime::GetCurrentTime

Örnek

COleDateTime::GetDay

İade Değeri

Açıklamalar

Örnek

COleDateTime::GetDayOfWeek

İade Değeri

Açıklamalar

Örnek

COleDateTime::GetDayOfYear

İade Değeri

Açıklamalar

Örnek

COleDateTime::GetHour

İade Değeri

Açıklamalar

Örnek

COleDateTime::GetMinute

İade Değeri

Açıklamalar

Örnek

COleDateTime::GetMonth

İade Değeri

Açıklamalar

Örnek

COleDateTime::GetSecond

İade Değeri

Açıklamalar

Örnek

COleDateTime::GetStatus

İade Değeri

Açıklamalar

Örnek

COleDateTime::GetYear

İade Değeri

Açıklamalar

Örnek

COleDateTime::m_dt

Açıklamalar

COleDateTime::m_status

Açıklamalar

COleDateTime::operator =

Açıklamalar