JapaneseCalendar Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Representa o calendário japonês.
public ref class JapaneseCalendar : System::Globalization::Calendar
public 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.Calendar
type JapaneseCalendar = class
inherit Calendar
[<System.Serializable>]
type JapaneseCalendar = class
inherit Calendar
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type JapaneseCalendar = class
inherit Calendar
Public Class JapaneseCalendar
Inherits Calendar
- Herança
- Atributos
Observações
O calendário japonês, também conhecido como calendário Wareki, funciona exatamente como o calendário gregoriano, exceto que o ano e a era são diferentes.
Note
Para obter informações sobre como usar a JapaneseCalendar classe e as outras classes de calendário no .NET, consulte Trabalhando com calendários.
O calendário japonês reconhece uma era para o reinado de cada imperador. As duas eras mais recentes são a era Heisei, que começa no ano do calendário gregoriano de 1989, e a era Reiwa, que começa no ano do calendário gregoriano de 2019. O nome da era é normalmente exibido antes do ano. Por exemplo, o ano gregoriano de 2001 é o ano japonês Heisei 13. Note-se que o primeiro ano de uma era chama-se "Gannen". Portanto, o ano do calendário gregoriano de 1989 foi o ano japonês Heisei Gannen. Por defeito, operações de formatação com cadeias de formato de data e hora especificadas, como "D", "F" e "Y", geram Gannen em vez de "1" na cadeia de resultados.
Importante
As eras nos calendários japoneses são baseadas no reinado do imperador e, portanto, espera-se que mudem. Por exemplo, 1º de maio de 2019 marcou o início da era Reiwa no JapaneseCalendar e JapaneseLunisolarCalendar. Essa mudança de era afeta todos os aplicativos que usam esses calendários. Para obter mais informações e determinar se seus aplicativos são afetados, consulte Manipulando uma nova era no calendário japonês no .NET. Para obter informações sobre como testar seus aplicativos em sistemas Windows para garantir sua prontidão para a mudança de era, consulte Preparar seu aplicativo para a mudança de era japonesa. Para obter recursos no .NET que oferecem suporte a calendários com várias eras e práticas recomendadas ao trabalhar com calendários que suportam várias eras, consulte Trabalhando com eras.
Esta classe atribui números às eras da seguinte forma:
| Valor GetEra | Nome da Era | Abreviatura de Era | Datas Gregorianas |
|---|---|---|---|
| 5 | 令和 (Reiwa) | 令和 (R, r) | 1 de maio de 2019 até ao presente |
| 4 | 平成 (Heisei) | 平 (H, h) | 8 de janeiro de 1989 a 30 de abril de 2019 |
| 3 | 昭和 (Showa) | 昭 (S, s) | 25 de dezembro de 1926 a 7 de janeiro de 1989 |
| 2 | 大正 (Taisho) | 大 (T, t) | 30 de julho de 1912 a 24 de dezembro de 1926 |
| 1 | 明治 (Meiji) | 明 (M, m) | 23 de outubro de 1868 a 29 de julho de 1912 |
Esta classe trata datas de 23 de outubro do ano Meiji 1 (no calendário gregoriano, 23 de outubro de 1868). Embora o calendário japonês tenha sido alterado de calendário lunar para calendário solar no ano Meiji 6 (1873 do calendário gregoriano), esta implementação baseia-se apenas no calendário solar.
Os anos bissextos no calendário japonês correspondem aos mesmos anos bissextos no calendário gregoriano. Um ano bissexto no calendário gregoriano é definido como um ano gregoriano que é igualmente divisível por quatro, exceto se for divisível por 100. No entanto, os anos gregorianos que são divisíveis por 400 são anos bissextos. Um ano comum tem 365 dias e um ano bissexto tem 366 dias.
O calendário japonês tem 12 meses, cada, entre 28 a 31 dias:
| Valor GetMonth | Mês | Inglês | Dias em anos comuns | Dias em anos bissextos |
|---|---|---|---|---|
| 1 | 1月 (Ichigatsu) | Janeiro | 31 | 31 |
| 2 | 2月 (Nigatsu) | Fevereiro | 28 | 29 |
| 3 | 3月 (Sangatsu) | Março | 31 | 31 |
| 4 | 4月 (Shigatsu) | Abril | 30 | 30 |
| 5 | 5月 (Gogatsu) | Maio | 31 | 31 |
| 6 | 6月 (Rokugatsu) | Junho | 30 | 30 |
| 7 | 7月 (Shichigatsu) | Julho | 31 | 31 |
| 8 | 8月 (Hachigatsu) | Agosto | 31 | 31 |
| 9 | 9月 (Kugatsu) | Setembro | 30 | 30 |
| 10 | 10月 (Juugatsu) | Outubro | 31 | 31 |
| 11 | 11月 (Juuichigatsu) | Novembro | 30 | 30 |
| 12 | 12月 (Juunigatsu) | Dezembro | 31 | 31 |
Nigatsu, que equivale ao mês de fevereiro do calendário gregoriano, tem 29 dias durante os anos bissextos e 28 nos anos comuns.
A data 1 de janeiro de 2001 d.C. no calendário gregoriano equivale ao primeiro dia de Ichigatsu no ano Heisei 13 no calendário japonês.
Se for JapaneseCalendar o calendário atual da cultura japonesa, DateTime.Parse reconhece as abreviaturas de era antes do ano. A abreviatura é ou a abreviatura latina insensível a maiúsculas minúsculas e maiúsculas de carácter ou a abreviatura Kanji de um caractere. DateTime.Parse também reconhece "1" ou Gannen (元年) como o primeiro ano de uma era.
Cada CultureInfo objeto suporta um conjunto de calendários. A Calendar propriedade devolve o calendário padrão da cultura, e a OptionalCalendars propriedade devolve um array contendo todos os calendários suportados pela cultura. Para alterar o calendário usado por um CultureInfo, defina a DateTimeFormatInfo.Calendar propriedade para um novo Calendar.
Construtores
| Name | Description |
|---|---|
| JapaneseCalendar() |
Inicializa uma nova instância da JapaneseCalendar classe. |
Campos
| Name | Description |
|---|---|
| CurrentEra |
Representa a era atual do calendário atual. O valor deste campo é 0. (Herdado de Calendar) |
Propriedades
| Name | Description |
|---|---|
| AlgorithmType |
Recebe um valor que indica se o calendário atual é baseado em energia solar, lunar ou uma combinação de ambos. |
| DaysInYearBeforeMinSupportedYear |
Obtém o número de dias no ano anterior ao ano especificado pela MinSupportedDateTime propriedade. (Herdado de Calendar) |
| Eras |
Obtém a lista de eras no JapaneseCalendar. |
| IsReadOnly |
Recebe um valor que indica se este Calendar objeto é apenas de leitura. (Herdado de Calendar) |
| MaxSupportedDateTime |
Recebe a data e hora mais recentes suportadas pelo objeto atual JapaneseCalendar . |
| MinSupportedDateTime |
Obtém a data e hora mais antigas suportadas pelo objeto atual JapaneseCalendar . |
| TwoDigitYearMax |
Obtém ou define o último ano de um intervalo de 100 anos que pode ser representado por um ano de 2 dígitos. |
Métodos
| Name | Description |
|---|---|
| AddDays(DateTime, Int32) |
Devolve um DateTime que é o número de dias especificado a partir do especificado DateTime. (Herdado de Calendar) |
| AddHours(DateTime, Int32) |
Retorna um DateTime que é o número especificado de horas do especificado DateTime. (Herdado de Calendar) |
| AddMilliseconds(DateTime, Double) |
Devolve a DateTime que é o número especificado de milissegundos do especificado DateTime. (Herdado de Calendar) |
| AddMinutes(DateTime, Int32) |
Devolve a DateTime que é o número especificado de minutos do especificado DateTime. (Herdado de Calendar) |
| AddMonths(DateTime, Int32) |
Devolve um DateTime que é o número de meses especificado a partir do especificado DateTime. |
| AddSeconds(DateTime, Int32) |
Retorna a DateTime que é o número especificado de segundos a partir do especificado DateTime. (Herdado de Calendar) |
| AddWeeks(DateTime, Int32) |
Devolve um DateTime que é o número especificado de semanas a partir do especificado DateTime. (Herdado de Calendar) |
| AddYears(DateTime, Int32) |
Devolve um DateTime que é o número de anos especificado a partir do especificado DateTime. |
| Clone() |
Cria um novo objeto que é uma cópia do objeto atual Calendar . (Herdado de Calendar) |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetDayOfMonth(DateTime) |
Devolve no dia do mês no especificado DateTime. |
| GetDayOfWeek(DateTime) |
Devolve no dia da semana no especificado DateTime. |
| GetDayOfYear(DateTime) |
Devolve o dia do ano no especificado DateTime. |
| GetDaysInMonth(Int32, Int32, Int32) |
Devolve o número de dias no mês especificado, no ano especificado na era especificada. |
| GetDaysInMonth(Int32, Int32) |
Devolve o número de dias no mês e ano especificados da era atual. (Herdado de Calendar) |
| GetDaysInYear(Int32, Int32) |
Devolve o número de dias no ano especificado na era especificada. |
| GetDaysInYear(Int32) |
Devolve o número de dias no ano especificado da era atual. (Herdado de Calendar) |
| GetEra(DateTime) |
Devolve a era no especificado DateTime. |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetHour(DateTime) |
Devolve o valor das horas no especificado DateTime. (Herdado de Calendar) |
| GetLeapMonth(Int32, Int32) |
Calcula o mês bissexto para um ano e era especificados. |
| GetLeapMonth(Int32) |
Calcula o mês bissexto para um ano especificado. (Herdado de Calendar) |
| GetMilliseconds(DateTime) |
Devolve o valor de milissegundos no especificado DateTime. (Herdado de Calendar) |
| GetMinute(DateTime) |
Devolve o valor dos minutos no especificado DateTime. (Herdado de Calendar) |
| GetMonth(DateTime) |
Devolve no mês especificado DateTime. |
| GetMonthsInYear(Int32, Int32) |
Devolve o número de meses do ano especificado na era especificada. |
| GetMonthsInYear(Int32) |
Devolve o número de meses do ano especificado na era atual. (Herdado de Calendar) |
| GetSecond(DateTime) |
Devolve o valor dos segundos no especificado DateTime. (Herdado de Calendar) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek) |
Devolve a semana do ano que inclui a data no especificado DateTime. |
| GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek) |
Devolve a semana do ano que inclui a data no valor especificado DateTime . (Herdado de Calendar) |
| GetYear(DateTime) |
Devolve o ano no especificado DateTime. |
| IsLeapDay(Int32, Int32, Int32, Int32) |
Determina se a data especificada na era especificada é um dia bissexto. |
| IsLeapDay(Int32, Int32, Int32) |
Determina se a data especificada na era atual é um dia bissexto. (Herdado de Calendar) |
| IsLeapMonth(Int32, Int32, Int32) |
Determina se o mês especificado no ano especificado na era especificada é um mês bissexto. |
| IsLeapMonth(Int32, Int32) |
Determina se o mês especificado no ano especificado na era atual é um mês bissexto. (Herdado de Calendar) |
| IsLeapYear(Int32, Int32) |
Determina se o ano especificado na era especificada é um ano bissexto. |
| IsLeapYear(Int32) |
Determina se o ano especificado na era atual é um ano bissexto. (Herdado de Calendar) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32) |
Devolve a DateTime que está definido para a data e hora especificadas na era especificada. |
| ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32) |
Devolve a DateTime que está definido para a data e hora especificadas na era atual. (Herdado de Calendar) |
| ToFourDigitYear(Int32) |
Converte o ano especificado para um ano de quatro dígitos, usando a TwoDigitYearMax propriedade para determinar o século apropriado. |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |