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

Definition

Gibt ein neues DateTime-Objekt zurück, das die angegebene Zeit oder Dauer von dem Wert dieser Instanz subtrahiert.Returns a new DateTime that subtracts the specified time or duration from the value of this instance.

Überlädt

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

Gibt ein neues DateTime-Objekt zurück, das das angegebene Datum und die angegebene Zeit von dem Wert dieser Instanz subtrahiert.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)

Gibt ein neues DateTime-Objekt zurück, das die angegebene Dauer von dem Wert dieser Instanz subtrahiert.Returns a new DateTime that subtracts the specified duration from the value of this instance.

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

Gibt ein neues DateTime-Objekt zurück, das das angegebene Datum und die angegebene Zeit von dem Wert dieser Instanz subtrahiert.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

Parameter

value
DateTime DateTime DateTime DateTime

Der Datums- und Uhrzeitwert, der subtrahiert werden soll.The date and time value to subtract.

Gibt zurück

Ein Zeitintervall, das der von dieser Instanz dargestellten Datums- und Uhrzeitangabe minus der durch value dargestellten Datums- und Uhrzeitangabe entspricht.A time interval that is equal to the date and time represented by this instance minus the date and time represented by value.

Ausnahmen

Das Ergebnis ist kleiner als MinValue oder größer als MaxValue.The result is less than MinValue or greater than MaxValue.

Beispiele

Im folgenden Beispiel werden die Subtract -Methode und der Subtraktions Operator veranschaulicht.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)

Hinweise

Die Subtract(DateTime) -Methode bestimmt den Unterschied zwischen zwei Datumsangaben.The Subtract(DateTime) method determines the difference between two dates. Um ein Zeitintervall von der aktuellen Instanz zu subtrahieren Subtract(TimeSpan) , rufen Sie die-Methode auf.To subtract a time interval from the current instance, call the Subtract(TimeSpan) method. Um ein bestimmtes Zeitintervall von der aktuellen Instanz zu subtrahieren, rufen Sie die-Methode auf, die dieses Zeitintervall dem aktuellen Datum hinzufügt, und geben einen negativen Wert als Methoden Argument an.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. Wenn Sie z. b. zwei Monate vom aktuellen Datum subtrahieren AddMonths(Int32) möchten, rufen Sie die-Methode mit dem Wert-2 auf.For example, to subtract two months from the current date, call the AddMonths(Int32) method with a value of -2.

Wenn das Datum und die Uhrzeit der aktuellen Instanz valuevor liegen, gibt die Methode ein TimeSpan -Objekt zurück, das eine negative Zeitspanne darstellt.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. Das heißt, der Wert aller seiner nicht-NULL-Eigenschaften (z Days . b. oder Ticks) ist negativ.That is, the value of all of its non-zero properties (such as Days or Ticks) is negative.

Die Subtract(DateTime) -Methode berücksichtigt nicht den Wert Kind der-Eigenschaft der beiden DateTime -Werte, wenn die Subtraktion durchgeführt wird.The Subtract(DateTime) method does not consider the value of the Kind property of the two DateTime values when performing the subtraction. Vor dem subtrahieren DateTime von Objekten sollten Sie sicherstellen, dass die-Objekte Zeiten in derselben Zeitzone darstellen.Before subtracting DateTime objects, ensure that the objects represent times in the same time zone. Andernfalls enthält das Ergebnis den Unterschied zwischen Zeitzonen.Otherwise, the result will include the difference between time zones.

Hinweis

Die DateTimeOffset.Subtract(DateTimeOffset) -Methode berücksichtigt den Unterschied zwischen den Zeitzonen beim Ausführen der Subtraktion.The DateTimeOffset.Subtract(DateTimeOffset) method does consider the difference between time zones when performing the subtraction.

Siehe auch

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

Gibt ein neues DateTime-Objekt zurück, das die angegebene Dauer von dem Wert dieser Instanz subtrahiert.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

Parameter

value
TimeSpan TimeSpan TimeSpan TimeSpan

Das Zeitintervall, das subtrahiert werden soll.The time interval to subtract.

Gibt zurück

Ein Objekt, das der von dieser Instanz dargestellten Datums- und Uhrzeitangabe minus dem durch value dargestellten Zeitintervall entspricht.An object that is equal to the date and time represented by this instance minus the time interval represented by value.

Ausnahmen

Das Ergebnis ist kleiner als MinValue oder größer als MaxValue.The result is less than MinValue or greater than MaxValue.

Beispiele

Im folgenden Beispiel werden die Subtract -Methode und der Subtraktions Operator veranschaulicht.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)

Hinweise

Die Subtract(TimeSpan) -Methode gibt das Datum zurück, das ein angegebenes Zeitintervall Unterschied von der aktuellen Instanz ist.The Subtract(TimeSpan) method returns the date that is a specified time interval difference from the current instance. Zum Ermitteln des Zeitintervalls zwischen zwei Datumsangaben wird Subtract(DateTime) die-Methode aufgerufen.To determine the time interval between two dates, call the Subtract(DateTime) method. Um ein bestimmtes Zeitintervall von der aktuellen Instanz zu subtrahieren, rufen Sie die-Methode auf, die dieses Zeitintervall dem aktuellen Datum hinzufügt, und geben einen negativen Wert als Methoden Argument an.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. Wenn Sie z. b. zwei Monate vom aktuellen Datum subtrahieren AddMonths(Int32) möchten, rufen Sie die-Methode mit dem Wert-2 auf.For example, to subtract two months from the current date, call the AddMonths(Int32) method with a value of -2.

Diese Methode ändert nicht den Wert dieses DateTime.This method does not change the value of this DateTime. Stattdessen wird ein neuer DateTime zurückgegeben, dessen Wert das Ergebnis dieses Vorgangs ist.Instead, it returns a new DateTime whose value is the result of this operation.

Normalerweise subtrahiert DateTime.Subtract(TimeSpan) die TimeSpan Methode ein-Objekt, das eine positive Zeitspanne DateTime darstellt, und gibt einen Wert zurück, der vor dem Datum und der Uhrzeit der aktuellen Instanz liegt.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. Wenn das TimeSpan Objekt jedoch eine negative Zeitspanne darstellt, gibt die DateTime.Subtract(TimeSpan) Methode einen DateTime Wert zurück, der nach dem Datum und der Uhrzeit der aktuellen Instanz liegt.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.

Mit DateTime.Subtract(TimeSpan) der-Methode können Sie ein Zeitintervall subtrahieren, das aus mehr als einer Zeiteinheit besteht (z. b. eine angegebene Anzahl von Stunden und eine bestimmte Anzahl von Minuten).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). 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: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, wenn eine bestimmte Anzahl von Jahren von der aktuellen Datums-und Uhrzeit Instanz subtrahiert werden soll.AddYears, to subtract a specific number of years from the current date and time instance.

  • AddMonths, wenn eine bestimmte Anzahl von Monaten von der aktuellen Datums-und Uhrzeit Instanz subtrahiert werden soll.AddMonths, to subtract a specific number of months from the current date and time instance.

  • AddDays, wenn eine bestimmte Anzahl von Tagen von der aktuellen Datums-und Uhrzeit Instanz subtrahiert werden soll.AddDays, to subtract a specific number of days from the current date and time instance.

  • AddHours, wenn eine bestimmte Anzahl von Stunden von der aktuellen Datums-und Uhrzeit Instanz subtrahiert werden soll.AddHours, to subtract a specific number of hours from the current date and time instance.

  • AddMinutes, wenn eine bestimmte Anzahl von Minuten von der aktuellen Datums-und Uhrzeit Instanz subtrahiert werden soll.AddMinutes, to subtract a specific number of minutes from the current date and time instance.

  • AddSeconds, wenn eine bestimmte Anzahl von Sekunden von der aktuellen Datums-und Uhrzeit Instanz subtrahiert werden soll.AddSeconds, to subtract a specific number of seconds from the current date and time instance.

  • AddMilliseconds, wenn eine bestimmte Anzahl von Millisekunden von der aktuellen Datums-und Uhrzeit Instanz subtrahiert werden soll.AddMilliseconds, to subtract a specific number of milliseconds from the current date and time instance.

  • AddTicks, wenn eine bestimmte Anzahl von Ticks von der aktuellen Datums-und Uhrzeit Instanz subtrahiert werden soll.AddTicks, to subtract a specific number of ticks from the current date and time instance.

Siehe auch

Gilt für: