COleDateTimeSpan::GetStatus

更新 : 2007 年 11 月

この COleDateTimeSpan オブジェクトの状態 (有効性) を取得します。

DateTimeSpanStatus GetStatus( ) const throw( );

戻り値

この COleDateTimeSpan 値の状態を返します。

解説

戻り値は、COleDateTimeSpan クラス内に定義されている列挙型 DateTimeSpanStatus により定義されます。

enum DateTimeSpanStatus{

valid = 0,

invalid = 1,

null = 2,

};

状態値の簡単な説明は、次の一覧を参照してください。

  • COleDateTimeSpan::valid   この COleDateTimeSpan オブジェクトが有効であることを示します。

  • COleDateTimeSpan::invalid   この COleDateTimeSpan オブジェクトが無効、つまりその値が不正である可能性を示します。

  • COleDateTimeSpan::null   この COleDateTimeSpan オブジェクトが null、つまりこのオブジェクトに値が設定されていないことを示します。これは、C++ の NULL とは異なり、"値を持たない" というデータベース用語での "null" です。

次の場合COleDateTimeSpan オブジェクトの状態は無効になります。

  • このオブジェクトが += または -= のような代入演算中にオーバーフロー、またはアンダーフローとなった場合。

  • このオブジェクトに無効な値が代入された場合。

  • このオブジェクトの状態が、SetStatus を使用して明示的に無効に設定された場合。

状態が無効に設定される可能性のある操作については、「COleDateTime::operator +、-」および「COleDateTime::operator +=、-=」を参照してください。

COleDateTimeSpan 値の範囲の詳細については、「日付と時刻 : オートメーションのサポート」を参照してください。

必要条件

ヘッダー : atlcomtime.h

参照

参照

COleDateTimeSpan クラス

階層図

COleDateTimeSpan::SetStatus

COleDateTimeSpan::m_status

その他の技術情報

COleDateTimeSpan のメンバ