JapaneseCalendar Classe

Definição

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
JapaneseCalendar
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)

Aplica-se a

Confira também