Partilhar via


DateTimeOffset.AddSeconds(Double) Método

Definição

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

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

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.

Aplica-se a

Confira também