DateTime.AddDays(Double) Метод

Определение

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

System

Сборки:

netstandard.dll, 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 дней после текущей даты.

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 Framework value параметр округляется до ближайшей миллисекунда. В .NET 7 и более поздних версиях используется полная Double точность value параметра. Тем не менее, из-за присущей непреднастойности математики с плавающей запятой результирующая точность будет отличаться.

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

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

• Double