DateTime.Subtract Metodo

Origine:

DateTime.cs

Origine:

DateTime.cs

Origine:

DateTime.cs

Origine:

DateTime.cs

Origine:

DateTime.cs

public:
 DateTime Subtract(TimeSpan value);

public DateTime Subtract(TimeSpan value);

member this.Subtract : TimeSpan -> DateTime

Public Function Subtract (value As TimeSpan) As DateTime

Parametri

Restituisce

Oggetto uguale alla data e all'ora rappresentate da questa istanza meno l'intervallo di tempo rappresentato da value.

Eccezioni

Esempio

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

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 rappresenta una differenza di intervallo di tempo specificata rispetto all'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 il valore -2.

Questo metodo non modifica il valore di .DateTime Restituisce invece un nuovo DateTime 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 sottrarre 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 di , è possibile passare un valore numerico negativo come parametro a uno dei metodi seguenti:

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

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

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

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

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

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

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

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

Vedi anche

• TimeSpan
• Esecuzione di operazioni aritmetiche con date e ore

Origine:

DateTime.cs

Origine:

DateTime.cs

Origine:

DateTime.cs

Origine:

DateTime.cs

Origine:

DateTime.cs

public:
 TimeSpan Subtract(DateTime value);

public TimeSpan Subtract(DateTime value);

member this.Subtract : DateTime -> TimeSpan

Public Function Subtract (value As DateTime) As TimeSpan

Parametri

Restituisce

Intervallo di tempo uguale alla data e all'ora rappresentate da questa istanza meno la data e l'ora rappresentate da value.

Eccezioni

Esempio

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

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 il valore -2.

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

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

Vedi anche

• Esecuzione di operazioni aritmetiche con date e ore