DateTime.Subtract Methode

Definition

Namespace:

System

Assemblys:

netstandard.dll, System.Runtime.dll

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

Überlädt

Name	Beschreibung
Subtract(TimeSpan)	Gibt einen neuen DateTime Wert zurück, der die angegebene Dauer vom Wert dieser Instanz subtrahiert.
Subtract(DateTime)	Gibt einen neuen TimeSpan Wert zurück, der das angegebene Datum und die angegebene Uhrzeit vom Wert dieser Instanz subtrahiert.

Subtract(TimeSpan)

Quelle:

DateTime.cs

Gibt einen neuen DateTime Wert zurück, der die angegebene Dauer vom 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 dem Datum und der Uhrzeit entspricht, das durch diese Instanz dargestellt wird, abzüglich des durch value.

Ausnahmen

ArgumentOutOfRangeException

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

Beispiele

Das folgende Beispiel veranschaulicht die Subtract Methode und den Subtraktionsoperator.

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, bei dem es sich um einen angegebenen Zeitintervallunterschied von der aktuellen Instanz handelt. Um das Zeitintervall zwischen zwei Datumsangaben zu bestimmen, rufen Sie die Subtract(DateTime) Methode auf. Um ein bestimmtes Zeitintervall von der aktuellen Instanz zu subtrahieren, rufen Sie die Methode auf, die dieses Zeitintervall zum aktuellen Datum hinzufügt, und geben Sie einen negativen Wert als Methodenargument an. Wenn Sie z. B. zwei Monate vom aktuellen Datum subtrahieren möchten, rufen Sie die AddMonths(Int32) Methode mit dem Wert -2 auf.

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

Ordinarily, the DateTime.Subtract(TimeSpan) method subtrahiert 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. Wenn das TimeSpan Objekt jedoch eine negative Zeitspanne darstellt, gibt die DateTime.Subtract(TimeSpan) Methode einen DateTime Wert zurück, der später als das Datum und die Uhrzeit der aktuellen Instanz liegt.

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

• AddYears, um eine bestimmte Anzahl von Jahren von der aktuellen Datums- und Uhrzeitinstanz zu subtrahieren.

• AddMonths, um eine bestimmte Anzahl von Monaten von der aktuellen Datums- und Uhrzeitinstanz zu subtrahieren.

• AddDays, um eine bestimmte Anzahl von Tagen von der aktuellen Datums- und Uhrzeitinstanz zu subtrahieren.

• AddHours, um eine bestimmte Anzahl von Stunden von der aktuellen Datums- und Uhrzeitinstanz zu subtrahieren.

• AddMinutes, um eine bestimmte Anzahl von Minuten von der aktuellen Datums- und Uhrzeitinstanz zu subtrahieren.

• AddSeconds, um eine bestimmte Anzahl von Sekunden von der aktuellen Datums- und Uhrzeitinstanz zu subtrahieren.

• AddMilliseconds, um eine bestimmte Anzahl von Millisekunden aus der aktuellen Datums- und Uhrzeitinstanz zu subtrahieren.

• AddTicks, um eine bestimmte Anzahl von Teilstrichen von der aktuellen Datums- und Uhrzeitinstanz zu subtrahieren.

Weitere Informationen

• TimeSpan
• Ausführen arithmetischer Vorgänge mit Datums- und Uhrzeitangaben

Subtract(DateTime)

Quelle:

DateTime.cs

Gibt einen neuen TimeSpan Wert zurück, der das angegebene Datum und die angegebene Uhrzeit vom 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 dem Datum und der Uhrzeit entspricht, das durch diese Instanz dargestellt wird, abzüglich des durch value.

Ausnahmen

ArgumentOutOfRangeException

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

Beispiele

Das folgende Beispiel veranschaulicht die Subtract Methode und den Subtraktionsoperator.

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 die Differenz zwischen zwei Datumsangaben. Rufen Sie die Subtract(TimeSpan) Methode auf, um ein Zeitintervall von der aktuellen Instanz zu subtrahieren. Um ein bestimmtes Zeitintervall von der aktuellen Instanz zu subtrahieren, rufen Sie die Methode auf, die dieses Zeitintervall zum aktuellen Datum hinzufügt, und geben Sie einen negativen Wert als Methodenargument an. Wenn Sie z. B. zwei Monate vom aktuellen Datum subtrahieren möchten, rufen Sie die AddMonths(Int32) Methode mit dem Wert -2 auf.

Wenn das Datum und die Uhrzeit der aktuellen Instanz früher als valueist, gibt die Methode ein TimeSpan Objekt zurück, das eine negative Zeitspanne darstellt. Das heißt, der Wert aller Nicht-Null-Eigenschaften (z Days . B. oder Ticks) ist negativ.

Die Subtract(DateTime) Methode berücksichtigt nicht den Wert der Kind Eigenschaft der beiden DateTime Werte beim Ausführen der Subtraktion. 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 den Unterschied zwischen Zeitzonen beim Ausführen der Subtraktion.

Weitere Informationen

• Ausführen arithmetischer Vorgänge mit Datums- und Uhrzeitangaben