DateTimeOffset.Subtract Méthode

Définition

Espace de noms:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Soustrait une heure ou une durée spécifiée de l'objet DateTimeOffset en cours.

Surcharges

Subtract(DateTimeOffset)	Soustrait une valeur DateTimeOffset qui représente une date et une heure spécifiques de l’objet DateTimeOffset actuel.
Subtract(TimeSpan)	Soustrait un intervalle de temps spécifié de l’objet DateTimeOffset actuel.

Subtract(DateTimeOffset)

Source:

DateTimeOffset.cs

Soustrait une valeur DateTimeOffset qui représente une date et une heure spécifiques de l’objet DateTimeOffset actuel.

C#

public TimeSpan Subtract(DateTimeOffset value);

Paramètres

value

DateTimeOffset

Objet qui représente la valeur à soustraire.

Retours

TimeSpan

Objet qui spécifie l’intervalle entre les deux objets DateTimeOffset.

Exemples

L’exemple suivant illustre la soustraction qui utilise la Subtract(DateTimeOffset) méthode .

C#

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

Remarques

Cette méthode convertit les deux DateTimeOffset objets en temps universel coordonné (UTC) avant de calculer l’intervalle de temps qui les sépare. Cela supprime tout effet que les différents décalages utc peuvent avoir sur la comparaison.

Notes

Pour les langues qui prennent en charge les opérateurs personnalisés, vous pouvez également effectuer une soustraction de date et d’heure à l’aide de l’opérateur de soustraction. Pour plus d’informations, consultez la Subtraction méthode .

Étant donné que ni l’objet actuel DateTimeOffset ni le value paramètre ne représentent la date et l’heure dans un fuseau horaire spécifique, la Subtract(DateTimeOffset) méthode ne prend pas en compte les règles d’ajustement d’un fuseau horaire particulier lorsqu’elle soustrait des dates et des heures.

Voir aussi

• Exécution d’opérations arithmétiques avec des dates et des heures

Subtract(TimeSpan)

Source:

DateTimeOffset.cs

Soustrait un intervalle de temps spécifié de l’objet DateTimeOffset actuel.

C#

public DateTimeOffset Subtract(TimeSpan value);

Paramètres

value

TimeSpan

Intervalle de temps à soustraire.

Retours

DateTimeOffset

Objet égal à la date et à l’heure représentées par l’objet DateTimeOffset actuel, moins l’intervalle de temps représenté par value.

Exceptions

ArgumentOutOfRangeException

La valeur résultante DateTimeOffset est inférieure à DateTimeOffset.MinValue.

-ou-

La valeur résultante DateTimeOffset est supérieure à DateTimeOffset.MaxValue.

Exemples

L’exemple suivant illustre la soustraction qui utilise la Subtract méthode .

C#

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

Remarques

Vous pouvez utiliser la Subtract méthode pour soustraire plusieurs types d’intervalles de temps (jours, heures, minutes, secondes ou millisecondes) en une seule opération. Son comportement est identique à la Subtraction(DateTimeOffset, TimeSpan) méthode , qui définit l’opérateur de soustraction. La DateTimeOffset structure prend également en charge les méthodes d’ajout spécialisées (telles que AddDays, AddHourset AddMinutes) qui vous permettent d’effectuer une soustraction en affectant une valeur négative au paramètre de méthode.

Notes

Cette méthode retourne un nouvel DateTimeOffset objet. Il ne modifie pas la valeur de l’objet actuel en soustrayant value de sa date et heure.

La Subtract méthode n’affecte pas la valeur de la propriété de l’objet DateTimeOffsetOffset . L’objet retourné DateTimeOffset a le même décalage que l’objet d’origine.

Étant donné que l’objet actuel DateTimeOffset ne représente pas la date et l’heure dans un fuseau horaire spécifique, la Subtract(TimeSpan) méthode ne prend pas en compte les règles d’ajustement d’un fuseau horaire particulier lorsqu’elle effectue la soustraction.

Voir aussi

• Exécution d’opérations arithmétiques avec des dates et des heures