Freigeben über

DateTime.Subtract Methode

  • Referenz

Definition

Namespace:
System
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Gibt den Wert zurück, der sich aus der Subtraktion der angegebenen Zeit oder Dauer vom Wert dieser Instanz ergibt.

Überlädt

Subtract(TimeSpan)

Gibt ein neues DateTime-Objekt zurück, das die angegebene Dauer von dem Wert dieser Instanz subtrahiert.
Subtract(DateTime)

Gibt ein neues TimeSpan-Objekt zurück, das das angegebene Datum und die angegebene Zeit von dem Wert dieser Instanz subtrahiert.

Subtract(TimeSpan)

Quelle:
DateTime.cs
Quelle:
DateTime.cs
Quelle:
DateTime.cs

Gibt ein neues DateTime-Objekt zurück, das die angegebene Dauer von dem Wert dieser Instanz subtrahiert.

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

Parameter

value
TimeSpan

Das Zeitintervall, das subtrahiert werden soll.

Gibt zurück

DateTime

Ein Objekt, das der von dieser Instanz dargestellten Datums- und Uhrzeitangabe minus dem durch value dargestellten Zeitintervall entspricht.

Ausnahmen

ArgumentOutOfRangeException

Das Ergebnis ist kleiner als DateTime.MinValue oder größer als DateTime.MaxValue.

Beispiele

Im folgenden Beispiel werden die Subtract -Methode und der Subtraktionsoperator veranschaulicht.

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)

Hinweise

Die Subtract(TimeSpan) -Methode gibt das Datum zurück, das eine angegebene Zeitintervalldifferenz vom aktuellen instance ist. Rufen Sie die -Methode auf, um das Zeitintervall zwischen zwei Datumsangaben Subtract(DateTime) zu bestimmen. Um ein bestimmtes Zeitintervall vom aktuellen instance zu subtrahieren, rufen Sie die -Methode auf, die dieses Zeitintervall dem aktuellen Datum hinzufügt, und geben Sie einen negativen Wert als Methodenargument an. Um beispielsweise zwei Monate vom aktuellen Datum zu subtrahieren, rufen Sie die AddMonths(Int32) -Methode mit dem Wert -2 auf.

Diese Methode ändert nicht den Wert dieses DateTime. Stattdessen wird ein neues DateTime zurückgegeben, dessen Wert das Ergebnis dieses Vorgangs ist.

Normalerweise subtrahiert die DateTime.Subtract(TimeSpan) -Methode ein -Objekt, das eine TimeSpan positive Zeitspanne darstellt, und gibt einen DateTime Wert zurück, der vor dem Datum und der Uhrzeit der aktuellen instance liegt. Wenn das TimeSpan -Objekt jedoch eine negative Zeitspanne darstellt, gibt die Methode einen DateTime Wert zurück, der DateTime.Subtract(TimeSpan) später als das Datum und die Uhrzeit des aktuellen instance.

Mit DateTime.Subtract(TimeSpan) der -Methode können Sie ein Zeitintervall subtrahieren, das aus mehr als einer Zeiteinheit (z. B. einer bestimmten Anzahl von Stunden und einer bestimmten Anzahl von Minuten) besteht. Um eine einzelne Zeiteinheit (z. B. Jahre, Monate oder Tage) vom DateTime instance zu subtrahieren, können Sie einen negativen numerischen Wert als Parameter an eine der folgenden Methoden übergeben:

  • AddYears, um eine bestimmte Anzahl von Jahren vom aktuellen Datum und der aktuellen Uhrzeit instance zu subtrahieren.

  • AddMonths, um eine bestimmte Anzahl von Monaten vom aktuellen Datum und der aktuellen Uhrzeit instance zu subtrahieren.

  • AddDays, um eine bestimmte Anzahl von Tagen vom aktuellen Datum und der aktuellen Uhrzeit instance zu subtrahieren.

  • AddHours, um eine bestimmte Anzahl von Stunden vom aktuellen Datum und der aktuellen Uhrzeit instance zu subtrahieren.

  • AddMinutes, um eine bestimmte Anzahl von Minuten vom aktuellen Datum und der aktuellen Uhrzeit instance zu subtrahieren.

  • AddSeconds, um eine bestimmte Anzahl von Sekunden vom aktuellen Datum und der aktuellen Uhrzeit instance zu subtrahieren.

  • AddMilliseconds, um eine bestimmte Anzahl von Millisekunden vom aktuellen Datum und der aktuellen Uhrzeit instance zu subtrahieren.

  • AddTicks, um eine bestimmte Anzahl von Teilstrichen vom aktuellen Datum und der aktuellen Uhrzeit instance zu subtrahieren.

Weitere Informationen

Gilt für:

Subtract(DateTime)

Quelle:
DateTime.cs
Quelle:
DateTime.cs
Quelle:
DateTime.cs

Gibt ein neues TimeSpan-Objekt zurück, das das angegebene Datum und die angegebene Zeit von dem Wert dieser Instanz subtrahiert.

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

Parameter

value
DateTime

Der Datums- und Uhrzeitwert, der subtrahiert werden soll.

Gibt zurück

TimeSpan

Ein Zeitintervall, das der von dieser Instanz dargestellten Datums- und Uhrzeitangabe minus der durch value dargestellten Datums- und Uhrzeitangabe entspricht.

Ausnahmen

ArgumentOutOfRangeException

Das Ergebnis ist kleiner als DateTime.MinValue oder größer als DateTime.MaxValue.

Beispiele

Im folgenden Beispiel werden die Subtract -Methode und der Subtraktionsoperator veranschaulicht.

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)

Hinweise

Die Subtract(DateTime) -Methode bestimmt den Unterschied zwischen zwei Datumsangaben. Um ein Zeitintervall vom aktuellen instance zu subtrahieren, rufen Sie die Subtract(TimeSpan) -Methode auf. Um ein bestimmtes Zeitintervall vom aktuellen instance zu subtrahieren, rufen Sie die -Methode auf, die dieses Zeitintervall dem aktuellen Datum hinzufügt, und geben Sie einen negativen Wert als Methodenargument an. Um beispielsweise zwei Monate vom aktuellen Datum zu subtrahieren, rufen Sie die AddMonths(Int32) -Methode mit dem Wert -2 auf.

Wenn das Datum und die Uhrzeit der aktuellen instance vor valueliegt, gibt die Methode ein TimeSpan Objekt zurück, das eine negative Zeitspanne darstellt. Das heißt, der Wert aller Eigenschaften ungleich 0 (z Days . B. oder Ticks) ist negativ.

Die Subtract(DateTime) -Methode berücksichtigt beim Ausführen der Kind Subtraktion nicht den Wert der -Eigenschaft der beiden DateTime Werte. Stellen Sie vor dem Subtrahieren DateTime von Objekten sicher, dass die -Objekte Zeiten in derselben Zeitzone darstellen. Andernfalls enthält das Ergebnis den Unterschied zwischen Zeitzonen.

Hinweis

Die DateTimeOffset.Subtract(DateTimeOffset) -Methode berücksichtigt beim Ausführen der Subtraktion den Unterschied zwischen Zeitzonen.

Weitere Informationen

Gilt für: