DateTime.Subtract Metodo

Definizione

Spazio dei nomi:

System

Assembly:

netstandard.dll, System.Runtime.dll

Restituisce il valore risultante dalla sottrazione dell'ora o della durata specificata dal valore di questa istanza.

Overload

Subtract(TimeSpan)	Restituisce un nuovo elemento DateTime che sottrae la durata specificata dal valore dell'istanza.
Subtract(DateTime)	Restituisce un nuovo elemento TimeSpan che sottrae la data e l'ora specificate dal valore dell'istanza.

Subtract(TimeSpan)

Origine:

DateTime.cs

Restituisce un nuovo elemento DateTime che sottrae la durata specificata dal valore dell'istanza.

C#

public DateTime Subtract(TimeSpan value);

Parametri

value

TimeSpan

Intervallo di tempo da sottrarre.

Restituisce

DateTime

Oggetto uguale alla data e all'ora rappresentate dall'istanza dalle quali è stato sottratto l'intervallo di tempo rappresentato da value.

Eccezioni

ArgumentOutOfRangeException

Il risultato è minore di DateTime.MinValue o maggiore di DateTime.MaxValue.

Esempio

Nell'esempio seguente viene illustrato il metodo e l'operatore Subtract di sottrazione.

C#

System.DateTime date1 = new System.DateTime(1996, 6, 3, 22, 15, 0);
System.DateTime date2 = new System.DateTime(1996, 12, 6, 13, 2, 0);
System.DateTime date3 = new System.DateTime(1996, 10, 12, 8, 42, 0);

// diff1 gets 185 days, 14 hours, and 47 minutes.
System.TimeSpan diff1 = date2.Subtract(date1);

// date4 gets 4/9/1996 5:55:00 PM.
System.DateTime date4 = date3.Subtract(diff1);

// diff2 gets 55 days 4 hours and 20 minutes.
System.TimeSpan diff2 = date2 - date3;

// date5 gets 4/9/1996 5:55:00 PM.
System.DateTime date5 = date1 - diff2;

Commenti

Il Subtract(TimeSpan) metodo restituisce la data che è una differenza di intervallo di tempo specificata dall'istanza corrente. Per determinare l'intervallo di tempo tra due date, chiamare il Subtract(DateTime) metodo . Per sottrarre un determinato intervallo di tempo dall'istanza corrente, chiamare il metodo che aggiunge tale intervallo di tempo alla data corrente e specificare un valore negativo come argomento del metodo. Ad esempio, per sottrarre due mesi dalla data corrente, chiamare il AddMonths(Int32) metodo con un valore pari a -2.

Questo metodo non modifica il valore di questo DateTimeoggetto . Restituisce invece un nuovo DateTime valore il cui valore è il risultato di questa operazione.

In genere, il DateTime.Subtract(TimeSpan) metodo sottrae un oggetto che rappresenta un TimeSpan intervallo di tempo positivo e restituisce un DateTime valore precedente alla data e all'ora dell'istanza corrente. Tuttavia, se l'oggetto TimeSpan rappresenta un intervallo di tempo negativo, il DateTime.Subtract(TimeSpan) metodo restituisce un DateTime valore successivo alla data e all'ora dell'istanza corrente.

Il DateTime.Subtract(TimeSpan) metodo consente di sottraere un intervallo di tempo costituito da più unità di tempo, ad esempio un determinato numero di ore e un determinato numero di minuti. Per sottrarre una singola unità di tempo (ad esempio anni, mesi o giorni) dall'istanza DateTime , è possibile passare un valore numerico negativo come parametro a uno dei metodi seguenti:

• AddYears, per sottraere un numero specifico di anni dall'istanza corrente di data e ora.

• AddMonths, per sottrarre un numero specifico di mesi dall'istanza corrente di data e ora.

• AddDays, per sottrarre un numero specifico di giorni dall'istanza di data e ora corrente.

• AddHours, per sottraere un numero specifico di ore dall'istanza di data e ora correnti.

• AddMinutes, per sottraere un numero specifico di minuti dall'istanza corrente di data e ora.

• AddSeconds, per sottrarre un numero specifico di secondi dall'istanza corrente di data e ora.

• AddMilliseconds, per sottrarre un numero specifico di millisecondi dall'istanza corrente di data e ora.

• AddTicks, per sottraere un numero specifico di tick dall'istanza di data e ora corrente.

Vedi anche

• TimeSpan
• Esecuzione di operazioni aritmetiche con date e ore

Subtract(DateTime)

Origine:

DateTime.cs

Restituisce un nuovo elemento TimeSpan che sottrae la data e l'ora specificate dal valore dell'istanza.

C#

public TimeSpan Subtract(DateTime value);

Parametri

value

DateTime

Valore di data e ora da sottrarre.

Restituisce

TimeSpan

Intervallo di tempo uguale alla data e all'ora rappresentate dall'istanza dalle quali sono state sottratte la data e l'ora rappresentate da value.

Eccezioni

ArgumentOutOfRangeException

Il risultato è minore di DateTime.MinValue o maggiore di DateTime.MaxValue.

Esempio

Nell'esempio seguente viene illustrato il metodo e l'operatore Subtract di sottrazione.

C#

System.DateTime date1 = new System.DateTime(1996, 6, 3, 22, 15, 0);
System.DateTime date2 = new System.DateTime(1996, 12, 6, 13, 2, 0);
System.DateTime date3 = new System.DateTime(1996, 10, 12, 8, 42, 0);

// diff1 gets 185 days, 14 hours, and 47 minutes.
System.TimeSpan diff1 = date2.Subtract(date1);

// date4 gets 4/9/1996 5:55:00 PM.
System.DateTime date4 = date3.Subtract(diff1);

// diff2 gets 55 days 4 hours and 20 minutes.
System.TimeSpan diff2 = date2 - date3;

// date5 gets 4/9/1996 5:55:00 PM.
System.DateTime date5 = date1 - diff2;

Commenti

Il Subtract(DateTime) metodo determina la differenza tra due date. Per sottrarre un intervallo di tempo dall'istanza corrente, chiamare il Subtract(TimeSpan) metodo . Per sottrarre un determinato intervallo di tempo dall'istanza corrente, chiamare il metodo che aggiunge tale intervallo di tempo alla data corrente e specificare un valore negativo come argomento del metodo. Ad esempio, per sottrarre due mesi dalla data corrente, chiamare il AddMonths(Int32) metodo con un valore pari a -2.

Se la data e l'ora dell'istanza corrente è precedente a value, il metodo restituisce un oggetto che rappresenta un TimeSpan intervallo di tempo negativo. Vale a dire, il valore di tutte le relative proprietà non zero (ad esempio Days o Ticks) è negativo.

Il Subtract(DateTime) metodo non considera il valore della proprietà dei due DateTime valori durante l'esecuzione Kind della sottrazione. Prima di sottraere DateTime oggetti, assicurarsi che gli oggetti rappresentino gli orari nello stesso fuso orario. In caso contrario, il risultato includerà la differenza tra i fusi orari.

Nota

Il DateTimeOffset.Subtract(DateTimeOffset) metodo considera la differenza tra i fusi orari durante l'esecuzione della sottrazione.

Vedi anche

• Esecuzione di operazioni aritmetiche con date e ore