DateTime.AddSeconds(Double) Methode

Definition

Namespace:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Quelle:

DateTime.cs

Gibt einen neuen DateTime-Wert zurück, der die angegebene Anzahl von Sekunden zum Wert dieser Instanz addiert.

C#

public DateTime AddSeconds(double value);

Parameter

value

Double

Eine Zahl, die aus ganzen Sekunden und dem Bruchteil einer Sekunde besteht. Der value-Parameter kann negativ oder positiv sein.

Gibt zurück

DateTime

Ein Objekt, dessen Wert die Summe aus der von dieser Instanz dargestellten Datums- und Uhrzeitangabe und der durch value dargestellten Anzahl von Sekunden ist.

Ausnahmen

ArgumentOutOfRangeException

Das resultierende DateTime ist kleiner als DateTime.MinValue oder größer als DateTime.MaxValue.

Beispiele

Im folgenden Beispiel wird die AddSeconds -Methode verwendet, um einem DateTime Wert 30 Sekunden und die Anzahl von Sekunden an einem Tag hinzuzufügen. Anschließend wird jeder neue Wert und der Unterschied zwischen dem Wert und dem ursprünglichen Wert angezeigt. Der Unterschied wird sowohl als Zeitspanne als auch als Anzahl von Teilstrichen angezeigt.

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)

Hinweise

Diese Methode ändert nicht den Wert dieses DateTime. Stattdessen wird ein neues DateTime zurückgegeben, dessen Wert das Ergebnis dieses Vorgangs ist.

Der Bruchteil von value ist der Bruchteil einer Sekunde. Beispielsweise entspricht 4,5 4 Sekunden, 500 Millisekunden und 0 Ticks.

In .NET 6 und früheren Versionen wird der value Parameter auf die nächste Millisekunde gerundet. In .NET 7 und höheren Versionen wird die vollständige Double Genauigkeit des value Parameters verwendet. Aufgrund der inhärenten Ungenauigkeit der Gleitkommaberechnung variiert die resultierende Genauigkeit jedoch.

Gilt für:

Weitere Informationen

• Double
• Ausführen arithmetischer Operationen mit Datums- und Uhrzeitangaben