Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo DateTime.Subtract (DateTime)

 

Data di pubblicazione: ottobre 2016

Sottrae la data e l'ora specificate dall'istanza.

Spazio dei nomi:   System
Assembly:  mscorlib (in mscorlib.dll)

public TimeSpan Subtract(
	DateTime value
)

Parametri

value
Type: System.DateTime

Valore di data e ora da sottrarre.

Valore restituito

Type: System.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.

Exception Condition
ArgumentOutOfRangeException

Il risultato è minore di MinValue o maggiore di MaxValue.

The M:System.DateTime.Subtract(System.DateTime) method determines the difference between two dates. To subtract a time interval from the current instance, call the M:System.DateTime.Subtract(System.TimeSpan) method. 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. For example, to subtract two months from the current date, call the M:System.DateTime.AddMonths(System.Int32) method with a value of -2.

If the date and time of the current instance is earlier than value, the method returns a T:System.TimeSpan object that represents a negative time span. That is, the value of all of its non-zero properties (such as P:System.TimeSpan.Days or P:System.TimeSpan.Ticks) is negative.

TheM:System.DateTime.Subtract(System.DateTime) method does not consider the value of the P:System.DateTime.Kind property of the two T:System.DateTime values when performing the subtraction. Before subtracting T:System.DateTime objects, ensure that the objects represent times in the same time zone. Otherwise, the result will include the difference between time zones.

System_CAPS_noteNota

The M:System.DateTimeOffset.Subtract(System.DateTimeOffset) method does consider the difference between time zones when performing the subtraction.

The following example demonstrates the M:System.DateTime.Subtract(System.DateTime) method and the subtraction operator.

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;

Universal Windows Platform
Disponibile da 8
.NET Framework
Disponibile da 1.1
Libreria di classi portabile
Supportato in: piattaforme .NET portabili
Silverlight
Disponibile da 2.0
Windows Phone Silverlight
Disponibile da 7.0
Windows Phone
Disponibile da 8.1
Torna all'inizio
Mostra: