DateTimeOffset.AddSeconds(Double) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Devuelve un nuevo DateTimeOffset objeto 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 negativo o positivo.
Devoluciones
Objeto cuyo valor es la suma de la fecha y hora representada por el objeto actual DateTimeOffset 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 fraccionaria del seconds parámetro es la parte fraccionaria de un segundo. El valor de las partes fraccionarios de un segundo se muestra en la tabla siguiente.
| Segundo valor | Equivalente |
|---|---|
| .1 segundo | 100 milisegundos |
| .01 segundo | 10 milisegundos |
| .001 segundo | 1 milisegundos |
En .NET Framework, 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 en 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.