DateTimeOffset.Subtract Méthode

Définition

Espace de noms:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Soustrait une durée ou une durée spécifiée de l’objet actuel DateTimeOffset .

Surcharges

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

Subtract(DateTimeOffset)

Source:

DateTimeOffset.cs

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

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

Objet qui représente la valeur à soustraire.

Retours

TimeSpan

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

Exemples

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

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

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 décalages différents de l’heure UTC peuvent avoir sur la comparaison.

Note

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 considère pas 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 actuel DateTimeOffset .

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

Intervalle de temps à soustraire.

Retours

DateTimeOffset

Objet égal à la date et à l’heure représentées par l’objet actuel DateTimeOffset , 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.

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

Remarques

Vous pouvez utiliser la Subtract méthode pour soustraire plusieurs types d’intervalle de temps (jours, heures, minutes, secondes ou millisecondes) dans 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.

Note

Cette méthode retourne un nouvel DateTimeOffset objet. Elle ne modifie pas la valeur de l’objet actuel en soustrayant value sa date et son 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 considère pas 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