Japanese calendar

.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 プロパティ

JapaneseCalendar コンストラクタ

JapaneseCalendar クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New JapaneseCalendar

C#

public JapaneseCalendar ()

C++

public:
JapaneseCalendar ()

J#

public JapaneseCalendar ()

JScript

public function JapaneseCalendar ()

プラットフォーム

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 クラス
JapaneseCalendar メンバ
System.Globalization 名前空間

JapaneseCalendar プロパティ

パブリック プロパティ

	名前	説明
	AlgorithmType	オーバーライドされます。 現在のカレンダーの暦法 (太陽暦、太陰暦、または両者の組み合わせ) を示す値を取得します。
	Eras	オーバーライドされます。 JapaneseCalendar における時代 (年号) のリストを取得します。
	IsReadOnly	この Calendar オブジェクトが読み取り専用かどうかを示す値を取得します。 ( Calendar から継承されます。)
	MaxSupportedDateTime	オーバーライドされます。 現在の JapaneseCalendar オブジェクトでサポートされている最も新しい日付と時刻を取得します。
	MinSupportedDateTime	オーバーライドされます。 現在の JapaneseCalendar オブジェクトでサポートされている最も古い日付と時刻を取得します。
	TwoDigitYearMax	オーバーライドされます。 年の 2 桁表記で表すことができる 100 年間の範囲内で最後に当たる年を取得または設定します。

参照

関連項目

JapaneseCalendar クラス
System.Globalization 名前空間
Calendar クラス
GregorianCalendar クラス
CultureInfo.Calendar プロパティ
CultureInfo.OptionalCalendars プロパティ

JapaneseCalendar メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	AddDays	指定した DateTime から指定した日数が経過した後の DateTime を返します。 ( Calendar から継承されます。)
	AddHours	指定した DateTime から指定した時間が経過した後の DateTime を返します。 ( Calendar から継承されます。)
	AddMilliseconds	指定した DateTime から指定したミリ秒が経過した後の DateTime を返します。 ( Calendar から継承されます。)
	AddMinutes	指定した DateTime から指定した分数が経過した後の DateTime を返します。 ( Calendar から継承されます。)
	AddMonths	オーバーライドされます。 指定した DateTime から指定した月数が経過した後の DateTime を返します。
	AddSeconds	指定した DateTime から指定した秒数が経過した後の DateTime を返します。 ( Calendar から継承されます。)
	AddWeeks	指定した DateTime から指定した週数が経過した後の DateTime を返します。 ( Calendar から継承されます。)
	AddYears	オーバーライドされます。 指定した DateTime から指定した年数が経過した後の DateTime を返します。
	Clone	現在の Calendar オブジェクトのコピーである新しいオブジェクトを作成します。 ( Calendar から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetDayOfMonth	オーバーライドされます。 指定した DateTime の日付を返します。
	GetDayOfWeek	オーバーライドされます。 指定した DateTime の曜日を返します。
	GetDayOfYear	オーバーライドされます。 指定した DateTime の年間積算日を返します。
	GetDaysInMonth	オーバーロードされます。 指定した月の日数を返します。
	GetDaysInYear	オーバーロードされます。 指定した年の日数を返します。
	GetEra	オーバーライドされます。 指定した DateTime の時代 (年号) を返します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetHour	指定した DateTime の時間の値を返します。 ( Calendar から継承されます。)
	GetLeapMonth	オーバーロードされます。
	GetMilliseconds	指定した DateTime のミリ秒の値を返します。 ( Calendar から継承されます。)
	GetMinute	指定した DateTime の分の値を返します。 ( Calendar から継承されます。)
	GetMonth	オーバーライドされます。 指定した DateTime の月を返します。
	GetMonthsInYear	オーバーロードされます。 指定した年の月数を返します。
	GetSecond	指定した DateTime の秒の値を返します。 ( Calendar から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	GetWeekOfYear	オーバーライドされます。 指定した DateTime オブジェクトの日付を含むその年の週を返します。
	GetYear	オーバーライドされます。 指定した DateTime の年を返します。
	IsLeapDay	オーバーロードされます。 指定した日が閏日かどうかを確認します。
	IsLeapMonth	オーバーロードされます。 指定した月が閏月かどうかを確認します。
	IsLeapYear	オーバーロードされます。 指定した年が閏年かどうかを確認します。
	ReadOnly	指定された Calendar オブジェクトの読み取り専用バージョンを返します。 ( Calendar から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToDateTime	オーバーロードされます。 指定した日付に設定された DateTime を返します。
	ToFourDigitYear	オーバーライドされます。 TwoDigitYearMax プロパティを使用して、指定した 2 桁表記の年を 4 桁表記に変換し、適切な世紀を判断します。
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

JapaneseCalendar クラス
System.Globalization 名前空間
Calendar クラス
GregorianCalendar クラス
CultureInfo.Calendar プロパティ
CultureInfo.OptionalCalendars プロパティ

JapaneseCalendar メンバ

和暦を表します。

JapaneseCalendar データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	JapaneseCalendar	JapaneseCalendar クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	AlgorithmType	オーバーライドされます。 現在のカレンダーの暦法 (太陽暦、太陰暦、または両者の組み合わせ) を示す値を取得します。
	Eras	オーバーライドされます。 JapaneseCalendar における時代 (年号) のリストを取得します。
	IsReadOnly	この Calendar オブジェクトが読み取り専用かどうかを示す値を取得します。(Calendar から継承されます。)
	MaxSupportedDateTime	オーバーライドされます。 現在の JapaneseCalendar オブジェクトでサポートされている最も新しい日付と時刻を取得します。
	MinSupportedDateTime	オーバーライドされます。 現在の JapaneseCalendar オブジェクトでサポートされている最も古い日付と時刻を取得します。
	TwoDigitYearMax	オーバーライドされます。 年の 2 桁表記で表すことができる 100 年間の範囲内で最後に当たる年を取得または設定します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	AddDays	指定した DateTime から指定した日数が経過した後の DateTime を返します。 (Calendar から継承されます。)
	AddHours	指定した DateTime から指定した時間が経過した後の DateTime を返します。 (Calendar から継承されます。)
	AddMilliseconds	指定した DateTime から指定したミリ秒が経過した後の DateTime を返します。 (Calendar から継承されます。)
	AddMinutes	指定した DateTime から指定した分数が経過した後の DateTime を返します。 (Calendar から継承されます。)
	AddMonths	オーバーライドされます。 指定した DateTime から指定した月数が経過した後の DateTime を返します。
	AddSeconds	指定した DateTime から指定した秒数が経過した後の DateTime を返します。 (Calendar から継承されます。)
	AddWeeks	指定した DateTime から指定した週数が経過した後の DateTime を返します。 (Calendar から継承されます。)
	AddYears	オーバーライドされます。 指定した DateTime から指定した年数が経過した後の DateTime を返します。
	Clone	現在の Calendar オブジェクトのコピーである新しいオブジェクトを作成します。 (Calendar から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetDayOfMonth	オーバーライドされます。 指定した DateTime の日付を返します。
	GetDayOfWeek	オーバーライドされます。 指定した DateTime の曜日を返します。
	GetDayOfYear	オーバーライドされます。 指定した DateTime の年間積算日を返します。
	GetDaysInMonth	オーバーロードされます。 指定した月の日数を返します。
	GetDaysInYear	オーバーロードされます。 指定した年の日数を返します。
	GetEra	オーバーライドされます。 指定した DateTime の時代 (年号) を返します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetHour	指定した DateTime の時間の値を返します。 (Calendar から継承されます。)
	GetLeapMonth	オーバーロードされます。
	GetMilliseconds	指定した DateTime のミリ秒の値を返します。 (Calendar から継承されます。)
	GetMinute	指定した DateTime の分の値を返します。 (Calendar から継承されます。)
	GetMonth	オーバーライドされます。 指定した DateTime の月を返します。
	GetMonthsInYear	オーバーロードされます。 指定した年の月数を返します。
	GetSecond	指定した DateTime の秒の値を返します。 (Calendar から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	GetWeekOfYear	オーバーライドされます。 指定した DateTime オブジェクトの日付を含むその年の週を返します。
	GetYear	オーバーライドされます。 指定した DateTime の年を返します。
	IsLeapDay	オーバーロードされます。 指定した日が閏日かどうかを確認します。
	IsLeapMonth	オーバーロードされます。 指定した月が閏月かどうかを確認します。
	IsLeapYear	オーバーロードされます。 指定した年が閏年かどうかを確認します。
	ReadOnly	指定された Calendar オブジェクトの読み取り専用バージョンを返します。 (Calendar から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToDateTime	オーバーロードされます。 指定した日付に設定された DateTime を返します。
	ToFourDigitYear	オーバーライドされます。 TwoDigitYearMax プロパティを使用して、指定した 2 桁表記の年を 4 桁表記に変換し、適切な世紀を判断します。
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

JapaneseCalendar クラス
System.Globalization 名前空間
Calendar クラス
GregorianCalendar クラス
CultureInfo.Calendar プロパティ
CultureInfo.OptionalCalendars プロパティ

ウィキペディア

日本の暦

出典: フリー百科事典『ウィキペディア（Wikipedia）』 (2024/01/08 02:51 UTC 版)

日本の暦（にっぽんのこよみ）では、日本における暦法の歴史と、それに伴う暦（暦書・暦表）に関する話題について述べる。

Weblio日本語例文用例辞書

「Japanese calendar」の例文・使い方・用例・文例

• 外国系米人 《Irish‐Americans (アイルランド系米人), Japanese‐Americans (日系米人)など》.