DateTime.Add(TimeSpan) Método

  • Referência

Definição

Namespace:
System
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Origem:
DateTime.cs
Origem:
DateTime.cs
Origem:
DateTime.cs

Retorna um novo DateTime que adiciona o valor do TimeSpan especificado ao valor dessa instância.

public:
 DateTime Add(TimeSpan value);
public DateTime Add (TimeSpan value);
member this.Add : TimeSpan -> DateTime
Public Function Add (value As TimeSpan) As DateTime

Parâmetros

value
TimeSpan

Um intervalo de tempo positivo ou negativo.

Retornos

DateTime

Um objeto cujo valor é a soma da data e hora representada por essa instância e o intervalo de tempo representado por value.

Exceções

ArgumentOutOfRangeException

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

Exemplos

O exemplo a seguir demonstra o Add método. Ele calcula o dia da semana que é de 36 dias (864 horas) a partir deste momento.

// Calculate what day of the week is 36 days from this instant.
System::DateTime today = System::DateTime::Now;
System::TimeSpan duration( 36, 0, 0, 0 );
System::DateTime answer = today.Add( duration );
System::Console::WriteLine( " {0:dddd}", answer );

// Calculate what day of the week is 36 days from this instant.
let today = DateTime.Now
let duration = TimeSpan(36, 0, 0, 0)
let answer = today.Add duration
printfn $"{answer:dddd}"

// Calculate what day of the week is 36 days from this instant.
System.DateTime today = System.DateTime.Now;
System.TimeSpan duration = new System.TimeSpan(36, 0, 0, 0);
System.DateTime answer = today.Add(duration);
System.Console.WriteLine("{0:dddd}", answer);

' Calculate what day of the week is 36 days from this instant.
Dim today As System.DateTime
Dim duration As System.TimeSpan
Dim answer As System.DateTime

today = System.DateTime.Now
duration = New System.TimeSpan(36, 0, 0, 0)
answer = today.Add(duration)

System.Console.WriteLine("{0:dddd}", answer)

Comentários

Você pode usar o Add método para adicionar mais de um tipo de intervalo de tempo (dias, horas, minutos, segundos ou milissegundos) em uma única operação. O comportamento desse método é idêntico ao do operador de adição. A DateTime estrutura também dá suporte a métodos de adição especializados (como AddDays, AddHourse AddMinutes) para cada intervalo de tempo.

O Add 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.

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 Kind propriedade da nova DateTime instância é a mesma da instância atual.

Aplica-se a

Confira também