JapaneseCalendar JapaneseCalendar JapaneseCalendar JapaneseCalendar Class

定義

和暦を表します。Represents the Japanese calendar.

public ref class JapaneseCalendar : System::Globalization::Calendar
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public class JapaneseCalendar : System.Globalization.Calendar
type JapaneseCalendar = class
    inherit Calendar
Public Class JapaneseCalendar
Inherits Calendar
継承
JapaneseCalendarJapaneseCalendarJapaneseCalendarJapaneseCalendar
属性

注釈

日本のカレンダーは、和暦とも呼ばれますが、年と時代 (年号) が異なる点を除いて、グレゴリオ暦のカレンダーとまったく同じように動作します。The Japanese calendar, which is also known as the Wareki calendar, works exactly like the Gregorian calendar, except that the year and era are different.

注意

使用方法について、JapaneseCalendarクラスとその他の .NET のクラスを予定表を参照してくださいカレンダーの使用します。For information about using the JapaneseCalendar class and the other calendar classes in .NET, see Working with Calendars.

和暦では、天皇の代ごとに 1 つの時代 (年号) を認識します。The Japanese calendar recognizes one era for every emperor's reign. 2 つ最新時代 (年号) は、平成時代、1989 年、グレゴリオ暦のカレンダー年度の開始および構成のグレゴリオ暦カレンダー年 2019、Reiwa 時代です。The two most recent eras are the Heisei era, beginning in the Gregorian calendar year 1989, and the Reiwa era, beginning in the Gregorian calendar year 2019. 時代 (年号) の名前は通常、年の前に表示されます。The era name is typically displayed before the year. たとえば、グレゴリオ暦の 2001 年は和暦の平成 13 年です。For example, the Gregorian calendar year 2001 is the Japanese calendar year Heisei 13. 時代 (年号) の最初の年が「元年」と呼ばれることに注意してください。Note that the first year of an era is called "Gannen." そのため、グレゴリオ暦の 1989 年は和暦の平成元年でした。Therefore, the Gregorian calendar year 1989 was the Japanese calendar year Heisei Gannen. 既定では書式設定で指定された日付と時刻の書式指定文字列、"D"、"F"、"Y"などの操作には、結果の文字列の「1」ではなく元年を出力します。By default, formatting operations with specified date and time format strings, such as "D", "F", and "Y", output Gannen rather than "1" in the result string.

重要

和暦の時代 (年号) は天皇の代に基づいているため、変更されることが予想されます。Eras in the Japanese calendars are based on the emperor's reign and are therefore expected to change. たとえば、JapaneseCalendarJapaneseLunisolarCalendar において、2019 年 5 月 1 日から令和時代が始まることになりました。For example, May 1, 2019 marked the beginning of the Reiwa era in the JapaneseCalendar and JapaneseLunisolarCalendar. このような時代 (年号) の変更は、これらのカレンダーを使用するすべてのアプリケーションに影響します。Such a change of era affects all applications that use these calendars. 詳細については「.NET での日本語のカレンダーの新しい時代」をご覧いただき、アプリケーションが影響を受けるかどうかを判断します。See Handling a new era in the Japanese calendar in .NET for more information and to determine whether your applications are affected. 日本語の時代の変更のためのアプリケーションの準備」をご覧いただき、時代の変更に対する状況を確認するために Windows システムでアプリケーションをテストします。See Prepare your application for the Japanese era change for information on testing your applications on Windows systems to ensure their readiness for the era change. 複数の時代 (年号) を含むカレンダーをサポートしている .NET の機能や、複数の時代 (年号) をサポートしているカレンダーを操作する際のベスト プラクティスについては、「Working with eras (時代 (年号) の操作)」をご覧ください。See Working with eras for features in .NET that support calendars with multiple eras and for best practices when working with calendars that support multiple eras.

このクラスは、次のように、時代 (年号) に数値を割り当てます。This class assigns numbers to the eras as follows:

GetEra 値GetEra value 時代 (年号) の名前Era Name 時代 (年号) の省略形Era Abbreviation グレゴリオ暦の日付Gregorian Dates
55 令和 (Reiwa)令和 (Reiwa) 令和 (R, r)令和 (R, r) 提示する、2019 年 5 月 1日May 1, 2019 to present
44 平成 (Heisei)平成 (Heisei) 平 (H, h)平 (H, h) 1989 年 1 月 8 日、2019 年 4 月 30日 ~January 8, 1989 to April 30, 2019
33 昭和 (Showa)昭和 (Showa) 昭 (S, s)昭 (S, s) 1926 年 12 月 25 日から 1989 年 1 月 7 日までDecember 25, 1926 to January 7, 1989
22 大正 (Taisho)大正 (Taisho) 大 (T, t)大 (T, t) 1912 年 7 月 30 日から 1926 年 12 月 24 日までJuly 30, 1912 to December 24, 1926
11 明治 (Meiji)明治 (Meiji) 明 (M, m)明 (M, m) 1868 年 9 月 8 日から 1912 年 7 月 29 日までSeptember 8, 1868 to July 29, 1912

このクラスは、明治元年 9 月 8 日 (グレゴリオ暦の 1868 年 9 月 8 日) 以降の日付を処理します。This class handles dates from September 8 in the year Meiji 1 (in the Gregorian calendar, September 8, 1868). 和暦は明治 6 年 (グレゴリオ暦の 1873 年) に太陰暦から太陽暦に切り替わりましたが、この実装は太陽暦のみに基づいています。Although the Japanese calendar was switched from a lunar calendar to a solar calendar in the year Meiji 6 (1873 of the Gregorian calendar), this implementation is based on the solar calendar only.

和暦の閏年は、グレゴリオ暦の閏年と同じ年に対応します。Leap years in the Japanese calendar correspond to the same leap years in the Gregorian calendar. グレゴリオ暦の閏年は、100 で割り切れる場合を除き、4 で割り切れるグレゴリオ暦の年として定義されます。A leap year in the Gregorian calendar is defined as a Gregorian year that is evenly divisible by four, except if it is divisible by 100. ただし、400 で割り切れるグレゴリオ暦の年は閏年です。However, Gregorian years that are divisible by 400 are leap years. 平年は 365 日で、閏年は 366 日です。A common year has 365 days and a leap year has 366 days.

和暦には、28 ~ 31 日の 12 か月があります。The Japanese calendar has 12 months with 28 to 31 days each:

GetMonth 値GetMonth value Month 英語English 平年の日数Days in common years 閏年の日数Days in leap years
11 1月 (Ichigatsu)1月 (Ichigatsu) JanuaryJanuary 3131 3131
22 2月 (Nigatsu)2月 (Nigatsu) FerbruaryFebruary 2828 2929
33 3月 (Sangatsu)3月 (Sangatsu) MarchMarch 3131 3131
44 4月 (Shigatsu)4月 (Shigatsu) AprilApril 3030 3030
55 5月 (Gogatsu)5月 (Gogatsu) MayMay 3131 3131
66 6月 (Rokugatsu)6月 (Rokugatsu) JuneJune 3030 3030
77 7月 (Shichigatsu)7月 (Shichigatsu) JulyJuly 3131 3131
88 8月 (Hachigatsu)8月 (Hachigatsu) AugustAugust 3131 3131
99 9月 (Kugatsu)9月 (Kugatsu) SeptemberSeptember 3030 3030
1010 10月 (Juugatsu)10月 (Juugatsu) OctoberOctober 3131 3131
1111 11月 (Juuichigatsu)11月 (Juuichigatsu) NovemberNovember 3030 3030
1212 12月 (Juunigatsu)12月 (Juunigatsu) DecemberDecember 3131 3131

グレゴリオ暦の February に相当する 2 月は、閏年の場合は 29 日で、平年の場合は 28 日です。Nigatsu, which is equivalent to the Gregorian calendar month of February, has 29 days during leap years and 28 during common years.

グレゴリオ暦の西暦 2001 年The date January 1, 2001 A.D. 1 月 1 日は、和暦の平成 13 年 1 月 1 日に相当します。in the Gregorian calendar is equivalent to the first day of Ichigatsu in the year Heisei 13 in the Japanese calendar.

場合、JapaneseCalendar日本語のカルチャの現在の暦は、DateTime.Parse年前に時代 (年号) の省略形を認識します。If the JapaneseCalendar is the current calendar of the Japanese culture, DateTime.Parse recognizes the era abbreviations in front of the year. 省略形は、大文字・小文字を区別しないラテン アルファベット 1 文字の省略形か、漢字 1 文字の省略形のいずれかです。The abbreviation is either the single-character case-insensitive Latin alphabet abbreviation or the single-character Kanji abbreviation. xref:System.DateTime.Parse%2A?displayProperty=nameWithType > も、時代 (年号) の最初の年として「1」または元年 (元年) のいずれかを認識します。xref:System.DateTime.Parse%2A?displayProperty=nameWithType> also recognizes either "1" or Gannen (元年) as the first year of an era.

CultureInfo オブジェクトは、カレンダーのセットをサポートしています。Each CultureInfo object supports a set of calendars. Calendar プロパティは、カルチャの既定のカレンダーを返し、OptionalCalendars プロパティは、カルチャでサポートされているすべてのカレンダーを含む配列を返します。The Calendar property returns the default calendar for the culture, and the OptionalCalendars property returns an array containing all the calendars supported by the culture. 使用する暦を変更する、 CultureInfo、設定、DateTimeFormatInfo.Calendarプロパティを新しいCalendarします。To change the calendar used by a CultureInfo, set the DateTimeFormatInfo.Calendar property to a new Calendar.

コンストラクター

JapaneseCalendar() JapaneseCalendar() JapaneseCalendar() JapaneseCalendar()

JapaneseCalendar クラスの新しいインスタンスを初期化します。Initializes a new instance of the JapaneseCalendar class.

プロパティ

AlgorithmType AlgorithmType AlgorithmType AlgorithmType

現在のカレンダーの暦法 (太陽暦、太陰暦、または両者の組み合わせ) を示す値を取得します。Gets a value that indicates whether the current calendar is solar-based, lunar-based, or a combination of both.

DaysInYearBeforeMinSupportedYear DaysInYearBeforeMinSupportedYear DaysInYearBeforeMinSupportedYear DaysInYearBeforeMinSupportedYear

MinSupportedDateTime プロパティで指定された年の前の年の日数を取得します。Gets the number of days in the year that precedes the year that is specified by the MinSupportedDateTime property.

(Inherited from Calendar)
Eras Eras Eras Eras

JapaneseCalendar における時代 (年号) のリストを取得します。Gets the list of eras in the JapaneseCalendar.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

この Calendar オブジェクトが読み取り専用かどうかを示す値を取得します。Gets a value indicating whether this Calendar object is read-only.

(Inherited from Calendar)
MaxSupportedDateTime MaxSupportedDateTime MaxSupportedDateTime MaxSupportedDateTime

現在の JapaneseCalendar オブジェクトでサポートされている最も新しい日付と時刻を取得します。Gets the latest date and time supported by the current JapaneseCalendar object.

MinSupportedDateTime MinSupportedDateTime MinSupportedDateTime MinSupportedDateTime

現在の JapaneseCalendar オブジェクトでサポートされている最も古い日付と時刻を取得します。Gets the earliest date and time supported by the current JapaneseCalendar object.

TwoDigitYearMax TwoDigitYearMax TwoDigitYearMax TwoDigitYearMax

年の 2 桁表記で表すことができる 100 年間の範囲内で最後に当たる年を取得または設定します。Gets or sets the last year of a 100-year range that can be represented by a 2-digit year.

メソッド

AddDays(DateTime, Int32) AddDays(DateTime, Int32) AddDays(DateTime, Int32) AddDays(DateTime, Int32)

指定した DateTime から指定した日数が経過した後の DateTime を返します。Returns a DateTime that is the specified number of days away from the specified DateTime.

(Inherited from Calendar)
AddHours(DateTime, Int32) AddHours(DateTime, Int32) AddHours(DateTime, Int32) AddHours(DateTime, Int32)

指定した DateTime から指定した時間数が経過した後の DateTime を返します。Returns a DateTime that is the specified number of hours away from the specified DateTime.

(Inherited from Calendar)
AddMilliseconds(DateTime, Double) AddMilliseconds(DateTime, Double) AddMilliseconds(DateTime, Double) AddMilliseconds(DateTime, Double)

指定した DateTime から指定したミリ秒数が経過した後の DateTime を返します。Returns a DateTime that is the specified number of milliseconds away from the specified DateTime.

(Inherited from Calendar)
AddMinutes(DateTime, Int32) AddMinutes(DateTime, Int32) AddMinutes(DateTime, Int32) AddMinutes(DateTime, Int32)

指定した DateTime から指定した分数が経過した後の DateTime を返します。Returns a DateTime that is the specified number of minutes away from the specified DateTime.

(Inherited from Calendar)
AddMonths(DateTime, Int32) AddMonths(DateTime, Int32) AddMonths(DateTime, Int32) AddMonths(DateTime, Int32)

指定した DateTime から指定した月数が経過した後の DateTime を返します。Returns a DateTime that is the specified number of months away from the specified DateTime.

AddSeconds(DateTime, Int32) AddSeconds(DateTime, Int32) AddSeconds(DateTime, Int32) AddSeconds(DateTime, Int32)

指定した DateTime から指定した秒数が経過した後の DateTime を返します。Returns a DateTime that is the specified number of seconds away from the specified DateTime.

(Inherited from Calendar)
AddWeeks(DateTime, Int32) AddWeeks(DateTime, Int32) AddWeeks(DateTime, Int32) AddWeeks(DateTime, Int32)

指定した DateTime から指定した週数が経過した後の DateTime を返します。Returns a DateTime that is the specified number of weeks away from the specified DateTime.

(Inherited from Calendar)
AddYears(DateTime, Int32) AddYears(DateTime, Int32) AddYears(DateTime, Int32) AddYears(DateTime, Int32)

指定した DateTime から指定した年数が経過した後の DateTime を返します。Returns a DateTime that is the specified number of years away from the specified DateTime.

Clone() Clone() Clone() Clone()

現在の Calendar オブジェクトのコピーである新しいオブジェクトを作成します。Creates a new object that is a copy of the current Calendar object.

(Inherited from Calendar)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetDayOfMonth(DateTime) GetDayOfMonth(DateTime) GetDayOfMonth(DateTime) GetDayOfMonth(DateTime)

指定した DateTime の日付を返します。Returns the day of the month in the specified DateTime.

GetDayOfWeek(DateTime) GetDayOfWeek(DateTime) GetDayOfWeek(DateTime) GetDayOfWeek(DateTime)

指定した DateTime の曜日を返します。Returns the day of the week in the specified DateTime.

GetDayOfYear(DateTime) GetDayOfYear(DateTime) GetDayOfYear(DateTime) GetDayOfYear(DateTime)

指定した DateTime の年間積算日を返します。Returns the day of the year in the specified DateTime.

GetDaysInMonth(Int32, Int32) GetDaysInMonth(Int32, Int32) GetDaysInMonth(Int32, Int32) GetDaysInMonth(Int32, Int32)

現在の時代 (年号) の指定した月および年の日数を返します。Returns the number of days in the specified month and year of the current era.

(Inherited from Calendar)
GetDaysInMonth(Int32, Int32, Int32) GetDaysInMonth(Int32, Int32, Int32) GetDaysInMonth(Int32, Int32, Int32) GetDaysInMonth(Int32, Int32, Int32)

指定した時代 (年号) の指定した年の指定した月の日数を返します。Returns the number of days in the specified month in the specified year in the specified era.

GetDaysInYear(Int32) GetDaysInYear(Int32) GetDaysInYear(Int32) GetDaysInYear(Int32)

現在の時代 (年号) の指定した年の日数を返します。Returns the number of days in the specified year of the current era.

(Inherited from Calendar)
GetDaysInYear(Int32, Int32) GetDaysInYear(Int32, Int32) GetDaysInYear(Int32, Int32) GetDaysInYear(Int32, Int32)

指定した時代 (年号) の指定した年の日数を返します。Returns the number of days in the specified year in the specified era.

GetEra(DateTime) GetEra(DateTime) GetEra(DateTime) GetEra(DateTime)

指定した DateTime の時代 (年号) を返します。Returns the era in the specified DateTime.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetHour(DateTime) GetHour(DateTime) GetHour(DateTime) GetHour(DateTime)

指定した DateTime の時間の値を返します。Returns the hours value in the specified DateTime.

(Inherited from Calendar)
GetLeapMonth(Int32) GetLeapMonth(Int32) GetLeapMonth(Int32) GetLeapMonth(Int32)

指定された年の閏月を計算します。Calculates the leap month for a specified year.

(Inherited from Calendar)
GetLeapMonth(Int32, Int32) GetLeapMonth(Int32, Int32) GetLeapMonth(Int32, Int32) GetLeapMonth(Int32, Int32)

指定された年と時代 (年号) の閏月を計算します。Calculates the leap month for a specified year and era.

GetMilliseconds(DateTime) GetMilliseconds(DateTime) GetMilliseconds(DateTime) GetMilliseconds(DateTime)

指定した DateTime のミリ秒の値を返します。Returns the milliseconds value in the specified DateTime.

(Inherited from Calendar)
GetMinute(DateTime) GetMinute(DateTime) GetMinute(DateTime) GetMinute(DateTime)

指定した DateTime の分の値を返します。Returns the minutes value in the specified DateTime.

(Inherited from Calendar)
GetMonth(DateTime) GetMonth(DateTime) GetMonth(DateTime) GetMonth(DateTime)

指定した DateTime の月を返します。Returns the month in the specified DateTime.

GetMonthsInYear(Int32) GetMonthsInYear(Int32) GetMonthsInYear(Int32) GetMonthsInYear(Int32)

現在の時代 (年号) の指定した年の月数を返します。Returns the number of months in the specified year in the current era.

(Inherited from Calendar)
GetMonthsInYear(Int32, Int32) GetMonthsInYear(Int32, Int32) GetMonthsInYear(Int32, Int32) GetMonthsInYear(Int32, Int32)

指定した時代 (年号) の指定した年の月数を返します。Returns the number of months in the specified year in the specified era.

GetSecond(DateTime) GetSecond(DateTime) GetSecond(DateTime) GetSecond(DateTime)

指定した DateTime の秒の値を返します。Returns the seconds value in the specified DateTime.

(Inherited from Calendar)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek) GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek) GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek) GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek)

指定した DateTime の日付を含むその年の週を返します。Returns the week of the year that includes the date in the specified DateTime.

GetYear(DateTime) GetYear(DateTime) GetYear(DateTime) GetYear(DateTime)

指定した DateTime の年を返します。Returns the year in the specified DateTime.

IsLeapDay(Int32, Int32, Int32) IsLeapDay(Int32, Int32, Int32) IsLeapDay(Int32, Int32, Int32) IsLeapDay(Int32, Int32, Int32)

現在の時代 (年号) の指定した日付が閏日かどうかを判断します。Determines whether the specified date in the current era is a leap day.

(Inherited from Calendar)
IsLeapDay(Int32, Int32, Int32, Int32) IsLeapDay(Int32, Int32, Int32, Int32) IsLeapDay(Int32, Int32, Int32, Int32) IsLeapDay(Int32, Int32, Int32, Int32)

指定した時代 (年号) の指定した日付が閏日かどうかを確認します。Determines whether the specified date in the specified era is a leap day.

IsLeapMonth(Int32, Int32) IsLeapMonth(Int32, Int32) IsLeapMonth(Int32, Int32) IsLeapMonth(Int32, Int32)

現在の時代 (年号) の指定した年の指定した月が閏月かどうかを判断します。Determines whether the specified month in the specified year in the current era is a leap month.

(Inherited from Calendar)
IsLeapMonth(Int32, Int32, Int32) IsLeapMonth(Int32, Int32, Int32) IsLeapMonth(Int32, Int32, Int32) IsLeapMonth(Int32, Int32, Int32)

指定した時代 (年号) の指定した年の指定した月が閏月かどうかを確認します。Determines whether the specified month in the specified year in the specified era is a leap month.

IsLeapYear(Int32) IsLeapYear(Int32) IsLeapYear(Int32) IsLeapYear(Int32)

現在の時代 (年号) の指定した年が閏年かどうかを判断します。Determines whether the specified year in the current era is a leap year.

(Inherited from Calendar)
IsLeapYear(Int32, Int32) IsLeapYear(Int32, Int32) IsLeapYear(Int32, Int32) IsLeapYear(Int32, Int32)

指定した時代 (年号) の指定した年が閏年かどうかを確認します。Determines whether the specified year in the specified era is a leap year.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32) ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32) ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32) ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32)

現在の時代 (年号) の指定した日付と時刻に設定された DateTime を返します。Returns a DateTime that is set to the specified date and time in the current era.

(Inherited from Calendar)
ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32) ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32) ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32) ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)

指定した時代 (年号) の指定した日付と時刻に設定された DateTime を返します。Returns a DateTime that is set to the specified date and time in the specified era.

ToFourDigitYear(Int32) ToFourDigitYear(Int32) ToFourDigitYear(Int32) ToFourDigitYear(Int32)

TwoDigitYearMax プロパティを使用して、指定した年を 4 桁表記に変換し、適切な世紀を判断します。Converts the specified year to a four-digit year by using the TwoDigitYearMax property to determine the appropriate century.

ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

フィールド

CurrentEra CurrentEra CurrentEra CurrentEra

現在のカレンダーの現在の時代 (年号) を表します。Represents the current era of the current calendar. このフィールドの値は 0 です。The value of this field is 0.

(Inherited from Calendar)

適用対象

こちらもご覧ください