System.DateUtils.RecodeYear

Delphi

function RecodeYear(const AValue: TDateTime; const AYear: Word): TDateTime;

C++

extern DELPHI_PACKAGE System::TDateTime __fastcall RecodeYear(const System::TDateTime AValue, const System::Word AYear);

説明

その年を、指定された TDateTime 値に対して置き換えます。

RecodeYear を呼び出すと、AValue で指定された日時の値を、年を AYear に変更して取得された値に変換することができます。 AYear の有効な値は、1 から 9999 です。 AYear は RecodeLeaveFieldAsIs の場合もあります。

AYear に対して提供された値が有効な範囲になかった場合、もしくは、変更結果がその月の正しくない日付となっていた場合（たとえば、うるう年の2月29日をうるう年ではない年に変更しようとするなど）、RecodeYear は EConvertError 例外を発生させます。