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