DateTime.Add(TimeSpan) Método

Referência

Definição

Namespace:: System

Assemblies:: mscorlib.dll, System.Runtime.dll

Assemblies:: netstandard.dll, System.Runtime.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Origem:: DateTime.cs

Origem:: DateTime.cs

Origem:: DateTime.cs

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

Produto	Versões
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Compartilhar via