DateTime.Subtract Méthode

Définition

Espace de noms:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Retourne la valeur qui résulte de la soustraction de l’heure ou de la durée spécifiée de la valeur de cette instance.

Surcharges

Nom	Description
Subtract(TimeSpan)	Retourne un nouveau DateTime qui soustrait la durée spécifiée de la valeur de cette instance.
Subtract(DateTime)	Retourne un nouveau TimeSpan qui soustrait la date et l’heure spécifiées de la valeur de cette instance.

Subtract(TimeSpan)

Source:

DateTime.cs

Retourne un nouveau DateTime qui soustrait la durée spécifiée de la valeur de cette instance.

public:
 DateTime Subtract(TimeSpan value);

public DateTime Subtract(TimeSpan value);

member this.Subtract : TimeSpan -> DateTime

Public Function Subtract (value As TimeSpan) As DateTime

Paramètres

value

TimeSpan

Intervalle de temps à soustraire.

Retours

DateTime

Objet égal à la date et à l’heure représentées par cette instance moins l’intervalle de temps représenté par value.

Exceptions

ArgumentOutOfRangeException

Le résultat est inférieur à DateTime.MinValue ou supérieur à DateTime.MaxValue.

Exemples

L’exemple suivant illustre la Subtract méthode et l’opérateur de soustraction.

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)

Remarques

La Subtract(TimeSpan) méthode retourne la date qui est une différence d’intervalle de temps spécifiée par rapport à l’instance actuelle. Pour déterminer l’intervalle de temps entre deux dates, appelez la Subtract(DateTime) méthode. Pour soustraire un intervalle de temps particulier de l’instance actuelle, appelez la méthode qui ajoute cet intervalle de temps à la date actuelle et fournissez une valeur négative en tant qu’argument de méthode. Par exemple, pour soustraire deux mois de la date actuelle, appelez la AddMonths(Int32) méthode avec la valeur -2.

Cette méthode ne modifie pas la valeur de ce DateTime. Au lieu de cela, elle retourne une nouvelle DateTime dont la valeur est le résultat de cette opération.

En règle générale, la DateTime.Subtract(TimeSpan) méthode soustrait un TimeSpan objet qui représente un intervalle de temps positif et retourne une DateTime valeur antérieure à la date et à l’heure de l’instance actuelle. Toutefois, si l’objet TimeSpan représente un intervalle de temps négatif, la DateTime.Subtract(TimeSpan) méthode retourne une DateTime valeur postérieure à la date et à l’heure de l’instance actuelle.

La DateTime.Subtract(TimeSpan) méthode vous permet de soustraire un intervalle de temps constitué de plusieurs unités de temps (par exemple, un nombre donné d’heures et un nombre donné de minutes). Pour soustraire une seule unité de temps (par exemple, des années, des mois ou des jours) de l’instance DateTime , vous pouvez passer une valeur numérique négative en tant que paramètre à l’une des méthodes suivantes :

• AddYears, pour soustraire un nombre spécifique d’années à partir de l’instance de date et d’heure actuelle.

• AddMonths, pour soustraire un nombre spécifique de mois à partir de l’instance de date et d’heure actuelle.

• AddDays, pour soustraire un nombre spécifique de jours à partir de l’instance de date et d’heure actuelle.

• AddHours, pour soustraire un nombre spécifique d’heures de l’instance de date et d’heure actuelle.

• AddMinutes, pour soustraire un nombre spécifique de minutes de l’instance de date et d’heure actuelle.

• AddSeconds, pour soustraire un nombre spécifique de secondes de l’instance de date et d’heure actuelle.

• AddMilliseconds, pour soustraire un nombre spécifique de millisecondes de l’instance de date et d’heure actuelle.

• AddTicks, pour soustraire un nombre spécifique de graduations de l’instance de date et d’heure actuelle.

Voir aussi

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

Subtract(DateTime)

Source:

DateTime.cs

Retourne un nouveau TimeSpan qui soustrait la date et l’heure spécifiées de la valeur de cette instance.

public:
 TimeSpan Subtract(DateTime value);

public TimeSpan Subtract(DateTime value);

member this.Subtract : DateTime -> TimeSpan

Public Function Subtract (value As DateTime) As TimeSpan

Paramètres

value

DateTime

Valeur de date et d’heure à soustraire.

Retours

TimeSpan

Intervalle de temps égal à la date et à l’heure représentées par cette instance moins la date et l’heure représentées par value.

Exceptions

ArgumentOutOfRangeException

Le résultat est inférieur à DateTime.MinValue ou supérieur à DateTime.MaxValue.

Exemples

L’exemple suivant illustre la Subtract méthode et l’opérateur de soustraction.

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)

Remarques

La Subtract(DateTime) méthode détermine la différence entre deux dates. Pour soustraire un intervalle de temps de l’instance actuelle, appelez la Subtract(TimeSpan) méthode. Pour soustraire un intervalle de temps particulier de l’instance actuelle, appelez la méthode qui ajoute cet intervalle de temps à la date actuelle et fournissez une valeur négative en tant qu’argument de méthode. Par exemple, pour soustraire deux mois de la date actuelle, appelez la AddMonths(Int32) méthode avec la valeur -2.

Si la date et l’heure de l’instance actuelle sont antérieures value, la méthode retourne un TimeSpan objet qui représente un intervalle de temps négatif. Autrement dit, la valeur de toutes ses propriétés non nulles (telles que Days ou Ticks) est négative.

La Subtract(DateTime) méthode ne prend pas en compte la valeur de la Kind propriété des deux DateTime valeurs lors de l’exécution de la soustraction. Avant de soustraire des DateTime objets, assurez-vous que les objets représentent des heures dans le même fuseau horaire. Sinon, le résultat inclut la différence entre les fuseaux horaires.

Note

La DateTimeOffset.Subtract(DateTimeOffset) méthode prend en compte la différence entre les fuseaux horaires lors de l’exécution de la soustraction.

Voir aussi

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