`CFileTime` 클래스

아티클
10/12/2023

이 클래스는 파일과 연결된 날짜 및 시간 값을 관리하는 메서드를 제공합니다.

구문

class CFileTime :  public FILETIME

멤버

Public 생성자

속성	설명
`CFileTime::CFileTime`	생성자입니다.

공용 메서드

이름	설명
`CFileTime::GetCurrentTime`	이 정적 함수를 호출하여 현재 시스템 날짜 및 시간을 나타내는 개체를 검색 `CFileTime` 합니다.
`CFileTime::GetTime`	개체에서 시간을 검색하려면 이 메서드를 호출합니다 `CFileTime` .
`CFileTime::LocalToUTC`	UTC(협정 세계시)에 따라 로컬 파일 시간을 파일 시간으로 변환하려면 이 메서드를 호출합니다.
`CFileTime::SetTime`	개체가 저장한 날짜 및 시간을 설정하려면 이 메서드를 호출합니다 `CFileTime` .
`CFileTime::UTCToLocal`	UTC(협정 세계시)를 기준으로 시간을 로컬 파일 시간으로 변환하려면 이 메서드를 호출합니다.

Public 연산자

속성	설명
`CFileTime::operator -`	이 연산자는 개체 또는 `CFileTimeSpan` 개체에서 `CFileTime` 빼기를 수행하는 데 사용됩니다.
`CFileTime::operator !=`	이 연산자는 같지 않은 두 `CFileTime` 개체를 비교합니다.
`CFileTime::operator +`	이 연산자는 `CFileTimeSpan` 개체에 대해 더하기를 수행하는 데 사용됩니다.
`CFileTime::operator +=`	이 연산자는 `CFileTimeSpan` 개체에 대해 더하기를 수행하고 결과를 현재 개체에 할당하는 데 사용됩니다.
`CFileTime::operator <`	이 연산자는 두 `CFileTime` 개체를 비교하여 더 작은 값을 확인합니다.
`CFileTime::operator <=`	이 연산자는 두 `CFileTime` 개체를 비교하여 더 작거나 같은 값을 확인합니다.
`CFileTime::operator =`	할당 연산자입니다.
`CFileTime::operator -=`	이 연산자는 개체에 대해 `CFileTimeSpan` 빼기를 수행하고 결과를 현재 개체에 할당하는 데 사용됩니다.
`CFileTime::operator ==`	이 연산자는 두 `CFileTime` 개체가 같은지 비교합니다.
`CFileTime::operator >`	이 연산자는 두 `CFileTime` 개체를 비교하여 더 큰 값을 확인합니다.
`CFileTime::operator >=`	이 연산자는 두 `CFileTime` 개체를 비교하여 더 크거나 같은 값을 확인합니다.

공용 상수

속성	설명
`CFileTime::Day`	1일을 구성하는 100나노초 간격의 수를 저장하는 정적 데이터 멤버입니다.
`CFileTime::Hour`	1시간을 구성하는 100나노초 간격의 수를 저장하는 정적 데이터 멤버입니다.
`CFileTime::Millisecond`	1밀리초를 구성하는 100나노초 간격의 수를 저장하는 정적 데이터 멤버입니다.
`CFileTime::Minute`	1분을 구성하는 100나노초 간격의 수를 저장하는 정적 데이터 멤버입니다.
`CFileTime::Second`	1초를 구성하는 100나노초 간격의 수를 저장하는 정적 데이터 멤버입니다.
`CFileTime::Week`	1주일을 구성하는 100나노초 간격의 수를 저장하는 정적 데이터 멤버입니다.

설명

이 클래스는 파일 만들기, 액세스 및 수정과 관련된 날짜 및 시간 값을 관리하는 메서드를 제공합니다. 이 클래스의 메서드와 데이터는 상대 시간 값을 처리하는 개체와 CFileTimeSpan 함께 자주 사용됩니다.

날짜 및 시간 값은 1601년 1월 1일 이후의 100나노초 간격 수를 나타내는 64비트 값으로 저장됩니다. 이 형식은 UTC(협정 세계시) 형식입니다.

계산을 간소화하기 위해 제공되는 정적 const 멤버 변수는 다음과 같습니다.

멤버 변수	100나노초 간격 수
Millisecond	10,000
둘째	밀리초 * 1,000
Minute	초 * 60
Hour	분 * 60
요일	시간 * 24
Week	일 * 7

참고 항목

모든 파일 시스템이 생성 및 마지막 액세스 시간을 기록할 수 있는 것은 아니며 모든 파일 시스템에서 동일한 방식으로 기록하는 것은 아닙니다. 예를 들어 Windows NT FAT 파일 시스템에서 만들기 시간은 10밀리초의 해상도를 가지며, 쓰기 시간은 2초의 해상도를 가지며, 액세스 시간은 1일(액세스 날짜)의 해상도를 가집니다. NTFS에서 액세스 시간은 1시간의 해상도를 줍니다. 또한 FAT는 로컬 시간에 디스크의 시간을 기록하지만 NTFS는 디스크의 시간을 UTC로 기록합니다. 자세한 내용은 파일 시간을 참조 하세요.

상속 계층

FILETIME
└ CFileTime

요구 사항

헤더: atltime.h

`CFileTime::CFileTime`

생성자입니다.

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

매개 변수

ft
구조체입니다 FILETIME .

nTime
64비트 값으로 표현된 날짜 및 시간입니다.

설명

개체는 CFileTime 구조체의 FILETIME 기존 날짜 및 시간을 사용하여 만들거나 64비트 값(로컬 또는 UTC(협정 세계시) 시간 형식으로 표현될 수 있습니다. 기본 생성자는 시간을 0으로 설정합니다.

`CFileTime::Day`

1일을 구성하는 100나노초 간격의 수를 저장하는 정적 데이터 멤버입니다.

static const ULONGLONG Day = Hour* 24;

예시

CFileTime::Millisecond에 대한 예를 참조하세요.

`CFileTime::GetCurrentTime`

이 정적 함수를 호출하여 현재 시스템 날짜 및 시간을 나타내는 개체를 검색 CFileTime 합니다.

static CFileTime GetCurrentTime() throw();

반환 값

현재 시스템 날짜 및 시간을 UTC(협정 세계시) 형식으로 반환합니다.

예시

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

`CFileTime::GetTime`

개체에서 시간을 검색하려면 이 메서드를 호출합니다 CFileTime .

ULONGLONG GetTime() const throw();

반환 값

날짜와 시간을 64비트 숫자로 반환하며, 로컬 또는 UTC(협정 세계시) 형식일 수 있습니다.

`CFileTime::Hour`

1시간을 구성하는 100나노초 간격의 수를 저장하는 정적 데이터 멤버입니다.

static const ULONGLONG Hour = Minute* 60;

예시

CFileTime::Millisecond에 대한 예를 참조하세요.

`CFileTime::LocalToUTC`

UTC(협정 세계시)에 따라 로컬 파일 시간을 파일 시간으로 변환하려면 이 메서드를 호출합니다.

CFileTime LocalToUTC() const throw();

반환 값

CFileTime 시간을 UTC 형식으로 포함하는 개체를 반환합니다.

예시

CFileTime::UTCToLocal에 대한 예를 참조하세요.

`CFileTime::Millisecond`

1밀리초를 구성하는 100나노초 간격의 수를 저장하는 정적 데이터 멤버입니다.

static const ULONGLONG Millisecond = 10000;

예시

// 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`

1분을 구성하는 100나노초 간격의 수를 저장하는 정적 데이터 멤버입니다.

static const ULONGLONG Minute = Second* 60;

예시

CFileTime::Millisecond에 대한 예를 참조하세요.

`CFileTime::operator -`

이 연산자는 개체 또는 CFileTimeSpan 개체에서 CFileTime 빼기를 수행하는 데 사용됩니다.

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

매개 변수

span
CFileTimeSpan 개체입니다.

ft
CFileTime 개체입니다.

반환 값

CFileTime 두 개체 간의 시간 차이 결과를 나타내는 개체 또는 CFileTimeSpan 개체를 반환합니다.

`CFileTime::operator !=`

이 연산자는 같지 않은 두 CFileTime 개체를 비교합니다.

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

매개 변수

ft
비교할 CFileTime 개체입니다.

반환 값

비교할 항목이 개체FALSE와 같지 CFileTime 않으면 반환 TRUE 합니다.

`CFileTime::operator +`

이 연산자는 CFileTimeSpan 개체에 대해 더하기를 수행하는 데 사용됩니다.

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

매개 변수

span
CFileTimeSpan 개체입니다.

반환 값

CFileTime 원래 시간의 결과와 상대 시간을 나타내는 개체를 반환합니다.

`CFileTime::operator +=`

이 연산자는 CFileTimeSpan 개체에 대해 더하기를 수행하고 결과를 현재 개체에 할당하는 데 사용됩니다.

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

매개 변수

span
CFileTimeSpan 개체입니다.

반환 값

원래 시간과 상대 시간의 결과를 나타내는 업데이트 CFileTime 된 개체를 반환합니다.

`CFileTime::operator <`

이 연산자는 두 CFileTime 개체를 비교하여 더 작은 값을 확인합니다.

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

매개 변수

ft
비교할 CFileTime 개체입니다.

반환 값

TRUE 첫 번째 개체가 두 번째 개체보다 작으면 반환하고, FALSE 그렇지 않으면 반환합니다.

예시

// 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 <>=`

이 연산자는 두 CFileTime 개체를 비교하여 더 작거나 같은 값을 확인합니다.

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

매개 변수

ft
비교할 CFileTime 개체입니다.

반환 값

첫 번째 개체가 이전 시간보다 작거나 두 번째 개체와 같은 경우를 반환하고, 그렇지 않으면 FALSE반환 TRUE 합니다.

`CFileTime::operator =`

할당 연산자입니다.

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

매개 변수

ft
CFileTime 새 시간과 날짜를 포함하는 개체입니다.

반환 값

업데이트 CFileTime 된 개체를 반환합니다.

`CFileTime::operator -=`

이 연산자는 개체에 대해 CFileTimeSpan 빼기를 수행하고 결과를 현재 개체에 할당하는 데 사용됩니다.

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

매개 변수

span
CFileTimeSpan 뺄 상대 시간이 들어 있는 개체입니다.

반환 값

업데이트 CFileTime 된 개체를 반환합니다.

`CFileTime::operator ==`

이 연산자는 두 CFileTime 개체가 같은지 비교합니다.

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

매개 변수

ft
CFileTime 비교할 개체입니다.

반환 값

개체가 같으면 반환하고, 그렇지 않으면 FALSE반환 TRUE 합니다.

`CFileTime::operator >`

이 연산자는 두 CFileTime 개체를 비교하여 더 큰 값을 확인합니다.

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

매개 변수

ft
비교할 CFileTime 개체입니다.

반환 값

첫 번째 개체가 두 번째 개체보다 크면(이후 시간) 반환하고, 그렇지 않으면 FALSE반환 TRUE 합니다.

`CFileTime::operator >=`

이 연산자는 두 CFileTime 개체를 비교하여 더 크거나 같은 값을 확인합니다.

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

매개 변수

ft
비교할 CFileTime 개체입니다.

반환 값

첫 번째 개체가 시간 후반보다 크거나 두 번째 개체와 같은지 여부를 반환 TRUE 합니다. 그렇지 않으면 FALSE반환합니다.

`CFileTime::Second`

1일을 구성하는 100나노초 간격의 수를 저장하는 정적 데이터 멤버입니다.

static const ULONGLONG Second = Millisecond* 1000;

예시

CFileTime::Millisecond에 대한 예를 참조하세요.

`CFileTime::SetTime`

개체가 저장한 날짜 및 시간을 설정하려면 이 메서드를 호출합니다 CFileTime .

void SetTime(ULONGLONG nTime) throw();

매개 변수

nTime
날짜와 시간을 나타내는 64비트 값(로컬 또는 UTC(협정 세계시) 형식입니다.

`CFileTime::UTCToLocal`

UTC(협정 세계시)를 기준으로 시간을 로컬 파일 시간으로 변환하려면 이 메서드를 호출합니다.

CFileTime UTCToLocal() const throw();

반환 값

CFileTime 시간을 현지 파일 시간 형식으로 포함하는 개체를 반환합니다.

예시

// 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`

1주일을 구성하는 100나노초 간격의 수를 저장하는 정적 데이터 멤버입니다.

static const ULONGLONG Week = Day* 7;

예시

CFileTime::Millisecond에 대한 예를 참조하세요.

참고 항목

FILETIME
CFileTimeSpan 클래스
계층 구조 차트
ATL/MFC 공유 클래스

다음을 통해 공유

CFileTime 클래스

구문

멤버

Public 생성자

공용 메서드

Public 연산자

공용 상수

설명

상속 계층

요구 사항

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

예시

참고 항목

피드백

추가 리소스

`CFileTime` 클래스

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