Třída PersianCalendar

Tento článek obsahuje doplňující poznámky k referenční dokumentaci pro toto rozhraní API.

Perský kalendář se používá ve většině zemí/oblastí, kde perština mluví, i když některé oblasti používají různé názvy měsíců. Perský kalendář je oficiálním kalendářem Íránu a Afghánistánu a je to jeden z alternativních kalendářů v regionech, jako je Kazachstán a Tádžikistán.

Poznámka:

Informace o používání PersianCalendar třídy a dalších tříd kalendáře v .NET naleznete v tématu Práce s kalendáři.

Perský kalendář je solární kalendář Hidžra a začíná od roku Hidžra, který odpovídá roku 622 C.E. roku, kdy Muhammad (PBUH) migroval z Mecca do Medina.

Perský kalendář je založen na slunečním roce a je přibližně 365 dní dlouhý. Rok prochází čtyřmi ročními obdobími a nový rok začíná, když se zdá, že slunce překříží rovník z jižní polokoule na severní polokouli, jak je vidět ze středu Země. Nový rok označuje první den měsíce Farvardeen, což je první den jara na severní polokouli. Například datum 21. března 2002 C.E. odpovídá prvnímu dni měsíce Farvardeen v roce 1381 Anno Persico.

Každý z prvních šesti měsíců v perském kalendáři má 31 dní, každý z následujících pěti měsíců má 30 dní a poslední měsíc má 29 dní ve společném roce a 30 dní v přestupném roce. Přestupný rok je rok, který má při dělení 33 zbytek 1, 5, 9, 13, 17, 22, 26 nebo 30. Například rok 1370 je přestupný rok, protože jeho rozdělení 33 přináší zbytek 17. Každý 33letý cyklus má přibližně osm přestupných let.

PerskýCalendar – třída a verze rozhraní .NET Framework

Počínaje rozhraním .NET Framework 4.6 třída PersianCalendar používá k výpočtu kalendářních dat místo observačního algoritmu sluneční astronomický algoritmus Hidžra. Díky tomu je PersianCalendar provádění v souladu s perským kalendářem, který se používá v Íránu a Afghánistánu, dvě země, ve kterých je perský kalendář nejrozšířenější. Tato změna má vliv na všechny aplikace spuštěné v rozhraní .NET Framework 4 nebo novější, pokud je nainstalovaná rozhraní .NET Framework 4.6.

Výsledkem změněného algoritmu:

• Dva algoritmy by měly při převodu kalendářních dat mezi 1800 a 2123 v gregoriánském kalendáři vrátit stejné výsledky.

• Dva algoritmy můžou při převodu kalendářních dat před 1800 a po roce 2123 v gregoriánském kalendáři vrátit různé hodnoty.

• Hodnota MinSupportedDateTime vlastnosti se změnila z 21. března 0622 v gregoriánském kalendáři na 22. března 0622 v gregoriánském kalendáři.

• Hodnota MaxSupportedDateTime nemovitosti se změnila z 10. dne 10. měsíce roku 9378 v Perském kalendáři na 13. den 10. měsíce roku 9378 v Perském kalendáři.

• Metoda IsLeapYear může vrátit jiný výsledek, než tomu bylo dříve.

Použití perskéhoCalendar – třída

Aplikace používají PersianCalendar objekt k výpočtu kalendářních dat v perském kalendáři nebo převod perských kalendářních dat na a z gregoriánských dat.

Objekt nelze použít PersianCalendar jako výchozí kalendář pro jazykovou verzi. Výchozí kalendář je určen vlastností CultureInfo.Calendar a musí být jedním z kalendářů vrácených CultureInfo.OptionalCalendars vlastností. PersianCalendar Třída v současné době není volitelným kalendářem pro žádnou jazykovou verzi podporovanou CultureInfo třídou a proto nemůže být výchozím kalendářem.