System.DateUtils.TryRecodeDateTime

提供: RAD Studio API Documentation
移動先: 案内検索

Delphi

function TryRecodeDateTime(const AValue: TDateTime; const AYear, AMonth, ADay, AHour, AMinute, ASecond, AMilliSecond: Word; out AResult: TDateTime): Boolean;

C++

extern DELPHI_PACKAGE bool __fastcall TryRecodeDateTime(const System::TDateTime AValue, const System::Word AYear, const System::Word AMonth, const System::Word ADay, const System::Word AHour, const System::Word AMinute, const System::Word ASecond, const System::Word AMilliSecond, /* out */ System::TDateTime &AResult);

プロパティ

種類 可視性 ソース ユニット
function public
System.DateUtils.pas
System.DateUtils.hpp
System.DateUtils System.DateUtils

説明

指定された TDateTime 値の構成要素を選択的に置換します。

TryRecodeDateTime 関数を呼び出すと,AValue で指定された日付時刻値を,年を AYear に,月を AMonth に,日を ADay に,時を AHour に,分を AMinute に,秒を ASecond に,ミリ秒を AMilliSecond に変更して得られた値で変換できます。これらのパラメータはいずれも,RecodeLeaveFieldAsIs に設定できます。その場合,TryRecodeDateTime は TDateTime 値の既存の部分を変更しません。

AYear の有効な値の範囲は 1 ~ 9999(または RecodeLeaveFieldAsIs)です。

AMonth の有効な値の範囲は 1 ~ 12(または RecodeLeaveFieldAsIs)です。

ADay の有効な値の範囲は,AMonth で表された月によって異なります。たとえば,AMonth が 1 の場合,ADay の有効な値の範囲は 1 ~ 31 です。AMonth が 2 の場合,有効な値の範囲は年に応じて 1 ~ 28 または 1 ~ 29 です。ADay には,RecodeLeaveFieldAsIs も設定できます。

AHour の有効な値の範囲は 0 ~ 24(または RecodeLeaveFieldAsIs)です。AHour が 24 の場合,AMinute,ASecond,および AMilliSecond はすべて 0 でなければなりません。

AMinute の有効な値の範囲は 0 ~ 59(または RecodeLeaveFieldAsIs)です。

ASecond の有効な値の範囲は 0 ~ 59(または RecodeLeaveFieldAsIs)です。

AMilliSecond の有効な値の範囲は 0 ~ 999(または RecodeLeaveFieldAsIs)です。

AResult は,AValue を指定どおりに変更した結果を返します。

TryRecodeDateTime は,パラメータがすべて有効な範囲にある場合に true を返し,それ以外の場合は false を返します。

関連項目