DateTime.AddDays(Double) Método

  • Referencia

Definición

Espacio de nombres:
System
Ensamblado:
System.Runtime.dll
Ensamblado:
mscorlib.dll
Ensamblado:
netstandard.dll
Source:
DateTime.cs
Source:
DateTime.cs
Source:
DateTime.cs

Devuelve un nuevo objeto DateTime que suma 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 parámetro value puede ser positivo o negativo.

Devoluciones

DateTime

Un objeto cuyo valor es la suma de la fecha y hora representadas 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.

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

Comentarios

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

La parte fraccionarcional de value es la parte fraccionarcional 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 6 y versiones anteriores, 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.

Se aplica a

Consulte también