DateTime.Add(TimeSpan) Méthode

Définition

Retourne un nouveau DateTime qui ajoute la valeur du TimeSpan spécifié à la valeur de cette 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.

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.

Exceptions

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

Exemples

L’exemple suivant illustre la Add méthode. Il calcule le jour de la semaine qui est de 36 jours (864 heures) à partir de ce 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.
let today = DateTime.Now
let duration = TimeSpan(36, 0, 0, 0)
let answer = today.Add duration
printfn $"{answer:dddd}"
// 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 Add méthode pour ajouter plusieurs types d’intervalles de temps (jours, heures, minutes, secondes ou millisecondes) en une seule opération. Le comportement de cette méthode est identique à celui de l’opérateur d’addition. La DateTime structure prend également en charge les méthodes d’ajout spécialisées (telles que AddDays, AddHourset AddMinutes) pour chaque intervalle de temps.

La Add méthode prend en compte les années bissextiles et le nombre de jours dans un mois lors de l’exécution arithmétique de date.

Cette méthode ne modifie pas la valeur de ce DateTime. Au lieu de cela, il retourne un nouveau DateTime dont la valeur est le résultat de cette opération. La Kind propriété du nouveau DateTime instance est identique à celle du instance actuel.

S’applique à

Voir aussi