DateTimeOffset.AddSeconds(Double) Método

Definición

Devuelve un nuevo objeto DateTimeOffset que agrega un número especificado de segundos enteros y fraccionarios al valor de esta instancia.

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

Número de segundos enteros y fraccionarios. El número puede ser positivo o negativo.

Devoluciones

Objeto cuyo valor es la suma de la fecha y hora representadas por el objeto DateTimeOffset actual y el número de segundos representados por seconds.

Excepciones

El valor resultante DateTimeOffset es menor que DateTimeOffset.MinValue.

O bien

El valor resultante DateTimeOffset es mayor que DateTimeOffset.MaxValue.

Comentarios

La parte fraccionarcional del seconds parámetro es la parte fraccionarcional de un segundo. El valor de las partes fraccionarios de un segundo se muestra en la tabla siguiente.

Segundo valor Tipo de datos de XPath
.1 segundo 100 milisegundos
.01 segundo 10 milisegundos
.001 segundo 1 milisegundo

En .NET 6 y versiones anteriores, el seconds parámetro se redondea al milisegundo más cercano. En .NET 7 y versiones posteriores, se usa la precisión completa Double del seconds parámetro . Sin embargo, debido a la imprecisión inherente de las matemáticas de punto flotante, la precisión resultante variará.

Nota:

Este método devuelve un nuevo DateTimeOffset objeto . No modifica el valor del objeto actual agregando seconds a su fecha y hora.

Dado que un DateTimeOffset objeto no representa la fecha y hora de una zona horaria específica, el AddSeconds método no considera las reglas de ajuste de una zona horaria determinada cuando realiza la aritmética de fecha y hora.

Se aplica a

Consulte también