JapaneseCalendar クラス

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

JapaneseCalendar クラス

和暦を表します。

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

Visual Basic (宣言)

<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public Class JapaneseCalendar
    Inherits Calendar

Visual Basic (使用法)

Dim instance As JapaneseCalendar

C#

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public class JapaneseCalendar : Calendar

C++

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public ref class JapaneseCalendar : public
 Calendar

J#

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public class JapaneseCalendar extends Calendar

JScript

SerializableAttribute 
ComVisibleAttribute(true) 
public class JapaneseCalendar extends
 Calendar

解説

和暦とも呼ばれる日本の暦は、年と時代 (年号) が異なる点を除いて、グレゴリオ暦と同じです。

和暦では、天皇の在位期間ごとに 1 つの元号が認識されます。現在の時代 (年号) は、グレゴリオ暦の 1989 年から始まる平成です。通常、時代 (年号) 名は年の前に表示されます。たとえば、グレゴリオ暦の 2001 年は、和暦では平成 13 年です。ある元号の最初の年を "元年" と呼ぶため、グレゴリオ暦の 1989 年は、和暦では平成元年となります。

このクラスは、次のように時代 (年号) に番号を割り当てます。

GetEra 値	時代 (年号) 名	時代 (年号) の省略形	グレゴリオ暦の日付
4	平成 (Heisei)	平 (H, h)	1989 年 1 月 8 日～現在
3	昭和 (Showa)	昭 (S, s)	1926 年 12 月 25 日～ 1989 年 1 月 7 日
2	大正 (Taisho)	大 (T, t)	1912 年 7 月 30 日～ 1926 年 12 月 24 日
1	明治 (Meiji)	明 (M, m)	1868 年 9 月 8 日～ 1912 年 7 月 29 日

このクラスは、明治 1 年の 9 番目の月の 8 番目の日 (グレゴリオ暦で 1868 年の 9 月 8 日) 以降の日付だけを処理します。和暦は明治 6 年 (グレゴリオ暦の 1873 年) に太陰暦から太陽暦に切り替えられましたが、この実装は太陽暦だけに基づいています。

和暦の閏年は、グレゴリオ暦の同じ閏年に対応しています。グレゴリオ暦の閏年は、100 で割り切れる年を除く、4 で割り切れるグレゴリオ暦年として定義されていますが、400 で割り切れるグレゴリオ暦年は閏年になります。平年の日数は 365 日で、閏年の日数は 366 日です。

和暦には、それぞれ 28 ～ 31 日で構成される 12 の月があります。

GetMonth 値	月	英語	平年の日数	閏年の日数
1	1 月 (Ichigatsu)	January	31	31
2	2 月 (Nigatsu)	February	28	29
3	3 月 (Sangatsu)	March	31	31
4	4 月 (Shigatsu)	April	30	30
5	5 月 (Gogatsu)	May	31	31
6	6 月 (Rokugatsu)	June	30	30
7	7 月 (Shichigatsu)	July	31	31
8	8 月 (Hachigatsu)	August	31	31
9	9 月 (Kugatsu)	September	30	30
10	10 月 (Juugatsu)	October	31	31
11	11 月 (Juuichigatsu)	November	30	30
12	12 月 (Juunigatsu)	December	31	31

グレゴリオ暦の February に相当する 2 月は、閏年には 29 日、平年には 28 日で構成されます。

グレゴリオ暦での紀元後 2001 年 1 月 1 日は、和暦の平成 13 年 1 月 1 日に相当します。

JapaneseCalendar クラスを使用する場合、DateTime.Parse は、年の前に表記される時代 (年号) の省略形を認識します。これは、大文字と小文字が区別されないローマ字 1 文字の省略形か、漢字 1 文字の省略形です。

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

継承階層

System.Object
   System.Globalization.Calendar
    System.Globalization.JapaneseCalendar

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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

参照

関連項目
JapaneseCalendar メンバ
System.Globalization 名前空間
Calendar クラス
GregorianCalendar クラス
CultureInfo.Calendar プロパティ
CultureInfo.OptionalCalendars プロパティ