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
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ı, CTime
mutlak 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 CTimeSpan
hakkı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 FALSE
dö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şkaCTimeSpan
bir değerden nesneCTimeSpan
oluşturur.CTimeSpan( __time64_t );
Türünden birCTimeSpan
__time64_t
nesne oluşturur.CTimeSpan( LONG, int, int, int );
Her bileşen aşağıdaki aralıklarla kısıtlanmış bileşenlerden birCTimeSpan
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.
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 CTimeSpan
iç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 GetHours
bakı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 GetHours
bakı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 CTimeSpan
iç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 CTimeSpan
iç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 CTimeSpan
içindeki toplam dakika sayısını temsil eden bir değer döndürür.
LONGLONG GetTotalMinutes() const throw();
Dönüş Değeri
Bu CTimeSpan
içindeki toplam dakika sayısını döndürür.
Örnek
örneğine GetTotalHours
bakın.
CTimeSpan::GetTotalSeconds
Bu CTimeSpan
içindeki toplam saniye sayısını temsil eden bir değer döndürür.
LONGLONG GetTotalSeconds() const throw();
Dönüş Değeri
Bu CTimeSpan
içindeki toplam tam saniye sayısını döndürür.
Örnek
örneğine GetTotalHours
bakı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 CTimeSpan
nesne 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ı