DateTime.AddDays(Double) Метод

Определение

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

System

Сборка:

System.Runtime.dll

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

DateTime.cs

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

public:
 DateTime AddDays(double value);

public DateTime AddDays (double value);

member this.AddDays : double -> DateTime

Public Function AddDays (value As Double) As DateTime

Параметры

value

Double

Число полных и неполных дней. Параметр value может быть положительным или отрицательным.

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

DateTime

Объект, значение которого равно сумме даты и времени, представленных текущим экземпляром, и количества дней, представленного параметром value.

Исключения

ArgumentOutOfRangeException

Полученный результат DateTime меньше DateTime.MinValue или больше DateTime.MaxValue.

Примеры

В следующем примере метод используется AddDays для определения дня недели на 36 дней после текущей даты.

using namespace System;

int main()
{
   // Calculate what day of the week is 36 days from this instant.
   DateTime today = System::DateTime::Now;
   DateTime answer = today.AddDays( 36 );
   Console::WriteLine("Today: {0:dddd}", today);
   Console::WriteLine("36 days from today: {0:dddd}", answer);
}
// The example displays output like the following:
//       Today: Wednesday
//       36 days from today: Thursday

open System

let today = DateTime.Now
let answer = today.AddDays 36
printfn $"Today: {today:dddd}"
printfn $"36 days from today: {answer:dddd}"


// The example displays output like the following:
//       Today: Wednesday
//       36 days from today: Thursday

using System;

class Class1
{
    static void Main()
    {
        DateTime today = DateTime.Now;
        DateTime answer = today.AddDays(36);
        Console.WriteLine("Today: {0:dddd}", today);
        Console.WriteLine("36 days from today: {0:dddd}", answer);
    }
}
// The example displays output like the following:
//       Today: Wednesday
//       36 days from today: Thursday

Class Class1
   Public Shared Sub Main()
      Dim today As System.DateTime
      Dim answer As System.DateTime

      today = System.DateTime.Now
      answer = today.AddDays(36)

      Console.WriteLine("Today: {0:dddd}", today)
      Console.WriteLine("36 days from today: {0:dddd}", answer)
   End Sub
End Class
' The example displays output like the following:
'       Today: Wednesday
'       36 days from today: Thursday

Комментарии

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

Дробная часть value — это дробная часть дня. Например, 4,5 эквивалентно 4 дням, 12 часам, 0 минутам, 0 секундам, 0 миллисекундам и 0 тактовам.

В .NET 6 и более ранних версиях value параметр округляется до ближайшей миллисекунды. В .NET 7 и более поздних версиях используется полная Double точность value параметра. Однако из-за присущей точности математических вычислений с плавающей запятой результирующая точность будет отличаться.

Метод AddDays учитывает високосные годы и количество дней в месяце при выполнении арифметики даты.

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

• Double