DateTime.AddSeconds(Double) Méthode

Définition

Espace de noms:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Source:

DateTime.cs

Retourne un nouveau DateTime qui ajoute le nombre de secondes spécifié à la valeur de cette instance.

C#

public DateTime AddSeconds(double value);

Paramètres

value

Double

Nombre de secondes entières et partielles. Le paramètre value peut être négatif ou positif.

Retours

DateTime

Objet dont la valeur est égale à la somme de la date et de l'heure représentées par cette instance et du nombre de secondes représenté par value.

Exceptions

ArgumentOutOfRangeException

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

Exemples

L’exemple suivant utilise la AddSeconds méthode pour ajouter 30 secondes et le nombre de secondes en un jour à une DateTime valeur. Il affiche ensuite chaque nouvelle valeur et affiche la différence entre celle-ci et la valeur d’origine. La différence s’affiche à la fois sous forme d’intervalle de temps et de nombre de graduations.

C#

using System;

public class Example
{
   public static void Main()
   {
      string dateFormat = "MM/dd/yyyy hh:mm:ss";
      DateTime date1 = new DateTime(2014, 9, 8, 16, 0, 0);
      Console.WriteLine("Original date: {0} ({1:N0} ticks)\n",
                        date1.ToString(dateFormat), date1.Ticks);

      DateTime date2 = date1.AddSeconds(30);
      Console.WriteLine("Second date:   {0} ({1:N0} ticks)",
                        date2.ToString(dateFormat), date2.Ticks);
      Console.WriteLine("Difference between dates: {0} ({1:N0} ticks)\n",
                        date2 - date1, date2.Ticks - date1.Ticks);

      // Add 1 day's worth of seconds (60 secs. * 60 mins * 24 hrs.
      DateTime date3 = date1.AddSeconds(60 * 60 * 24);
      Console.WriteLine("Third date:    {0} ({1:N0} ticks)",
                        date3.ToString(dateFormat), date3.Ticks);
      Console.WriteLine("Difference between dates: {0} ({1:N0} ticks)",
                        date3 - date1, date3.Ticks - date1.Ticks);
   }
}
// The example displays the following output:
//    Original date: 09/08/2014 04:00:00 (635,457,888,000,000,000 ticks)
//
//    Second date:   09/08/2014 04:00:30 (635,457,888,300,000,000 ticks)
//    Difference between dates: 00:00:30 (300,000,000 ticks)
//
//    Third date:    09/09/2014 04:00:00 (635,458,752,000,000,000 ticks)
//    Difference between dates: 1.00:00:00 (864,000,000,000 ticks)

Remarques

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 partie fractionnaire de value est la partie fractionnaire d’une seconde. Par exemple, 4,5 équivaut à 4 secondes, 500 millisecondes et 0 ticks.

Dans .NET 6 et les versions antérieures, le value paramètre est arrondi à la milliseconde la plus proche. Dans .NET 7 et versions ultérieures, la précision complète Double du value paramètre est utilisée. Toutefois, en raison de l’imprécision inhérente des mathématiques à virgule flottante, la précision obtenue varie.

S’applique à

Voir aussi

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