DateTime.AddSeconds(Double) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Retourneert een nieuwe DateTime die het opgegeven aantal seconden toevoegt aan de waarde van dit exemplaar.
public:
DateTime AddSeconds(double value);
public DateTime AddSeconds(double value);
member this.AddSeconds : double -> DateTime
Public Function AddSeconds (value As Double) As DateTime
Parameters
- value
- Double
Een aantal hele en fractionele seconden. De value parameter kan negatief of positief zijn.
Retouren
Een object waarvan de waarde de som is van de datum en tijd die wordt vertegenwoordigd door dit exemplaar en het aantal seconden dat wordt vertegenwoordigd door value.
Uitzonderingen
Het resultaat DateTime is kleiner dan DateTime.MinValue of hoger dan DateTime.MaxValue.
Voorbeelden
In het volgende voorbeeld wordt de AddSeconds methode gebruikt om 30 seconden en het aantal seconden in één dag aan een DateTime waarde toe te voegen. Vervolgens wordt elke nieuwe waarde weergegeven en wordt het verschil tussen de waarde en de oorspronkelijke waarde weergegeven. Het verschil wordt weergegeven als een tijdsduur en als een aantal tikken.
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)
Opmerkingen
Met deze methode wordt de waarde van deze DateTimemethode niet gewijzigd. In plaats daarvan wordt een nieuwe DateTime geretourneerd waarvan de waarde het resultaat is van deze bewerking.
Het breukdeel is value het breukdeel van een seconde. 4,5 is bijvoorbeeld gelijk aan 4 seconden, 500 milliseconden en 0 tikken.
In .NET Framework wordt de parameter value afgerond op de dichtstbijzijnde milliseconden. In .NET 7 en hoger wordt de volledige Double precisie van de parameter value gebruikt. Vanwege de inherente onnauwkeurigheid van drijvendekommaberekeningen varieert de resulterende precisie.