System.DateUtils.EncodeDateWeek

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

Delphi

function EncodeDateWeek(const AYear, AWeekOfYear, ADayOfWeek: Word): TDateTime;

C++

extern DELPHI_PACKAGE System::TDateTime __fastcall EncodeDateWeek(const System::Word AYear, const System::Word AWeekOfYear, const System::Word ADayOfWeek = (System::Word)(0x1));

プロパティ

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

説明

指定された年,週の指定された曜日を表す TDateTime 値を返します。

EncodeDateWeek 関数は,AYear,AWeekOfYear,および ADayOfWeek パラメータで指定された日付を表す TDateTime を返します。戻り値の時刻部分は 0(指定された日の午前 0 時)です。

AYear は,年です。値の範囲は 1 ~ 9999(1 と 9999 を含む)です。

AWeekOfYear は AYear 内の週です。1 は,少なくとも 4 日以上ある最初の週を示します。年の最初の日が金曜,土曜,または日曜である場合,その日は AYear を前年に設定し,AWeekOfYear を前年の週数に設定して表現する必要があります。同様に,年の最後の日が月曜,火曜,または水曜である場合,その日は AYear を次の年に設定し,AWeekOfYear を 1 に設定して表現します。

ADayOfWeek は曜日です。1 は月曜,2 は火曜を表します。

ヒント:  ADayOfWeek 値をよりわかりやすくするには,曜日定数 constants を使用します。

AYear が範囲外である場合,または AWeekOfYear が 1 より小さいか,AYear の週数より大きい場合,あるいは ADayOfWeek が 1 より小さいか,7 より大きい場合,EncodeDateWeek は EConvertError 例外を生成します。

メモ:  AWeekOfYear と ADayOfWeek の定義は,ISO 8601 規格に基づいてます。

関連項目