DateTimeOffset.AddSeconds(Double) Método
Definição
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 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 -> DateTimeOffsetPublic Function AddSeconds (seconds As Double) As DateTimeOffsetParâ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.
