Classe PersianCalendar

Este artigo fornece comentários complementares à documentação de referência para esta API.

O calendário persa é usado na maioria dos países/regiões onde persa é falada, embora algumas regiões usem nomes de mês diferentes. O calendário persa é o calendário oficial do Irã e afeganistão, e é um dos calendários alternativos em regiões como Cazaquistão e Tajiquistão.

Observação

Para obter informações sobre como usar a PersianCalendar classe e as outras classes de calendário no .NET, consulte Como trabalhar com calendários.

O calendário persa é um calendário hijri solar, e começa a partir do ano do Hijra, que corresponde a 622 C.E. no ano em que Muhammad (PBUH) migrou de Meca para Medina.

O calendário persa é baseado em um ano solar e tem aproximadamente 365 dias de duração. Um ano percorre quatro estações, e um novo ano começa quando o sol parece atravessar o equador do hemisfério sul para o hemisfério norte, como visto do centro da Terra. O ano novo marca o primeiro dia do mês de Farvardeen, que é o primeiro dia da primavera no hemisfério norte. Por exemplo, a data de 21 de março de 2002 corresponde ao primeiro dia do mês de Farvardeen no ano 1381 Anno Persico.

Cada um dos primeiros seis meses no calendário persa tem 31 dias, cada um dos próximos cinco meses tem 30 dias, e o último mês tem 29 dias em um ano comum e 30 dias em um ano bissexto. Um ano bissexto é um ano que, quando dividido por 33, tem um restante de 1, 5, 9, 13, 17, 22, 26 ou 30. Por exemplo, o ano 1370 é um ano bissexto porque dividi-lo por 33 produz um restante de 17. Há aproximadamente oito anos bissextos em cada ciclo de 33 anos.

As versões da classe PersianCalendar e do .NET

A partir do .NET Framework 4.6, a PersianCalendar classe usa o algoritmo astronômico solar Hijri em vez de um algoritmo observacional para calcular datas. Isso torna a PersianCalendar implementação consistente com o calendário persa em uso no Irã e no Afeganistão, os dois países nos quais o calendário persa está em uso mais difundido. A alteração afetará todos os aplicativos em execução no .NET Framework 4 ou posterior se o .NET Framework 4.6 estiver instalado.

Como resultado do algoritmo alterado:

• Os dois algoritmos devem retornar resultados idênticos ao converter datas entre 1800 e 2123 no calendário gregoriano.
• Os dois algoritmos podem retornar resultados diferentes ao converter datas antes de 1800 e depois de 2123 no calendário gregoriano.
• O valor da propriedade MinSupportedDateTime foi alterado de 21 de março de 0622 no calendário gregoriano para 22 de março de 0622 no calendário gregoriano.
• O valor da propriedade MaxSupportedDateTime foi alterado do 10º dia do 10º mês do ano 9378 no calendário persa para o 13º dia do 10º mês do ano 9378 no calendário persa.
• O IsLeapYear método pode retornar um resultado diferente do que anteriormente.

Usar a classe PersianCalendar

Você pode usar um PersianCalendar objeto para calcular datas no calendário persa ou converter datas persas de e para datas gregorianas. O calendário persa é o calendário padrão para culturas como Persa (Afeganistão) e Curdo Central (Irã).