DateTimeOffset.Add(TimeSpan) Méthode

  • Référence

Définition

Espace de noms:
System
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Source:
DateTimeOffset.cs
Source:
DateTimeOffset.cs
Source:
DateTimeOffset.cs

Retourne un nouvel objet DateTimeOffset qui ajoute un intervalle de temps spécifié à la valeur de cette instance.

public:
 DateTimeOffset Add(TimeSpan timeSpan);
public DateTimeOffset Add (TimeSpan timeSpan);
member this.Add : TimeSpan -> DateTimeOffset
Public Function Add (timeSpan As TimeSpan) As DateTimeOffset

Paramètres

timeSpan
TimeSpan

Objet TimeSpan représentant un intervalle de temps positif ou négatif.

Retours

DateTimeOffset

Objet dont la valeur est égale à la somme de la date et de l’heure représentées par l’objet DateTimeOffset actif et de l’intervalle de temps représenté par timeSpan.

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 crée un tableau d’objets TimeSpan qui représentent les temps de vol entre les destinations. La Add méthode ajoute ensuite ces heures à un DateTimeOffset objet qui représente le temps de décollage initial d’un vol. Le résultat reflète l’heure d’arrivée planifiée à chaque destination.

DateTimeOffset takeOff = new DateTimeOffset(2007, 6, 1, 7, 55, 0,
                             new TimeSpan(-5, 0, 0));
DateTimeOffset currentTime = takeOff;
TimeSpan[] flightTimes = new TimeSpan[]
                  {new TimeSpan(2, 25, 0), new TimeSpan(1, 48, 0)};
Console.WriteLine("Takeoff is scheduled for {0:d} at {0:T}.",
                  takeOff);
for (int ctr = flightTimes.GetLowerBound(0);
     ctr <= flightTimes.GetUpperBound(0); ctr++)
{
   currentTime = currentTime.Add(flightTimes[ctr]);
   Console.WriteLine("Destination #{0} at {1}.", ctr + 1, currentTime);
}

let takeOff = DateTimeOffset(2007, 6, 1, 7, 55, 0, TimeSpan(-5, 0, 0))
let mutable currentTime = takeOff
let flightTimes = [| TimeSpan(2, 25, 0); TimeSpan(1, 48, 0) |]
printfn $"Takeoff is scheduled for {takeOff:d} at {takeOff:T}."
                
for i = 0 to flightTimes.Length - 1 do
    currentTime <- currentTime.Add flightTimes[i]
    printfn $"Destination #{i + 1} at {currentTime}."

Dim takeOff As New DateTimeOffset(#6/1/2007 7:55AM#, _
                                  New TimeSpan(-5, 0, 0))
Dim currentTime As DateTimeOffset = takeOff
Dim flightTimes() As TimeSpan = New TimeSpan() _
                  {New TimeSpan(2, 25, 0), New TimeSpan(1, 48, 0)}
Console.WriteLine("Takeoff is scheduled for {0:d} at {0:T}.", _
                  takeOff)
For ctr As Integer = flightTimes.GetLowerBound(0) To _
                     flightTimes.GetUpperBound(0)
   currentTime = currentTime.Add(flightTimes(ctr))
   Console.WriteLine("Destination #{0} at {1}.", ctr + 1, currentTime)
Next

Remarques

Vous pouvez utiliser la Add méthode pour ajouter plusieurs types d’intervalle de temps (jours, heures, minutes, secondes ou millisecondes) en une seule opération. Le comportement de cette méthode est identique à l’opérateur d’addition. La DateTimeOffset structure prend également en charge les méthodes d’ajout spécialisées (telles que AddDays, AddHourset AddMinutes) pour chaque intervalle de temps.

Notes

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

La Add méthode n’affecte pas la valeur de la propriété de l’objet Offset actuelDateTimeOffset.

Étant donné qu’un DateTimeOffset objet ne représente pas la date et l’heure dans un fuseau horaire spécifique, la Add méthode ne prend pas en compte les règles d’ajustement d’un fuseau horaire particulier lorsqu’elle effectue des opérations arithmétiques de date et d’heure.

Si le timeSpan paramètre est null, cette méthode retourne la valeur de l’objet d’origine DateTimeOffset inchangée.

S’applique à

Voir aussi