Calendar.AddDays(DateTime, Int32) Yöntem

Tanım

Ad Alanı:

System.Globalization

Bütünleştirilmiş Kod:

System.Runtime.dll

Kaynak:

Calendar.cs

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

C#

public virtual DateTime AddDays (DateTime time, int days);

Parametreler

time

DateTime

Günlerin DateTime ekleneceği yer.

days

Int32

Eklenecek gün sayısı.

Döndürülenler

DateTime

Belirtilen DateTime gün sayısını belirtilen öğesine eklemenin sonucu olan DateTime.

Özel durumlar

ArgumentException

DateTime Sonuçta bu takvimin desteklenen aralığının dışında bir sonuç elde edilir.

ArgumentOutOfRangeException

days 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

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

Sonuçta elde DateTime edilen gün belirtilen DateTimeayın dışındaysa, sonuçta elde edilen ayın ay bölümü etkilenir. Sonuçta elde DateTime edilen ayın belirtilen DateTimeyılın dışında olması durumunda, sonuçta elde edilen yılın yıl bölümü etkilenir. Sonuçta elde DateTime edilen yıl belirtilen DateTimeöğesinin çağının dışındaysa, sonuçta elde edilen bölümü etkilenir. Sonuçta elde DateTime edilen günün saati bölümü belirtilen DateTimeile aynı kalır.

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.AddDays(time, days), time.Kind);

Şunlara uygulanır

Ayrıca bkz.

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