COleDateTime::SetDateTime

COleDateTime でこのオブジェクトの日時を設定します。

int SetDateTime(
   int nYear,
   int nMonth,
   int nDay,
   int nHour,
   int nMin,
   int nSec 
) throw( );

パラメーター

nYear, nMonth, nDay, nHour, nMin, nSec
COleDateTime のこのオブジェクトにコピーされる日付と時刻のコンポーネント。

この COleDateTime オブジェクトの値が正常に設定された場合は 0。それ以外の場合は 1。この戻り値は、DateTimeStatus 列挙型に基づきます。詳細については、SetStatus メンバー関数を参照してください。

各パラメーターの範囲は、次の表を参照してください。

ある月の日付がオーバーフローすると、次の月の正しい日付に変換され、月または月と年がインクリメントされます。日付値 0 は、前の月の最後の日を示します。SystemTimeToVariantTime と同じ動作になります。

パラメーターで指定した日付または時刻の値が無効な場合、このオブジェクトの状態は無効に設定され、値は変更されません。

時刻値のいくつかの例を次に示します。

nHour	nMin	nSec	値
1	3	3	01:03:03
23	45	0	23:45:00
25	30	0	無効
9	60	0	無効

日付値のいくつかの例を次に示します。

nYear	nMonth	nDay	値
1995	4	15	1995 年 1 月 4 日 15
1789	7	14	1789 年 1 月 7 日 17
1925	2	30	無効
10000	1	1	無効

日付のみを設定するには、COleDateTime::SetDateを参照してください。時刻のみを設定するには、COleDateTime::SetTimeを参照してください。

この COleDateTime オブジェクトの持つ値を問い合わせる他のメンバー関数については、次のメンバー関数を参照してください。

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