JapaneseCalendar JapaneseCalendar JapaneseCalendar JapaneseCalendar Class

Definición

Representa el calendario japonés.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
Herencia
JapaneseCalendarJapaneseCalendarJapaneseCalendarJapaneseCalendar
Atributos

Comentarios

El calendario japonés, que es también conocido como calendario Wareki, funciona exactamente igual que el calendario gregoriano, salvo que el año y era son diferentes.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.

Nota

Para obtener información sobre el uso de la JapaneseCalendar clase y otras clases en .NET de calendario, consulte trabajar con calendarios.For information about using the JapaneseCalendar class and the other calendar classes in .NET, see Working with Calendars.

El calendario japonés reconoce una era para cada imperial del.The Japanese calendar recognizes one era for every emperor's reign. Las dos últimas eras son la era Heisei, a partir del año del calendario gregoriano 1989 y la era Reiwa, a partir del año del calendario gregoriano de 2019.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. Normalmente, se muestra el nombre de la era anterior al año.The era name is typically displayed before the year. Por ejemplo, el año del calendario gregoriano 2001 es el año de calendario japonés Heisei 13.For example, the Gregorian calendar year 2001 is the Japanese calendar year Heisei 13. Tenga en cuenta que el primer año de una era se denomina "Gannen."Note that the first year of an era is called "Gannen." Por lo tanto, el año 1989 del calendario gregoriano fue el año de calendario japonés Heisei Gannen.Therefore, the Gregorian calendar year 1989 was the Japanese calendar year Heisei Gannen. De forma predeterminada, las operaciones con cadenas de formato de hora, por ejemplo, "D", "F" e "Y" y la fecha especificada de formato de salida Gannen en lugar de "1" en la cadena de resultado.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.

Importante

Las eras en los calendarios japoneses se basan en el reino del emperador y, por tanto, se espera que cambien.Eras in the Japanese calendars are based on the emperor's reign and are therefore expected to change. Por ejemplo, el 1 de mayo de 2019 marcaba el comienzo de la era Reiwa en JapaneseCalendar y JapaneseLunisolarCalendar.For example, May 1, 2019 marked the beginning of the Reiwa era in the JapaneseCalendar and JapaneseLunisolarCalendar. Este cambio de era afecta a todas las aplicaciones que usan estos calendarios.Such a change of era affects all applications that use these calendars. Para obtener más información y determinar si sus aplicaciones están entre las afectadas, consulte Handling a new era in the Japanese calendar in .NET (Gestión de una nueva era del calendario japonés en .NET).See Handling a new era in the Japanese calendar in .NET for more information and to determine whether your applications are affected. Para obtener más información sobre cómo probar aplicaciones en sistemas Windows para garantizar que estén preparadas para el cambio de era, consulte Prepare your application for the Japanese era change (Preparación de la aplicación para el cambio de era japonesa).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. Consulte Trabajar con eras para ver las características de .NET que admiten calendarios con varias eras y procedimientos recomendados al trabajar con calendarios que admiten varias 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.

Esta clase asigna a números a las eras de la siguiente manera:This class assigns numbers to the eras as follows:

GetEra valueGetEra value Nombre de la eraEra Name Abreviatura de la eraEra Abbreviation Fechas gregorianasGregorian Dates
55 令和 (Reiwa)令和 (Reiwa) 令和 (R, r)令和 (R, r) 1 de mayo de 2019 para presentarMay 1, 2019 to present
44 平成 (Heisei)平成 (Heisei) 平 (H, h)平 (H, h) 8 de enero de 1989 al 30 de abril de 2019January 8, 1989 to April 30, 2019
33 昭和 (Showa)昭和 (Showa) 昭 (S, s)昭 (S, s) 25 de diciembre de 1926 al 7 de enero de 1989December 25, 1926 to January 7, 1989
22 大正 (Taisho)大正 (Taisho) 大 (T, t)大 (T, t) 30 de julio de 1912 al 24 de diciembre de 1926July 30, 1912 to December 24, 1926
11 明治 (Meiji)明治 (Meiji) 明 (M, m)明 (M, m) 8 de septiembre de 1868 al 29 de julio de 1912September 8, 1868 to July 29, 1912

Esta clase controla las fechas desde el 8 de septiembre del año Meiji 1 (en el calendario gregoriano, 8 de septiembre de 1868).This class handles dates from September 8 in the year Meiji 1 (in the Gregorian calendar, September 8, 1868). Aunque el calendario japonés se cambió de un calendario lunar a un calendario solar en el año Meiji 6 (1873 del calendario gregoriano), esta implementación se basa en el calendario solar solo.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.

Los años bisiestos en el calendario japonés se corresponden con los años bisiestos mismos en el calendario gregoriano.Leap years in the Japanese calendar correspond to the same leap years in the Gregorian calendar. En el calendario gregoriano un año bisiesto se define como un año gregoriano que es divisible por cuatro, excepto si es divisible por 100.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. Sin embargo, los años que son divisibles por 400 son años bisiestos.However, Gregorian years that are divisible by 400 are leap years. Un año normal tiene 365 días y un año bisiesto tiene 366 días.A common year has 365 days and a leap year has 366 days.

El calendario japonés tiene 12 meses con 28 al 31 días:The Japanese calendar has 12 months with 28 to 31 days each:

Valor de GetMonthGetMonth value MesMonth InglésEnglish Días en años comunesDays in common years Días en años bisiestosDays in leap years
11 1月 (ichi gatsu)1月 (Ichigatsu) EneroJanuary 3131 3131
22 2月 (ni gatsu)2月 (Nigatsu) FebreroFebruary 2828 2929
33 3月 (SAN gatsu)3月 (Sangatsu) MarzoMarch 3131 3131
44 4月 (Shi gatsu)4月 (Shigatsu) AbrilApril 3030 3030
55 5月 (go gatsu)5月 (Gogatsu) MayoMay 3131 3131
66 6月 (Roku gatsu)6月 (Rokugatsu) JunioJune 3030 3030
77 7月 (Shichi gatsu)7月 (Shichigatsu) JulioJuly 3131 3131
88 8月 (Hachi gatsu)8月 (Hachigatsu) AgostoAugust 3131 3131
99 9月 (ku gatsu)9月 (Kugatsu) SeptiembreSeptember 3030 3030
1010 10月 (Juu gatsu)10月 (Juugatsu) OctubreOctober 3131 3131
1111 11月 (Juuichigatsu)11月 (Juuichigatsu) NoviembreNovember 3030 3030
1212 12月 (Juu ni gatsu)12月 (Juunigatsu) DiciembreDecember 3131 3131

Ni gatsu, que equivale al mes de calendario gregoriano de febrero, tiene 29 días durante los años bisiestos y 28 durante años.Nigatsu, which is equivalent to the Gregorian calendar month of February, has 29 days during leap years and 28 during common years.

La fecha del 1 de enero de 2001 D.C.The date January 1, 2001 A.D. en el calendario gregoriano es equivalente al primer día de ichi gatsu del año Heisei 13 en el calendario japonés.in the Gregorian calendar is equivalent to the first day of Ichigatsu in the year Heisei 13 in the Japanese calendar.

Si el JapaneseCalendar es el calendario actual de la referencia cultural japonés, DateTime.Parse reconoce las abreviaturas era delante del año.If the JapaneseCalendar is the current calendar of the Japanese culture, DateTime.Parse recognizes the era abbreviations in front of the year. La abreviatura es la abreviatura del alfabeto latino entre mayúsculas y minúsculas de carácter único o la abreviatura Kanji de carácter único.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 > también reconoce "1" o Gannen (元年) como el primer año de una era.xref:System.DateTime.Parse%2A?displayProperty=nameWithType> also recognizes either "1" or Gannen (元年) as the first year of an era.

Cada CultureInfo objeto admite un conjunto de calendarios.Each CultureInfo object supports a set of calendars. El Calendar propiedad devuelve el calendario predeterminado para la referencia cultural y el OptionalCalendars propiedad devuelve una matriz que contiene todos los calendarios admitidos por la referencia cultural.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. Para cambiar el calendario usado por un CultureInfo, establezca el DateTimeFormatInfo.Calendar propiedad a un nuevo Calendar.To change the calendar used by a CultureInfo, set the DateTimeFormatInfo.Calendar property to a new Calendar.

Constructores

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

Inicializa una nueva instancia de la clase JapaneseCalendar.Initializes a new instance of the JapaneseCalendar class.

Propiedades

AlgorithmType AlgorithmType AlgorithmType AlgorithmType

Obtiene un valor que indica si el calendario actual está basado en el calendario solar, en el lunar o en una combinación de ambos.Gets a value that indicates whether the current calendar is solar-based, lunar-based, or a combination of both.

DaysInYearBeforeMinSupportedYear DaysInYearBeforeMinSupportedYear DaysInYearBeforeMinSupportedYear DaysInYearBeforeMinSupportedYear

Obtiene el número de días del año que precede al año especificado por la propiedad 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

Obtiene la lista de eras de JapaneseCalendar.Gets the list of eras in the JapaneseCalendar.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

Obtiene un valor que indica si este objeto Calendar es de solo lectura.Gets a value indicating whether this Calendar object is read-only.

(Inherited from Calendar)
MaxSupportedDateTime MaxSupportedDateTime MaxSupportedDateTime MaxSupportedDateTime

Obtiene la última fecha y la última hora que admite el objeto JapaneseCalendar actual.Gets the latest date and time supported by the current JapaneseCalendar object.

MinSupportedDateTime MinSupportedDateTime MinSupportedDateTime MinSupportedDateTime

Obtiene la primera fecha y la primera hora que admite el objeto JapaneseCalendar actual.Gets the earliest date and time supported by the current JapaneseCalendar object.

TwoDigitYearMax TwoDigitYearMax TwoDigitYearMax TwoDigitYearMax

Obtiene o establece el último año de un intervalo de 100 años que puede representarse mediante un año de dos dígitos.Gets or sets the last year of a 100-year range that can be represented by a 2-digit year.

Métodos

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

Devuelve un DateTime que consiste en el número especificado de días transcurridos desde el DateTime especificado.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)

Devuelve un DateTime que consiste en el número especificado de horas transcurridas desde el DateTime especificado.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)

Devuelve un DateTime que consiste en el número especificado de milisegundos transcurridos desde el DateTime especificado.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)

Devuelve un DateTime que consiste en el número especificado de minutos transcurridos desde el DateTime especificado.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)

Devuelve un objeto DateTime que es un número específico de meses anterior o posterior al objeto DateTime especificado.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)

Devuelve un DateTime que consiste en el número especificado de segundos transcurridos desde el DateTime especificado.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)

Devuelve un DateTime que consiste en el número especificado de semanas aparte del DateTime especificado.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)

Devuelve un objeto DateTime que es el número especificado de años fuera del objeto DateTime especificado.Returns a DateTime that is the specified number of years away from the specified DateTime.

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

Crea un objeto nuevo copiado del objeto Calendar actual.Creates a new object that is a copy of the current Calendar object.

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

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

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

Devuelve el día del mes del objeto DateTime especificado.Returns the day of the month in the specified DateTime.

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

Devuelve el día de la semana del objeto DateTime especificado.Returns the day of the week in the specified DateTime.

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

Devuelve el día del año del objeto DateTime especificado.Returns the day of the year in the specified DateTime.

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

Devuelve el número de días del mes y año especificados de la era actual.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)

Devuelve el número de días del mes especificado del año especificado de la era especificada.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)

Devuelve el número de días del año especificado de la era actual.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)

Devuelve el número de días del año especificado de la era especificada.Returns the number of days in the specified year in the specified era.

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

Devuelve la era del objeto DateTime especificado.Returns the era in the specified DateTime.

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

Sirve como la función hash predeterminada.Serves as the default hash function.

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

Devuelve el valor de las horas del DateTime especificado.Returns the hours value in the specified DateTime.

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

Calcula el mes bisiesto para un año especificado.Calculates the leap month for a specified year.

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

Calcula el mes bisiesto para un año y era especificados.Calculates the leap month for a specified year and era.

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

Devuelve el valor de los milisegundos del DateTime especificado.Returns the milliseconds value in the specified DateTime.

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

Devuelve el valor de los minutos del DateTime especificado.Returns the minutes value in the specified DateTime.

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

Devuelve el mes del DateTime especificado.Returns the month in the specified DateTime.

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

Devuelve el número de meses del año especificado de la era actual.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)

Devuelve el número de meses del año especificado de la era especificada.Returns the number of months in the specified year in the specified era.

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

Devuelve el valor de los segundos del DateTime especificado.Returns the seconds value in the specified DateTime.

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

Obtiene el Type de la instancia actual.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)

Devuelve la semana del año que incluye la fecha del DateTime especificado.Returns the week of the year that includes the date in the specified DateTime.

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

Devuelve el año del DateTime especificado.Returns the year in the specified DateTime.

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

Determina si la fecha especificada de la era actual es un día bisiesto.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)

Determina si la fecha especificada de la era especificada es un día bisiesto.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)

Determina si el mes especificado del año especificado de la era actual es un mes bisiesto.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)

Determina si el mes especificado del año especificado de la era especificada es un mes bisiesto.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)

Determina si el año especificado de la era actual es un año bisiesto.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)

Determina si el año especificado de la era especificada es un año bisiesto.Determines whether the specified year in the specified era is a leap year.

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

Crea una copia superficial del Object actual.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)

Devuelve un DateTime que se establece en la fecha y la hora especificadas de la era actual.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)

Devuelve un DateTime que se establece en la fecha y hora de la era especificada.Returns a DateTime that is set to the specified date and time in the specified era.

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

Convierte el año especificado en un año de 4 dígitos mediante la propiedad TwoDigitYearMax para determinar el siglo adecuado.Converts the specified year to a four-digit year by using the TwoDigitYearMax property to determine the appropriate century.

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

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Campos

CurrentEra CurrentEra CurrentEra CurrentEra

Representa la era actual del calendario actual.Represents the current era of the current calendar. El valor de este campo es 0.The value of this field is 0.

(Inherited from Calendar)

Se aplica a

Consulte también: