DateTime.Subtract Methode

Definitie

Naamruimte:: System

Assembly's:: mscorlib.dll, System.Runtime.dll

Assembly's:: netstandard.dll, System.Runtime.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Retourneert de waarde die het resultaat is van het aftrekken van de opgegeven tijd of duur van de waarde van dit exemplaar.

Overloads

Name	Description
Subtract(TimeSpan)	Retourneert een nieuwe DateTime die de opgegeven duur aftrekken van de waarde van dit exemplaar.
Subtract(DateTime)	Retourneert een nieuwe TimeSpan die de opgegeven datum en tijd aftrekken van de waarde van dit exemplaar.

Subtract(TimeSpan)

Bron:: DateTime.cs

Bron:: DateTime.cs

Bron:: DateTime.cs

Bron:: DateTime.cs

Bron:: DateTime.cs

Retourneert een nieuwe DateTime die de opgegeven duur aftrekken van de waarde van dit exemplaar.

public:
 DateTime Subtract(TimeSpan value);

public DateTime Subtract(TimeSpan value);

member this.Subtract : TimeSpan -> DateTime

Public Function Subtract (value As TimeSpan) As DateTime

Parameters

value: TimeSpan

Het tijdsinterval dat moet worden afgetrokken.

Retouren

DateTime

Een object dat gelijk is aan de datum en tijd die door dit exemplaar wordt vertegenwoordigd, minus het tijdsinterval dat wordt vertegenwoordigd door value.

Uitzonderingen

ArgumentOutOfRangeException

Het resultaat is kleiner dan DateTime.MinValue of hoger dan DateTime.MaxValue.

Voorbeelden

In het volgende voorbeeld ziet u de Subtract methode en de aftrekkingsoperator.

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)

Opmerkingen

De Subtract(TimeSpan) methode retourneert de datum die een opgegeven tijdsinterval is van het huidige exemplaar. Als u het tijdsinterval tussen twee datums wilt bepalen, roept u de Subtract(DateTime) methode aan. Als u een bepaald tijdsinterval wilt aftrekken van het huidige exemplaar, roept u de methode aan waarmee dat tijdsinterval wordt toegevoegd aan de huidige datum en geeft u een negatieve waarde op als het methodeargument. Als u bijvoorbeeld twee maanden wilt aftrekken van de huidige datum, roept u de AddMonths(Int32) methode aan met de waarde -2.

Met deze methode wordt de waarde van deze DateTimemethode niet gewijzigd. In plaats daarvan wordt een nieuwe DateTime geretourneerd waarvan de waarde het resultaat is van deze bewerking.

Normaal gesproken trekt de DateTime.Subtract(TimeSpan) methode een TimeSpan object af dat een positieve tijdsperiode vertegenwoordigt en retourneert een DateTime waarde die ouder is dan de datum en tijd van het huidige exemplaar. Als het TimeSpan object echter een negatieve tijdsperiode vertegenwoordigt, retourneert de DateTime.Subtract(TimeSpan) methode een DateTime waarde die later is dan de datum en tijd van het huidige exemplaar.

Met de DateTime.Subtract(TimeSpan) methode kunt u een tijdsinterval aftrekken dat uit meer dan één tijdseenheid bestaat (zoals een gegeven aantal uren en een bepaald aantal minuten). Als u één tijdseenheid (zoals jaren, maanden of dagen) van het DateTime exemplaar wilt aftrekken, kunt u een negatieve numerieke waarde als parameter doorgeven aan een van de volgende methoden:

AddYears, om een bepaald aantal jaren af te trekken van de huidige datum- en tijdinstantie.
AddMonths, om een bepaald aantal maanden af te trekken van de huidige datum- en tijdinstantie.
AddDays, om een bepaald aantal dagen af te trekken van de huidige datum- en tijdinstantie.
AddHours, om een bepaald aantal uren af te trekken van de huidige datum- en tijdinstantie.
AddMinutes, om een bepaald aantal minuten af te trekken van de huidige datum- en tijdinstantie.
AddSeconds, om een bepaald aantal seconden af te trekken van de huidige datum- en tijdinstantie.
AddMilliseconds, om een bepaald aantal milliseconden af te trekken van de huidige datum- en tijdinstantie.
AddTicks, om een bepaald aantal tikken af te trekken van de huidige datum- en tijdexemplaren.

Zie ook

Van toepassing op

Subtract(DateTime)

Bron:: DateTime.cs

Bron:: DateTime.cs

Bron:: DateTime.cs

Bron:: DateTime.cs

Bron:: DateTime.cs

Retourneert een nieuwe TimeSpan die de opgegeven datum en tijd aftrekken van de waarde van dit exemplaar.

public:
 TimeSpan Subtract(DateTime value);

public TimeSpan Subtract(DateTime value);

member this.Subtract : DateTime -> TimeSpan

Public Function Subtract (value As DateTime) As TimeSpan

Parameters

value: DateTime

De datum- en tijdwaarde die moet worden afgetrokken.

Retouren

TimeSpan

Een tijdsinterval dat gelijk is aan de datum en tijd die door dit exemplaar wordt vertegenwoordigd, minus de datum en tijd die wordt vertegenwoordigd door value.

Uitzonderingen

ArgumentOutOfRangeException

Het resultaat is kleiner dan DateTime.MinValue of hoger dan DateTime.MaxValue.

Voorbeelden

In het volgende voorbeeld ziet u de Subtract methode en de aftrekkingsoperator.

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)

Opmerkingen

De Subtract(DateTime) methode bepaalt het verschil tussen twee datums. Als u een tijdsinterval van het huidige exemplaar wilt aftrekken, roept u de Subtract(TimeSpan) methode aan. Als u een bepaald tijdsinterval wilt aftrekken van het huidige exemplaar, roept u de methode aan waarmee dat tijdsinterval wordt toegevoegd aan de huidige datum en geeft u een negatieve waarde op als het methodeargument. Als u bijvoorbeeld twee maanden wilt aftrekken van de huidige datum, roept u de AddMonths(Int32) methode aan met de waarde -2.

Als de datum en tijd van het huidige exemplaar ouder is dan value, retourneert de methode een object dat een TimeSpan negatieve tijdsperiode vertegenwoordigt. Dat wil gezegd, de waarde van alle niet-nuleigenschappen (zoals Days of Ticks) is negatief.

De Subtract(DateTime) methode beschouwt de waarde van de Kind eigenschap van de twee DateTime waarden niet bij het uitvoeren van de aftrekking. Voordat u objecten aftrekken DateTime , moet u ervoor zorgen dat de objecten tijden in dezelfde tijdzone vertegenwoordigen. Anders bevat het resultaat het verschil tussen tijdzones.

Note

De DateTimeOffset.Subtract(DateTimeOffset) methode houdt rekening met het verschil tussen tijdzones bij het aftrekken.

Zie ook

Rekenkundige bewerkingen uitvoeren met datums en tijden

Van toepassing op

Feedback

Is deze pagina nuttig?