DateTimeOffset.Subtract Methode

public:
 TimeSpan Subtract(DateTimeOffset value);

public TimeSpan Subtract(DateTimeOffset value);

member this.Subtract : DateTimeOffset -> TimeSpan

Public Function Subtract (value As DateTimeOffset) As TimeSpan

Parameters

Retouren

Een object dat het interval tussen de twee DateTimeOffset objecten aangeeft.

Voorbeelden

In het volgende voorbeeld ziet u aftrekken die gebruikmaakt van de Subtract(DateTimeOffset) methode.

DateTimeOffset firstDate = new DateTimeOffset(2018, 10, 25, 18, 0, 0,
                                              new TimeSpan(-7, 0, 0));
DateTimeOffset secondDate = new DateTimeOffset(2018, 10, 25, 18, 0, 0,
                                               new TimeSpan(-5, 0, 0));
DateTimeOffset thirdDate = new DateTimeOffset(2018, 9, 28, 9, 0, 0,
                                              new TimeSpan(-7, 0, 0));
TimeSpan difference;

difference = firstDate.Subtract(secondDate);
Console.WriteLine($"({firstDate}) - ({secondDate}): {difference.Days} days, {difference.Hours}:{difference.Minutes:d2}");

difference = firstDate.Subtract(thirdDate);
Console.WriteLine($"({firstDate}) - ({thirdDate}): {difference.Days} days, {difference.Hours}:{difference.Minutes:d2}");

// The example produces the following output:
//    (10/25/2018 6:00:00 PM -07:00) - (10/25/2018 6:00:00 PM -05:00): 0 days, 2:00
//    (10/25/2018 6:00:00 PM -07:00) - (9/28/2018 9:00:00 AM -07:00): 27 days, 9:00

let firstDate = DateTimeOffset(2018, 10, 25, 18, 0, 0, TimeSpan(-7, 0, 0))
let secondDate = DateTimeOffset(2018, 10, 25, 18, 0, 0, TimeSpan(-5, 0, 0))
let thirdDate = DateTimeOffset(2018, 9, 28, 9, 0, 0, TimeSpan(-7, 0, 0))

let difference = firstDate.Subtract secondDate
printfn $"({firstDate}) - ({secondDate}): {difference.Days} days, {difference.Hours}:{difference.Minutes:d2}"

let difference = firstDate.Subtract thirdDate
printfn $"({firstDate}) - ({thirdDate}): {difference.Days} days, {difference.Hours}:{difference.Minutes:d2}"

// The example produces the following output:
//    (10/25/2018 6:00:00 PM -07:00) - (10/25/2018 6:00:00 PM -05:00): 0 days, 2:00
//    (10/25/2018 6:00:00 PM -07:00) - (9/28/2018 9:00:00 AM -07:00): 27 days, 9:00

Dim firstDate As New DateTimeOffset(#10/25/2018 6:00PM#, _
                                    New TimeSpan(-7, 0, 0))
Dim secondDate As New DateTimeOffset(#10/25/2018 6:00PM#, _
                                     New TimeSpan(-5, 0, 0))
Dim thirdDate As New DateTimeOffset(#9/28/2018 9:00AM#, _
                                    New TimeSpan(-7, 0, 0))
Dim difference As TimeSpan

difference = firstDate.Subtract(secondDate)
Console.WriteLine($"({firstDate}) - ({secondDate}): {difference.Days} days, {difference.Hours}:{difference.Minutes:d2}")

difference = firstDate.Subtract(thirdDate)
Console.WriteLine($"({firstDate}) - ({thirdDate}): {difference.Days} days, {difference.Hours}:{difference.Minutes:d2}")

' The example produces the following output:
'    (10/25/2018 6:00:00 PM -07:00) - (10/25/2018 6:00:00 PM -05:00): 0 days, 2:00
'    (10/25/2018 6:00:00 PM -07:00) - (9/28/2018 9:00:00 AM -07:00): 27 days, 9:00

Opmerkingen

Met deze methode worden beide DateTimeOffset objecten geconverteerd naar Coordinated Universal Time (UTC) voordat het tijdsinterval wordt berekend dat deze van elkaar scheidt. Hiermee verwijdert u elk effect dat verschillende verschuivingen van UTC op de vergelijking kunnen hebben.

Omdat noch het huidige DateTimeOffset object noch de value parameter de datum en tijd in een specifieke tijdzone vertegenwoordigen, houdt de methode geen rekening met de Subtract(DateTimeOffset) aanpassingsregels van een bepaalde tijdzone wanneer deze datums en tijden aftrekken.

Zie ook

• Rekenkundige bewerkingen uitvoeren met datums en tijden

public:
 DateTimeOffset Subtract(TimeSpan value);

public DateTimeOffset Subtract(TimeSpan value);

member this.Subtract : TimeSpan -> DateTimeOffset

Public Function Subtract (value As TimeSpan) As DateTimeOffset

Parameters

Retouren

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

Uitzonderingen

Voorbeelden

In het volgende voorbeeld ziet u aftrekken die gebruikmaakt van de Subtract methode.

DateTimeOffset offsetDate = new DateTimeOffset(2007, 12, 3, 11, 30, 0,
                               new TimeSpan(-8, 0, 0));
TimeSpan duration = new TimeSpan(7, 18, 0, 0);
Console.WriteLine(offsetDate.Subtract(duration).ToString());  // Displays 11/25/2007 5:30:00 PM -08:00

let offsetDate = DateTimeOffset(2007, 12, 3, 11, 30, 0, TimeSpan(-8, 0, 0))
let duration = TimeSpan(7, 18, 0, 0)
printfn $"{offsetDate.Subtract duration}"  // Displays 11/25/2007 5:30:00 PM -08:00

Dim offsetDate As New DateTimeOffset(#12/3/2007 11:30AM#, _
                               New TimeSpan(-8, 0, 0)) 
Dim duration As New TimeSpan(7, 18, 0, 0)
Console.WriteLine(offsetDate.Subtract(duration))    ' Displays 11/25/2007 5:30:00 PM -08:00

Opmerkingen

U kunt de Subtract methode gebruiken om meer dan één soort tijdsinterval (dagen, uren, minuten, seconden of milliseconden) in één bewerking af te trekken. Het gedrag is identiek aan de Subtraction(DateTimeOffset, TimeSpan) methode, waarmee de aftrekkingsoperator wordt gedefinieerd. De DateTimeOffset structuur ondersteunt ook gespecialiseerde optellingsmethoden (zoals AddDays, AddHoursen AddMinutes) waarmee u aftrekken kunt uitvoeren door een negatieve waarde toe te wijzen aan de methodeparameter.

De Subtract methode heeft geen invloed op de waarde van de eigenschap van het DateTimeOffset object Offset . Het geretourneerde DateTimeOffset object heeft dezelfde verschuiving als het oorspronkelijke object.

Omdat het huidige DateTimeOffset object niet de datum en tijd in een specifieke tijdzone vertegenwoordigt, wordt bij het Subtract(TimeSpan) aftrekken van een bepaalde tijdzone niet rekening gehouden met de aanpassingsregels van een bepaalde tijdzone.

Zie ook

• Rekenkundige bewerkingen uitvoeren met datums en tijden