DateTimeOffset.AddSeconds(Double) Método

Definição

Namespace:

System

Assemblies:

netstandard.dll, 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.

C#

public DateTimeOffset AddSeconds(double seconds);

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.

Aplica-se a

Confira também

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