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 igual que el calendario gregoriano, excepto que el año y la era son diferentes.
Note
Para obtener información sobre el uso de la JapaneseCalendar clase y las otras 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, comenzando en el 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 reinado del emperador y, por tanto, se espera que cambien. Por ejemplo, el 1 de mayo de 2019 marcó el principio 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 de la era japonesa. Para ver 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 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) | 23 de octubre de 1868 al 29 de julio de 1912 |
Esta clase controla las fechas del 23 de octubre del año Meiji 1 (en el calendario gregoriano, 23 de octubre 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 solo 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 divisible por cuatro, excepto si es divisible en 100. Sin embargo, los años gregorianos que son divisibles en 400 años bisiestos. Un año común tiene 365 días y un año bisiesto tiene 366 días.
El calendario japonés tiene de 12 meses con 28 a 31 días cada uno:
| Valor GetMonth | Mes | English | Días en años comunes | Días bisiestos |
|---|---|---|---|---|
| 1 | 1月 (Ichigatsu) | Enero | 31 | 31 |
| 2 | 2月 (Nigatsu) | Febrero | 28 | 29 |
| 3 | 3月 (Sangatsu) | Marzo | 31 | 31 |
| 4 | 4月 (Shigatsu) | Abril | 30 | 30 |
| 5 | 5月 (Gogatsu) | Mayo | 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 carácter único o la abreviatura kanji de carácter único. 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
| Nombre | Description |
|---|---|
| JapaneseCalendar() |
Inicializa una nueva instancia de la clase JapaneseCalendar. |
Campos
| Nombre | Description |
|---|---|
| CurrentEra |
Representa la era actual del calendario actual. El valor de este campo es 0. (Heredado de Calendar) |
Propiedades
| Nombre | Description |
|---|---|
| AlgorithmType |
Obtiene un valor que indica si el calendario actual está basado en solar, basado en lunares o una combinación de ambos. |
| DaysInYearBeforeMinSupportedYear |
Obtiene el número de días del año que precede al año especificado por la MinSupportedDateTime propiedad . (Heredado de Calendar) |
| Eras |
Obtiene la lista de eras en .JapaneseCalendar |
| IsReadOnly |
Obtiene un valor que indica si este Calendar objeto es de solo lectura. (Heredado de Calendar) |
| MaxSupportedDateTime |
Obtiene la fecha y hora más recientes admitidas por el objeto actual JapaneseCalendar . |
| MinSupportedDateTime |
Obtiene la fecha y hora más tempranas admitidas por el objeto actual JapaneseCalendar . |
| TwoDigitYearMax |
Obtiene o establece el último año de un intervalo de 100 años que se puede representar mediante un año de 2 dígitos. |
Métodos
| Nombre | Description |
|---|---|
| AddDays(DateTime, Int32) |
Devuelve un DateTime valor de tipo que es el número especificado de días lejos del especificado DateTime. (Heredado de Calendar) |
| AddHours(DateTime, Int32) |
Devuelve un DateTime valor de tipo que es el número especificado de horas lejos del especificado DateTime. (Heredado de Calendar) |
| AddMilliseconds(DateTime, Double) |
Devuelve un DateTime valor de tipo que es el número especificado de milisegundos lejos del especificado DateTime. (Heredado de Calendar) |
| AddMinutes(DateTime, Int32) |
Devuelve un DateTime valor de tipo que es el número especificado de minutos lejos del especificado DateTime. (Heredado de Calendar) |
| AddMonths(DateTime, Int32) |
Devuelve un valor DateTime de tipo que es el número especificado de meses lejos del especificado DateTime. |
| AddSeconds(DateTime, Int32) |
Devuelve un DateTime valor de tipo que es el número especificado de segundos lejos del especificado DateTime. (Heredado de Calendar) |
| AddWeeks(DateTime, Int32) |
Devuelve un DateTime valor de tipo que es el número especificado de semanas lejos del especificado DateTime. (Heredado de Calendar) |
| AddYears(DateTime, Int32) |
Devuelve un DateTime valor de tipo que es el número especificado de años lejos del especificado DateTime. |
| Clone() |
Crea un nuevo objeto que es una copia del objeto actual Calendar . (Heredado de Calendar) |
| Equals(Object) |
Determina si el objeto especificado es igual al objeto actual. (Heredado de Object) |
| GetDayOfMonth(DateTime) |
Devuelve el día del mes en el especificado DateTime. |
| GetDayOfWeek(DateTime) |
Devuelve el día de la semana en el especificado DateTime. |
| GetDayOfYear(DateTime) |
Devuelve el día del año en el especificado DateTime. |
| GetDaysInMonth(Int32, Int32, Int32) |
Devuelve el número de días del mes especificado en el año especificado en la era especificada. |
| GetDaysInMonth(Int32, Int32) |
Devuelve el número de días del mes y el año especificados de la era actual. (Heredado de Calendar) |
| GetDaysInYear(Int32, Int32) |
Devuelve el número de días del año especificado en la era especificada. |
| GetDaysInYear(Int32) |
Devuelve el número de días del año especificado de la era actual. (Heredado de Calendar) |
| GetEra(DateTime) |
Devuelve la era en el especificado DateTime. |
| GetHashCode() |
Actúa como función hash predeterminada. (Heredado de Object) |
| GetHour(DateTime) |
Devuelve el valor de horas del especificado DateTime. (Heredado de Calendar) |
| GetLeapMonth(Int32, Int32) |
Calcula el mes bisiesto para un año y una era especificados. |
| GetLeapMonth(Int32) |
Calcula el mes bisiesto para un año especificado. (Heredado de Calendar) |
| GetMilliseconds(DateTime) |
Devuelve el valor de milisegundos del especificado DateTime. (Heredado de Calendar) |
| GetMinute(DateTime) |
Devuelve el valor de minutos en el especificado DateTime. (Heredado de Calendar) |
| GetMonth(DateTime) |
Devuelve el mes del especificado DateTime. |
| GetMonthsInYear(Int32, Int32) |
Devuelve el número de meses del año especificado en la era especificada. |
| GetMonthsInYear(Int32) |
Devuelve el número de meses del año especificado en la era actual. (Heredado de Calendar) |
| GetSecond(DateTime) |
Devuelve el valor de segundos en el especificado DateTime. (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 en el especificado DateTime. |
| GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek) |
Devuelve la semana del año que incluye la fecha en el valor especificado DateTime . (Heredado de Calendar) |
| GetYear(DateTime) |
Devuelve el año en el especificado DateTime. |
| IsLeapDay(Int32, Int32, Int32, Int32) |
Determina si la fecha especificada en la era especificada es un día bisiesto. |
| IsLeapDay(Int32, Int32, Int32) |
Determina si la fecha especificada en la era actual es un día bisiesto. (Heredado de Calendar) |
| IsLeapMonth(Int32, Int32, Int32) |
Determina si el mes especificado del año especificado en la era especificada es un mes bisiesto. |
| IsLeapMonth(Int32, Int32) |
Determina si el mes especificado del año especificado en la era actual es un mes bisiesto. (Heredado de Calendar) |
| IsLeapYear(Int32, Int32) |
Determina si el año especificado en la era especificada es un año bisiesto. |
| IsLeapYear(Int32) |
Determina si el año especificado en la era actual es un año bisiesto. (Heredado de Calendar) |
| MemberwiseClone() |
Crea una copia superficial del Objectactual. (Heredado de Object) |
| ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32) |
Devuelve un DateTime objeto que se establece en la fecha y hora especificadas en la era especificada. |
| ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32) |
Devuelve un DateTime que se establece en la fecha y hora especificadas en la era actual. (Heredado de Calendar) |
| ToFourDigitYear(Int32) |
Convierte el año especificado en un año de cuatro dígitos mediante la TwoDigitYearMax propiedad para determinar el siglo adecuado. |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
