DateTimeOffset.AddSeconds(Double) Metodo

Definizione

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.

Si applica a

Vedi anche