DateTimeFormatInfo.Calendar プロパティ

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

DateTimeFormatInfo.Calendar プロパティ

現在のカルチャで使用する暦を取得または設定します。

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

Visual Basic (宣言)

Public Property Calendar As
 Calendar

Visual Basic (使用法)

Dim instance As DateTimeFormatInfo
Dim value As Calendar

value = instance.Calendar

instance.Calendar = value

C#

public Calendar Calendar { get; set;
 }

C++

public:
property Calendar^ Calendar {
    Calendar^ get ();
    void set (Calendar^ value);
}

J#

/** @property */
public Calendar get_Calendar ()

/** @property */
public void set_Calendar (Calendar value)

JScript

public function get Calendar
 () : Calendar

public function set Calendar
 (value : Calendar)

プロパティ値
現在のカルチャで使用する暦を示す Calendar。InvariantInfo の既定値は、GregorianCalendar です。

例外

例外の種類	条件
ArgumentNullException	プロパティが null 参照 (Visual Basic では Nothing) に設定されています。
ArgumentException	プロパティが、現在のカルチャでは有効でない Calendar に設定されています。
InvalidOperationException	プロパティが設定されていますが、DateTimeFormatInfo が読み取り専用です。

解説

Calendar プロパティは、DateTimeFormatInfo のこのインスタンスに関連付けられたカルチャで有効な暦だけを受け入れます。たとえば、現在のインスタンスが、"en-US" の CultureInfo インスタンスの DateTimeFormat プロパティを源とする場合、このプロパティは、"en-US" カルチャで有効な暦だけを受け入れます。CultureInfo.Calendar プロパティは、カルチャの既定の暦を指定し、CultureInfo.OptionalCalendars プロパティは、そのカルチャがサポートしているその他の暦を指定します。

このプロパティの値を変更すると、MonthNames、AbbreviatedMonthNames、DayNames、AbbreviatedDayNames、CalendarWeekRule、FirstDayOfWeek、FullDateTimePattern、LongDatePattern、ShortDatePattern、YearMonthPattern、MonthDayPattern の各プロパティにも影響を与えます。

たとえば、現在のスレッドのカルチャが Japanese の場合、このプロパティは JapaneseCalendar、LocalizedGregorianCalendar、または USEnglishGregorianCalendar を受け入れます。JapaneseCalendar を使用する場合、既定の Long Date パターンは、"gg y'\x5e74'M'\x6708'd'\x65e5'" です。LocalizedGregorianCalendar を使用する場合、既定の Long Date パターンは "yyyy'\x5e74'M'\x6708'd'\x65e5'" です。

プラットフォーム

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

参照

関連項目
DateTimeFormatInfo クラス
DateTimeFormatInfo メンバ
System.Globalization 名前空間
Calendar クラス
GregorianCalendar
HebrewCalendar
HijriCalendar
JapaneseCalendar
JulianCalendar
KoreanCalendar
ThaiBuddhistCalendar