System.DateUtils.WeekOfTheYear

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

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 関数と同じ値を返します。

関連項目