COleDateTimeSpan Sınıfı

Not

Microsoft Foundation Sınıfları (MFC) kitaplığı ve Etkin Şablon Kitaplığı (ATL) desteklenmeye devam ediyor. Ancak artık özellik eklemeyeceğiz veya belgeleri güncelleştirmeyeceğiz.

Göreli bir saati, bir zaman aralığını temsil eder.

Sözdizimi

class COleDateTimeSpan

Üyeler

Ortak Oluşturucular

Veri Akışı Adı	Açıklama
COleDateTimeSpan::COleDateTimeSpan	Bir `COleDateTimeSpan` nesne oluşturur.

Genel Yöntemler

Veri Akışı Adı	Açıklama
COleDateTimeSpan::Format	Bir nesnenin biçimlendirilmiş dize gösterimini `COleDateTimeSpan` oluşturur.
COleDateTimeSpan::GetDays	Bu `COleDateTimeSpan` nesnenin temsil ettiği yayılma alanının gün bölümünü döndürür.
COleDateTimeSpan::GetHours	Bu `COleDateTimeSpan` nesnenin temsil ettiği yayılma alanının saat bölümünü döndürür.
COleDateTimeSpan::GetMinutes	Bu `COleDateTimeSpan` nesnenin temsil ettiği yayılma alanının dakika bölümünü döndürür.
COleDateTimeSpan::GetSeconds	Bu `COleDateTimeSpan` nesnenin temsil ettiği yayılma alanının ikinci bölümünü döndürür.
COleDateTimeSpan::GetStatus	Bu `COleDateTimeSpan` nesnenin durumunu (geçerliliğini) alır.
COleDateTimeSpan::GetTotalDays	Bu `COleDateTimeSpan` nesnenin temsil ettiği gün sayısını döndürür.
COleDateTimeSpan::GetTotalHours	Bu `COleDateTimeSpan` nesnenin temsil ettiği saat sayısını döndürür.
COleDateTimeSpan::GetTotalMinutes	Bu `COleDateTimeSpan` nesnenin temsil ettiği dakika sayısını döndürür.
COleDateTimeSpan::GetTotalSeconds	Bu `COleDateTimeSpan` nesnenin temsil ettiği saniye sayısını döndürür.
COleDateTimeSpan::SetDateTimeSpan	Bu `COleDateTimeSpan` nesnenin değerini ayarlar.
COleDateTimeSpan::SetStatus	Bu `COleDateTimeSpan` nesnenin durumunu (geçerliliğini) ayarlar.

Ortak İşleçler

Veri Akışı Adı	Açıklama
işleç +, -	Değerler için `COleDateTimeSpan` işaret ekleyin, çıkarın ve değiştirin.
işleç +=, -=	Bu `COleDateTimeSpan` değerden bir `COleDateTimeSpan` değer ekleyin ve çıkarın.
operator =	Bir `COleDateTimeSpan` değeri kopyalar.
operator ==, <, <=	İki `COleDateTimeSpan` değeri karşılaştırın.
işleç çift	Bu `COleDateTimeSpan` değeri değerine `double`dönüştürür.

Ortak Veri Üyeleri

Veri Akışı Adı	Açıklama
COleDateTimeSpan::m_span	Bu `double` nesne için temel alınanı `COleDateTimeSpan` içerir.
COleDateTimeSpan::m_status	Bu `COleDateTimeSpan` nesnenin durumunu içerir.

Açıklamalar

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

A COleDateTimeSpan , zamanı gün içinde tutar.

COleDateTimeSpan , eşlikçi sınıfı COleDateTime ile birlikte kullanılır. COleDateTime OLE otomasyonunun DATE veri türünü kapsüller. COleDateTime mutlak saat değerlerini temsil eder. Tüm COleDateTime hesaplamalar değerler içerir COleDateTimeSpan . Bu sınıflar arasındaki ilişki, CTime ile CTimeSpan arasındaki ilişkiyle benzerdir.

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

COleDateTimeSpan İlişkisel İşleçleri

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

bool operator==(const COleDateTimeSpan& dateSpan) const throw();
bool operator!=(const COleDateTimeSpan& dateSpan) const throw();
bool operator<(const COleDateTimeSpan& dateSpan) const throw();
bool operator>(const COleDateTimeSpan& dateSpan) const throw();
bool operator<=(const COleDateTimeSpan& dateSpan) const throw();
bool operator>=(const COleDateTimeSpan& dateSpan) const throw();

Parametreler

dateSpan
COleDateTimeSpan Karşılaştıracak.

Dönüş Değeri

Bu işleçler iki tarih/saat aralığı değerini karşılaştırır ve koşul true ise TRUE döndürür; aksi takdirde YANLIŞ.

Açıklamalar

Not

İşlenenlerden biri geçersizse ATLASSERT oluşur.

Örnek

COleDateTimeSpan spanOne(3, 12, 0, 0); // 3 days and 12 hours
COleDateTimeSpan spanTwo(spanOne);     // 3 days and 12 hours
BOOL b;
b = spanOne == spanTwo;                // TRUE
b = spanOne < spanTwo;                 // FALSE, same value
b = spanOne > spanTwo;                 // FALSE, same value
b = spanOne <= spanTwo;                // TRUE, same value
b = spanOne >= spanTwo;                // TRUE, same value   

spanTwo.SetStatus(COleDateTimeSpan::invalid);
b = spanOne == spanTwo;                // FALSE, different status
b = spanOne != spanTwo;                // TRUE, different status

COleDateTimeSpan ts1(100.0);   // one hundred days
COleDateTimeSpan ts2(110.0);   // ten more days

ASSERT((ts1 != ts2) && (ts1 < ts2) && (ts1 <= ts2));

COleDateTimeSpan::COleDateTimeSpan

Bir COleDateTimeSpan nesne oluşturur.

COleDateTimeSpan() throw();
COleDateTimeSpan(double dblSpanSrc) throw();
COleDateTimeSpan(LONG lDays, int nHours, int nMins, int nSecs) throw();

Parametreler

dblSpanSrc
Yeni COleDateTimeSpan nesneye kopyalanacak gün sayısı.

lDays, nHours, nMins, nSecs
Yeni COleDateTimeSpan nesneye kopyalanacak gün ve saat değerlerini belirtin.

Açıklamalar

Bu oluşturucuların tümü, belirtilen değere başlatılan yeni COleDateTimeSpan nesneler oluşturur. Bu oluşturucuların her birinin kısa bir açıklaması aşağıdadır:

COleDateTimeSpan( ) 0 olarak başlatılan bir COleDateTimeSpan nesne oluşturur.
COleDateTimeSpan(dblSpanSrc) Kayan nokta değerinden nesne oluşturur COleDateTimeSpan .
COleDateTimeSpan(lDays,nHours,nMins,nSecs ) Belirtilen sayısal değerlere başlatılan bir COleDateTimeSpan nesne oluşturur.

Yeni COleDateTimeSpan nesnenin durumu geçerli olarak ayarlanır.

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

Örnek

COleDateTimeSpan spanOne(2.75);          // 2 days and 18 hours
COleDateTimeSpan spanTwo(2, 18, 0, 0);   // 2 days and 18 hours
COleDateTimeSpan spanThree(3, -6, 0, 0); // 2 days and 18 hours

COleDateTimeSpan ts1;               // Uninitialized time value
COleDateTimeSpan ts2a(ts1);         // Copy constructor
COleDateTimeSpan ts2b = ts1;         // Copy constructor again
COleDateTimeSpan ts3(100.0);          // 100 days
COleDateTimeSpan ts4(0, 1, 5, 12);   // 1 hour, 5 minutes, and 12 seconds

COleDateTimeSpan::Format

Bir nesnenin biçimlendirilmiş dize gösterimini COleDateTimeSpan oluşturur.

CString Format(LPCTSTR pFormat) const;
CString Format(UINT nID) const;

Parametreler

pFormat
Biçimlendirme dizesine printf benzer bir biçimlendirme dizesi. Yüzde (%) işaretinden önce gelen biçimlendirme kodları, karşılık gelen COleDateTimeSpan bileşenle değiştirilir. Biçimlendirme dizesindeki diğer karakterler döndürülen dizeye değiştirilmeden kopyalanır. biçimlendirme Format kodlarının değeri ve anlamı aşağıda listelenmiştir:

Geçerli gün içindeki %H Saat sayısı
Geçerli saat içindeki %M Dakika
Geçerli dakikada %S Saniye
%% Yüzde işareti

Yukarıda listelenen dört biçim kodu, Format'ın kabul edeceği tek kodlardır.

Nıd
Biçim denetimi dizesinin kaynak kimliği.

Dönüş Değeri

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

Açıklamalar

Zaman aralığı değerinin biçimlendirilmiş bir gösterimini oluşturmak için bu işlevleri çağırın. Bu COleDateTimeSpan nesnenin durumu null ise, dönüş değeri boş bir dizedir. Durum geçersizse, dönüş dizesi dize kaynağı IDS_INVALID_DATETIMESPAN tarafından belirtilir.

Bu işlevin formlarının kısa bir açıklaması aşağıdadır:

Format(pFormat)
Bu form, değerini , içinde olduğu gibi önünde yüzde işareti (%) bulunan özel biçimlendirme kodları içeren biçim dizesini kullanarak biçimlendiriyor printf. Biçimlendirme dizesi işleve parametre olarak geçirilir.

Format(nID)
Bu form, değerini , içinde olduğu gibi önünde yüzde işareti (%) bulunan ö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.

Örnek

// get the current time
COleDateTime tmStart = COleDateTime::GetCurrentTime();

// waste some time
CString str;
::Sleep(3000);

// get the current time again
COleDateTime tmFinish = COleDateTime::GetCurrentTime();

// find the difference
COleDateTimeSpan tmSpan = tmFinish - tmStart;

// tell the user
str = tmSpan.Format(_T("%S seconds elapsed"));
_tprintf_s(_T("%s\n"), (LPCTSTR) str);

COleDateTimeSpan::GetDays

Bu tarih/saat aralığı değerinin gün bölümünü alır.

LONG GetDays() const throw();

Dönüş Değeri

Bu tarih/saat aralığı değerinin gün bölümü.

Açıklamalar

Bu işlevden döndürülen değerler yaklaşık - 3.615.000 ile 3.615.000 arasında değişir.

Bir COleDateTimeSpan nesnenin değerini sorgulayan diğer işlevler için aşağıdaki üye işlevlerine bakın:

GetHours
GetMinutes
GetSeconds
GetTotalDays
GetTotalHours
GetTotalMinutes
GetTotalSeconds

Örnek

COleDateTimeSpan ts(3, 1, 5, 12); // 3 days, 1 hour, 5 min, and 12 sec
ASSERT(ts.GetDays() == 3);

COleDateTimeSpan::GetHours

Bu tarih/saat aralığı değerinin saat bölümünü alır.

LONG GetHours() const throw();

Dönüş Değeri

Bu tarih/saat aralığı değerinin saat bölümü.

Açıklamalar

Bu işlevden döndürülen değerler - 23 ile 23 arasında değişir.

Bir COleDateTimeSpan nesnenin değerini sorgulayan diğer işlevler için aşağıdaki üye işlevlerine bakın:

GetDays
GetMinutes
GetSeconds
GetTotalDays
GetTotalHours
GetTotalMinutes
GetTotalSeconds

Örnek

COleDateTimeSpan ts(3, 1, 5, 12); // 3 days, 1 hour, 5 min, and 12 sec
ASSERT(ts.GetHours() == 1);

COleDateTimeSpan::GetMinutes

Bu tarih/saat aralığı değerinin dakika bölümünü alır.

LONG GetMinutes() const throw();

Dönüş Değeri

Bu tarih/saat aralığı değerinin dakika bölümü.

Açıklamalar

Bu işlevden döndürülen değerler - 59 ile 59 arasında değişir.

Bir COleDateTimeSpan nesnenin değerini sorgulayan diğer işlevler için aşağıdaki üye işlevlerine bakın:

GetDays
GetHours
GetSeconds
GetTotalDays
GetTotalHours
GetTotalMinutes
GetTotalSeconds

Örnek

COleDateTimeSpan ts(3, 1, 5, 12); // 3 days, 1 hour, 5 min, and 12 sec
ASSERT(ts.GetMinutes() == 5);

COleDateTimeSpan::GetSeconds

Bu tarih/saat aralığı değerinin ikinci bölümünü alır.

LONG GetSeconds() const throw();

Dönüş Değeri

Bu tarih/saat aralığı değerinin saniye bölümü.

Açıklamalar

Bu işlevden döndürülen değerler - 59 ile 59 arasında değişir.

Bir COleDateTimeSpan nesnenin değerini sorgulayan diğer işlevler için aşağıdaki üye işlevlerine bakın:

GetDays
GetHours
GetMinutes
GetTotalDays
GetTotalHours
GetTotalMinutes
GetTotalSeconds

Örnek

COleDateTimeSpan ts(3, 1, 5, 12); // 3 days, 1 hour, 5 min, and 12 sec
ASSERT(ts.GetSeconds() == 12);

COleDateTimeSpan::GetStatus

Bu COleDateTimeSpan nesnenin durumunu (geçerliliğini) alır.

DateTimeSpanStatus GetStatus() const throw();

Dönüş Değeri

Bu COleDateTimeSpan değerin durumu.

Açıklamalar

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

enum DateTimeSpanStatus{
   valid = 0,
   invalid = 1,
   null = 2,
};

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

COleDateTimeSpan::valid Bu COleDateTimeSpan nesnenin geçerli olduğunu gösterir.
COleDateTimeSpan::invalid Bu COleDateTimeSpan nesnenin geçersiz olduğunu gösterir; yani değeri yanlış olabilir.
COleDateTimeSpan::null Bu COleDateTimeSpan 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 COleDateTimeSpan durumu geçersizdir:

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 bkz . COleDateTimeSpan::operator +, - ve COleDateTimeSpan::operator +=, -=.

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

COleDateTimeSpan::GetTotalDays

Gün cinsinden ifade edilen bu tarih/saat aralığı değerini alır.

double GetTotalDays() const throw();

Dönüş Değeri

Bu tarih/saat aralığı değeri gün cinsinden ifade edilir. Bu işlevin prototipi bir çift döndürmek için olsa da, her zaman bir tamsayı değeri döndürür.

Açıklamalar

Bu işlevden döndürülen değerler yaklaşık - 3,65e6 ile 3,65e6 arasında değişir.

Bir COleDateTimeSpan nesnenin değerini sorgulayan diğer işlevler için aşağıdaki üye işlevlerine bakın:

GetDays
GetHours
GetMinutes
GetSeconds
GetTotalHours
GetTotalMinutes
GetTotalSeconds

Örnek

COleDateTimeSpan ts(3, 1, 5, 12); // 3 days, 1 hour, 5 min, and 12 sec
ASSERT(ts.GetTotalDays() == 3);
ASSERT(ts.GetTotalHours() == 73);
ASSERT(ts.GetTotalMinutes() == 4385);
ASSERT(ts.GetTotalSeconds() == 263112);

COleDateTimeSpan::GetTotalHours

Saat cinsinden ifade edilen bu tarih/saat aralığı değerini alır.

double GetTotalHours() const throw();

Dönüş Değeri

Saat cinsinden ifade edilen bu tarih/saat aralığı değeri. Bu işlevin prototipi bir çift döndürmek için olsa da, her zaman bir tamsayı değeri döndürür.

Açıklamalar

Bu işlevden döndürülen değerler yaklaşık - 8,77e7 ile 8,77e7 arasında değişir.

Bir COleDateTimeSpan nesnenin değerini sorgulayan diğer işlevler için aşağıdaki üye işlevlerine bakın:

GetDays
GetHours
GetMinutes
GetSeconds
GetTotalDays
GetTotalMinutes
GetTotalSeconds

Örnek

GetTotalDays örneğine bakın.

COleDateTimeSpan::GetTotalMinutes

Dakika cinsinden ifade edilen bu tarih/saat aralığı değerini alır.

double GetTotalMinutes() const throw();

Dönüş Değeri

Bu tarih/saat aralığı değeri dakika cinsinden ifade edilir. Bu işlevin prototipi bir çift döndürmek için olsa da, her zaman bir tamsayı değeri döndürür.

Açıklamalar

Bu işlevden döndürülen değerler yaklaşık - 5,26e9 ile 5,26e9 arasında değişir.

Bir COleDateTimeSpan nesnenin değerini sorgulayan diğer işlevler için aşağıdaki üye işlevlerine bakın:

GetDays
GetHours
GetMinutes
GetSeconds
GetTotalDays
GetTotalHours
GetTotalSeconds

Örnek

GetTotalDays örneğine bakın.

COleDateTimeSpan::GetTotalSeconds

Saniye cinsinden ifade edilen bu tarih/saat aralığı değerini alır.

double GetTotalSeconds() const throw();

Dönüş Değeri

Bu tarih/saat aralığı değeri saniye cinsinden ifade edilir. Bu işlevin prototipi bir çift döndürmek için olsa da, her zaman bir tamsayı değeri döndürür.

Açıklamalar

Bu işlevden döndürülen değerler yaklaşık - 3,16e11 ile 3,16e11 arasında değişir.

Bir COleDateTimeSpan nesnenin değerini sorgulayan diğer işlevler için aşağıdaki üye işlevlerine bakın:

GetDays
GetHours
GetMinutes
GetSeconds
GetTotalDays
GetTotalHours
GetTotalMinutes

Örnek

GetTotalDays örneğine bakın.

COleDateTimeSpan::m_span

Bu double nesne için temel alınan COleDateTime değer.

double m_span;

Açıklamalar

Bu değer, tarih/saat aralığını gün cinsinden ifade eder.

Dikkat

Veri üyesindeki değerin double değiştirilmesi bu COleDateTimeSpan nesnenin değerini değiştirir. Bu COleDateTimeSpan nesnenin durumunu değiştirmez.

COleDateTimeSpan::m_status

Bu veri üyesinin türü, sınıfı içinde DateTimeSpanStatus tanımlanan numaralandırılmış türdürCOleDateTimeSpan.

DateTimeSpanStatus m_status;

Açıklamalar

enum DateTimeSpanStatus{
   valid = 0,
   invalid = 1,
   null = 2,
   };

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

COleDateTimeSpan::valid Bu COleDateTimeSpan nesnenin geçerli olduğunu gösterir.
COleDateTimeSpan::invalid Bu COleDateTimeSpan nesnenin geçersiz olduğunu gösterir; yani değeri yanlış olabilir.
COleDateTimeSpan::null Bu COleDateTimeSpan 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 COleDateTimeSpan durumu geçersizdir:

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 SetStatus kullanılarak açıkça geçersiz olarak ayarlandıysa.

Durumu geçersiz olarak ayarlayabilen işlemler hakkında daha fazla bilgi için bkz . COleDateTimeSpan::operator +, - ve COleDateTimeSpan::operator +=, -=.

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 .

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

COleDateTimeSpan::operator =

Bir COleDateTimeSpan değeri kopyalar.

COleDateTimeSpan& operator=(double dblSpanSrc) throw();

Açıklamalar

Bu aşırı yüklenmiş atama işleci, kaynak tarih/saat aralığı değerini bu COleDateTimeSpan nesneye kopyalar.

COleDateTimeSpan::operator +, -

Değerler için COleDateTimeSpan işaret ekleyin, çıkarın ve değiştirin.

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

Açıklamalar

İlk iki işleç, tarih/saat aralığı değerlerini eklemenize ve çıkarmanıza olanak sağlar. Üçüncüsü, tarih/saat aralığı değerinin işaretini değiştirmenize olanak tanır.

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

İşlenenlerden biri geçersizse ve diğeri null değilse, sonuçta elde COleDateTimeSpan edilen 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.

Örnek

COleDateTimeSpan ts1(3, 1, 5, 12); // 3 days, 1 hour, 5 min, and 12 sec
COleDateTimeSpan ts2(100.0 / (24 * 3600.0)); // 100 seconds
COleDateTimeSpan ts3 = ts1 + ts2;
ASSERT(ts3.GetSeconds() == 52); // 6 mins, 52 secs

COleDateTimeSpan::operator +=, -=

Bu COleDateTimeSpan değerden bir COleDateTimeSpan değer ekleyin ve çıkarın.

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

Açıklamalar

Bu işleçler, bu COleDateTimeSpan nesneden tarih/saat aralığı değerleri eklemenize ve çıkarmanıza olanak sağlar. İşlenenlerden biri null ise, sonuçta COleDateTimeSpan elde edilen değerin durumu null olur.

İşlenenlerden biri geçersizse ve diğeri null değilse, sonuçta elde COleDateTimeSpan edilen 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.

Örnek

COleDateTimeSpan ts1(10.0); // 10 days
COleDateTimeSpan ts2(100.0); // 100 days
ts2 -= ts1;
ASSERT(ts2.GetTotalDays() == 90);

COleDateTimeSpan::operator double

Bu COleDateTimeSpan değeri değerine doubledönüştürür.

operator double() const throw();

Açıklamalar

Bu işleç, bu COleDateTimeSpan değerin değerini kayan noktalı gün sayısı olarak döndürür.

COleDateTimeSpan::SetDateTimeSpan

Bu tarih/saat aralığı değerini ayarlar.

void SetDateTimeSpan(LONG lDays, int nHours, int nMins, int nSecs) throw();

Parametreler

lDays, nHours, nMins, nSecs
Bu COleDateTimeSpan nesneye kopyalanacak tarih-yayılma ve zaman aralığı değerlerini belirtin.

Açıklamalar

Bir COleDateTimeSpan nesnenin değerini sorgulayan işlevler için aşağıdaki üye işlevlerine bakın:

GetDays
GetHours
GetMinutes
GetSeconds
GetTotalDays
GetTotalHours
GetTotalMinutes
GetTotalSeconds

Örnek

COleDateTimeSpan spanOne;
COleDateTimeSpan spanTwo;
spanOne.SetDateTimeSpan(0, 2, 45, 0);  // 2 hours and 45 seconds
spanTwo.SetDateTimeSpan(0, 3, -15, 0); // 2 hours and 45 seconds

COleDateTimeSpan::SetStatus

Bu COleDateTimeSpan nesnenin durumunu (geçerliliğini) ayarlar.

void SetStatus(DateTimeSpanStatus status) throw();

Parametreler

durum
Bu COleDateTimeSpan nesne için yeni durum değeri.

Açıklamalar

Status parametre değeri, sınıfı içinde DateTimeSpanStatus tanımlanan numaralandırılmış tür tarafından COleDateTimeSpan tanımlanır.

enum DateTimeSpanStatus{
   valid = 0,
   invalid = 1,
   null = 2,
   };

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

COleDateTimeSpan::valid Bu COleDateTimeSpan nesnenin geçerli olduğunu gösterir.
COleDateTimeSpan::invalid Bu COleDateTimeSpan nesnenin geçersiz olduğunu gösterir; yani değeri yanlış olabilir.
COleDateTimeSpan::null Bu COleDateTimeSpan 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.)

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şlecinin (işleç =) ve SetDateTimeSpan'ın nesnenin durumunu kaynak değerlere göre ayarladığını unutmayın.

Örnek

// if the person is not still in school, set days to graduation to null
if (!m_bStillInSchool || m_dtDateOfGraduation.GetStatus() == COleDateTime::null)
   m_dtsDaysToGraduation.SetStatus(COleDateTimeSpan::null);

Ayrıca bkz.

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

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Last updated on 2025-11-07