DateTimeOffset.AddSeconds(Double) Método

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Origem:

DateTimeOffset.cs

Retorna um novo objeto DateTimeOffset que adiciona um número especificado de segundos inteiros e fracionários ao valor dessa instância.

public:
 DateTimeOffset AddSeconds(double seconds);

public DateTimeOffset AddSeconds (double seconds);

member this.AddSeconds : double -> DateTimeOffset

Public Function AddSeconds (seconds As Double) As DateTimeOffset

Parâmetros

seconds

Double

Um número de segundos inteiros e fracionários. O número pode ser positivo ou negativo.

Retornos

DateTimeOffset

Um objeto cujo valor é a soma da data e hora representadas pelo objeto DateTimeOffset atual e o número de segundos representados por seconds.

Exceções

ArgumentOutOfRangeException

O valor resultante DateTimeOffset é menor que DateTimeOffset.MinValue.

-ou-

O valor resultante DateTimeOffset é maior que DateTimeOffset.MaxValue.

Comentários

A parte fracionária do seconds parâmetro é a parte fracionária de um segundo. O valor de partes fracionárias de um segundo é mostrado na tabela a seguir.

Segundo valor	Equivalente
0,1 segundo	100 milissegundos
0,01 segundo	10 milissegundos
0,001 segundo	1 milissegundo

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

Observação

Este método retorna um novo objeto DateTimeOffset. Ele não modifica o valor do objeto atual adicionando seconds à sua data e hora.

Como um DateTimeOffset objeto não representa a data e a hora em um fuso horário específico, o AddSeconds método não considera as regras de ajuste de um fuso horário específico quando executa a aritmética de data e hora.

Confira também

• Executando operações aritméticas com datas e horas