`CTimeSpan` 수업

아티클
10/12/2023

시간 범위의 초 수로 내부적으로 저장되는 시간입니다.

구문

class CTimeSpan

멤버

공용 생성자

속성	설명
`CTimeSpan::CTimeSpan`	다양한 방법으로 개체를 생성합니다 `CTimeSpan` .

공용 메서드

이름	설명
`CTimeSpan::Format`	형식이 `CTimeSpan` 지정된 문자열로 변환합니다.
`CTimeSpan::GetDays`	이 `CTimeSpan`날짜의 전체 일 수를 나타내는 값을 반환합니다.
`CTimeSpan::GetHours`	현재 날짜의 시간(-23~23)을 나타내는 값을 반환합니다.
`CTimeSpan::GetMinutes`	현재 시간(-59-59)의 분 수를 나타내는 값을 반환합니다.
`CTimeSpan::GetSeconds`	현재 분(-59~59)의 초 수를 나타내는 값을 반환합니다.
`CTimeSpan::GetTimeSpan`	개체의 `CTimeSpan` 값을 반환합니다.
`CTimeSpan::GetTotalHours`	이 `CTimeSpan`작업의 총 완료 시간을 나타내는 값을 반환합니다.
`CTimeSpan::GetTotalMinutes`	이 `CTimeSpan`항목의 총 완료 시간(분)을 나타내는 값을 반환합니다.
`CTimeSpan::GetTotalSeconds`	이 `CTimeSpan`항목의 총 완료 시간(초)을 나타내는 값을 반환합니다.
`CTimeSpan::Serialize64`	보관 파일에서 데이터를 직렬화합니다.

연산자

속성	설명
`operator + -`	개체를 추가하고 뺍니다 `CTimeSpan` .
`operator += -=`	개체를 `CTimeSpan` 이 `CTimeSpan`개체에 추가 및 뺍니다.
`operator == < etc.`	두 상대 시간 값을 비교합니다.

설명

CTimeSpan 에는 기본 클래스가 없습니다.

CTimeSpan 함수는 초를 일, 시간, 분 및 초의 다양한 조합으로 변환합니다.

개체는 CTimeSpan 8바이트인 구조체에 저장 __time64_t 됩니다.

도우미 클래스는 CTime절대 시간을 나타냅니다.

및 CTimeSpan 클래스는 CTime 파생용으로 설계되지 않았습니다. 가상 함수가 없으므로 두 개체의 CTime CTimeSpan 크기는 정확히 8바이트입니다. 대부분의 멤버 함수는 인라인입니다.

사용에 CTimeSpan대한 자세한 내용은 런타임 라이브러리 참조의 날짜 및 시간 및 시간 관리 문서를 참조하세요.

요구 사항

머리글: atltime.h

`CTimeSpan` 비교 연산자

비교 연산자입니다.

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();

매개 변수

span
비교할 개체입니다.

Return Value

이러한 연산자는 두 개의 상대 시간 값을 비교합니다. 조건이 true이면 반환되고, 그렇지 않으면 FALSE반환 TRUE 됩니다.

예시

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

`CTimeSpan::CTimeSpan`

다양한 방법으로 개체를 생성합니다 CTimeSpan .

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

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

매개 변수

timeSpanSrc
CTimeSpan 이미 존재하는 개체입니다.

time
__time64_t 시간 범위의 초 수인 시간 값입니다.

lDays, nHours, nMinsnSecs
각각 일, 시간, 분 및 초입니다.

설명

이러한 모든 생성자는 지정된 상대 시간으로 초기화된 새 CTimeSpan 개체를 만듭니다. 각 생성자는 아래에 설명되어 있습니다.

CTimeSpan( ); 초기화 CTimeSpan 되지 않은 개체를 생성합니다.
CTimeSpan( const CTimeSpan& );다른 CTimeSpan 값에서 개체를 CTimeSpan 생성합니다.
CTimeSpan( __time64_t ); 형식에서 CTimeSpan 개체를 __time64_t 생성합니다.
CTimeSpan( LONG, int, int, int );CTimeSpan 각 구성 요소가 다음 범위로 제한되는 구성 요소에서 개체를 생성합니다.

구성 요소 범위

lDays 0-25,000(대략)

nHours 0-23

nMins 0-59

nSecs 0-59

구성 요소	범위
lDays	0-25,000(대략)
nHours	0-23
nMins	0-59
nSecs	0-59

Microsoft Foundation 클래스 라이브러리의 디버그 버전은 하나 이상의 시간-일 구성 요소가 범위를 벗어나면 어설션됩니다. 호출하기 전에 인수의 유효성을 검사하는 것은 사용자의 책임입니다.

예시

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`

이에 CTimeSpan해당하는 형식이 지정된 문자열을 생성합니다.

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

매개 변수

pFormat, pszFormat
서식 문자열과 printf 유사한 서식 문자열입니다. 백분율(%) 기호 앞에 오는 서식 지정 코드는 해당 CTimeSpan 구성 요소로 바뀝니다. 서식 문자열의 다른 문자는 반환된 문자열에 변경되지 않고 복사됩니다. 서식 코드 Format 의 값과 의미는 다음과 같습니다.

%D 총 일수 CTimeSpan
%H 현재 날짜의 시간
%M 현재 시간의 분
%S 현재 분 단위의 초
%% 백분율 기호

nID
이 형식을 식별하는 문자열의 ID입니다.

Return Value

CString 서식이 지정된 시간을 포함하는 개체입니다.

설명

라이브러리의 디버그 버전은 서식 코드를 확인하고 코드가 위의 목록에 없는 경우 어설션합니다.

예시

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`

이 CTimeSpan날짜의 전체 일 수를 나타내는 값을 반환합니다.

LONGLONG GetDays() const throw();

Return Value

시간 범위의 전체 24시간 일 수를 반환합니다. 시간 범위가 음수이면 이 값이 음수일 수 있습니다.

설명

DST(일광 절약 시간)는 GetDays 잠재적으로 놀라운 결과를 반환할 수 있습니다. 예를 들어 DST가 적용되는 GetDays 경우 4월 1일부터 5월 1일 사이의 일 수를 30이 아닌 29로 보고합니다. 4월의 하루는 1시간 단축되므로 전체 일로 계산되지 않기 때문입니다.

예시

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

`CTimeSpan::GetHours`

현재 날짜의 시간(-23~23)을 나타내는 값을 반환합니다.

LONG GetHours() const throw();

Return Value

현재 날짜의 시간 수를 반환합니다. 범위는 -23~23입니다.

예시

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`

현재 시간(-59-59)의 분 수를 나타내는 값을 반환합니다.

LONG GetMinutes() const throw();

Return Value

현재 시간의 분 수를 반환합니다. 범위는 -59~59입니다.

예시

GetHours에 대한 예를 참조하세요.

`CTimeSpan::GetSeconds`

현재 분(-59~59)의 초 수를 나타내는 값을 반환합니다.

LONG GetSeconds() const throw();

Return Value

현재 분의 초 수를 반환합니다. 범위는 -59~59입니다.

예시

GetHours에 대한 예를 참조하세요.

`CTimeSpan::GetTimeSpan`

개체의 CTimeSpan 값을 반환합니다.

__ time64_t GetTimeSpan() const throw();

Return Value

개체의 CTimeSpan 현재 값을 반환합니다.

`CTimeSpan::GetTotalHours`

이 CTimeSpan작업의 총 완료 시간을 나타내는 값을 반환합니다.

LONGLONG GetTotalHours() const throw();

Return Value

이 CTimeSpan작업의 총 완료 시간 수를 반환합니다.

예시

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`

이 CTimeSpan항목의 총 완료 시간(분)을 나타내는 값을 반환합니다.

LONGLONG GetTotalMinutes() const throw();

Return Value

이 CTimeSpan작업의 총 완료 시간(분)을 반환합니다.

예시

GetTotalHours에 대한 예를 참조하세요.

`CTimeSpan::GetTotalSeconds`

이 CTimeSpan항목의 총 완료 시간(초)을 나타내는 값을 반환합니다.

LONGLONG GetTotalSeconds() const throw();

Return Value

이 CTimeSpan항목의 총 완료 시간(초)을 반환합니다.

예시

GetTotalHours에 대한 예를 참조하세요.

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

개체를 추가하고 뺍니다 CTimeSpan .

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

매개 변수

span
개체에 추가할 값입니다 CTimeSpan .

Return Value

CTimeSpan 작업의 결과를 나타내는 개체입니다.

설명

이 두 연산자를 사용하면 서로 개체를 추가하고 빼 CTimeSpan 는 데 사용할 수 있습니다.

예시

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

개체를 CTimeSpan 이 CTimeSpan개체에 추가 및 뺍니다.

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

매개 변수

span
개체에 추가할 값입니다 CTimeSpan .

Return Value

업데이트 CTimeSpan 된 개체입니다.

설명

이러한 연산자를 사용하면 개체를 이 개체와 빼 CTimeSpan 고 추가할 수 CTimeSpan있습니다.

예시

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

`CTimeSpan::Serialize64`

참고 항목

이 메서드는 MFC 프로젝트에서만 사용할 수 있습니다.

보관 파일에서 멤버 변수와 연결된 데이터를 직렬화합니다.

CArchive& Serialize64(CArchive& ar);

매개 변수

ar
CArchive 업데이트하려는 개체입니다.

Return Value

업데이트 CArchive 된 개체입니다.

참고 항목

asctime, _wasctime
_ftime, , _ftime32_ftime64
gmtime, , _gmtime32_gmtime64
localtime, , _localtime32_localtime64
strftime, wcsftime, _strftime_l_wcsftime_l
time, , _time32_time64
계층 구조 차트
ATL/MFC 공유 클래스

다음을 통해 공유

CTimeSpan 수업

구문

멤버

공용 생성자

공용 메서드

연산자

설명

요구 사항

CTimeSpan 비교 연산자

매개 변수

Return Value

예시

CTimeSpan::CTimeSpan

매개 변수

설명

예시

CTimeSpan::Format

매개 변수

Return Value

설명

예시

CTimeSpan::GetDays

Return Value

설명

예시

CTimeSpan::GetHours

Return Value

예시

CTimeSpan::GetMinutes

Return Value

예시

CTimeSpan::GetSeconds

Return Value

예시

CTimeSpan::GetTimeSpan

Return Value

CTimeSpan::GetTotalHours

Return Value

예시

CTimeSpan::GetTotalMinutes

Return Value

예시

CTimeSpan::GetTotalSeconds

Return Value

예시

CTimeSpan::operator +, CTimeSpan::operator -

매개 변수

Return Value

설명

예시

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

매개 변수

Return Value

설명

예시

CTimeSpan::Serialize64

매개 변수

Return Value

참고 항목

피드백

추가 리소스

`CTimeSpan` 수업

`CTimeSpan` 비교 연산자

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