Calendar.AddHours(DateTime, Int32) Método

Definição

Namespace:

System.Globalization

Assembly:

System.Runtime.dll

Origem:

Calendar.cs

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

C#

public virtual DateTime AddHours (DateTime time, int hours);

Parâmetros

time

DateTime

O DateTime ao qual adicionar horas.

hours

Int32

O número de horas a serem adicionadas.

Retornos

DateTime

O DateTime resultante da adição do número especificado de horas ao DateTime especificado.

Exceções

ArgumentException

O DateTime resultante está fora do intervalo com suporte deste calendário.

ArgumentOutOfRangeException

hours está fora do intervalo com suporte do valor retornado de DateTime.

Exemplos

O exemplo de código a seguir demonstra os membros da Calendar classe .

C#

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

*/

Comentários

O hours valor é adicionado ao especificado DateTime. Se hours for negativo, o resultado DateTime será anterior ao especificado DateTime.

A parte do dia do resultado DateTime será afetada se o tempo resultante estiver fora do dia do especificado DateTime. A parte do mês do resultado DateTime será afetada se o dia resultante estiver fora do mês do especificado DateTime. A parte do ano do resultado DateTime será afetada se o mês resultante estiver fora do ano do especificado DateTime. A parte de era do resultado DateTime será afetada se o ano resultante estiver fora da era do especificado DateTime.

A Kind propriedade do valor retornado DateTime sempre é DateTimeKind.Unspecifiedigual a . Você pode preservar a Kind propriedade do time parâmetro chamando o DateTime.SpecifyKind método , como mostra o exemplo a seguir.

C#

returnTime = DateTime.SpecifyKind(cal.AddHours(time, hours), time.Kind);

Aplica-se a

Confira também

• DateTime
• AddYears(DateTime, Int32)
• AddMonths(DateTime, Int32)
• AddWeeks(DateTime, Int32)
• AddDays(DateTime, Int32)
• AddMinutes(DateTime, Int32)
• AddSeconds(DateTime, Int32)
• AddMilliseconds(DateTime, Double)