DateTimeOffset.Subtract DateTimeOffset.Subtract DateTimeOffset.Subtract DateTimeOffset.Subtract Method

Définition

Soustrait une heure ou une durée spécifiée de l'objet DateTimeOffset en cours.Subtracts a specified time or duration from the current DateTimeOffset object.

Surcharges

Subtract(DateTimeOffset) Subtract(DateTimeOffset) Subtract(DateTimeOffset) Subtract(DateTimeOffset)

Soustrait une valeur DateTimeOffset qui représente une date et une heure spécifiques de l’objet DateTimeOffset actuel.Subtracts a DateTimeOffset value that represents a specific date and time from the current DateTimeOffset object.

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

Soustrait un intervalle de temps spécifié de l’objet DateTimeOffset actuel.Subtracts a specified time interval from the current DateTimeOffset object.

Subtract(DateTimeOffset) Subtract(DateTimeOffset) Subtract(DateTimeOffset) Subtract(DateTimeOffset)

Soustrait une valeur DateTimeOffset qui représente une date et une heure spécifiques de l’objet DateTimeOffset actuel.Subtracts a DateTimeOffset value that represents a specific date and time from the current DateTimeOffset object.

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

Paramètres

value
DateTimeOffset DateTimeOffset DateTimeOffset DateTimeOffset

Objet qui représente la valeur à soustraire.An object that represents the value to subtract.

Retours

Objet qui spécifie l’intervalle entre les deux objets DateTimeOffset.An object that specifies the interval between the two DateTimeOffset objects.

Exemples

L’exemple suivant illustre la soustraction qui utilise la Subtract(DateTimeOffset) méthode.The following example illustrates subtraction that uses the Subtract(DateTimeOffset) method.

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
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

Remarques

Cette méthode convertit DateTimeOffset les deux objets en temps universel coordonné (UTC, Universal Time Coordinated) avant de calculer l’intervalle de temps qui les sépare.This method converts both DateTimeOffset objects to Coordinated Universal Time (UTC) before calculating the time interval that separates them. Cela supprime tous les effets que des décalages différents par rapport à l’heure UTC peuvent avoir sur la comparaison.This removes any effect that different offsets from UTC may have on the comparison.

Notes

Pour les langages qui prennent en charge des opérateurs personnalisés, vous pouvez également effectuer une soustraction de date et d’heure à l’aide de l’opérateur de soustraction.For languages that support custom operators, you can also perform date and time subtraction by using the subtraction operator. Pour plus d’informations, Subtraction consultez la méthode.For details, see the Subtraction method.

Étant donné que ni DateTimeOffset l’objet actuel value , ni le paramètre ne représentent la date et l’heure d’un Subtract(DateTimeOffset) fuseau horaire spécifique, la méthode ne prend pas en compte les règles d’ajustement d’un fuseau horaire particulier lorsqu’il soustrait des dates et des heures.Because neither the current DateTimeOffset object nor the value parameter represent the date and time in a specific time zone, the Subtract(DateTimeOffset) method does not consider a particular time zone's adjustment rules when it subtracts dates and times.

Voir aussi

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

Soustrait un intervalle de temps spécifié de l’objet DateTimeOffset actuel.Subtracts a specified time interval from the current DateTimeOffset object.

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

Paramètres

value
TimeSpan TimeSpan TimeSpan TimeSpan

Intervalle de temps à soustraire.The time interval to subtract.

Retours

Objet égal à la date et à l’heure représentées par l’objet DateTimeOffset actuel, moins l’intervalle de temps représenté par value.An object that is equal to the date and time represented by the current DateTimeOffset object, minus the time interval represented by value.

Exceptions

La valeur DateTimeOffset obtenue est inférieure à MinValue.The resulting DateTimeOffset value is less than MinValue.

- ou --or- La valeur DateTimeOffset obtenue est supérieure à MaxValue.The resulting DateTimeOffset value is greater than MaxValue.

Exemples

L’exemple suivant illustre la soustraction qui utilise la Subtract méthode.The following example illustrates subtraction that uses the Subtract method.

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
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

Remarques

Vous pouvez utiliser la Subtract méthode pour soustraire plus d’un type d’intervalle de temps (jours, heures, minutes, secondes ou millisecondes) en une seule opération.You can use the Subtract method to subtract more than one kind of time interval (days, hours, minutes, seconds, or milliseconds) in a single operation. Son comportement est identique à celui Subtraction(DateTimeOffset, TimeSpan) de la méthode, qui définit l’opérateur de soustraction.Its behavior is identical to the Subtraction(DateTimeOffset, TimeSpan) method, which defines the subtraction operator. La DateTimeOffset structure prend également en charge des méthodes d’addition AddDaysspécialisées (telles AddMinutesque, AddHourset) qui vous permettent d’effectuer une soustraction en affectant une valeur négative au paramètre de méthode.The DateTimeOffset structure also supports specialized addition methods (such as AddDays, AddHours, and AddMinutes) that allow you to perform subtraction by assigning a negative value to the method parameter.

Notes

Cette méthode retourne un nouvel DateTimeOffset objet.This method returns a new DateTimeOffset object. Elle ne modifie pas la valeur de l’objet actuel en ajoutant timeSpan à sa date et à son heure.It does not modify the value of the current object by adding timeSpan to its date and time.

La Subtract méthode n’affecte pas la valeur de la DateTimeOffset Offset propriété de l’objet.The Subtract method does not affect the value of the DateTimeOffset object's Offset property. L’objet DateTimeOffset retourné a le même offset que l’objet d’origine.The returned DateTimeOffset object has the same offset as the original object.

Étant donné que DateTimeOffset l’objet actuel ne représente pas la date et l’heure dans un fuseau horaire Subtract(TimeSpan) spécifique, la méthode ne prend pas en compte les règles d’ajustement d’un fuseau horaire particulier lorsqu’il effectue la soustraction.Because the current DateTimeOffset object does not represent the date and time in a specific time zone, the Subtract(TimeSpan) method does not consider a particular time zone's adjustment rules when it performs the subtraction.

Voir aussi

S’applique à