Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
OLE otomasyonunda DATE kullanılan veri türünü kapsüller.
Sözdizimi
class COleDateTime
Üyeler
Ortak Oluşturucular
| Veri Akışı Adı | Açıklama |
|---|---|
| COleDateTime::COleDateTime | Bir COleDateTime nesne oluşturur. |
Genel Yöntemler
| Veri Akışı Adı | Açıklama |
|---|---|
| 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 COleDateTimeayarlar. |
| 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
| Veri Akışı Adı | Açıklama |
|---|---|
| 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 DATEdeğerine DATE* dönüştürür. |
Ortak Veri Üyeleri
| Veri Akışı Adı | Açıklama |
|---|---|
| COleDateTime::m_dt | Bu DATE nesne için temel alınanı COleDateTime 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:
| Tarih | 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çCOleDateTimesıralanacağını 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.)
Not
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. Örneğin:
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 COleDateTime sınıfları hakkında COleDateTimeSpan 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
Not
İ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
=, =>nesne null olarak ayarlanırsa < 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 VARIANT nesneye kopyalanacak mevcut COleVariant bir veri yapısı (büyük olasılıkla COleDateTime bir nesne).
dtSrc
Yeni DATE nesneye kopyalanacak tarih/saat (COleDateTime) değeri.
timeSrc
Tarihtime_t/saat değerine dönüştürülecek ve yeni __time64_t nesneye kopyalanacak bir veya COleDateTime 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 |
| saniye | 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 SetDate üye işlevlerine SetDateTime 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 birCOleDateTimenesne oluşturur.COleDateTime(dateSrc) Var olanCOleDateTimebirCOleDateTimenesneden nesne oluşturur.COleDateTime(varSrc) BirCOleDateTimenesne oluşturur. BirVARIANTyapı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 yeniCOleDateTimenesneye kopyalanır. Değilse, nesneninCOleDateTimedeğeri 0 (gece yarısı, 30 Aralık 1899) ve durumu geçersiz olarak ayarlanır.COleDateTime(dtSrc) BirCOleDateTimedeğerdenDATEnesne oluşturur.COleDateTime(timeSrc) BirCOleDateTimedeğerdentime_tnesne oluşturur.COleDateTime(systimeSrc) BirCOleDateTimedeğerdenSYSTEMTIMEnesne oluşturur.COleDateTime(filetimeSrc) BirCOleDateTimedeğerdenFILETIMEnesne oluşturur. . AFILETIME, 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 birCOleDateTimenesne oluşturur.COleDateTime(wDosDate,wDosTime) Belirtilen MS-DOS tarih ve saat değerlerinden birCOleDateTimenesne 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.
Not
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 kodu, karşılık gelen COleDateTime bileşenle değiştirilir. 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:
%HGeçerli gündeki saatler%MGeçerli saat içindeki dakika sayısı%SGeçerli dakikadaki saniye sayısı%%Yüzde işareti
nFormatID
Biçim denetimi dizesinin kaynak kimliği.
Dönüş 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.
Dönüş 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.
Dönüş 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 .
Dönüş 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();
Dönüş 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:
Ö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();
Dönüş 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:
Ö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();
Dönüş 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:
Ö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();
Dönüş 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:
Ö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();
Dönüş 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:
Örnek
GetHour örneğine bakın.
COleDateTime::GetMonth
Bu tarih/saat değeriyle temsil edilen ayı alır.
int GetMonth() const throw();
Dönüş 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:
Örnek
GetDay örneğine bakın.
COleDateTime::GetSecond
Bu tarih/saat değeriyle temsil edilen ikinci değeri alır.
int GetSecond() const throw();
Dönüş 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ığı.
Not
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:
Örnek
GetHour örneğine bakın.
COleDateTime::GetStatus
Belirli COleDateTime bir nesnenin durumunu (geçerliliğini) alır.
DateTimeStatus GetStatus() const throw();
Dönüş Değeri
Bu COleDateTime değerin durumunu döndürür.
GetStatus
COleDateTime Varsayılan değerle oluşturduğunuzda nesne geçerli olarak döndürülecektir. Oluşturucu null olarak ayarlanmış bir GetStatus nesnede çağrısı COleDateTime 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::errorTarih/saat değerinin bir kısmını elde etmeye çalışırken bir hata oluştuğunun göstergesidir.COleDateTime::validBuCOleDateTimenesnenin geçerli olduğunu gösterir.COleDateTime::invalidBuCOleDateTimenesnenin geçersiz olduğunu gösterir; yani değeri yanlış olabilir.COleDateTime::nullBuCOleDateTimenesnenin 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
VARIANTveyaCOleVariantdeğerinden ayarlanırsa.Değeri, geçerli bir tarih/saat değerine dönüştürülemeyen bir
time_t,SYSTEMTIMEveyaFILETIMEdeğ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:
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();
Dönüş 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:
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 DATE nesnenin temel yapısıCOleDateTime.
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 DateTimeStatus tanımlanan numaralandırılmış türüdürCOleDateTime. 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:
operator =(
dateSrc) İşlenenin değeri ve durumu buCOleDateTimenesneye 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
COleDateTimenesneye 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.operator =(
dtSrc) DeğerDATEbuCOleDateTimenesneye kopyalanır ve durumu geçerli olarak ayarlanır.operator =(
timeSrc)time_tor__time64_tdeğeri dönüştürülür ve buCOleDateTimenesneye 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
COleDateTimenesneye 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 =(
uDate)UDATEDeğer dönüştürülür ve buCOleDateTimenesneye 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.operator =(
filetimeSrc)FILETIME değeri dönüştürülür ve buCOleDateTimenesneye 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.FILETIMEEvrensel 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 - ve COleDateTime 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 COleDateTimeSpanöğesine ve içinden bir COleDateTime 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 -= ve COleDateTime 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 DATE nesneden kopyalanan bir COleDateTime 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.
Dönüş 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.
Not
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.
Dönüş 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 denetlemek için GetStatusDATEve 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 |
|---|---|---|---|
| Kategori 2000 | 2 | 29 | 29 Şubat 2000 |
| 1776 | 7 | 4 | 4 Temmuz 1776 |
| 1925 | 4 | 35 | 35 Nisan 1925 (geçersiz tarih) |
| 10.000 | 1 | 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:
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.
Dönüş 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
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 |
| Yirmi beş | 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 |
| 10.000 | 1 | 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:
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
durum
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.
Dönüş 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
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 |
| Yirmi beş | 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:
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ı