`CTimeSpan` 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.

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

Sözdizimi

class CTimeSpan

Üyeler

Ortak Oluşturucular

Veri Akışı Adı	Açıklama
`CTimeSpan::CTimeSpan`	`CTimeSpan` Nesneleri çeşitli şekillerde oluşturur.

Genel Yöntemler

Veri Akışı Adı	Açıklama
`CTimeSpan::Format`	bir `CTimeSpan` öğesini biçimlendirilmiş bir dizeye dönüştürür.
`CTimeSpan::GetDays`	Bu `CTimeSpan`iç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 `CTimeSpan`içindeki toplam tam saat sayısını temsil eden bir değer döndürür.
`CTimeSpan::GetTotalMinutes`	Bu `CTimeSpan`içindeki toplam dakika sayısını temsil eden bir değer döndürür.
`CTimeSpan::GetTotalSeconds`	Bu `CTimeSpan`iç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

Veri Akışı Adı	Açıklama
`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 CTime de CTimeSpan 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.

Dönüş 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

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.

Dönüş 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();

Dönüş 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();

Dönüş 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();

Dönüş 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();

Dönüş 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();

Dönüş 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();

Dönüş 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();

Dönüş 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();

Dönüş 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.

Dönüş 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.

Dönüş 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`

Not

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.

Dönüş 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ı

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Last updated on 2025-11-07

Aracılığıyla paylaş

CTimeSpan Sınıf

Sözdizimi

Üyeler

Ortak Oluşturucular

Genel Yöntemler

İşleçler

Açıklamalar

Gereksinimler

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

Parametreler

Dönüş Değeri

Örnek

CTimeSpan::CTimeSpan

Parametreler

Açıklamalar

Örnek

CTimeSpan::Format

Parametreler

Dönüş Değeri

Açıklamalar

Örnek

CTimeSpan::GetDays

Dönüş Değeri

Açıklamalar

Örnek

CTimeSpan::GetHours

Dönüş Değeri

Örnek

CTimeSpan::GetMinutes

Dönüş Değeri

Örnek

CTimeSpan::GetSeconds

Dönüş Değeri

Örnek

CTimeSpan::GetTimeSpan

Dönüş Değeri

CTimeSpan::GetTotalHours

Dönüş Değeri

Örnek

CTimeSpan::GetTotalMinutes

Dönüş Değeri

Örnek

CTimeSpan::GetTotalSeconds

Dönüş Değeri

Örnek

CTimeSpan::operator +, CTimeSpan::operator -

Parametreler

Dönüş Değeri

Açıklamalar

Örnek

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

Parametreler

Dönüş Değeri

Açıklamalar

Örnek

CTimeSpan::Serialize64

Parametreler

Dönüş Değeri

Ayrıca bkz.

Geri Bildirim

Ek kaynaklar

`CTimeSpan` Sınıf

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

`CTimeSpan::CTimeSpan`

`CTimeSpan::Format`

`CTimeSpan::GetDays`

`CTimeSpan::GetHours`

`CTimeSpan::GetMinutes`

`CTimeSpan::GetSeconds`

`CTimeSpan::GetTimeSpan`

`CTimeSpan::GetTotalHours`

`CTimeSpan::GetTotalMinutes`

`CTimeSpan::GetTotalSeconds`

`CTimeSpan::operator +`, `CTimeSpan::operator -`

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

`CTimeSpan::Serialize64`