DateTimeOffset.AddSeconds(Double) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Devolve um novo DateTimeOffset objeto que adiciona um número especificado de segundos inteiros e fracionários ao valor desta 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 negativo ou positivo.
Devoluções
Um objeto cujo valor é a soma da data e hora representadas pelo objeto atual DateTimeOffset e o número de segundos representado por seconds.
Exceções
O valor resultante DateTimeOffset é inferior ao DateTimeOffset.MinValue.
-ou-
O valor resultante DateTimeOffset é superior ao DateTimeOffset.MaxValue.
Observações
A parte fracionária do seconds parâmetro é a parte fracionária de um segundo. O valor das partes fracionárias de um segundo é mostrado na tabela seguinte.
| Segundo valor | Equivalente |
|---|---|
| 0,1 segundo | 100 milissegundos |
| 0,01 segundo | 10 milissegundos |
| .001 segundo | 1 milissegundo |
No .NET Framework, o parâmetro seconds é arredondado para o milissegundo mais próximo. Nas versões .NET 7 e posteriores, é utilizada a precisão total Double do parâmetro seconds. No entanto, devido à imprecisão inerente da matemática de ponto flutuante, a precisão resultante irá variar.
Note
Este método devolve um novo DateTimeOffset objeto. 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 num fuso horário específico, o AddSeconds método não considera as regras de ajuste de um fuso horário específico ao realizar a aritmética de data e hora.
