JapaneseCalendar Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Representa o calendário 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- Herança
- Atributos
Comentários
O calendário japonês, que também é conhecido como calendário Wareki, funciona exatamente como o calendário gregoriano, exceto que o ano e a era são diferentes.
Observação
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, começando no ano civil gregoriano de 1989, e a era Reiwa, começando no ano civil gregoriano de 2019. O nome da era normalmente é exibido antes do ano. Por exemplo, o ano civil gregoriano de 2001 é o ano civil japonês Heisei 13. Observe que o primeiro ano de uma era é chamado de "Gannen". Portanto, o ano civil gregoriano de 1989 foi o ano civil japonês Heisei Gannen. Por padrão, as operações de formatação com cadeias de caracteres de formato de data e hora especificadas, como "D", "F" e "Y", geram Gannen em vez de "1" na cadeia de caracteres de resultado.
Importante
As eras nos calendários japoneses se baseiam no reinado do Imperador e, portanto, estão sujeitas a alterações. Por exemplo, 1º de maio de 2019 marcou o início da era Reiwa no JapaneseCalendar e no JapaneseLunisolarCalendar. Tal alteração de eras 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 preparação para a alteração da era, consulte Preparar seu aplicativo para a alteração da era japonesa. Para recursos no .NET que dão suporte a calendários com várias eras e para práticas recomendadas ao trabalhar com calendários que dão suporte a várias eras, consulte Trabalhando com eras.
Essa classe atribui números às eras da seguinte maneira:
| Valor GetEra | Nome da Era | Abreviação de Era | Datas gregorianas |
|---|---|---|---|
| 5 | 令和 (Reiwa) | 令和 (R, r) | 1º de maio de 2019 para apresentar |
| 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) | 8 de setembro de 1868 a 29 de julho de 1912 |
Esta classe manipula datas de 8 de setembro no ano Meiji 1 (no calendário gregoriano, 8 de setembro de 1868). Embora o calendário japonês tenha sido alternado de um calendário lunar para um calendário solar no ano Meiji 6 (1873 do calendário gregoriano), essa implementação é baseada 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 é uniformemente divisível por quatro, exceto se for divisível por 100. No entanto, anos gregorianos que são divisível 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 com 28 a 31 dias cada:
| 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) | Mai | 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 é equivalente ao mês calendário gregoriano de fevereiro, tem 29 dias durante os anos bissextos e 28 durante anos comuns.
A data de 1º de janeiro de 2001 no calendário gregoriano é equivalente ao primeiro dia de Ichigatsu no ano Heisei 13 no calendário japonês.
Se o JapaneseCalendar for o calendário atual da cultura japonesa, DateTime.Parse reconhecerá as abreviações de era na frente do ano. A abreviação é a abreviação do alfabeto latino sem diferenciação de maiúsculas e minúsculas de caractere único ou a abreviação Kanji de caractere único. DateTime.Parse também reconhece "1" ou Gannen (元年) como o primeiro ano de uma era.
Cada CultureInfo objeto dá suporte a um conjunto de calendários. A Calendar propriedade retorna o calendário padrão para a cultura e a OptionalCalendars propriedade retorna uma matriz que contém todos os calendários compatíveis com a cultura. Para alterar o calendário usado por um CultureInfo, defina a DateTimeFormatInfo.Calendar propriedade como um novo Calendar.
Construtores
| JapaneseCalendar() |
Inicializa uma nova instância da classe JapaneseCalendar. |
Campos
| CurrentEra |
Representa a era atual do calendário atual. O valor desse campo é 0. (Herdado de Calendar) |
Propriedades
| AlgorithmType |
Obtém um valor que indica se o calendário atual é solar, lunar ou uma combinação de ambos. |
| AlgorithmType |
Obtém um valor que indica se o calendário atual é solar, lunar ou uma combinação de ambos. (Herdado de Calendar) |
| DaysInYearBeforeMinSupportedYear |
Obtém o número de dias do ano que precede o ano especificado pela propriedade MinSupportedDateTime. (Herdado de Calendar) |
| Eras |
Obtém a lista de eras no JapaneseCalendar. |
| IsReadOnly |
Obtém um valor que indica se esse objeto Calendar é somente leitura. (Herdado de Calendar) |
| MaxSupportedDateTime |
Obtém a data e a hora mais recentes com suporte pelo objeto JapaneseCalendar. |
| MaxSupportedDateTime |
Obtém a data e hora mais recentes com suporte deste objeto Calendar. (Herdado de Calendar) |
| MinSupportedDateTime |
Obtém a data e a hora mais antigas com suporte pelo objeto JapaneseCalendar. |
| MinSupportedDateTime |
Obtém a data e hora menos recentes com suporte deste objeto Calendar. (Herdado de Calendar) |
| TwoDigitYearMax |
Obtém ou define o último ano de um intervalo de 100 anos que pode ser representado por um ano de dois dígitos. |
Métodos
| AddDays(DateTime, Int32) |
Retorna um DateTime que é o número especificado de dias à frente do DateTime indicado. (Herdado de Calendar) |
| AddHours(DateTime, Int32) |
Retorna um DateTime que é o número especificado de horas à frente do DateTime indicado. (Herdado de Calendar) |
| AddMilliseconds(DateTime, Double) |
Retorna um DateTime que é o número especificado de milissegundos à frente do DateTime indicado. (Herdado de Calendar) |
| AddMinutes(DateTime, Int32) |
Retorna um DateTime que é o número especificado de minutos à frente do DateTime indicado. (Herdado de Calendar) |
| AddMonths(DateTime, Int32) |
Retorna um DateTime, que é o número especificado de meses de distância do DateTime especificado. |
| AddSeconds(DateTime, Int32) |
Retorna um DateTime que é o número especificado de segundos à frente do DateTime indicado. (Herdado de Calendar) |
| AddWeeks(DateTime, Int32) |
Retorna um DateTime que é o número especificado de semanas à frente do DateTime indicado. (Herdado de Calendar) |
| AddYears(DateTime, Int32) |
Retorna um DateTime, que é o número especificado de anos de distância do DateTime especificado. |
| Clone() |
Cria um novo objeto que é uma cópia do objeto Calendar atual. (Herdado de Calendar) |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetDayOfMonth(DateTime) |
Retorna o dia do mês no DateTime especificado. |
| GetDayOfWeek(DateTime) |
Retorna o dia da semana no DateTime especificado. |
| GetDayOfYear(DateTime) |
Retorna o dia do ano no DateTime especificado. |
| GetDaysInMonth(Int32, Int32) |
Retorna o número de dias no mês e ano especificados da era atual. (Herdado de Calendar) |
| GetDaysInMonth(Int32, Int32, Int32) |
Retorna o número de dias no mês especificado do ano especificado na era especificada. |
| GetDaysInYear(Int32) |
Retorna o número de dias no ano especificado da era atual. (Herdado de Calendar) |
| GetDaysInYear(Int32, Int32) |
Retorna o número de dias do ano especificado na era especificada. |
| GetEra(DateTime) |
Retorna a era no DateTime especificado. |
| GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
| GetHour(DateTime) |
Retorna o valor de horas no DateTime especificado. (Herdado de Calendar) |
| GetLeapMonth(Int32) |
Calcula o mês bissexto de um ano especificado. (Herdado de Calendar) |
| GetLeapMonth(Int32, Int32) |
Calcula o mês bissexto de um ano e era especificados. |
| GetLeapMonth(Int32, Int32) |
Calcula o mês bissexto de um ano e era especificados. (Herdado de Calendar) |
| GetMilliseconds(DateTime) |
Retorna o valor de milissegundos no DateTime especificado. (Herdado de Calendar) |
| GetMinute(DateTime) |
Retorna o valor de minutos no DateTime especificado. (Herdado de Calendar) |
| GetMonth(DateTime) |
Retorna o mês na DateTime especificada. |
| GetMonthsInYear(Int32) |
Retorna o número de meses no ano especificado na era atual. (Herdado de Calendar) |
| GetMonthsInYear(Int32, Int32) |
Retorna o número de meses no ano especificado na era especificada. |
| GetSecond(DateTime) |
Retorna o valor de segundos no DateTime especificado. (Herdado de Calendar) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek) |
Retorna a semana do ano que inclui a data no DateTime especificado. |
| GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek) |
Retorna a semana do ano que inclui a data no valor DateTime especificado. (Herdado de Calendar) |
| GetYear(DateTime) |
Retorna o ano no DateTime especificado. |
| IsLeapDay(Int32, Int32, Int32) |
Determina se a data especificada na era atual é um dia bissexto. (Herdado de Calendar) |
| IsLeapDay(Int32, Int32, Int32, Int32) |
Determina se a data especificada na era especificada é um dia bissexto. |
| IsLeapMonth(Int32, Int32) |
Determina se o mês especificado no ano especificado na era atual é um mês bissexto. (Herdado de Calendar) |
| IsLeapMonth(Int32, Int32, Int32) |
Determina se o mês especificado no ano especificado na era especificada é um mês bissexto. |
| IsLeapYear(Int32) |
Determina se o ano especificado na era atual é um ano bissexto. (Herdado de Calendar) |
| IsLeapYear(Int32, Int32) |
Determina se o ano especificado na era especificada é um ano bissexto. |
| MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
| ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32) |
Retorna um DateTime que é definido como a data e hora especificadas na era atual. (Herdado de Calendar) |
| ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32) |
Retorna um DateTime, que é definido como a data e hora especificadas na era especificada. |
| ToFourDigitYear(Int32) |
Converte o ano especificado em um ano de quatro dígitos usando a propriedade TwoDigitYearMax para determinar o século apropriado. |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
