DateTime.Add(TimeSpan) Méthode

Définition

Retourne un nouveau DateTime qui ajoute la valeur du TimeSpan spécifié à la valeur de cette instance.Returns a new DateTime that adds the value of the specified TimeSpan to the value of this instance.

public:
 DateTime Add(TimeSpan value);
public DateTime Add (TimeSpan value);
member this.Add : TimeSpan -> DateTime
Public Function Add (value As TimeSpan) As DateTime

Paramètres

value
TimeSpan

Intervalle de temps positif ou négatif.A positive or negative time interval.

Retours

Objet dont la valeur est la somme de la date et de l'heure représentées par cette instance et de l'intervalle de temps représenté par value.An object whose value is the sum of the date and time represented by this instance and the time interval represented by value.

Exceptions

L’objet DateTime obtenu est inférieur à MinValue ou supérieur à MaxValue.The resulting DateTime is less than MinValue or greater than MaxValue.

Exemples

L’exemple suivant illustre la méthode Add.The following example demonstrates the Add method. Il calcule le jour de la semaine qui est de 36 jours (864 heures) à partir de ce moment.It calculates the day of the week that is 36 days (864 hours) from this moment.

// Calculate what day of the week is 36 days from this instant.
System::DateTime today = System::DateTime::Now;
System::TimeSpan duration( 36, 0, 0, 0 );
System::DateTime answer = today.Add( duration );
System::Console::WriteLine( " {0:dddd}", answer );
// Calculate what day of the week is 36 days from this instant.
System.DateTime today = System.DateTime.Now;
System.TimeSpan duration = new System.TimeSpan(36, 0, 0, 0);
System.DateTime answer = today.Add(duration);
System.Console.WriteLine("{0:dddd}", answer);
' Calculate what day of the week is 36 days from this instant.
Dim today As System.DateTime
Dim duration As System.TimeSpan
Dim answer As System.DateTime

today = System.DateTime.Now
duration = New System.TimeSpan(36, 0, 0, 0)
answer = today.Add(duration)

System.Console.WriteLine("{0:dddd}", answer)

Remarques

Vous pouvez utiliser la méthode Add pour ajouter plus d’un type d’intervalle de temps (jours, heures, minutes, secondes ou millisecondes) en une seule opération.You can use the Add method to add more than one kind of time interval (days, hours, minutes, seconds, or milliseconds) in a single operation. Le comportement de cette méthode est identique à celui de l’opérateur d’addition.This method's behavior is identical to that of the addition operator. La structure DateTime prend également en charge des méthodes d’addition spécialisées (telles que AddDays, AddHours et AddMinutes) pour chaque intervalle de temps.The DateTime structure also supports specialized addition methods (such as AddDays, AddHours, and AddMinutes) for each time interval.

La méthode Add prend en compte les années bissextiles et le nombre de jours dans un mois lors de l’exécution de l’arithmétique des dates.The Add method takes into account leap years and the number of days in a month when performing date arithmetic.

Cette méthode ne modifie pas la valeur de ce DateTime.This method does not change the value of this DateTime. Au lieu de cela, elle retourne un nouvel DateTime dont la valeur est le résultat de cette opération.Instead, it returns a new DateTime whose value is the result of this operation. La propriété Kind de la nouvelle instance DateTime est identique à celle de l’instance actuelle.The Kind property of the new DateTime instance is the same as that of the current instance.

S’applique à

Voir aussi