PersianCalendar Classe

Definição

Representa o calendário persa.Represents the Persian calendar.

public ref class PersianCalendar : System::Globalization::Calendar
public class PersianCalendar : System.Globalization.Calendar
[System.Serializable]
public class PersianCalendar : System.Globalization.Calendar
type PersianCalendar = class
    inherit Calendar
Public Class PersianCalendar
Inherits Calendar
Herança
PersianCalendar
Atributos

Exemplos

O exemplo a seguir instancia DateTime objetos usando a propriedade DateTime.Now, um Construtor DateTime e o método ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32) do calendário persa.The following example instantiates DateTime objects by using the DateTime.Now property, a DateTime constructor, and the Persian calendar's ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32) method. Em seguida, ele exibe essas datas nos calendários gregoriano e persa.It then displays these dates in both the Gregorian and Persian calendars. Ele também exibe o intervalo de datas do calendário persa.It also displays the date range of the Persian calendar.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
        PersianCalendar pc = new PersianCalendar();
        DateTime thisDate = DateTime.Now;

        // Display the current date using the Gregorian and Persian calendars. 
        Console.WriteLine("Today in the Gregorian Calendar:  {0:dddd}, {0}", thisDate);
        Console.WriteLine("Today in the Persian Calendar:    {0}, {1}/{2}/{3} {4}:{5}:{6}\n",  
                      pc.GetDayOfWeek(thisDate), 
                      pc.GetMonth(thisDate), 
                      pc.GetDayOfMonth(thisDate),  
                      pc.GetYear(thisDate), 
                      pc.GetHour(thisDate), 
                      pc.GetMinute(thisDate), 
                      pc.GetSecond(thisDate));
        
        // Create a date using the Gregorian calendar.
        thisDate = new DateTime(2013, 5, 28, 10, 35, 0);
        Console.WriteLine("Gregorian Calendar:  {0:D} ", thisDate);
        Console.WriteLine("Persian Calendar:    {0}, {1}/{2}/{3} {4}:{5}:{6}\n",  
                          pc.GetDayOfWeek(thisDate), 
                          pc.GetMonth(thisDate), 
                          pc.GetDayOfMonth(thisDate),  
                          pc.GetYear(thisDate), 
                          pc.GetHour(thisDate), 
                          pc.GetMinute(thisDate), 
                          pc.GetSecond(thisDate));
         
        // Create a date using the Persian calendar.
        thisDate = pc.ToDateTime(1395, 4, 22, 12, 30, 0, 0);
        Console.WriteLine("Gregorian Calendar:  {0:D} ", thisDate);
        Console.WriteLine("Persian Calendar:    {0}, {1}/{2}/{3} {4}:{5}:{6}\n",  
                      pc.GetDayOfWeek(thisDate), 
                      pc.GetMonth(thisDate), 
                      pc.GetDayOfMonth(thisDate),  
                      pc.GetYear(thisDate), 
                      pc.GetHour(thisDate), 
                      pc.GetMinute(thisDate), 
                      pc.GetSecond(thisDate));
        
        // Show the Persian Calendar date range.
        Console.WriteLine("Minimum Persian Calendar date (Gregorian Calendar):  {0:D} ", 
                          pc.MinSupportedDateTime);
        Console.WriteLine("Minimum Persian Calendar date (Persian Calendar):  " +    
                          "{0}, {1}/{2}/{3} {4}:{5}:{6}\n",  
                          pc.GetDayOfWeek(pc.MinSupportedDateTime), 
                          pc.GetMonth(pc.MinSupportedDateTime), 
                          pc.GetDayOfMonth(pc.MinSupportedDateTime),  
                          pc.GetYear(pc.MinSupportedDateTime), 
                          pc.GetHour(pc.MinSupportedDateTime), 
                          pc.GetMinute(pc.MinSupportedDateTime), 
                          pc.GetSecond(pc.MinSupportedDateTime));
        
        Console.WriteLine("Maximum Persian Calendar date (Gregorian Calendar):  {0:D} ", 
                          pc.MaxSupportedDateTime);
        Console.WriteLine("Maximum Persian Calendar date (Persian Calendar):  " +   
                          "{0}, {1}/{2}/{3} {4}:{5}:{6}\n",  
                          pc.GetDayOfWeek(pc.MaxSupportedDateTime), 
                          pc.GetMonth(pc.MaxSupportedDateTime), 
                          pc.GetDayOfMonth(pc.MaxSupportedDateTime),  
                          pc.GetYear(pc.MaxSupportedDateTime), 
                          pc.GetHour(pc.MinSupportedDateTime), 
                          pc.GetMinute(pc.MaxSupportedDateTime), 
                          pc.GetSecond(pc.MaxSupportedDateTime));
   }
}
// The example displays the following output when run under the .NET Framework 4.6:
//    Today in the Gregorian Calendar:  Monday, 2/4/2013 9:11:36 AM
//    Today in the Persian Calendar:    Monday, 11/16/1391 9:11:36
//
//    Gregorian Calendar:  Tuesday, May 28, 2013
//    Persian Calendar:    Tuesday, 3/7/1392 10:35:0
//
//    Gregorian Calendar:  Tuesday, July 12, 2016
//    Persian Calendar:    Tuesday, 4/22/1395 12:30:0
//
//    Minimum Persian Calendar date (Gregorian Calendar):  Friday, March 22, 0622
//    Minimum Persian Calendar date (Persian Calendar):  Friday, 1/1/1 0:0:0
//
//    Maximum Persian Calendar date (Gregorian Calendar):  Friday, December 31, 9999
//    Maximum Persian Calendar date (Persian Calendar):  Friday, 10/13/9378 0:59:59
//
// The example displays the following output when run under versions of
// the .NET Framework before the .NET Framework 4.6:
//    Today in the Gregorian Calendar:  Monday, 2/4/2013 9:11:36 AM
//    Today in the Persian Calendar:    Monday, 11/16/1391 9:11:36
//    
//    Gregorian Calendar:  Tuesday, May 28, 2013
//    Persian Calendar:    Tuesday, 3/7/1392 10:35:0
//    
//    Gregorian Calendar:  Tuesday, July 12, 2016
//    Persian Calendar:    Tuesday, 4/22/1395 12:30:0
//    
//    Minimum Persian Calendar date (Gregorian Calendar):  Thursday, March 21, 0622
//    Minimum Persian Calendar date (Persian Calendar):  Thursday, 1/1/1 0:0:0
//    
//    Maximum Persian Calendar date (Gregorian Calendar):  Friday, December 31, 9999
//    Maximum Persian Calendar date (Persian Calendar):  Friday, 10/10/9378 0:59:59
Imports System.Globalization

Module Example
    Public Sub Main()
        Dim pc As New PersianCalendar()
        Dim thisDate As Date = Date.Now

        ' Display the current date using the Gregorian and Persian calendars. 
        Console.WriteLine("Today in the Gregorian Calendar:  {0:dddd}, {0}", thisDate)
        Console.WriteLine("Today in the Persian Calendar:    {0}, {1}/{2}/{3} {4}:{5}:{6}",  
                      pc.GetDayOfWeek(thisDate),
                      pc.GetMonth(thisDate),
                      pc.GetDayOfMonth(thisDate), 
                      pc.GetYear(thisDate),
                      pc.GetHour(thisDate),
                      pc.GetMinute(thisDate),
                      pc.GetSecond(thisDate))
        Console.WriteLine()
        
        ' Create a date using the Gregorian calendar.
        thisDate = New DateTime(2013, 5, 28, 10, 35, 0)
        Console.WriteLine("Gregorian Calendar:  {0:D} ", thisDate)
        Console.WriteLine("Persian Calendar:    {0}, {1}/{2}/{3} {4}:{5}:{6}", 
                      pc.GetDayOfWeek(thisDate),
                      pc.GetMonth(thisDate),
                      pc.GetDayOfMonth(thisDate), 
                      pc.GetYear(thisDate),
                      pc.GetHour(thisDate),
                      pc.GetMinute(thisDate),
                      pc.GetSecond(thisDate))
        Console.WriteLine()
         
        ' Create a date using the Persian calendar.
        thisDate = pc.ToDateTime(1395, 4, 22, 12, 30, 0, 0)
        Console.WriteLine("Gregorian Calendar:  {0:D} ", thisDate)
        Console.WriteLine("Persian Calendar:    {0}, {1}/{2}/{3} {4}:{5}:{6}", 
                      pc.GetDayOfWeek(thisDate),
                      pc.GetMonth(thisDate),
                      pc.GetDayOfMonth(thisDate), 
                      pc.GetYear(thisDate),
                      pc.GetHour(thisDate),
                      pc.GetMinute(thisDate),
                      pc.GetSecond(thisDate))
        Console.WriteLine()
        
        ' Show the Persian Calendar date range.
        Console.WriteLine("Minimum Persian Calendar date (Gregorian Calendar):  {0:D} ", 
                          pc.MinSupportedDateTime)
        Console.WriteLine("Minimum Persian Calendar date (Persian Calendar):  " +    
                          "{0}, {1}/{2}/{3} {4}:{5}:{6}",  
                          pc.GetDayOfWeek(pc.MinSupportedDateTime), 
                          pc.GetMonth(pc.MinSupportedDateTime), 
                          pc.GetDayOfMonth(pc.MinSupportedDateTime),  
                          pc.GetYear(pc.MinSupportedDateTime), 
                          pc.GetHour(pc.MinSupportedDateTime), 
                          pc.GetMinute(pc.MinSupportedDateTime), 
                          pc.GetSecond(pc.MinSupportedDateTime))
        Console.WriteLine()
        
        Console.WriteLine("Maximum Persian Calendar date (Gregorian Calendar):  {0:D} ", 
                          pc.MaxSupportedDateTime)
        Console.WriteLine("Maximum Persian Calendar date (Persian Calendar):  " +   
                          "{0}, {1}/{2}/{3} {4}:{5}:{6}",  
                          pc.GetDayOfWeek(pc.MaxSupportedDateTime), 
                          pc.GetMonth(pc.MaxSupportedDateTime), 
                          pc.GetDayOfMonth(pc.MaxSupportedDateTime),  
                          pc.GetYear(pc.MaxSupportedDateTime), 
                          pc.GetHour(pc.MinSupportedDateTime), 
                          pc.GetMinute(pc.MaxSupportedDateTime), 
                          pc.GetSecond(pc.MaxSupportedDateTime))
        Console.WriteLine()
    End Sub
End Module 
' The example displays the following output when run under the .NET Framework 4.6:
'    Today in the Gregorian Calendar:  Monday, 2/4/2013 9:11:36 AM
'    Today in the Persian Calendar:    Monday, 11/16/1391 9:11:36
'
'    Gregorian Calendar:  Tuesday, May 28, 2013
'    Persian Calendar:    Tuesday, 3/7/1392 10:35:0
'
'    Gregorian Calendar:  Tuesday, July 12, 2016
'    Persian Calendar:    Tuesday, 4/22/1395 12:30:0
'
'    Minimum Persian Calendar date (Gregorian Calendar):  Friday, March 22, 0622
'    Minimum Persian Calendar date (Persian Calendar):  Friday, 1/1/1 0:0:0
'
'    Maximum Persian Calendar date (Gregorian Calendar):  Friday, December 31, 9999
'    Maximum Persian Calendar date (Persian Calendar):  Friday, 10/13/9378 0:59:59
'
' The example displays the following output when run under versions of
' the .NET Framework before the .NET Framework 4.6:
'    Today in the Gregorian Calendar:  Monday, 2/4/2013 9:11:36 AM
'    Today in the Persian Calendar:    Monday, 11/16/1391 9:11:36
'
'    Gregorian Calendar:  Tuesday, May 28, 2013
'    Persian Calendar:    Tuesday, 3/7/1392 10:35:0
'
'    Gregorian Calendar:  Tuesday, July 12, 2016
'    Persian Calendar:    Tuesday, 4/22/1395 12:30:0
'
'    Minimum Persian Calendar date (Gregorian Calendar):  Thursday, March 21, 0622
'    Minimum Persian Calendar date (Persian Calendar):  Thursday, 1/1/1 0:0:0
'
'    Maximum Persian Calendar date (Gregorian Calendar):  Friday, December 31, 9999
'    Maximum Persian Calendar date (Persian Calendar):  Friday, 10/10/9378 0:59:59

O exemplo a seguir demonstra os membros de campo, propriedade e método da classe PersianCalendar.The following example demonstrates the field, property, and method members of the PersianCalendar class.

using System;
using System.Globalization;
 
class Sample 
{
    public static void Main() 
    {
      PersianCalendar jc = new PersianCalendar();
      DateTime thisDate = DateTime.Now;
 
        //--------------------------------------------------------------------------------
        // Properties
        //--------------------------------------------------------------------------------
      Console.WriteLine("\n........... Selected Properties .....................\n");
      Console.Write("Eras:");
      foreach (int era in jc.Eras)
      {
         Console.WriteLine(" era = {0}", era);
      }
        //--------------------------------------------------------------------------------
      Console.WriteLine("\nTwoDigitYearMax = {0}", jc.TwoDigitYearMax);
        //--------------------------------------------------------------------------------
        // Methods
        //--------------------------------------------------------------------------------
      Console.WriteLine("\n............ Selected Methods .......................\n");
 
        //--------------------------------------------------------------------------------
      Console.WriteLine("GetDayOfYear: day = {0}", jc.GetDayOfYear(thisDate));
        //--------------------------------------------------------------------------------
      Console.WriteLine("GetDaysInMonth: days = {0}", 
                        jc.GetDaysInMonth( thisDate.Year, thisDate.Month, 
                        PersianCalendar.PersianEra));
        //--------------------------------------------------------------------------------
      Console.WriteLine("GetDaysInYear: days = {0}", 
                        jc.GetDaysInYear(thisDate.Year, PersianCalendar.PersianEra));
        //--------------------------------------------------------------------------------
      Console.WriteLine("GetLeapMonth: leap month (if any) = {0}", 
                        jc.GetLeapMonth(thisDate.Year, PersianCalendar.PersianEra));
        //-------------------------------------------------------------
      Console.WriteLine("GetMonthsInYear: months in a year = {0}", 
                        jc.GetMonthsInYear(thisDate.Year, PersianCalendar.PersianEra));
        //--------------------------------------------------------------------------------
      Console.WriteLine("IsLeapDay: This is a leap day = {0}", 
                        jc.IsLeapDay(thisDate.Year, thisDate.Month, thisDate.Day, 
                        PersianCalendar.PersianEra));
        //--------------------------------------------------------------------------------
      Console.WriteLine("IsLeapMonth: This is a leap month = {0}", 
                        jc.IsLeapMonth(thisDate.Year, thisDate.Month, 
                        PersianCalendar.PersianEra));
        //--------------------------------------------------------------------------------
      Console.WriteLine("IsLeapYear: 1370 is a leap year = {0}", 
                        jc.IsLeapYear(1370, PersianCalendar.PersianEra));
        //--------------------------------------------------------------------------------
 
        // Get the 4-digit year for a year whose last two digits are 99. The 4-digit year 
        // depends on the current value of the TwoDigitYearMax property.
 
      Console.WriteLine("ToFourDigitYear:");
      Console.WriteLine("  If TwoDigitYearMax = {0}, ToFourDigitYear(99) = {1}", 
                         jc.TwoDigitYearMax, jc.ToFourDigitYear(99));
      jc.TwoDigitYearMax = thisDate.Year;
      Console.WriteLine("  If TwoDigitYearMax = {0}, ToFourDigitYear(99) = {1}", 
                        jc.TwoDigitYearMax, jc.ToFourDigitYear(99));
    }
}
// The example displays the following output:
//       ........... Selected Properties .....................
//       
//       Eras: era = 1
//       
//       TwoDigitYearMax = 99
//       
//       ............ Selected Methods .......................
//       
//       GetDayOfYear: day = 1
//       GetDaysInMonth: days = 31
//       GetDaysInYear: days = 365
//       GetLeapMonth: leap month (if any) = 0
//       GetMonthsInYear: months in a year = 12
//       IsLeapDay: This is a leap day = False
//       IsLeapMonth: This is a leap month = False
//       IsLeapYear: 1370 is a leap year = True
//       ToFourDigitYear:
//         If TwoDigitYearMax = 99, ToFourDigitYear(99) = 99
//         If TwoDigitYearMax = 2012, ToFourDigitYear(99) = 1999
Imports System.Globalization

Class Sample
    Public Shared Sub Main()
        '--------------------------------------------------------------------------------
        ' Get today's date.
        '--------------------------------------------------------------------------------
        Dim jc As New PersianCalendar()
        Dim thisDate As Date = Date.Now

        '--------------------------------------------------------------------------------
        ' Properties
        '--------------------------------------------------------------------------------
        Console.WriteLine(vbCrLf & _
                          "........... Selected Properties ....................." & vbCrLf)
        Console.Write("Eras:")
        Dim era As Integer
        For Each era In jc.Eras
            Console.WriteLine(" era = {0}", era)
        Next era
        '--------------------------------------------------------------------------------
        Console.WriteLine("TwoDigitYearMax = {0}", jc.TwoDigitYearMax)
        '--------------------------------------------------------------------------------
        ' Methods
        '--------------------------------------------------------------------------------
        Console.WriteLine(vbCrLf & _
                          "............ Selected Methods ......................." & vbCrLf)

        '--------------------------------------------------------------------------------
        Console.WriteLine("GetDayOfYear: day = {0}", jc.GetDayOfYear(thisDate))
        '--------------------------------------------------------------------------------

        Console.WriteLine("GetDaysInMonth: days = {0}", _
                           jc.GetDaysInMonth(thisDate.Year, _
                                             thisDate.Month, _
                                             PersianCalendar.PersianEra))
        '--------------------------------------------------------------------------------
        Console.WriteLine("GetDaysInYear: days = {0}", _
                          jc.GetDaysInYear(thisDate.Year, PersianCalendar.PersianEra))
        '--------------------------------------------------------------------------------
        Console.WriteLine("GetLeapMonth: leap month (if any) = {0}", _
                           jc.GetLeapMonth(thisDate.Year, PersianCalendar.PersianEra))
        '--------------------------------------------------------------------------------
        Console.WriteLine("GetMonthsInYear: months in a year = {0}", _
                           jc.GetMonthsInYear(thisDate.Year, PersianCalendar.PersianEra))
        '--------------------------------------------------------------------------------
        Console.WriteLine("IsLeapDay: This is a leap day = {0}", _
                           jc.IsLeapDay(thisDate.Year, _
                                        thisDate.Month, thisDate.Day, _
                                        PersianCalendar.PersianEra))
        '--------------------------------------------------------------------------------
        Console.WriteLine("IsLeapMonth: This is a leap month = {0}", _
                           jc.IsLeapMonth(thisDate.Year, _
                                          thisDate.Month, _
                                          PersianCalendar.PersianEra))
        '--------------------------------------------------------------------------------
        Console.WriteLine("IsLeapYear: 1370 is a leap year = {0}", _
                           jc.IsLeapYear(1370, PersianCalendar.PersianEra))
        '--------------------------------------------------------------------------------

        ' Get the 4-digit year for a year whose last two digits are 99. The 4-digit year 
        ' depends on the current value of the TwoDigitYearMax property.

        Console.WriteLine("ToFourDigitYear:")
        Console.WriteLine("  If TwoDigitYearMax = {0}, ToFourDigitYear(99) = {1}", _
                          jc.TwoDigitYearMax, jc.ToFourDigitYear(99))
        jc.TwoDigitYearMax = thisDate.Year
        Console.WriteLine("  If TwoDigitYearMax = {0}, ToFourDigitYear(99) = {1}", _
                          jc.TwoDigitYearMax, jc.ToFourDigitYear(99))
    End Sub
End Class 
' The example displays output like the following: 
'       ........... Seleted Properties .....................
'       
'       Eras: era = 1
'       
'       TwoDigitYearMax = 99
'       
'       ............ Selected Methods .......................
'       
'       GetDayOfYear: day = 1
'       GetDaysInMonth: days = 31
'       GetDaysInYear: days = 365
'       GetLeapMonth: leap month (if any) = 0
'       GetMonthsInYear: months in a year = 12
'       IsLeapDay: This is a leap day = False
'       IsLeapMonth: This is a leap month = False
'       IsLeapYear: 1370 is a leap year = True
'       ToFourDigitYear:
'         If TwoDigitYearMax = 99, ToFourDigitYear(99) = 99
'         If TwoDigitYearMax = 2012, ToFourDigitYear(99) = 1999

Comentários

O calendário persa é usado na maioria dos países/regiões em que o persa é falado, embora algumas regiões usem nomes de mês diferentes.The Persian calendar is used in most countries/regions where Persian is spoken, although some regions use different month names. O calendário persa é o calendário oficial do Irã e do Afeganistão, e é um dos calendários alternativos em regiões como o Cazaquistão e o Tadjiquistão.The Persian calendar is the official calendar of Iran and Afghanistan, and it is one of the alternative calendars in regions such as Kazakhstan and Tajikistan.

Observação

Para obter informações sobre como usar a classe PersianCalendar e as outras classes de calendário na .NET Framework, consulte trabalhando com calendários.For information about using the PersianCalendar class and the other calendar classes in the .NET Framework, see Working with Calendars.

As datas no calendário persa começam do ano do Hijra, que corresponde a 622 C.E.Dates in the Persian calendar start from the year of the Hijra, which corresponds to 622 C.E. e é o ano em que Muhammad (PBUH) migrou de Mecca para Medina.and is the year when Muhammad (PBUH) migrated from Mecca to Medina. Por exemplo, a data 21 de março de 2002 C.E.For example, the date March 21, 2002 C.E. corresponde ao primeiro dia do mês de Farvardeen no ano 1381 Anno Persico.corresponds to the first day of the month of Farvardeen in the year 1381 Anno Persico.

O calendário persa é baseado em um ano solar e tem aproximadamente 365 dias.The Persian calendar is based on a solar year and is approximately 365 days long. Um ano é ciclos por meio de quatro estações, e um novo ano começa quando o sol parece cruzar o Equador do hemisfério do Sul para o hemisfério do Norte, conforme exibido no centro da terra.A year cycles through four seasons, and a new year begins when the sun appears to cross the equator from the southern hemisphere to the northern hemisphere as viewed from the center of the Earth. O novo ano marca o primeiro dia do mês de Farvardeen, que é o primeiro dia do Spring no hemisfério do Norte.The new year marks the first day of the month of Farvardeen, which is the first day of spring in the northern hemisphere.

Cada um dos seis primeiros 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.Each of the first six months in the Persian calendar has 31 days, each of the next five months has 30 days, and the last month has 29 days in a common year and 30 days in a leap year. Um ano bissexto é um ano que, quando dividido por 33, tem um resto de 1, 5, 9, 13, 17, 22, 26 ou 30.A leap year is a year that, when divided by 33, has a remainder of 1, 5, 9, 13, 17, 22, 26, or 30. Por exemplo, o ano 1370 é um ano bissexto porque dividi-lo por 33 produz um resto de 17.For example, the year 1370 is a leap year because dividing it by 33 yields a remainder of 17. Há aproximadamente oito anos bissextos em cada ciclo de 33 anos.There are approximately eight leap years in every 33-year cycle.

A classe PersianCalendar e as versões de .NET FrameworkThe PersianCalendar class and .NET Framework versions

Começando com a .NET Framework 4.6.NET Framework 4.6, a classe PersianCalendar usa o algoritmo astronômicos solar islâmico em vez de um algoritmo de observação para calcular datas.Starting with the .NET Framework 4.6.NET Framework 4.6, the PersianCalendar class uses the Hijri solar astronomical algorithm rather than an observational algorithm to calculate dates. Isso torna a implementação de PersianCalendar 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á no uso mais generalizado.This makes the PersianCalendar implementation consistent with the Persian calendar in use in Iran and Afghanistan, the two countries in which the Persian calendar is in most widespread use. A alteração afeta todos os aplicativos em execução no .NET Framework 4 ou posterior se o .NET Framework 4.6.NET Framework 4.6 estiver instalado.The change affects all apps running on the .NET Framework 4 or later if the .NET Framework 4.6.NET Framework 4.6 is installed.

Como resultado do algoritmo alterado:As a result of the changed algorithm:

  • Os dois algoritmos devem retornar resultados idênticos ao converter datas entre 1800 e 2123 no calendário gregoriano.The two algorithms should return identical results when converting dates between 1800 and 2123 in the Gregorian calendar.

  • Os dois algoritmos podem retornar resultados diferentes ao converter datas antes de 1800 e depois de 2123 no calendário gregoriano.The two algorithms may return different results when converting dates before 1800 and after 2123 in the Gregorian calendar.

  • 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.The MinSupportedDateTime property value has changed from March 21, 0622 in the Gregorian calendar to March 22, 0622 in the Gregorian calendar.

  • O valor da propriedade MaxSupportedDateTime foi alterado do 10º dia do 10º mês do ano 9378 no calendário persa para o dia 13 do décimo mês do ano 9378 no calendário persa.The MaxSupportedDateTime property value has changed from the 10th day of the 10th month of the year 9378 in the Persian calendar to the 13th day of the 10th month of the year 9378 in the Persian calendar.

  • O método IsLeapYear pode retornar um resultado diferente do anterior.The IsLeapYear method may return a different result than it did previously.

Usando a classe PersianCalendarUsing the PersianCalendar class

Os aplicativos usam um objeto PersianCalendar para calcular datas no calendário persa ou converter datas persas de e para datas gregorianas.Applications use a PersianCalendar object to calculate dates in the Persian calendar or convert Persian dates to and from Gregorian dates.

Você não pode usar um objeto PersianCalendar como o calendário padrão para uma cultura.You cannot use a PersianCalendar object as the default calendar for a culture. O calendário padrão é especificado pela propriedade CultureInfo.Calendar e deve ser um dos calendários retornados pela propriedade CultureInfo.OptionalCalendars.The default calendar is specified by the CultureInfo.Calendar property and must be one of the calendars returned by the CultureInfo.OptionalCalendars property. Atualmente, a classe PersianCalendar não é um calendário opcional para nenhuma cultura com suporte da classe CultureInfo e, consequentemente, não pode ser um calendário padrão.Currently, the PersianCalendar class is not an optional calendar for any culture supported by the CultureInfo class and consequently cannot be a default calendar.

Construtores

PersianCalendar()

Inicializa uma nova instância da classe PersianCalendar.Initializes a new instance of the PersianCalendar class.

Campos

CurrentEra

Representa a era atual do calendário atual.Represents the current era of the current calendar. O valor desse campo é 0.The value of this field is 0.

(Herdado de Calendar)
PersianEra

Representa a era atual.Represents the current era. Este campo é constante.This field is constant.

Propriedades

AlgorithmType

Obtém um valor que indica se o calendário atual é baseado em solar, lunar ou lunissolar.Gets a value indicating whether the current calendar is solar-based, lunar-based, or lunisolar-based.

DaysInYearBeforeMinSupportedYear

Obtém o número de dias do ano que precede o ano especificado pela propriedade MinSupportedDateTime.Gets the number of days in the year that precedes the year that is specified by the MinSupportedDateTime property.

(Herdado de Calendar)
Eras

Obtém a lista de eras em um objeto PersianCalendar.Gets the list of eras in a PersianCalendar object.

IsReadOnly

Obtém um valor que indica se esse objeto Calendar é somente leitura.Gets a value indicating whether this Calendar object is read-only.

(Herdado de Calendar)
MaxSupportedDateTime

Obtém a data e hora mais recentes com suporte pela classe PersianCalendar.Gets the latest date and time supported by the PersianCalendar class.

MinSupportedDateTime

Obtém a data e hora mais antigas com suporte pela classe PersianCalendar.Gets the earliest date and time supported by the PersianCalendar class.

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.Gets or sets the last year of a 100-year range that can be represented by a 2-digit year.

Métodos

AddDays(DateTime, Int32)

Retorna um DateTime que é o número especificado de dias à frente do DateTime indicado.Returns a DateTime that is the specified number of days away from the specified DateTime.

(Herdado de Calendar)
AddHours(DateTime, Int32)

Retorna um DateTime que é o número especificado de horas à frente do DateTime indicado.Returns a DateTime that is the specified number of hours away from the specified DateTime.

(Herdado de Calendar)
AddMilliseconds(DateTime, Double)

Retorna um DateTime que é o número especificado de milissegundos à frente do DateTime indicado.Returns a DateTime that is the specified number of milliseconds away from the specified DateTime.

(Herdado de Calendar)
AddMinutes(DateTime, Int32)

Retorna um DateTime que é o número especificado de minutos à frente do DateTime indicado.Returns a DateTime that is the specified number of minutes away from the specified DateTime.

(Herdado de Calendar)
AddMonths(DateTime, Int32)

Retorna um objeto DateTime que é o deslocamento do número especificado de meses do objeto DateTime especificado.Returns a DateTime object that is offset the specified number of months from the specified DateTime object.

AddSeconds(DateTime, Int32)

Retorna um DateTime que é o número especificado de segundos à frente do DateTime indicado.Returns a DateTime that is the specified number of seconds away from the specified DateTime.

(Herdado de Calendar)
AddWeeks(DateTime, Int32)

Retorna um DateTime que é o número especificado de semanas à frente do DateTime indicado.Returns a DateTime that is the specified number of weeks away from the specified DateTime.

(Herdado de Calendar)
AddYears(DateTime, Int32)

Retorna um objeto DateTime que é o deslocamento do número especificado de anos do objeto DateTime especificado.Returns a DateTime object that is offset the specified number of years from the specified DateTime object.

Clone()

Cria um novo objeto que é uma cópia do objeto Calendar atual.Creates a new object that is a copy of the current Calendar object.

(Herdado de Calendar)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetDayOfMonth(DateTime)

Retorna o dia do mês especificado no objeto DateTime.Returns the day of the month in the specified DateTime object.

GetDayOfWeek(DateTime)

Retorna o dia da semana no objeto DateTime especificado.Returns the day of the week in the specified DateTime object.

GetDayOfYear(DateTime)

Retorna o dia do ano no objeto DateTime especificado.Returns the day of the year in the specified DateTime object.

GetDaysInMonth(Int32, Int32)

Retorna o número de dias no mês e ano especificados da era atual.Returns the number of days in the specified month and year of the current era.

(Herdado de Calendar)
GetDaysInMonth(Int32, Int32, Int32)

Retorna o número de dias no mês especificado do ano e era especificados.Returns the number of days in the specified month of the specified year and era.

GetDaysInYear(Int32)

Retorna o número de dias no ano especificado da era atual.Returns the number of days in the specified year of the current era.

(Herdado de Calendar)
GetDaysInYear(Int32, Int32)

Retorna o número de dias do ano especificado da era especificada.Returns the number of days in the specified year of the specified era.

GetEra(DateTime)

Retorna a era no objeto DateTime especificado.Returns the era in the specified DateTime object.

GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetHour(DateTime)

Retorna o valor de horas no DateTime especificado.Returns the hours value in the specified DateTime.

(Herdado de Calendar)
GetLeapMonth(Int32)

Calcula o mês bissexto de um ano especificado.Calculates the leap month for a specified year.

(Herdado de Calendar)
GetLeapMonth(Int32, Int32)

Retorna o mês bissexto para um ano e era especificados.Returns the leap month for a specified year and era.

GetMilliseconds(DateTime)

Retorna o valor de milissegundos no DateTime especificado.Returns the milliseconds value in the specified DateTime.

(Herdado de Calendar)
GetMinute(DateTime)

Retorna o valor de minutos no DateTime especificado.Returns the minutes value in the specified DateTime.

(Herdado de Calendar)
GetMonth(DateTime)

Retorna o mês no objeto DateTime especificado.Returns the month in the specified DateTime object.

GetMonthsInYear(Int32)

Retorna o número de meses no ano especificado na era atual.Returns the number of months in the specified year in the current era.

(Herdado de Calendar)
GetMonthsInYear(Int32, Int32)

Retorna o número de meses no ano especificado da era especificado.Returns the number of months in the specified year of the specified era.

GetSecond(DateTime)

Retorna o valor de segundos no DateTime especificado.Returns the seconds value in the specified DateTime.

(Herdado de Calendar)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek)

Retorna a semana do ano que inclui a data no valor DateTime especificado.Returns the week of the year that includes the date in the specified DateTime value.

(Herdado de Calendar)
GetYear(DateTime)

Retorna o ano no objeto DateTime especificado.Returns the year in the specified DateTime object.

IsLeapDay(Int32, Int32, Int32)

Determina se a data especificada na era atual é um dia bissexto.Determines whether the specified date in the current era is a leap day.

(Herdado de Calendar)
IsLeapDay(Int32, Int32, Int32, Int32)

Determina se a data especificada é um dia bissexto.Determines whether the specified date is a leap day.

IsLeapMonth(Int32, Int32)

Determina se o mês especificado no ano especificado na era atual é um mês bissexto.Determines whether the specified month in the specified year in the current era is a leap month.

(Herdado de Calendar)
IsLeapMonth(Int32, Int32, Int32)

Determina se o mês especificado no ano e a era especificados é um mês bissexto.Determines whether the specified month in the specified year and era is a leap month.

IsLeapYear(Int32)

Determina se o ano especificado na era atual é um ano bissexto.Determines whether the specified year in the current era is a leap year.

(Herdado de Calendar)
IsLeapYear(Int32, Int32)

Determina se o ano especificado na era especificada é um ano bissexto.Determines whether the specified year in the specified era is a leap year.

MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(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.Returns a DateTime that is set to the specified date and time in the current era.

(Herdado de Calendar)
ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)

Retorna um objeto DateTime que é definido para a data, a hora e a era especificadas.Returns a DateTime object that is set to the specified date, time, and era.

ToFourDigitYear(Int32)

Converte um ano especificado em uma representação de quatro dígitos.Converts the specified year to a four-digit year representation.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)

Aplica-se a

Veja também