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 規格に基づいて週を定義します。つまり，週は月曜に始まり，日曜に終了します。