DateTimeOffset.AddSeconds(Double) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Restituisce un nuovo oggetto DateTimeOffset che aggiunge un numero specificato di secondi interi e frazionari al valore dell'istanza.
public:
DateTimeOffset AddSeconds(double seconds);
public DateTimeOffset AddSeconds (double seconds);
member this.AddSeconds : double -> DateTimeOffset
Public Function AddSeconds (seconds As Double) As DateTimeOffset
Parametri
- seconds
- Double
Numero di secondi interi e frazionari. Il numero può essere positivo o negativo.
Restituisce
Oggetto il cui valore è la somma della data e dell'ora rappresentate dall'oggetto DateTimeOffset corrente e del numero di secondi rappresentato da seconds
.
Eccezioni
Il valore risultante DateTimeOffset è minore di DateTimeOffset.MinValue.
-oppure-
Il valore risultante DateTimeOffset è maggiore di DateTimeOffset.MaxValue.
Commenti
La parte frazionaria del seconds
parametro è la parte frazionaria di un secondo. Il valore delle parti frazionarie di un secondo è illustrato nella tabella seguente.
Secondo valore | Equivalente |
---|---|
.1 secondo | 100 millisecondi |
.01 secondo | 10 millisecondi |
.001 secondo | 1 millisecondo |
In .NET 6 e versioni precedenti il seconds
parametro viene arrotondato al millisecondo più vicino. In .NET 7 e versioni successive viene usata la precisione completa Double del seconds
parametro. Tuttavia, a causa dell'inesattezza intrinseca della matematica a virgola mobile, la precisione risultante varia.
Nota
Questo metodo restituisce un nuovo DateTimeOffset oggetto. Non modifica il valore dell'oggetto corrente aggiungendo seconds
alla data e all'ora.
Poiché un DateTimeOffset oggetto non rappresenta la data e l'ora in un fuso orario specifico, il AddSeconds metodo non considera le regole di regolazione di un particolare fuso orario quando esegue l'aritmetica di data e ora.