DateTimeOffset.Add(TimeSpan) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Retourne un nouvel DateTimeOffset objet 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 -> DateTimeOffsetPublic Function Add (timeSpan As TimeSpan) As DateTimeOffsetParamètres
Retours
Objet dont la valeur est la somme de la date et de l’heure représentées par l’objet actuel DateTimeOffset et l’intervalle de temps représenté par timeSpan.
Exceptions
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 qui représentent les temps de TimeSpan vol entre les destinations. La Add méthode ajoute ensuite ces heures à un objet qui représente le temps de décollage initial d’un DateTimeOffset 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) dans une seule opération. Le comportement de cette méthode est identique à l’opérateur d’ajout. 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.
Note
Cette méthode retourne un nouvel DateTimeOffset objet. Elle 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 considère pas les règles d’ajustement d’un fuseau horaire particulier lorsqu’elle effectue des 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é.
