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 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.