DateTime.Subtract Metodo

Definizione

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
Origine:
DateTime.cs
Origine:
DateTime.cs

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

public:
 DateTime Subtract(TimeSpan value);
public DateTime Subtract (TimeSpan value);
member this.Subtract : TimeSpan -> DateTime
Public Function Subtract (value As TimeSpan) As DateTime

Parametri

value
TimeSpan

Intervallo di tempo da sottrarre.

Restituisce

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

Eccezioni

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.

System::DateTime date1 = System::DateTime( 1996, 6, 3, 22, 15, 0 );
System::DateTime date2 = System::DateTime( 1996, 12, 6, 13, 2, 0 );
System::DateTime date3 = 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;
open System

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

// diff1 gets 185 days, 14 hours, and 47 minutes.
let diff1 = date2.Subtract date1

// date4 gets 4/9/1996 5:55:00 PM.
let date4 = date3.Subtract diff1

// diff2 gets 55 days 4 hours and 20 minutes.
let diff2 = date2 - date3

// date5 gets 4/9/1996 5:55:00 PM.
let date5 = date1 - diff2
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;
Dim date1 As New System.DateTime(1996, 6, 3, 22, 15, 0)
Dim date2 As New System.DateTime(1996, 12, 6, 13, 2, 0)
Dim date3 As New System.DateTime(1996, 10, 12, 8, 42, 0)

Dim diff1 As System.TimeSpan
' diff1 gets 185 days, 14 hours, and 47 minutes.
diff1 = date2.Subtract(date1)

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

Dim diff2 As System.TimeSpan
' diff2 gets 55 days 4 hours and 20 minutes.
diff2 = System.DateTime.op_Subtraction(date2, date3)

Dim date5 As System.DateTime
' date5 gets 4/9/1996 5:55:00 PM.
date5 = System.DateTime.op_Subtraction(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

Si applica a

Subtract(DateTime)

Origine:
DateTime.cs
Origine:
DateTime.cs
Origine:
DateTime.cs

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

public:
 TimeSpan Subtract(DateTime value);
public TimeSpan Subtract (DateTime value);
member this.Subtract : DateTime -> TimeSpan
Public Function Subtract (value As DateTime) As TimeSpan

Parametri

value
DateTime

Valore di data e ora da sottrarre.

Restituisce

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

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.

System::DateTime date1 = System::DateTime( 1996, 6, 3, 22, 15, 0 );
System::DateTime date2 = System::DateTime( 1996, 12, 6, 13, 2, 0 );
System::DateTime date3 = 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;
open System

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

// diff1 gets 185 days, 14 hours, and 47 minutes.
let diff1 = date2.Subtract date1

// date4 gets 4/9/1996 5:55:00 PM.
let date4 = date3.Subtract diff1

// diff2 gets 55 days 4 hours and 20 minutes.
let diff2 = date2 - date3

// date5 gets 4/9/1996 5:55:00 PM.
let date5 = date1 - diff2
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;
Dim date1 As New System.DateTime(1996, 6, 3, 22, 15, 0)
Dim date2 As New System.DateTime(1996, 12, 6, 13, 2, 0)
Dim date3 As New System.DateTime(1996, 10, 12, 8, 42, 0)

Dim diff1 As System.TimeSpan
' diff1 gets 185 days, 14 hours, and 47 minutes.
diff1 = date2.Subtract(date1)

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

Dim diff2 As System.TimeSpan
' diff2 gets 55 days 4 hours and 20 minutes.
diff2 = System.DateTime.op_Subtraction(date2, date3)

Dim date5 As System.DateTime
' date5 gets 4/9/1996 5:55:00 PM.
date5 = System.DateTime.op_Subtraction(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

Si applica a