System.DateUtils.WeekOfTheYear
Delphi
function WeekOfTheYear(const AValue: TDateTime): Word;
function WeekOfTheYear(const AValue: TDateTime; var AYear: Word): Word;
C++
extern DELPHI_PACKAGE System::Word __fastcall WeekOfTheYear(const System::TDateTime AValue)/* overload */;
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
function | public | System.DateUtils.pas System.DateUtils.hpp |
System.DateUtils | System.DateUtils |
説明
TDateTime 値で表された週を返します。
WeekOfTheYear 関数を呼び出すと,指定された TDateTime 値で表された週を取得できます。WeekOfTheYear は,1 ~ 53 の範囲の値を返します。
AYear は,指定された週が含まれている年を返します。この値は,AValue の年とは異なる場合があります。その理由は,年の最初の週が,少なくとも 4 日以上ある最初の週として定義されるからです。したがって,年の最初の日が金曜,土曜,または日曜である場合,その年の最初の 3 日,2 日,または 1 日に関しては,WeekOfTheYear は前年の最後の週を返します。同様に,年の最後の日が月曜,火曜,または水曜である場合,その年の最後の 1 日,2 日,または 3 日に関しては,WeekOfTheYear は 1(翌年の最初の週)を返します。
メモ: WeekOfTheYear は,ISO 8601 規格に基づいて週を定義します。つまり,週は月曜に始まり,日曜に終了します。
メモ: WeekOfTheYear は,WeekOf 関数と同じ値を返します。