Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Classe Calendar

 

Representa o tempo em divisões como, por exemplo, semanas, meses e anos.

Namespace:   System.Globalization
Assembly:  mscorlib (em mscorlib.dll)


[SerializableAttribute]
[ComVisibleAttribute(true)]
public abstract class Calendar : ICloneable

NomeDescrição
System_CAPS_protmethodCalendar()

Inicializa uma nova instância da classe Calendar.

NomeDescrição
System_CAPS_pubpropertyAlgorithmType

Obtém um valor que indica se o calendário atual é solar baseado, lunar ou uma combinação de ambos.

System_CAPS_protpropertyDaysInYearBeforeMinSupportedYear

Obtém o número de dias do ano que precede o ano especificado pelo MinSupportedDateTime propriedade.

System_CAPS_pubpropertyEras

Quando substituído em uma classe derivada, obtém a lista de eras no calendário atual.

System_CAPS_pubpropertyIsReadOnly

Obtém um valor que indica se este Calendar objeto é somente leitura.

System_CAPS_pubpropertyMaxSupportedDateTime

Obtém a última data e hora suportados por esse Calendar objeto.

System_CAPS_pubpropertyMinSupportedDateTime

Obtém a primeira data e hora suportados por esse Calendar objeto.

System_CAPS_pubpropertyTwoDigitYearMax

Obtém ou define o último ano de um intervalo de 100 anos que pode ser representado por um ano de dois dígitos.

NomeDescrição
System_CAPS_pubmethodAddDays(DateTime, Int32)

Retorna um DateTime que é o número especificado de dias à frente do DateTime indicado.

System_CAPS_pubmethodAddHours(DateTime, Int32)

Retorna um DateTime que é o número especificado de horas de ausência especificado DateTime.

System_CAPS_pubmethodAddMilliseconds(DateTime, Double)

Retorna um DateTime que é o número especificado de milissegundos longe especificado DateTime.

System_CAPS_pubmethodAddMinutes(DateTime, Int32)

Retorna um DateTime que é o número especificado de minutos de especificado DateTime.

System_CAPS_pubmethodAddMonths(DateTime, Int32)

Quando substituído em uma classe derivada, retorna um DateTime que é o número especificado de meses à frente do DateTime especificado.

System_CAPS_pubmethodAddSeconds(DateTime, Int32)

Retorna um DateTime que é o número especificado de segundos especificado DateTime.

System_CAPS_pubmethodAddWeeks(DateTime, Int32)

Retorna um DateTime que é o número especificado de semanas à frente do DateTime indicado.

System_CAPS_pubmethodAddYears(DateTime, Int32)

Quando substituído em uma classe derivada, retorna um DateTime que é o número especificado de anos à frente especificado DateTime.

System_CAPS_pubmethodClone()

Cria um novo objeto que é uma cópia do atual Calendar objeto.

System_CAPS_pubmethodEquals(Object)

Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)

System_CAPS_protmethodFinalize()

Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes que ele seja recuperado pela coleta de lixo. (Herdado de Object.)

System_CAPS_pubmethodGetDayOfMonth(DateTime)

Quando substituído em uma classe derivada, retorna o dia do mês no DateTime especificado.

System_CAPS_pubmethodGetDayOfWeek(DateTime)

Quando substituído em uma classe derivada, retorna o dia da semana no DateTime especificado.

System_CAPS_pubmethodGetDayOfYear(DateTime)

Quando substituído em uma classe derivada, retorna o dia do ano no DateTime especificado.

System_CAPS_pubmethodGetDaysInMonth(Int32, Int32)

Retorna o número de dias no mês e ano especificados da era atual.

System_CAPS_pubmethodGetDaysInMonth(Int32, Int32, Int32)

Quando substituído em uma classe derivada, retorna o número de dias no mês, ano e era especificados.

System_CAPS_pubmethodGetDaysInYear(Int32)

Retorna o número de dias do ano especificado da era atual.

System_CAPS_pubmethodGetDaysInYear(Int32, Int32)

Quando substituído em uma classe derivada, retorna o número de dias no ano especificado e era.

System_CAPS_pubmethodGetEra(DateTime)

Quando substituído em uma classe derivada, retorna a era no DateTime especificado.

System_CAPS_pubmethodGetHashCode()

Serve como a função de hash padrão.(Herdado de Object.)

System_CAPS_pubmethodGetHour(DateTime)

Retorna o valor de horas especificado na DateTime.

System_CAPS_pubmethodGetLeapMonth(Int32)

Calcula o mês de salto para um ano especificado.

System_CAPS_pubmethodGetLeapMonth(Int32, Int32)

Calcula o mês de salto para um ano especificado e era.

System_CAPS_pubmethodGetMilliseconds(DateTime)

Retorna o valor de milissegundos especificado na DateTime.

System_CAPS_pubmethodGetMinute(DateTime)

Retorna o valor de minutos especificado na DateTime.

System_CAPS_pubmethodGetMonth(DateTime)

Quando substituído em uma classe derivada, retorna o mês no DateTime especificado.

System_CAPS_pubmethodGetMonthsInYear(Int32)

Retorna o número de meses do ano especificado na era atual.

System_CAPS_pubmethodGetMonthsInYear(Int32, Int32)

Quando substituído em uma classe derivada, retorna o número de meses do ano especificado na era especificado.

System_CAPS_pubmethodGetSecond(DateTime)

Retorna os segundos de valor especificado na DateTime.

System_CAPS_pubmethodGetType()

Obtém o Type da instância atual.(Herdado de Object.)

System_CAPS_pubmethodGetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek)

Retorna a semana do ano que inclui a data no valor DateTime especificado.

System_CAPS_pubmethodGetYear(DateTime)

Quando substituído em uma classe derivada, retorna o ano no DateTime especificado.

System_CAPS_pubmethodIsLeapDay(Int32, Int32, Int32)

Determina se a data especificada na era atual é um dia bissexto.

System_CAPS_pubmethodIsLeapDay(Int32, Int32, Int32, Int32)

Quando substituído em uma classe derivada, determina se a data especificada na era especificado é um dia bissexto.

System_CAPS_pubmethodIsLeapMonth(Int32, Int32)

Determina se o mês do ano especificado na era atual especificado é um mês de salto.

System_CAPS_pubmethodIsLeapMonth(Int32, Int32, Int32)

Quando substituído em uma classe derivada, determina se o mês do ano especificado na especificado era especificado é um mês de salto.

System_CAPS_pubmethodIsLeapYear(Int32)

Determina se o ano especificado na era atual é um ano bissexto.

System_CAPS_pubmethodIsLeapYear(Int32, Int32)

Quando substituído em uma classe derivada, determina se o ano especificado na era especificado é um ano bissexto.

System_CAPS_protmethodMemberwiseClone()

Cria uma cópia superficial do Object atual.(Herdado de Object.)

System_CAPS_pubmethodSystem_CAPS_staticReadOnly(Calendar)

Retorna uma versão somente leitura especificado Calendar objeto.

System_CAPS_pubmethodToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32)

Retorna um DateTime que é definido como a data e hora especificadas na era atual.

System_CAPS_pubmethodToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)

Quando substituído em uma classe derivada, retorna um DateTime que é definida como a data e hora especificadas na era especificado.

System_CAPS_pubmethodToFourDigitYear(Int32)

Converte o ano especificado em um ano de quatro dígitos usando a propriedade TwoDigitYearMax para determinar o século apropriado.

System_CAPS_pubmethodToString()

Retorna uma string que representa o objeto atual.(Herdado de Object.)

NomeDescrição
System_CAPS_pubfieldSystem_CAPS_staticCurrentEra

Representa a era atual do calendário atual.

A calendar divides time into units, such as weeks, months, and years. The number, length, and start of the divisions vary in each calendar.

System_CAPS_noteObservação

For information about using the calendar classes in the .NET Framework, see Working with Calendars.

Any moment in time can be represented as a set of numeric values using a particular calendar. For example, a vernal equinox occurred at (1999, 3, 20, 8, 46, 0, 0.0) in the Gregorian calendar, that is, March 20, 1999 C.E. at 8:46:00:0.0. An implementation of T:System.Globalization.Calendar can map any date in the range of a specific calendar to a similar set of numeric values, and T:System.DateTime can map such sets of numeric values to a textual representation using information from T:System.Globalization.Calendar and T:System.Globalization.DateTimeFormatInfo. The textual representation can be culture-sensitive, for example, "8:46 AM March 20th 1999 AD" for the en-US culture, or culture-insensitive, for example, "1999-03-20T08:46:00" in ISO 8601 format.

A T:System.Globalization.Calendar implementation can define one or more eras. The T:System.Globalization.Calendar class identifies the eras as enumerated integers, where the current era (F:System.Globalization.Calendar.CurrentEra) has the value 0.

To make up for the difference between the calendar year and the actual time that the earth rotates around the sun or the actual time that the moon rotates around the earth, a leap year has a different number of days from a standard calendar year. Each T:System.Globalization.Calendar implementation defines leap years differently.

For consistency, the first unit in each interval (the first month, for example) is assigned the value 1.

The N:System.Globalization namespace includes the following T:System.Globalization.Calendar implementations:

The following code example demonstrates the members of the T:System.Globalization.Calendar class.

using System;
using System.Globalization;


public class SamplesCalendar  {

   public static void Main()  {

      // Sets a DateTime to April 3, 2002 of the Gregorian calendar.
      DateTime myDT = new DateTime( 2002, 4, 3, new GregorianCalendar() );

      // Uses the default calendar of the InvariantCulture.
      Calendar myCal = CultureInfo.InvariantCulture.Calendar;

      // Displays the values of the DateTime.
      Console.WriteLine( "April 3, 2002 of the Gregorian calendar:" );
      DisplayValues( myCal, myDT );

      // Adds 5 to every component of the DateTime.
      myDT = myCal.AddYears( myDT, 5 );
      myDT = myCal.AddMonths( myDT, 5 );
      myDT = myCal.AddWeeks( myDT, 5 );
      myDT = myCal.AddDays( myDT, 5 );
      myDT = myCal.AddHours( myDT, 5 );
      myDT = myCal.AddMinutes( myDT, 5 );
      myDT = myCal.AddSeconds( myDT, 5 );
      myDT = myCal.AddMilliseconds( myDT, 5 );

      // Displays the values of the DateTime.
      Console.WriteLine( "After adding 5 to each component of the DateTime:" );
      DisplayValues( myCal, myDT );

   }

   public static void DisplayValues( Calendar myCal, DateTime myDT )  {
      Console.WriteLine( "   Era:          {0}", myCal.GetEra( myDT ) );
      Console.WriteLine( "   Year:         {0}", myCal.GetYear( myDT ) );
      Console.WriteLine( "   Month:        {0}", myCal.GetMonth( myDT ) );
      Console.WriteLine( "   DayOfYear:    {0}", myCal.GetDayOfYear( myDT ) );
      Console.WriteLine( "   DayOfMonth:   {0}", myCal.GetDayOfMonth( myDT ) );
      Console.WriteLine( "   DayOfWeek:    {0}", myCal.GetDayOfWeek( myDT ) );
      Console.WriteLine( "   Hour:         {0}", myCal.GetHour( myDT ) );
      Console.WriteLine( "   Minute:       {0}", myCal.GetMinute( myDT ) );
      Console.WriteLine( "   Second:       {0}", myCal.GetSecond( myDT ) );
      Console.WriteLine( "   Milliseconds: {0}", myCal.GetMilliseconds( myDT ) );
      Console.WriteLine();
   }

}


/*
This code produces the following output.

April 3, 2002 of the Gregorian calendar:
   Era:          1
   Year:         2002
   Month:        4
   DayOfYear:    93
   DayOfMonth:   3
   DayOfWeek:    Wednesday
   Hour:         0
   Minute:       0
   Second:       0
   Milliseconds: 0

After adding 5 to each component of the DateTime:
   Era:          1
   Year:         2007
   Month:        10
   DayOfYear:    286
   DayOfMonth:   13
   DayOfWeek:    Saturday
   Hour:         5
   Minute:       5
   Second:       5
   Milliseconds: 5

*/

Plataforma Universal do Windows
Disponível desde 8
.NET Framework
Disponível desde 1.1
Biblioteca de Classes Portátil
Com suporte no: plataformas portáteis do .NET
Silverlight
Disponível desde 2.0
Windows Phone Silverlight
Disponível desde 7.0
Windows Phone
Disponível desde 8.1

Quaisquer membros estáticos públicos ( Compartilhado no Visual Basic) desse tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Retornar ao início
Mostrar: