DateTimeOffset.AddSeconds(Double) Metodo

Definizione

Spazio dei nomi:

System

Assembly:

System.Runtime.dll

Origine:

DateTimeOffset.cs

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

DateTimeOffset

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

ArgumentOutOfRangeException

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.

Vedi anche

• Esecuzione di operazioni aritmetiche con date e ore