PersianCalendar classe

Este artigo fornece observações complementares à documentação de referência para esta API.

O calendário persa é usado na maioria dos países/regiões onde o persa é falado, embora algumas regiões usem nomes de meses diferentes. O calendário persa é o calendário oficial do Irã e do 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 Trabalhando com calendários.

O calendário persa é um calendário solar Hijri, e começa a partir do ano da Hijra, que corresponde a 622 d.C., o ano em que Maomé (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 passa por quatro estações, e um novo ano começa quando o sol parece cruzar o equador do hemisfério sul para o hemisfério norte, visto do centro da Terra. O novo ano 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 d.C. corresponde ao primeiro dia do mês de Farvardeen no ano de 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 de 1370 é um ano bissexto porque, ao dividi-lo por 33, obtém-se um resto de 17. Há aproximadamente oito anos bissextos em cada ciclo de 33 anos.

A classe PersianCalendar e versões .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 em que o calendário persa está em uso mais difundido. A alteração afeta todos os aplicativos executados 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 anteriores a 1800 e posteriores a 2123 no calendário gregoriano.
• O MinSupportedDateTime valor do imóvel mudou de 21 de março de 0622 no calendário gregoriano para 22 de março de 0622 no calendário gregoriano.
• O MaxSupportedDateTime valor da propriedade mudou 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 fazia anteriormente.

Use 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ã).