CTimeSpan Sınıfı

Dahili olarak zaman aralığındaki saniye sayısı olarak depolanan süre miktarı.

Sözdizimi

class CTimeSpan

Üyeler

Ortak Oluşturucular

Ad	Tanım
CTimeSpan::CTimeSpan	CTimeSpan Nesneleri çeşitli şekillerde oluşturur.

Genel Yöntemler

Ad	Tanım
CTimeSpan::Format	bir CTimeSpan öğesini biçimlendirilmiş bir dizeye dönüştürür.
CTimeSpan::GetDays	Bu CTimeSpaniçindeki tam gün sayısını temsil eden bir değer döndürür.
CTimeSpan::GetHours	Geçerli gündeki saat sayısını (-23 ile 23 arasında) gösteren bir değer döndürür.
CTimeSpan::GetMinutes	Geçerli saat içindeki dakika sayısını (-59 ile 59 arasında) temsil eden bir değer döndürür.
CTimeSpan::GetSeconds	Geçerli dakikadaki saniye sayısını (-59 ile 59 arasında) temsil eden bir değer döndürür.
CTimeSpan::GetTimeSpan	Nesnesinin CTimeSpan değerini döndürür.
CTimeSpan::GetTotalHours	Bu CTimeSpaniçindeki toplam tam saat sayısını temsil eden bir değer döndürür.
CTimeSpan::GetTotalMinutes	Bu CTimeSpaniçindeki toplam dakika sayısını temsil eden bir değer döndürür.
CTimeSpan::GetTotalSeconds	Bu CTimeSpaniçindeki toplam saniye sayısını temsil eden bir değer döndürür.
CTimeSpan::Serialize64	Verileri arşive veya arşivden serileştirir.

İşleçler

Ad	Tanım
operator + -	Nesneleri ekler ve çıkarır CTimeSpan .
operator += -=	Bu CTimeSpanöğesine ve öğesinden bir CTimeSpan nesne ekler ve çıkarır.
operator == < etc.	İki göreli zaman değerini karşılaştırır.

Açıklamalar

CTimeSpan temel sınıfı yoktur.

CTimeSpan işlevleri saniyeleri gün, saat, dakika ve saniyelerin çeşitli birleşimlerine dönüştürür.

CTimeSpan Nesne, 8 bayt olan bir __time64_t yapıda depolanır.

eşlikçi sınıfı, CTimemutlak bir zamanı temsil eder.

CTime ve CTimeSpan sınıfları türetme için tasarlanmamıştır. Sanal işlevler olmadığından, hem hem CTimeSpan de CTime nesnelerinin boyutu tam olarak 8 bayttır. Üye işlevlerin çoğu satır içidir.

kullanma CTimeSpanhakkında daha fazla bilgi için, Çalışma Zamanı Kitaplığı Başvurusu'ndaki Tarih ve Saat ve Saat Yönetimi makalelerine bakın.

Gereksinimler

Üstbilgi:atltime.h

CTimeSpan Karşılaştırma İşleçleri

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

bool operator==(CTimeSpan span) const throw();
bool operator!=(CTimeSpan span) const throw();
bool operator<(CTimeSpan span) const throw();
bool operator>(CTimeSpan span) const throw();
bool operator<=(CTimeSpan span) const throw();
bool operator>=(CTimeSpan span) const throw();

Parametreler

span
Karşılaştırma yapılacak nesne.

İade Değeri

Bu işleçler iki göreli zaman değerini karşılaştırır. Koşulun true olması durumunda döndürürler TRUE ; aksi takdirde FALSEdöndürür.

Örnek

CTimeSpan ts1(100);
CTimeSpan ts2(110);
ATLASSERT((ts1 != ts2) && (ts1 < ts2) && (ts1 <= ts2));   

CTimeSpan::CTimeSpan

CTimeSpan Nesneleri çeşitli şekillerde oluşturur.

CTimeSpan() throw();
CTimeSpan(__time64_t time) throw();

CTimeSpan(
    LONG lDays,
    int nHours,
    int nMins,
    int nSecs) throw();

Parametreler

timeSpanSrc
CTimeSpan Zaten var olan bir nesne.

time
__time64_t Zaman aralığındaki saniye sayısı olan bir zaman değeri.

lDays, nHours, nMins, nSecs
Sırasıyla gün, saat, dakika ve saniye.

Açıklamalar

Tüm bu oluşturucular, belirtilen göreli süreyle başlatılan yeni CTimeSpan bir nesne oluşturur. Her oluşturucu aşağıda açıklanmıştır:

• CTimeSpan( ); Başlatılmamış CTimeSpan bir nesne oluşturur.

• CTimeSpan( const CTimeSpan& );Başka CTimeSpan bir değerden nesne CTimeSpan oluşturur.

• CTimeSpan( __time64_t ); Türünden bir CTimeSpan__time64_t nesne oluşturur.

• CTimeSpan( LONG, int, int, int ); Her bileşen aşağıdaki aralıklarla kısıtlanmış bileşenlerden bir CTimeSpan nesne oluşturur:

  Bileşen	Aralık
  lDays	0-25.000 (yaklaşık)
  nHours	0-23
  nMins	0-59
  nSecs	0-59

Microsoft Foundation Sınıf Kitaplığı'nın Hata Ayıklama sürümünün, bir veya daha fazla zaman günü bileşeni aralık dışındaysa onaylar. Çağırmadan önce bağımsız değişkenleri doğrulamak sizin sorumluluğunuzdadır.

Örnek

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

CTimeSpan::Format

Bu CTimeSpanöğesine karşılık gelen biçimlendirilmiş bir dize oluşturur.

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

Parametreler

pFormat, pszFormat
Biçimlendirme dizesine printf benzer bir biçimlendirme dizesi. Yüzde (%) işaretinden önce gelen biçimlendirme kodları, karşılık gelen CTimeSpan 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:

• %D Bu işlemdeki toplam gün sayısı CTimeSpan

• %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

nID
Bu biçimi tanımlayan dizenin kimliği.

İade Değeri

CString Biçimlendirilmiş zamanı içeren bir nesne.

Açıklamalar

Kitaplığın Hata Ayıklama sürümü, biçimlendirme kodlarını denetler ve kod yukarıdaki listede yoksa onaylar.

Örnek

CTimeSpan ts(3, 1, 5, 12); // 3 days, 1 hour, 5 min, and 12 sec
CString s = ts.Format(_T("Total days: %D, hours: %H, mins: %M, secs: %S"));
ATLASSERT(s == _T("Total days: 3, hours: 01, mins: 05, secs: 12"));   

CTimeSpan::GetDays

Bu CTimeSpaniçindeki tam gün sayısını temsil eden bir değer döndürür.

LONGLONG GetDays() const throw();

İade Değeri

Zaman aralığındaki tam 24 saatlik gün sayısını döndürür. Zaman aralığı negatifse bu değer negatif olabilir.

Açıklamalar

Yaz Saati (DST) uygulamasının şaşırtıcı olabilecek bir sonuç döndürmesine neden GetDays olabileceğini unutmayın. Örneğin, DST etkin GetDays olduğunda 1 Nisan ile 1 Mayıs arasındaki gün sayısını 30 değil 29 olarak bildirir çünkü Nisan'da bir gün bir saat kısaltılır ve dolayısıyla tam gün olarak sayılmaz.

Örnek

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

CTimeSpan::GetHours

Geçerli gündeki saat sayısını (-23 ile 23 arasında) gösteren bir değer döndürür.

LONG GetHours() const throw();

İade Değeri

Geçerli gündeki saat sayısını döndürür. Aralık -23 ile 23 arasındadır.

Örnek

CTimeSpan ts(3, 1, 5, 12); // 3 days, 1 hour, 5 min, and 12 sec
ATLASSERT(ts.GetHours() == 1);
ATLASSERT(ts.GetMinutes() == 5);
ATLASSERT(ts.GetSeconds() == 12);   

CTimeSpan::GetMinutes

Geçerli saat içindeki dakika sayısını (-59 ile 59 arasında) temsil eden bir değer döndürür.

LONG GetMinutes() const throw();

İade Değeri

Geçerli saat içindeki dakika sayısını döndürür. Aralık -59 ile 59 arasındadır.

Örnek

örneğine GetHoursbakın.

CTimeSpan::GetSeconds

Geçerli dakikadaki saniye sayısını (-59 ile 59 arasında) temsil eden bir değer döndürür.

LONG GetSeconds() const throw();

İade Değeri

Geçerli dakikadaki saniye sayısını döndürür. Aralık -59 ile 59 arasındadır.

Örnek

örneğine GetHoursbakın.

CTimeSpan::GetTimeSpan

Nesnesinin CTimeSpan değerini döndürür.

__ time64_t GetTimeSpan() const throw();

İade Değeri

Nesnenin geçerli değerini CTimeSpan döndürür.

CTimeSpan::GetTotalHours

Bu CTimeSpaniçindeki toplam tam saat sayısını temsil eden bir değer döndürür.

LONGLONG GetTotalHours() const throw();

İade Değeri

Bu CTimeSpaniçindeki toplam tam saat sayısını döndürür.

Örnek

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

CTimeSpan::GetTotalMinutes

Bu CTimeSpaniçindeki toplam dakika sayısını temsil eden bir değer döndürür.

LONGLONG GetTotalMinutes() const throw();

İade Değeri

Bu CTimeSpaniçindeki toplam dakika sayısını döndürür.

Örnek

örneğine GetTotalHoursbakın.

CTimeSpan::GetTotalSeconds

Bu CTimeSpaniçindeki toplam saniye sayısını temsil eden bir değer döndürür.

LONGLONG GetTotalSeconds() const throw();

İade Değeri

Bu CTimeSpaniçindeki toplam tam saniye sayısını döndürür.

Örnek

örneğine GetTotalHoursbakın.

CTimeSpan::operator +, CTimeSpan::operator -

Nesneleri ekler ve çıkarır CTimeSpan .

CTimeSpan operator+(CTimeSpan span) const throw();
CTimeSpan operator-(CTimeSpan span) const throw();

Parametreler

span
Nesneye CTimeSpan eklenecek değer.

İade Değeri

CTimeSpan İşlemin sonucunu temsil eden bir nesne.

Açıklamalar

Bu iki işleç, nesneleri birbirine eklemenizi ve birbirinden çıkarmanızı CTimeSpan sağlar.

Örnek

CTimeSpan ts1(3, 1, 5, 12); // 3 days, 1 hour, 5 min, and 12 sec
CTimeSpan ts2(100); // 100 seconds
CTimeSpan ts3 = ts1 + ts2;
ATLASSERT(ts3.GetSeconds() == 52); // 6 mins, 52 secs   

CTimeSpan::operator +=, CTimeSpan::operator -=

Bu CTimeSpanöğesine ve öğesinden bir CTimeSpan nesne ekler ve çıkarır.

CTimeSpan& operator+=(CTimeSpan span) throw();
CTimeSpan& operator-=(CTimeSpan span) throw();

Parametreler

span
Nesneye CTimeSpan eklenecek değer.

İade Değeri

Güncelleştirilmiş CTimeSpan nesne.

Açıklamalar

Bu işleçler, bu öğesine ve öğesinden CTimeSpannesne CTimeSpan eklemenize ve çıkarmanıza olanak sağlar.

Örnek

CTimeSpan ts1(10); // 10 seconds
CTimeSpan ts2(100); // 100 seconds
ts2 -= ts1;
ATLASSERT(ts2.GetTotalSeconds() == 90);   

CTimeSpan::Serialize64

Dekont

Bu yöntem yalnızca MFC projelerinde kullanılabilir.

Bir arşive veya arşivden üye değişkeniyle ilişkili verileri serileştirir.

CArchive& Serialize64(CArchive& ar);

Parametreler

ar
CArchive Güncelleştirmek istediğiniz nesne.

İade Değeri

Güncelleştirilmiş CArchive nesne.

Ayrıca bkz.

asctime, _wasctime
_ftime, _ftime32, _ftime64
gmtime, _gmtime32, _gmtime64
localtime, _localtime32, _localtime64
strftime, wcsftime, _strftime_l, _wcsftime_l
time, _time32, _time64
Hiyerarşi Grafiği
ATL/MFC Paylaşılan Sınıfları