Calendar.AddDays(DateTime, Int32) Метод

Определение

Пространство имен:

System.Globalization

Сборка:

System.Runtime.dll

Исходный код:

Calendar.cs

Возвращает DateTime как заданное число дней из заданного объекта DateTime.

C#

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

Параметры

time

DateTime

Объект DateTime, к которому добавляются дни.

days

Int32

Количество дней, которое нужно добавить.

Возвращаемое значение

DateTime

Объект DateTime, полученный добавлением заданного числа дней к заданному объекту DateTime.

Исключения

ArgumentException

Результирующее значение DateTime находится вне диапазона значений данного календаря.

ArgumentOutOfRangeException

Значение days находится вне допустимого диапазона возвращаемого значения DateTime.

Примеры

В следующем примере кода показаны члены Calendar класса .

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

*/

Комментарии

Значение days добавляется к указанному DateTimeобъекту . Если days является отрицательным, результирующий DateTime объект будет раньше указанного DateTime.

Часть результирующего DateTime месяца влияет, если результирующий день находится за пределами месяца указанного DateTime. Часть года в результирующем DateTime объекте влияет, если результирующий месяц находится за пределами года указанного DateTime. Часть эры в результирующем DateTime объекте затрагивается, если результирующий год находится за пределами эры указанного DateTime. Временная часть результирующего объекта DateTime остается той же, что и указанная DateTime.

Свойство Kind возвращаемого DateTime значения всегда равно DateTimeKind.Unspecified. Свойство параметра можно сохранить Kindtime , вызвав DateTime.SpecifyKind метод , как показано в следующем примере.

C#

returnTime = DateTime.SpecifyKind(cal.AddDays(time, days), time.Kind);

Применяется к

См. также раздел

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