JapaneseCalendar Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Representa el calendario japonés.
public ref class JapaneseCalendar : System::Globalization::Calendarpublic class JapaneseCalendar : System.Globalization.Calendar[System.Serializable]
public class JapaneseCalendar : System.Globalization.Calendar[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class JapaneseCalendar : System.Globalization.Calendartype JapaneseCalendar = class
inherit Calendar[<System.Serializable>]
type JapaneseCalendar = class
inherit Calendar[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type JapaneseCalendar = class
inherit CalendarPublic Class JapaneseCalendar
Inherits Calendar- Herencia
- Atributos
Comentarios
El calendario japonés, que también se conoce como calendario Wareki, funciona exactamente como el calendario gregoriano, excepto que el año y la era son diferentes.
Nota
Para obtener información sobre el uso de la JapaneseCalendar clase y las demás clases de calendario en .NET, vea Trabajar con calendarios.
El calendario japonés reconoce una era para el reinado de cada emperador. Las dos eras más recientes son la era Heisei, a partir del año natural gregoriano 1989, y la era Reiwa, comenzando en el año natural gregoriano 2019. El nombre de la era se muestra normalmente antes del año. Por ejemplo, el año natural gregoriano 2001 es el año natural japonés Heisei 13. Tenga en cuenta que el primer año de una era se denomina "Gannen". Por lo tanto, el año natural gregoriano 1989 fue el año natural japonés Heisei Gannen. De forma predeterminada, las operaciones de formato con cadenas de formato de fecha y hora especificadas, como "D", "F" y "Y", generan Gannen en lugar de "1" en la cadena de resultado.
Importante
Las eras en los calendarios japoneses se basan en el reino del emperador y, por tanto, se espera que cambien. Por ejemplo, el 1 de mayo de 2019 marcaba el comienzo de la era Reiwa en JapaneseCalendar y JapaneseLunisolarCalendar. Este cambio de era afecta a todas las aplicaciones que usan estos calendarios. Para obtener más información y determinar si las aplicaciones se ven afectadas, consulte Control de una nueva era en el calendario japonés en .NET. Para obtener información sobre cómo probar las aplicaciones en sistemas Windows para garantizar su preparación para el cambio de era, consulte Preparación de la aplicación para el cambio en la era japonesa. Para conocer las características de .NET que admiten calendarios con varias eras y procedimientos recomendados al trabajar con calendarios que admiten varias eras, consulte Trabajar con eras.
Esta clase asigna números a las eras de la siguiente manera:
| Valor getEra | Nombre de la era | Abreviatura de era | Fechas gregorianas |
|---|---|---|---|
| 5 | 令和 (Reiwa) | 令和 (R, r) | 1 de mayo de 2019 para presentar |
| 4 | 平成 (Heisei) | 平 (H, h) | 8 de enero de 1989 al 30 de abril de 2019 |
| 3 | 昭和 (Showa) | 昭 (S, s) | 25 de diciembre de 1926 al 7 de enero de 1989 |
| 2 | 正 (Taisho) | (T, t) | 30 de julio de 1912 al 24 de diciembre de 1926 |
| 1 | 明治 (Meiji) | 明 (M, m) | 8 de septiembre de 1868 al 29 de julio de 1912 |
Esta clase controla las fechas del 8 de septiembre del año Meiji 1 (en el calendario gregoriano, 8 de septiembre de 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 únicamente en el calendario solar.
Los años bisiestos del calendario japonés corresponden a los mismos años bisiestos en el calendario gregoriano. Un año bisiesto en el calendario gregoriano se define como un año gregoriano que es divisible uniformemente por cuatro, excepto si es divisible en 100. Sin embargo, los años gregorianos que son divisibles en 400 años son bisiestos. Un año común tiene 365 días y un año bisiesto tiene 366 días.
El calendario japonés tiene 12 meses con 28 a 31 días cada uno:
| Valor getMonth | Month (Mes) | Inglés | Días en años comunes | Días en años bisiestos |
|---|---|---|---|---|
| 1 | 1月 (Ichigatsu) | January | 31 | 31 |
| 2 | 2月 (Nigatsu) | February | 28 | 29 |
| 3 | 3月 (Sangatsu) | Marzo | 31 | 31 |
| 4 | 4月 (Shigatsu) | April | 30 | 30 |
| 5 | 5月 (Gogatsu) | May | 31 | 31 |
| 6 | 6月 (Rokugatsu) | Junio | 30 | 30 |
| 7 | 7月 (Shichigatsu) | Julio | 31 | 31 |
| 8 | 8月 (Hachigatsu) | Agosto | 31 | 31 |
| 9 | 9月 (Kugatsu) | Septiembre | 30 | 30 |
| 10 | 10月 (Juugatsu) | Octubre | 31 | 31 |
| 11 | 11月 (Juuichigatsu) | Noviembre | 30 | 30 |
| 12 | 12月 (Juunigatsu) | Diciembre | 31 | 31 |
Nigatsu, que es equivalente al mes natural gregoriano de febrero, tiene 29 días durante los años bisiestos y 28 durante los años comunes.
La fecha del 1 de enero de 2001 A.D. en el calendario gregoriano es equivalente al primer día de Ichigatsu en el año Heisei 13 en el calendario japonés.
JapaneseCalendar Si es el calendario actual de la cultura japonesa, DateTime.Parse reconoce las abreviaturas de la era delante del año. La abreviatura es la abreviatura del alfabeto latino que no distingue mayúsculas de minúsculas de un solo carácter o la abreviatura kanji de un solo carácter. DateTime.Parse también reconoce "1" o Gannen (元年) como primer año de una era.
Cada CultureInfo objeto admite un conjunto de calendarios. La Calendar propiedad devuelve el calendario predeterminado para la referencia cultural y la OptionalCalendars propiedad devuelve una matriz que contiene todos los calendarios admitidos por la referencia cultural. Para cambiar el calendario usado por , CultureInfoestablezca la DateTimeFormatInfo.Calendar propiedad en un nuevo Calendar.
Constructores
| JapaneseCalendar() |
Inicializa una nueva instancia de la clase JapaneseCalendar. |
Campos
| CurrentEra |
Representa la era actual del calendario actual. El valor de este campo es 0. (Heredado de Calendar) |
Propiedades
| 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. |
| 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. (Heredado de Calendar) |
| DaysInYearBeforeMinSupportedYear |
Obtiene el número de días del año que precede al año especificado por la propiedad MinSupportedDateTime. (Heredado de Calendar) |
| Eras |
Obtiene la lista de eras de JapaneseCalendar. |
| IsReadOnly |
Obtiene un valor que indica si este objeto Calendar es de solo lectura. (Heredado de Calendar) |
| MaxSupportedDateTime |
Obtiene la última fecha y la última hora que admite el objeto JapaneseCalendar actual. |
| MaxSupportedDateTime |
Obtiene las últimas fecha y hora admitidas por este objeto Calendar. (Heredado de Calendar) |
| MinSupportedDateTime |
Obtiene la primera fecha y la primera hora que admite el objeto JapaneseCalendar actual. |
| MinSupportedDateTime |
Obtiene las primeras fecha y hora admitidas por este objeto Calendar. (Heredado de Calendar) |
| 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. |
Métodos
| AddDays(DateTime, Int32) |
Devuelve un DateTime que consiste en el número especificado de días transcurridos desde el DateTime especificado. (Heredado de Calendar) |
| AddHours(DateTime, Int32) |
Devuelve un DateTime que consiste en el número especificado de horas transcurridas desde el DateTime especificado. (Heredado de Calendar) |
| AddMilliseconds(DateTime, Double) |
Devuelve un DateTime que consiste en el número especificado de milisegundos transcurridos desde el DateTime especificado. (Heredado de Calendar) |
| AddMinutes(DateTime, Int32) |
Devuelve un DateTime que consiste en el número especificado de minutos transcurridos desde el DateTime especificado. (Heredado de Calendar) |
| AddMonths(DateTime, Int32) |
Devuelve un objeto DateTime que es un número específico de meses anterior o posterior al objeto DateTime especificado. |
| AddSeconds(DateTime, Int32) |
Devuelve un DateTime que consiste en el número especificado de segundos transcurridos desde el DateTime especificado. (Heredado de Calendar) |
| AddWeeks(DateTime, Int32) |
Devuelve un DateTime que consiste en el número especificado de semanas aparte del DateTime especificado. (Heredado de Calendar) |
| AddYears(DateTime, Int32) |
Devuelve un objeto DateTime que es el número especificado de años fuera del objeto DateTime especificado. |
| Clone() |
Crea un objeto nuevo copiado del objeto Calendar actual. (Heredado de Calendar) |
| Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
| GetDayOfMonth(DateTime) |
Devuelve el día del mes del objeto DateTime especificado. |
| GetDayOfWeek(DateTime) |
Devuelve el día de la semana del objeto DateTime especificado. |
| GetDayOfYear(DateTime) |
Devuelve el día del año del objeto DateTime especificado. |
| GetDaysInMonth(Int32, Int32) |
Devuelve el número de días del mes y año especificados de la era actual. (Heredado de Calendar) |
| GetDaysInMonth(Int32, Int32, Int32) |
Devuelve el número de días del mes especificado del año especificado de la era especificada. |
| GetDaysInYear(Int32) |
Devuelve el número de días del año especificado de la era actual. (Heredado de Calendar) |
| GetDaysInYear(Int32, Int32) |
Devuelve el número de días del año especificado de la era especificada. |
| GetEra(DateTime) |
Devuelve la era del objeto DateTime especificado. |
| GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
| GetHour(DateTime) |
Devuelve el valor de las horas del DateTime especificado. (Heredado de Calendar) |
| GetLeapMonth(Int32) |
Calcula el mes bisiesto para un año especificado. (Heredado de Calendar) |
| GetLeapMonth(Int32, Int32) |
Calcula el mes bisiesto para un año y era especificados. |
| GetLeapMonth(Int32, Int32) |
Calcula el mes bisiesto para un año y era especificados. (Heredado de Calendar) |
| GetMilliseconds(DateTime) |
Devuelve el valor de los milisegundos del DateTime especificado. (Heredado de Calendar) |
| GetMinute(DateTime) |
Devuelve el valor de los minutos del DateTime especificado. (Heredado de Calendar) |
| GetMonth(DateTime) |
Devuelve el mes del DateTime especificado. |
| GetMonthsInYear(Int32) |
Devuelve el número de meses del año especificado de la era actual. (Heredado de Calendar) |
| GetMonthsInYear(Int32, Int32) |
Devuelve el número de meses del año especificado de la era especificada. |
| GetSecond(DateTime) |
Devuelve el valor de los segundos del DateTime especificado. (Heredado de Calendar) |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek) |
Devuelve la semana del año que incluye la fecha del DateTime especificado. |
| GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek) |
Devuelve la semana del año que incluye la fecha en el valor DateTime especificado. (Heredado de Calendar) |
| GetYear(DateTime) |
Devuelve el año del DateTime especificado. |
| IsLeapDay(Int32, Int32, Int32) |
Determina si la fecha especificada de la era actual es un día bisiesto. (Heredado de Calendar) |
| IsLeapDay(Int32, Int32, Int32, Int32) |
Determina si la fecha especificada de la era especificada es un día bisiesto. |
| IsLeapMonth(Int32, Int32) |
Determina si el mes especificado del año especificado de la era actual es un mes bisiesto. (Heredado de Calendar) |
| IsLeapMonth(Int32, Int32, Int32) |
Determina si el mes especificado del año especificado de la era especificada es un mes bisiesto. |
| IsLeapYear(Int32) |
Determina si el año especificado de la era actual es un año bisiesto. (Heredado de Calendar) |
| IsLeapYear(Int32, Int32) |
Determina si el año especificado de la era especificada es un año bisiesto. |
| MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
| 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. (Heredado de Calendar) |
| ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32) |
Devuelve un DateTime que se establece en la fecha y hora de la era especificada. |
| ToFourDigitYear(Int32) |
Convierte el año especificado en un año de 4 dígitos mediante la propiedad TwoDigitYearMax para determinar el siglo adecuado. |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
