CalendarWeekRule 列挙体

.NET Framework クラス ライブラリ リファレンス

CalendarWeekRule 列挙体

年の最初の週を決定するためのさまざまな規則を定義します。

名前空間: System.Globalization
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public Enumeration CalendarWeekRule

Visual Basic (使用法)

Dim instance As CalendarWeekRule

C#

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public enum CalendarWeekRule

C++

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public enum class CalendarWeekRule

J#

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public enum CalendarWeekRule

JScript

SerializableAttribute 
ComVisibleAttribute(true) 
public enum CalendarWeekRule

メンバ

	メンバ名	説明
	FirstDay	1 年の最初の週が、その年の第 1 日に始まり、週の最初の曜日として指定されている曜日が次に訪れるのを待たずに終了することを示します。値は 0 です。
	FirstFourDayWeek	1 年の最初の週が、週の最初の曜日として指定されている曜日が次に訪れるまでに 4 日以上かかる週になるように指定します。ISO 8601 に準拠します。値は 2 です。
	FirstFullWeek	1 年の最初の週が、その年の第 1 日目またはその後に訪れる、週の最初の曜日として指定されている曜日に始まることを示します。値は 1 です。

解説

この暦の週規則は、週の最初の曜日として指定される System.DayOfWeek 値に依存します。DateTimeFormatInfo.FirstDayOfWeek プロパティは、カルチャに対する既定値を提供しますが、Calendar.GetWeekOfYear メソッドでその週の最初の曜日として任意の DayOfWeek 値を指定できます。

FirstDay 値に基づく最初の週の日数は、1 日から 7 日までのいずれかになります。FirstFullWeek 値に基づく最初の週の日数は、常に 7 日になります。FirstFourDayWeek 値に基づく最初の週の日数は、4 日から 7 日までのいずれかになります。

たとえば、グレゴリオ暦で、その年の最初の日 (1 月 1 日) が火曜日であり、指定した週の最初の曜日が日曜日であるとします。FirstFullWeek を選択すると、最初の日曜日 (1 月 6 日) がその年の最初の週の始まりとして定義されます。その年の最初の 5 日間は、前年の最後の週の一部と見なされます。FirstFourDayWeek を選択すると、その年の最初の日 (1 月 1 日) がその年の最初の週の始まりとして定義されます。これは、次の日曜日の前に 1 月 1 日からその日まで 4 日以上あるためです。

日付	FirstDay	FirstFullWeek	FirstFourDayWeek
12 月 31 日 月曜日	前年の最後の週	前年の最後の週	前年の最後の週
1 月 1 日 火曜日	第 1 週	前年の最後の週	第 1 週
1 月 2 日 水曜日	第 1 週	前年の最後の週	第 1 週
1 月 3 日 木曜日	第 1 週	前年の最後の週	第 1 週
1 月 4 日 金曜日	第 1 週	前年の最後の週	第 1 週
1 月 5 日 土曜日	第 1 週	前年の最後の週	第 1 週
1 月 6 日 日曜日	第 2 週	第 1 週	第 2 週
1 月 7 日 月曜日	第 2 週	第 1 週	第 2 週
1 月 8 日 火曜日	第 2 週	第 1 週	第 2 週
1 月 9 日 水曜日	第 2 週	第 1 週	第 2 週
1 月 10 日 木曜日	第 2 週	第 1 週	第 2 週
1 月 11 日 金曜日	第 2 週	第 1 週	第 2 週
1 月 12 日 土曜日	第 2 週	第 1 週	第 2 週

その年の最初の日 (1 月 1 日) が金曜日であり、指定した週の最初の曜日が日曜日であるとします。FirstFourDayWeek を選択すると、その年の最初の日曜日 (1 月 3 日) がその年の最初の週の始まりとして定義されます。これは、1 月 1 日から次の日曜の前日までの日数が 4 日よりも少ないためです。

日付	FirstDay	FirstFullWeek	FirstFourDayWeek
12 月 31 日 木曜日	前年の最後の週	前年の最後の週	前年の最後の週
1 月 1 日 金曜日	第 1 週	前年の最後の週	前年の最後の週
1 月 2 日 土曜日	第 1 週	前年の最後の週	前年の最後の週
1 月 3 日 日曜日	第 2 週	第 1 週	第 1 週
1 月 4 日 月曜日	第 2 週	第 1 週	第 1 週
1 月 5 日 火曜日	第 2 週	第 1 週	第 1 週
1 月 6 日 水曜日	第 2 週	第 1 週	第 1 週
1 月 7 日 木曜日	第 2 週	第 1 週	第 1 週
1 月 8 日 金曜日	第 2 週	第 1 週	第 1 週
1 月 9 日 土曜日	第 2 週	第 1 週	第 1 週

各 CultureInfo は一連の暦をサポートしています。Calendar プロパティは、カルチャの既定の暦を返し、OptionalCalendars プロパティは、そのカルチャがサポートしているすべての暦の配列を返します。CultureInfo が使用する暦を変更するには、CultureInfo.DateTimeFormat の Calendar プロパティを新しい Calendar に設定します。

メモ
ISO 8601 に準拠した暦を作成するには、FirstFourDayWeek を使用します。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
System.Globalization 名前空間
Calendar
OptionalCalendars