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 hinzufügt.

public:
 DateTime AddSeconds(double value);

public DateTime AddSeconds(double value);

member this.AddSeconds : double -> DateTime

Public Function AddSeconds (value As Double) As DateTime

Parameter

value

Double

Eine Anzahl von ganzen und bruchteilalen Sekunden. Der value Parameter kann negativ oder positiv sein.

Gibt zurück

DateTime

Ein Objekt, dessen Wert die Summe des Datums und der Uhrzeit darstellt, die durch diese Instanz dargestellt wird, und die Anzahl der Sekunden, die durch value.

Ausnahmen

ArgumentOutOfRangeException

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

Beispiele

Im folgenden Beispiel wird die AddSeconds Methode zum Hinzufügen von 30 Sekunden und der Anzahl von Sekunden in einem Tag zu einem DateTime Wert verwendet. Anschließend wird jeder neue Wert angezeigt und der Unterschied zwischen dem Wert und dem ursprünglichen Wert angezeigt. Der Unterschied wird sowohl als Zeitspanne als auch als Eine Reihe von Teilstrichen angezeigt.

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)

open System

let dateFormat = "MM/dd/yyyy hh:mm:ss"
let date1 = DateTime(2014, 9, 8, 16, 0, 0)
printfn $"Original date: {date1.ToString dateFormat} ({date1.Ticks:N0} ticks)\n"

let date2 = date1.AddSeconds 30
printfn $"Second date:   {date2.ToString dateFormat} ({date2.Ticks:N0} ticks)"
printfn $"Difference between dates: {date2 - date1} ({date2.Ticks - date1.Ticks:N0} ticks)\n"

// Add 1 day's worth of seconds (60 secs. * 60 mins * 24 hrs.
let date3 = date1.AddSeconds(60. * 60. * 24.)
printfn $"Third date:    {date3.ToString dateFormat} ({date3.Ticks:N0} ticks)" 
printfn $"Difference between dates: {date3 - date1} ({date3.Ticks - date1.Ticks:N0} 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)

Module Example
   Public Sub Main()
      Dim dateFormat As String = "MM/dd/yyyy hh:mm:ss"
      Dim date1 As Date = #09/08/2014 16:00#
      Console.WriteLine("Original date: {0} ({1:N0} ticks)", _
                        date1.ToString(dateFormat), date1.Ticks)
      Console.WriteLine()
      
      Dim date2 As Date = 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)", _
                        date2 - date1, date2.Ticks - date1.Ticks)                        
      Console.WriteLine()
      
      ' Add 1 day's worth of seconds (60 secs. * 60 mins * 24 hrs.
      Dim date3 As Date = 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)                        
   End Sub
End Module
' 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 den Wert dieser DateTimeMethode nicht. Stattdessen wird ein neuer DateTime Wert zurückgegeben, dessen Wert das Ergebnis dieses Vorgangs ist.

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

In .NET Framework wird der value Parameter auf die nächste Millisekunden gerundet. In .NET 7 und höheren Versionen wird die volle Double Genauigkeit des value Parameters verwendet. Aufgrund der inhärenten Ungenauigkeit von Gleitkommagleichungen variiert die resultierende Genauigkeit jedoch.

Weitere Informationen

• Double
• Ausführen arithmetischer Vorgänge mit Datums- und Uhrzeitangaben