DateTime.AddDays(Double) Método

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Origem:

DateTime.cs

Retorna um novo DateTime que adiciona o número especificado de dias ao valor dessa instância.

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

Um número de dias inteiros e fracionários. O parâmetro value pode ser positivo ou negativo.

Retornos

DateTime

Um objeto cujo valor é a soma da data e hora representada por essa instância e o número de dias representado por value.

Exceções

ArgumentOutOfRangeException

O resultado DateTime é menor que DateTime.MinValue ou maior que DateTime.MaxValue.

Exemplos

O exemplo a seguir usa o AddDays método para determinar o dia da semana 36 dias após a data atual.

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

Comentários

Este método não altera o valor desse DateTime. Em vez disso, ele retorna um novo DateTime cujo valor é o resultado dessa operação.

A parte fracionária de value é a parte fracionária de um dia. Por exemplo, 4,5 é equivalente a 4 dias, 12 horas, 0 minutos, 0 segundos, 0 milissegundos e 0 tiques.

No .NET 6 e em versões anteriores, o value parâmetro é arredondado para o milissegundo mais próximo. No .NET 7 e versões posteriores, a precisão completa Double do value parâmetro é usada. No entanto, devido à imprecisão inerente da matemática de ponto flutuante, a precisão resultante variará.

O AddDays método leva em conta os anos bissextos e o número de dias em um mês ao executar a aritmética de data.

Confira também

• Double