COleDateTime::GetStatus

아티클
02/21/2013

(유효성) 상태를 가져옵니다는 지정 된 COleDateTime 개체입니다.

DateTimeStatus GetStatus( ) const throw( );

반환 값

이 상태를 반환 하는 COleDateTime 값입니다.호출 하는 경우 GetStatus 에 있는 COleDateTime 개체는 기본 생성을 잘못 반환 됩니다.호출 하는 경우 GetStatus 에 있는 COleDateTime 초기화할 생성자 집합 null 개체 GetStatus null을 반환 합니다.참조 비고 에 대 한 자세한 내용은.

설명

반환 값으로 정의 되는 DateTimeStatus 열거에서 정의 된 형식을 COleDateTime 클래스.

enum DateTimeStatus

{

error = -1,

valid = 0,

invalid = 1, // Invalid date (out of range, etc.)

null = 2, // Literally has no value

};

이러한 상태 값에 대 한 간단한 설명은 다음을 참조 하십시오.

COleDateTime::error부분 날짜/시간 값을 가져오는 동안 오류가 있음을 나타냅니다.
COleDateTime::valid 나타냅니다가 COleDateTime 개체 유효 합니다.
COleDateTime::invalid 나타냅니다가 COleDateTime 개체가 유효 하지 않습니다. 즉, 값을 올바르지 않을 수 있습니다.
COleDateTime::null 나타냅니다가 COleDateTime 개체는 null, 즉,이 개체에 대 한 지정 된 값이 없습니다.(이 "null" 데이터베이스 "는 C++와는 달리 값을 갖는" 의미에서 NULL.)

상태는 COleDateTime 개체는 다음과 같은 경우에는 유효 하지 않습니다.

해당 값이 설정 된 경우는 변형 또는 COleVariant 값 날짜/시간 값으로 변환할 수 없습니다.
해당 값이 설정 된 경우는 time_t, SYSTEMTIME, 또는 FILETIME 값은 유효한 날짜/시간 값으로 변환할 수 없습니다.
해당 값으로 설정 하면 SetDateTime 잘못 된 매개 변수 값을 사용 합니다.
이 개체 오버플로 또는 언더플로가 산술 할당 과정 즉, 발생 하는 경우 += 또는 -=.
잘못 된 값이이 개체에 할당 된 경우.
이 개체의 상태를 잘못 사용 하 여 명시적으로 설정 된 경우 SetStatus.

잘못 된 멤버 함수는 다음을 참조 하십시오 상태를 설정할 있는 작업에 대 한 자세한 내용은.

범위에 대 한 자세한 내용은 COleDateTime 문서를 참조 하는 값을 날짜 및 시간: 자동화 지원.

예제

COleDateTime t;

// this one is a leap year
t.SetDateTime(2000, 2, 29, 5, 0, 0);
ASSERT(t.GetStatus() == COleDateTime::valid);

// this date isn't valid
t.SetDateTime(1925, 2, 30, 5, 0, 0);
ASSERT(t.GetStatus() == COleDateTime::invalid);

// the only way to set null is to set null!
t.SetStatus(COleDateTime::null);
ASSERT(t.GetStatus() == COleDateTime::null);