DateTime.AddDays(Double) Método

Definición

Espacio de nombres:

System

Ensamblados:

netstandard.dll, System.Runtime.dll

Source:

DateTime.cs

Devuelve un nuevo DateTime que agrega el número especificado de días al valor de esta instancia.

public:
 DateTime AddDays(double value);

public DateTime AddDays(double value);

member this.AddDays : double -> DateTime

Public Function AddDays (value As Double) As DateTime

Parámetros

value

Double

Número de días enteros y fraccionarios. El value parámetro puede ser negativo o positivo.

Devoluciones

DateTime

Objeto cuyo valor es la suma de la fecha y hora representada por esta instancia y el número de días representados por value.

Excepciones

ArgumentOutOfRangeException

El resultado DateTime es menor que DateTime.MinValue o mayor que DateTime.MaxValue.

Ejemplos

En el ejemplo siguiente se usa el AddDays método para determinar el día de la semana 36 días después de la fecha actual.

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

Comentarios

Este método no cambia el valor de este DateTime. En su lugar, devuelve un nuevo DateTime cuyo valor es el resultado de esta operación.

La parte fraccionaria de value es la parte fraccionaria de un día. Por ejemplo, 4,5 equivale a 4 días, 12 horas, 0 minutos, 0 segundos, 0 milisegundos y 0 tics.

En .NET Framework, el value parámetro se redondea al milisegundo más cercano. En .NET 7 y versiones posteriores, se usa la precisión completa Double del value parámetro. Sin embargo, debido a la imprecisión inherente de las matemáticas de punto flotante, la precisión resultante variará.

El AddDays método tiene en cuenta los años bisiestos y el número de días de un mes al realizar la aritmética de fecha.

Consulte también

• Double