Calendar.AddHours(DateTime, Int32) Yöntem

Tanım

Ad Alanı:

System.Globalization

Bütünleştirilmiş Kod:

System.Runtime.dll

Kaynak:

Calendar.cs

Belirtilen saat sayısından uzak DateTimeolan bir DateTime döndürür.

C#

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

Parametreler

time

DateTime

Saatlerin DateTime ekleneceği yer.

hours

Int32

Eklenecek saat sayısı.

Döndürülenler

DateTime

Belirtilen DateTime saat sayısını belirtilen öğesine eklemenin sonucunda elde edilir DateTime.

Özel durumlar

ArgumentException

DateTime Sonuç, bu takvimin desteklenen aralığının dışındadır.

ArgumentOutOfRangeException

hours döndürülen değerin desteklenen aralığının DateTime dışındadır.

Örnekler

Aşağıdaki kod örneği sınıfın üyelerini Calendar gösterir.

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

*/

Açıklamalar

hours Değeri belirtilen DateTimeöğesine eklenir. Negatifse hours , sonuç DateTime belirtilen DateTimedeğerinden önce olur.

Sonuçta elde edilen süre belirtilen DateTimeöğesinin DateTime gününün dışındaysa, sonucun gün kısmı etkilenir. Sonuçta elde edilen DateTime gün belirtilen DateTimeayın dışındaysa, sonuçta elde edilen ayın ay bölümü etkilenir. Sonuçta elde edilen DateTime ay belirtilen DateTimeyılın dışındaysa, sonuçta elde edilen yılın yıl bölümü etkilenir. Sonuçta elde DateTime edilen yıl belirtilen DateTimeöğesinin döneminin dışındaysa, sonuçta elde edilen bölümün dönem bölümü etkilenir.

Kind Döndürülen DateTime değerin özelliği her zaman eşittirDateTimeKind.Unspecified. Aşağıdaki örnekte gösterildiği gibi yöntemini çağırarak DateTime.SpecifyKind parametresinin özelliğini time koruyabilirsinizKind.

C#

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

Şunlara uygulanır

Ayrıca bkz.

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