`CFileTime` sınıfı

Makale
08/03/2024

Bu sınıf, bir dosyayla ilişkili tarih ve saat değerlerini yönetmek için yöntemler sağlar.

Sözdizimi

class CFileTime :  public FILETIME

Üyeler

Ortak oluşturucular

Veri Akışı Adı	Açıklama
`CFileTime::CFileTime`	Oluşturucu.

Genel yöntemler

Veri Akışı Adı	Açıklama
`CFileTime::GetCurrentTime`	Geçerli sistem tarih ve saatini temsil eden bir `CFileTime` nesneyi almak için bu statik işlevi çağırın.
`CFileTime::GetTime`	nesnesinden saati almak için bu yöntemi çağırın `CFileTime` .
`CFileTime::LocalToUTC`	Yerel bir dosya saatini Eşgüdümlü Evrensel Saat'e (UTC) göre bir dosya zamanına dönüştürmek için bu yöntemi çağırın.
`CFileTime::SetTime`	Nesnesi tarafından depolanan tarih ve saati ayarlamak için bu yöntemi çağırın `CFileTime` .
`CFileTime::UTCToLocal`	Eşgüdümlü Evrensel Saat'e (UTC) göre saati yerel dosya saatine dönüştürmek için bu yöntemi çağırın.

Genel işleçler

Veri Akışı Adı	Açıklama
`CFileTime::operator -`	Bu işleç, bir `CFileTime` veya `CFileTimeSpan` nesnesi üzerinde çıkarma gerçekleştirmek için kullanılır.
`CFileTime::operator !=`	Bu işleç, eşitsizlik için iki `CFileTime` nesneyi karşılaştırır.
`CFileTime::operator +`	Bu işleç, bir `CFileTimeSpan` nesne üzerinde toplama gerçekleştirmek için kullanılır.
`CFileTime::operator +=`	Bu işleç, bir `CFileTimeSpan` nesne üzerinde toplama gerçekleştirmek ve sonucu geçerli nesneye atamak için kullanılır.
`CFileTime::operator <`	Bu işleç, daha azını belirlemek için iki `CFileTime` nesneyi karşılaştırır.
`CFileTime::operator <=`	Bu işleç, eşitliği veya daha azını belirlemek için iki `CFileTime` nesneyi karşılaştırır.
`CFileTime::operator =`	Atama işleci.
`CFileTime::operator -=`	Bu işleç, bir `CFileTimeSpan` nesne üzerinde çıkarma gerçekleştirmek ve sonucu geçerli nesneye atamak için kullanılır.
`CFileTime::operator ==`	Bu işleç eşitlik için iki `CFileTime` nesneyi karşılaştırır.
`CFileTime::operator >`	Bu işleç, daha büyük olanını belirlemek için iki `CFileTime` nesneyi karşılaştırır.
`CFileTime::operator >=`	Bu işleç, eşitliği veya daha büyük olanını belirlemek için iki `CFileTime` nesneyi karşılaştırır.

Genel sabitler

Veri Akışı Adı	Açıklama
`CFileTime::Day`	Bir günü oluşturan 100 nanosaniyelik aralıkların sayısını depolayan statik veri üyesi.
`CFileTime::Hour`	Bir saati oluşturan 100 nanosaniyelik aralıkların sayısını depolayan statik veri üyesi.
`CFileTime::Millisecond`	Bir milisaniyeyi oluşturan 100 nanosaniyelik aralıkların sayısını depolayan statik veri üyesi.
`CFileTime::Minute`	Bir dakikayı oluşturan 100 nanosaniyelik aralıkların sayısını depolayan statik veri üyesi.
`CFileTime::Second`	Bir saniyeyi oluşturan 100 nanosaniyelik aralıkların sayısını depolayan statik veri üyesi.
`CFileTime::Week`	Bir haftayı oluşturan 100 nanosaniyelik aralıkların sayısını depolayan statik veri üyesi.

Açıklamalar

Bu sınıf, dosyaların oluşturulması, erişimi ve değiştirilmesiyle ilişkili tarih ve saat değerlerini yönetmek için yöntemler sağlar. Bu sınıfın yöntemleri ve verileri genellikle göreli zaman değerleriyle ilgilenen nesnelerle CFileTimeSpan birlikte kullanılır.

Tarih ve saat değeri, 1 Ocak 1601'den bu yana 100 nanosaniyelik aralıkların sayısını temsil eden 64 bit değer olarak depolanır. Bu biçim Eşgüdümlü Evrensel Saat (UTC) biçimidir.

Hesaplamaları basitleştirmek için aşağıdaki statik sabit üye değişkenleri sağlanır:

Üye değişkeni	100 nanosaniyelik aralık sayısı
Milisaniye	Kategori 10,000
Second	Milisaniye * 1.000
Dakika	İkinci * 60
Saat	Dakika * 60
Gün	Saat * 24
Hafta	Gün * 7

Not

Tüm dosya sistemleri oluşturma ve son erişim zamanını kaydedemez ve tüm dosya sistemleri bunları aynı şekilde kaydedemez. Örneğin, Windows NT FAT dosya sisteminde oluşturma süresi 10 milisaniye, yazma süresi 2 saniye ve erişim süresi 1 günlük (erişim tarihi) çözünürlüğe sahiptir. NTFS'de erişim süresi 1 saatlik bir çözünürlüğe sahiptir. Ayrıca FAT, diskteki saatleri yerel saatle kaydeder ancak NTFS, UTC'de diskteki zamanları kaydeder. Daha fazla bilgi için bkz . Dosya süreleri.

Devralma hiyerarşisi

FILETIME
└ CFileTime

Gereksinimler

Üst bilgi: atltime.h

`CFileTime::CFileTime`

Oluşturucu.

CFileTime() throw();
CFileTime(const FILETIME& ft) throw();
CFileTime(ULONGLONG nTime) throw();

Parametreler

ft
Bir FILETIME yapı.

nTime
64 bit değer olarak ifade edilen tarih ve saat.

Açıklamalar

Nesne CFileTime , bir FILETIME yapıdaki mevcut tarih ve saat kullanılarak oluşturulabilir veya 64 bitlik bir değer (yerel veya Eşgüdümlü Evrensel Saat (UTC) saat biçimlerinde) olarak ifade edilebilir. Varsayılan oluşturucu saati 0 olarak ayarlar.

`CFileTime::Day`

Bir günü oluşturan 100 nanosaniyelik aralıkların sayısını depolayan statik veri üyesi.

static const ULONGLONG Day = Hour* 24;

Örnek

örneğine CFileTime::Millisecondbakın.

`CFileTime::GetCurrentTime`

Geçerli sistem tarih ve saatini temsil eden bir CFileTime nesneyi almak için bu statik işlevi çağırın.

static CFileTime GetCurrentTime() throw();

Dönüş değeri

Geçerli sistem tarih ve saatini Eşgüdümlü Evrensel Saat (UTC) biçiminde döndürür.

Örnek

// Retrieve the current time
CFileTime myFT;
myFT = CFileTime::GetCurrentTime();

`CFileTime::GetTime`

nesnesinden saati almak için bu yöntemi çağırın CFileTime .

ULONGLONG GetTime() const throw();

Dönüş değeri

Tarih ve saati, yerel veya Eşgüdümlü Evrensel Saat (UTC) biçiminde olabilecek 64 bitlik bir sayı olarak döndürür.

`CFileTime::Hour`

Bir saati oluşturan 100 nanosaniyelik aralıkların sayısını depolayan statik veri üyesi.

static const ULONGLONG Hour = Minute* 60;

Örnek

örneğine CFileTime::Millisecondbakın.

`CFileTime::LocalToUTC`

Yerel bir dosya saatini Eşgüdümlü Evrensel Saat'e (UTC) göre bir dosya zamanına dönüştürmek için bu yöntemi çağırın.

CFileTime LocalToUTC() const throw();

Dönüş değeri

UTC biçiminde saati içeren bir CFileTime nesne döndürür.

Örnek

örneğine CFileTime::UTCToLocalbakın.

`CFileTime::Millisecond`

Bir milisaniyeyi oluşturan 100 nanosaniyelik aralıkların sayısını depolayan statik veri üyesi.

static const ULONGLONG Millisecond = 10000;

Örnek

// Calculate the difference between two times
CFileTime myFT1, myFT2;
CFileTimeSpan myFTS;

// Get the first time
myFT1 = CFileTime::GetCurrentTime();

// Pause for a moment
UINT randVal;
rand_s(&randVal);
Sleep(randVal % 10000);

// Get the second time
myFT2 = CFileTime::GetCurrentTime();

// Calculate the time difference
myFTS = myFT2 - myFT1;

// Measure the difference
if (myFTS.GetTimeSpan() < CFileTime::Minute)
   printf_s("Less than a minute passed\n");
else
   printf_s("A minute or more passed\n");

if (myFTS.GetTimeSpan() < CFileTime::Second)
   printf_s("Less than a second passed\n");
else
   printf_s("A second or more passed\n");

if (myFTS.GetTimeSpan() < CFileTime::Millisecond)
   printf_s("Less than a millisecond passed\n");
else
   printf_s("A millisecond or more passed\n");

`CFileTime::Minute`

Bir dakikayı oluşturan 100 nanosaniyelik aralıkların sayısını depolayan statik veri üyesi.

static const ULONGLONG Minute = Second* 60;

Örnek

örneğine CFileTime::Millisecondbakın.

`CFileTime::operator -`

Bu işleç, bir CFileTime veya CFileTimeSpan nesnesi üzerinde çıkarma gerçekleştirmek için kullanılır.

CFileTime operator-(CFileTimeSpan span) const throw();
CFileTimeSpan operator-(CFileTime ft) const throw();

Parametreler

span
Bir CFileTimeSpan nesnesi.

ft
Bir CFileTime nesnesi.

Dönüş değeri

CFileTime İki nesne arasındaki zaman farkının sonucunu temsil eden bir CFileTimeSpan nesne veya nesne döndürür.

`CFileTime::operator !=`

Bu işleç, eşitsizlik için iki CFileTime nesneyi karşılaştırır.

bool operator!=(CFileTime ft) const throw();

Parametreler

ft
Karşılaştırılacak CFileTime nesne.

Dönüş değeri

Karşılaştırılan öğenin nesneye CFileTime eşit olmadığı durumlarda döndürürTRUE.FALSE

`CFileTime::operator +`

Bu işleç, bir CFileTimeSpan nesne üzerinde toplama gerçekleştirmek için kullanılır.

CFileTime operator+(CFileTimeSpan span) const throw();

Parametreler

span
Bir CFileTimeSpan nesnesi.

Dönüş değeri

CFileTime Özgün saatin sonucunu ve göreli zamanı temsil eden bir nesne döndürür.

`CFileTime::operator +=`

Bu işleç, bir CFileTimeSpan nesne üzerinde toplama gerçekleştirmek ve sonucu geçerli nesneye atamak için kullanılır.

CFileTime& operator+=(CFileTimeSpan span) throw();

Parametreler

span
Bir CFileTimeSpan nesnesi.

Dönüş değeri

Özgün saatin sonucunu ve göreli zamanı temsil eden güncelleştirilmiş CFileTime nesneyi döndürür.

`CFileTime::operator <`

Bu işleç, daha azını belirlemek için iki CFileTime nesneyi karşılaştırır.

bool operator<(CFileTime ft) const throw();

Parametreler

ft
Karşılaştırılacak CFileTime nesne.

Dönüş değeri

İlk nesne ikinci nesneden daha azsa (daha erkense) döndürür TRUE , FALSE aksi takdirde.

Örnek

// Test for one time less than another
// Declare the CFileType objects
CFileTime myFT1, myFT2;

// Obtain the first time value
myFT1 = CFileTime::GetCurrentTime();

// Pause for a moment...
Sleep(1000);

// Obtain the second time value
myFT2 = CFileTime::GetCurrentTime();

// Perform the comparison
if (myFT1 < myFT2)
   _tprintf_s(_T("Time is going in the correct direction.\n"));
else
   _tprintf_s(_T("Oh dear. Time is going backwards.\n"));

`CFileTime::operator <>=`

Bu işleç, eşitliği veya daha azını belirlemek için iki CFileTime nesneyi karşılaştırır.

bool operator<=(CFileTime ft) const throw();

Parametreler

ft
Karşılaştırılacak CFileTime nesne.

Dönüş değeri

İlk nesnenin değerinden küçük (daha erken) veya ikinci nesneye eşit olması durumunda döndürür TRUE . Aksi takdirde FALSE.

`CFileTime::operator =`

Atama işleci.

CFileTime& operator=(const FILETIME& ft) throw();

Parametreler

ft
CFileTime Yeni saat ve tarihi içeren bir nesne.

Dönüş değeri

Güncelleştirilmiş CFileTime nesneyi döndürür.

`CFileTime::operator -=`

Bu işleç, bir CFileTimeSpan nesne üzerinde çıkarma gerçekleştirmek ve sonucu geçerli nesneye atamak için kullanılır.

CFileTime& operator-=(CFileTimeSpan span) throw();

Parametreler

span
CFileTimeSpan Çıkarılması gereken göreli zamanı içeren bir nesne.

Dönüş değeri

Güncelleştirilmiş CFileTime nesneyi döndürür.

`CFileTime::operator ==`

Bu işleç eşitlik için iki CFileTime nesneyi karşılaştırır.

bool operator==(CFileTime ft) const throw();

Parametreler

ft
Karşılaştıracak CFileTime nesne.

Dönüş değeri

Nesneler eşitse, aksi takdirde FALSEdöndürürTRUE.

`CFileTime::operator >`

Bu işleç, daha büyük olanını belirlemek için iki CFileTime nesneyi karşılaştırır.

bool operator>(CFileTime ft) const throw();

Parametreler

ft
Karşılaştırılacak CFileTime nesne.

Dönüş değeri

İlk nesne ikinci nesneden büyükse (daha sonra), değilse FALSEdöndürürTRUE.

`CFileTime::operator >=`

Bu işleç, eşitliği veya daha büyük olanını belirlemek için iki CFileTime nesneyi karşılaştırır.

bool operator>=(CFileTime ft) const throw();

Parametreler

ft
Karşılaştırılacak CFileTime nesne.

Dönüş değeri

İlk nesnenin değerinden büyük (daha sonra) veya ikinci nesneye eşit olması durumunda döndürür TRUE ; aksi takdirde FALSE.

`CFileTime::Second`

Bir günü oluşturan 100 nanosaniyelik aralıkların sayısını depolayan statik veri üyesi.

static const ULONGLONG Second = Millisecond* 1000;

Örnek

örneğine CFileTime::Millisecondbakın.

`CFileTime::SetTime`

Nesnesi tarafından depolanan tarih ve saati ayarlamak için bu yöntemi çağırın CFileTime .

void SetTime(ULONGLONG nTime) throw();

Parametreler

nTime
Tarih ve saati yerel veya Eşgüdümlü Evrensel Saat (UTC) biçiminde temsil eden 64 bit değer.

`CFileTime::UTCToLocal`

Eşgüdümlü Evrensel Saat'e (UTC) göre saati yerel dosya saatine dönüştürmek için bu yöntemi çağırın.

CFileTime UTCToLocal() const throw();

Dönüş değeri

Yerel dosya saat biçiminde saati içeren bir CFileTime nesne döndürür.

Örnek

// Convert a UTC time to local file time format
CFileTime myUTC_FT, myL_FT;
// Get system time (in UTC format)
myUTC_FT = CFileTime::GetCurrentTime();
// Convert to local file time
myL_FT = myUTC_FT.UTCToLocal();

`CFileTime::Week`

Bir haftayı oluşturan 100 nanosaniyelik aralıkların sayısını depolayan statik veri üyesi.

static const ULONGLONG Week = Day* 7;

Örnek

örneğine CFileTime::Millisecondbakın.

Ayrıca bkz.

FILETIME
CFileTimeSpan sınıfı
Hiyerarşi grafiği
ATL/MFC paylaşılan sınıfları

Aracılığıyla paylaş

CFileTime sınıfı

Sözdizimi

Üyeler

Ortak oluşturucular

Genel yöntemler

Genel işleçler

Genel sabitler

Açıklamalar

Devralma hiyerarşisi

Gereksinimler

CFileTime::CFileTime

Parametreler

Açıklamalar

CFileTime::Day

Örnek

CFileTime::GetCurrentTime

Dönüş değeri

Örnek

CFileTime::GetTime

Dönüş değeri

CFileTime::Hour

Örnek

CFileTime::LocalToUTC

Dönüş değeri

Örnek

CFileTime::Millisecond

Örnek

CFileTime::Minute

Örnek

CFileTime::operator -

Parametreler

Dönüş değeri

CFileTime::operator !=

Parametreler

Dönüş değeri

CFileTime::operator +

Parametreler

Dönüş değeri

CFileTime::operator +=

Parametreler

Dönüş değeri

CFileTime::operator <

Parametreler

Dönüş değeri

Örnek

CFileTime::operator <>=

Parametreler

Dönüş değeri

CFileTime::operator =

Parametreler

Dönüş değeri

CFileTime::operator -=

Parametreler

Dönüş değeri

CFileTime::operator ==

Parametreler

Dönüş değeri

CFileTime::operator >

Parametreler

Dönüş değeri

CFileTime::operator >=

Parametreler

Dönüş değeri

CFileTime::Second

Örnek

CFileTime::SetTime

Parametreler

CFileTime::UTCToLocal

Dönüş değeri

Örnek

CFileTime::Week

Örnek

Ayrıca bkz.

Geri Bildirim

Ek kaynaklar

`CFileTime` sınıfı

`CFileTime::CFileTime`

`CFileTime::Day`

`CFileTime::GetCurrentTime`

`CFileTime::GetTime`

`CFileTime::Hour`

`CFileTime::LocalToUTC`

`CFileTime::Millisecond`

`CFileTime::Minute`

`CFileTime::operator -`

`CFileTime::operator !=`

`CFileTime::operator +`

`CFileTime::operator +=`

`CFileTime::operator <`

`CFileTime::operator <>=`

`CFileTime::operator =`

`CFileTime::operator -=`

`CFileTime::operator ==`

`CFileTime::operator >`

`CFileTime::operator >=`

`CFileTime::Second`

`CFileTime::SetTime`

`CFileTime::UTCToLocal`

`CFileTime::Week`