System.TDateTime.Create
C++
__fastcall TDateTime() {Val = 0;}
__fastcall TDateTime(const TDateTimeBase& src) {Val = src.Val;}
__fastcall TDateTime(const double src) {Val = src;}
__fastcall TDateTime(const int src) {Val = src;}
__fastcall TDateTime(const System::String& src, TDateTimeFlag flag = DateTime);
__fastcall TDateTime(unsigned short year, unsigned short month, unsigned short day);
__fastcall TDateTime(unsigned short hour, unsigned short min,
unsigned short sec, unsigned short msec);
__fastcall TDateTime(unsigned short year, unsigned short month, unsigned short day,
unsigned short hour, unsigned short min,
unsigned short sec, unsigned short msec);
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
constructor | public | systdate.h | System | TDateTime |
説明
TDateTime のインスタンスを作成および初期化します。
TDateTime を使用すると、TDateTime オブジェクトを初期化することができます。
引数なしで呼び出した場合、その結果の TDateTime オブジェクトの Val データ メンバーの値は 0 になります。この日時は、12/30/1899 12:00 A.M に相当します。
src パラメータに TDateTime オブジェクトを指定して呼び出した場合、その結果のオブジェクトは、src のコピーになります(コピー コンストラクタ)。
src パラメータに TDateTimeBase オブジェクトを指定して呼び出した場合、その結果のオブジェクトは、src パラメータと同じ値を持っています。TDateTimeBase は、TDateTime 型の基底クラスです。これは、メンバーを 1 つ、オブジェクトの値を表す public Val フィールドを持っています。
src パラメータに、Double または Integer を指定して呼び出した場合、その結果のオブジェクトは、src パラメータと同じ値を持っています。 src の整数部分は、1899年12月30日からの経過日数です。 少数部分はその日の経過時間で、24 時間制で表されます。
src パラメータに AnsiString を、flag パラメータに TDateTimeFlag を指定して呼び出した場合、その結果のオブジェクトの値は、AnsiString から変換されます。 flag パラメータは、その文字列に日付か時間、もしくはその両方が含まれていることを示します。flag のデフォルトは、DateTime です。
3 つの unsigned short を指定して (year、month、day パラメータとして)呼び出した場合、その結果のオブジェクトの値は、指定された年、月、日と、時間部分に 0 (深夜 0 時)を組み合わせたものになります。year は、1 から 9999 でなければなりません。有効な month 値は、1 から 12 です。有効な day 値は、1 から 28、29、30 または 31 に、month の値によって変わります。たとえば、month 2(2月)の場合に指定できる day 値は、1 から 28、または 1 から 29 です。これは、year の値がうるう年かどうかによって変わります。
4 つの unsigned short を指定して (hour、min、sec、msec パラメータとして)呼び出した場合、その結果のオブジェクトの値は、指定された、深夜より経過した分の、時、分、秒、ミリ秒に基づいた時間を表します。その結果の値の日付部分は、0 (12/30/1899) になります。hour は 0 から 23、min は 0 から 59、sec は 0 から 59、そして msec は 0 から 59 でなければなりません。
メモ: このコンストラクタが、実行できない変換のために呼び出された場合(日付や時間を表さない AnsiString、もしくは、不正な年、月、日、時、分、秒、ミリ秒の値)、EConvertError 例外が発生します。