DateTime.Subtract DateTime.Subtract DateTime.Subtract DateTime.Subtract Method

Definizione

Restituisce un nuovo elemento DateTime che sottrae il tempo o la durata specificati dal valore dell'istanza.Returns a new DateTime that subtracts the specified time or duration from the value of this instance.

Overload

Subtract(DateTime) Subtract(DateTime) Subtract(DateTime) Subtract(DateTime)

Restituisce un nuovo elemento DateTime che sottrae la data e l'ora specificate dal valore dell'istanza.Returns a new DateTime that subtracts the specified date and time from the value of this instance.

Subtract(TimeSpan) Subtract(TimeSpan) Subtract(TimeSpan) Subtract(TimeSpan)

Restituisce un nuovo elemento DateTime che sottrae la durata specificata dal valore dell'istanza.Returns a new DateTime that subtracts the specified duration from the value of this instance.

Subtract(DateTime) Subtract(DateTime) Subtract(DateTime) Subtract(DateTime)

Restituisce un nuovo elemento DateTime che sottrae la data e l'ora specificate dal valore dell'istanza.Returns a new DateTime that subtracts the specified date and time from the value of this instance.

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 DateTime DateTime DateTime

Valore di data e ora da sottrarre.The date and time value to subtract.

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.A time interval that is equal to the date and time represented by this instance minus the date and time represented by value.

Eccezioni

Esempi

Nell'esempio seguente vengono illustrati il Subtract metodo e l'operatore di sottrazione.The following example demonstrates the Subtract method and the subtraction operator.

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;
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.The Subtract(DateTime) method determines the difference between two dates. Per sottrarre un intervallo di tempo dall'istanza corrente, chiamare Subtract(TimeSpan) il metodo.To subtract a time interval from the current instance, call the Subtract(TimeSpan) method. Per sottrarre un determinato intervallo di tempo dall'istanza corrente, chiamare il metodo che aggiunge tale intervallo di tempo alla data corrente e fornire un valore negativo come argomento del metodo.To subtract a particular time interval from the current instance, call the method that adds that time interval to the current date, and supply a negative value as the method argument. Ad esempio, per sottrarre due mesi dalla data corrente, chiamare il AddMonths(Int32) metodo con un valore pari a-2.For example, to subtract two months from the current date, call the AddMonths(Int32) method with a value of -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.If the date and time of the current instance is earlier than value, the method returns a TimeSpan object that represents a negative time span. Ovvero, il valore di tutte le relative proprietà diverse da zero, ad esempio Days o Ticks, è negativo.That is, the value of all of its non-zero properties (such as Days or Ticks) is negative.

Quando Subtract(DateTime) si esegue la sottrazione, il metodo Kind non considera il valore DateTime della proprietà dei due valori.The Subtract(DateTime) method does not consider the value of the Kind property of the two DateTime values when performing the subtraction. Prima di sottrarre DateTime oggetti, verificare che gli oggetti rappresentino orari nello stesso fuso orario.Before subtracting DateTime objects, ensure that the objects represent times in the same time zone. In caso contrario, il risultato includerà la differenza tra i fusi orari.Otherwise, the result will include the difference between time zones.

Nota

Il DateTimeOffset.Subtract(DateTimeOffset) metodo considera la differenza tra i fusi orari durante l'esecuzione della sottrazione.The DateTimeOffset.Subtract(DateTimeOffset) method does consider the difference between time zones when performing the subtraction.

Vedi anche

Subtract(TimeSpan) Subtract(TimeSpan) Subtract(TimeSpan) Subtract(TimeSpan)

Restituisce un nuovo elemento DateTime che sottrae la durata specificata dal valore dell'istanza.Returns a new DateTime that subtracts the specified duration from the value of this instance.

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 TimeSpan TimeSpan TimeSpan

Intervallo di tempo da sottrarre.The time interval to subtract.

Restituisce

Oggetto uguale alla data e all'ora rappresentate dall'istanza dalle quali è stato sottratto l'intervallo di tempo rappresentato da value.An object that is equal to the date and time represented by this instance minus the time interval represented by value.

Eccezioni

Esempi

Nell'esempio seguente vengono illustrati il Subtract metodo e l'operatore di sottrazione.The following example demonstrates the Subtract method and the subtraction operator.

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;
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 dall'istanza corrente.The Subtract(TimeSpan) method returns the date that is a specified time interval difference from the current instance. Per determinare l'intervallo di tempo tra due date, chiamare Subtract(DateTime) il metodo.To determine the time interval between two dates, call the Subtract(DateTime) method. Per sottrarre un determinato intervallo di tempo dall'istanza corrente, chiamare il metodo che aggiunge tale intervallo di tempo alla data corrente e fornire un valore negativo come argomento del metodo.To subtract a particular time interval from the current instance, call the method that adds that time interval to the current date, and supply a negative value as the method argument. Ad esempio, per sottrarre due mesi dalla data corrente, chiamare il AddMonths(Int32) metodo con un valore pari a-2.For example, to subtract two months from the current date, call the AddMonths(Int32) method with a value of -2.

Questo metodo non modifica il valore di questo DateTimeoggetto.This method does not change the value of this DateTime. Viene invece restituito un nuovo DateTime oggetto il cui valore è il risultato di questa operazione.Instead, it returns a new DateTime whose value is the result of this operation.

In genere, il DateTime.Subtract(TimeSpan) metodo sottrae un TimeSpan oggetto che rappresenta un intervallo di tempo positivo e restituisce DateTime un valore che è precedente alla data e all'ora dell'istanza corrente.Ordinarily, the DateTime.Subtract(TimeSpan) method subtracts a TimeSpan object that represents a positive time span and returns a DateTime value that is earlier than the date and time of the current instance. Tuttavia, se l' TimeSpan oggetto rappresenta un intervallo di tempo negativo, DateTime.Subtract(TimeSpan) il metodo restituisce DateTime un valore successivo alla data e all'ora dell'istanza corrente.However, if the TimeSpan object represents a negative time span, the DateTime.Subtract(TimeSpan) method returns a DateTime value that is later than the date and time of the current instance.

Il DateTime.Subtract(TimeSpan) metodo consente di sottrarre un intervallo di tempo costituito da più di un'unità di tempo, ad esempio un numero specificato di ore e un numero di minuti specificato.The DateTime.Subtract(TimeSpan) method allows you to subtract a time interval that consists of more than one unit of time (such as a given number of hours and a given number of minutes). Per sottrarre una singola unità di tempo, ad esempio anni, mesi o giorni, dall' DateTime istanza di, è possibile passare un valore numerico negativo come parametro a uno dei metodi seguenti:To subtract a single unit of time (such as years, months, or days) from the DateTime instance, you can pass a negative numeric value as a parameter to any of the following methods:

  • AddYears, per sottrarre un numero specifico di anni dall'istanza di data e ora corrente.AddYears, to subtract a specific number of years from the current date and time instance.

  • AddMonths, per sottrarre un numero specifico di mesi dall'istanza di data e ora corrente.AddMonths, to subtract a specific number of months from the current date and time instance.

  • AddDays, per sottrarre un numero specifico di giorni dall'istanza di data e ora corrente.AddDays, to subtract a specific number of days from the current date and time instance.

  • AddHours, per sottrarre un numero specifico di ore dall'istanza di data e ora corrente.AddHours, to subtract a specific number of hours from the current date and time instance.

  • AddMinutes, per sottrarre un numero specifico di minuti dall'istanza di data e ora corrente.AddMinutes, to subtract a specific number of minutes from the current date and time instance.

  • AddSeconds, per sottrarre un numero specifico di secondi dall'istanza di data e ora corrente.AddSeconds, to subtract a specific number of seconds from the current date and time instance.

  • AddMilliseconds, per sottrarre un numero specifico di millisecondi dall'istanza di data e ora corrente.AddMilliseconds, to subtract a specific number of milliseconds from the current date and time instance.

  • AddTicks, per sottrarre un numero specifico di cicli dall'istanza di data e ora corrente.AddTicks, to subtract a specific number of ticks from the current date and time instance.

Vedi anche

Si applica a