DateTime.AddSeconds(Double) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt einen neuen DateTime-Wert zurück, der die angegebene Anzahl von Sekunden zum Wert dieser Instanz addiert.
public:
DateTime AddSeconds(double value);public DateTime AddSeconds (double value);member this.AddSeconds : double -> DateTimePublic Function AddSeconds (value As Double) As DateTimeParameter
- 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
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
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.
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 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.
