DateTime.AddMinutes(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 minuten toevoegt aan de waarde van dit exemplaar.
public:
DateTime AddMinutes(double value);
public DateTime AddMinutes(double value);
member this.AddMinutes : double -> DateTime
Public Function AddMinutes (value As Double) As DateTime
Parameters
- value
- Double
Een aantal gehele en breukminuten. 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 minuten 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 AddMinutes methode gebruikt om een aantal gehele en breukwaarden toe te voegen aan een datum en tijd.
using System;
public class Example
{
public static void Main()
{
DateTime dateValue = new DateTime(2013, 9, 15, 12, 0, 0);
double[] minutes = { .01667, .08333, .16667, .25, .33333,
.5, .66667, 1, 2, 15, 30, 17, 45,
60, 180, 60 * 24 };
foreach (double minute in minutes)
Console.WriteLine("{0} + {1} minute(s) = {2}", dateValue, minute,
dateValue.AddMinutes(minute));
}
}
// The example displays the following output on a system whose current culture is en-US:
// 9/15/2013 12:00:00 PM + 0.01667 minute(s) = 9/15/2013 12:00:01 PM
// 9/15/2013 12:00:00 PM + 0.08333 minute(s) = 9/15/2013 12:00:05 PM
// 9/15/2013 12:00:00 PM + 0.16667 minute(s) = 9/15/2013 12:00:10 PM
// 9/15/2013 12:00:00 PM + 0.25 minute(s) = 9/15/2013 12:00:15 PM
// 9/15/2013 12:00:00 PM + 0.33333 minute(s) = 9/15/2013 12:00:20 PM
// 9/15/2013 12:00:00 PM + 0.5 minute(s) = 9/15/2013 12:00:30 PM
// 9/15/2013 12:00:00 PM + 0.66667 minute(s) = 9/15/2013 12:00:40 PM
// 9/15/2013 12:00:00 PM + 1 minute(s) = 9/15/2013 12:01:00 PM
// 9/15/2013 12:00:00 PM + 2 minute(s) = 9/15/2013 12:02:00 PM
// 9/15/2013 12:00:00 PM + 15 minute(s) = 9/15/2013 12:15:00 PM
// 9/15/2013 12:00:00 PM + 30 minute(s) = 9/15/2013 12:30:00 PM
// 9/15/2013 12:00:00 PM + 17 minute(s) = 9/15/2013 12:17:00 PM
// 9/15/2013 12:00:00 PM + 45 minute(s) = 9/15/2013 12:45:00 PM
// 9/15/2013 12:00:00 PM + 60 minute(s) = 9/15/2013 1:00:00 PM
// 9/15/2013 12:00:00 PM + 180 minute(s) = 9/15/2013 3:00:00 PM
// 9/15/2013 12:00:00 PM + 1440 minute(s) = 9/16/2013 12:00:00 PM
open System
let dateValue = DateTime(2013, 9, 15, 12, 0, 0)
let minutes =
[ 0.01667; 0.08333; 0.16667; 0.25; 0.33333
0.5; 0.66667; 1; 2; 15; 30; 17; 45
60; 180; 60. * 24. ]
for minute in minutes do
printfn $"{dateValue} + {minute} minute(s) = {dateValue.AddMinutes minute}"
// The example displays the following output on a system whose current culture is en-US:
// 9/15/2013 12:00:00 PM + 0.01667 minute(s) = 9/15/2013 12:00:01 PM
// 9/15/2013 12:00:00 PM + 0.08333 minute(s) = 9/15/2013 12:00:05 PM
// 9/15/2013 12:00:00 PM + 0.16667 minute(s) = 9/15/2013 12:00:10 PM
// 9/15/2013 12:00:00 PM + 0.25 minute(s) = 9/15/2013 12:00:15 PM
// 9/15/2013 12:00:00 PM + 0.33333 minute(s) = 9/15/2013 12:00:20 PM
// 9/15/2013 12:00:00 PM + 0.5 minute(s) = 9/15/2013 12:00:30 PM
// 9/15/2013 12:00:00 PM + 0.66667 minute(s) = 9/15/2013 12:00:40 PM
// 9/15/2013 12:00:00 PM + 1 minute(s) = 9/15/2013 12:01:00 PM
// 9/15/2013 12:00:00 PM + 2 minute(s) = 9/15/2013 12:02:00 PM
// 9/15/2013 12:00:00 PM + 15 minute(s) = 9/15/2013 12:15:00 PM
// 9/15/2013 12:00:00 PM + 30 minute(s) = 9/15/2013 12:30:00 PM
// 9/15/2013 12:00:00 PM + 17 minute(s) = 9/15/2013 12:17:00 PM
// 9/15/2013 12:00:00 PM + 45 minute(s) = 9/15/2013 12:45:00 PM
// 9/15/2013 12:00:00 PM + 60 minute(s) = 9/15/2013 1:00:00 PM
// 9/15/2013 12:00:00 PM + 180 minute(s) = 9/15/2013 3:00:00 PM
// 9/15/2013 12:00:00 PM + 1440 minute(s) = 9/16/2013 12:00:00 PM
Module Example
Public Sub Main()
Dim minutes() As Double = {.01667, .08333, .16667, .25, .33333,
.5, .66667, 1, 2, 15, 30, 17, 45,
60, 180, 60 * 24 }
Dim dateValue As Date = #9/15/2013 12:00#
For Each minute As Double In minutes
Console.WriteLine("{0} + {1} minute(s) = {2}", dateValue,
minute, dateValue.AddMinutes(minute))
Next
End Sub
End Module
' The example displays the following output on a system whose current culture is en-US:
' 9/15/2013 12:00:00 PM + 0.01667 minute(s) = 9/15/2013 12:00:01 PM
' 9/15/2013 12:00:00 PM + 0.08333 minute(s) = 9/15/2013 12:00:05 PM
' 9/15/2013 12:00:00 PM + 0.16667 minute(s) = 9/15/2013 12:00:10 PM
' 9/15/2013 12:00:00 PM + 0.25 minute(s) = 9/15/2013 12:00:15 PM
' 9/15/2013 12:00:00 PM + 0.33333 minute(s) = 9/15/2013 12:00:20 PM
' 9/15/2013 12:00:00 PM + 0.5 minute(s) = 9/15/2013 12:00:30 PM
' 9/15/2013 12:00:00 PM + 0.66667 minute(s) = 9/15/2013 12:00:40 PM
' 9/15/2013 12:00:00 PM + 1 minute(s) = 9/15/2013 12:01:00 PM
' 9/15/2013 12:00:00 PM + 2 minute(s) = 9/15/2013 12:02:00 PM
' 9/15/2013 12:00:00 PM + 15 minute(s) = 9/15/2013 12:15:00 PM
' 9/15/2013 12:00:00 PM + 30 minute(s) = 9/15/2013 12:30:00 PM
' 9/15/2013 12:00:00 PM + 17 minute(s) = 9/15/2013 12:17:00 PM
' 9/15/2013 12:00:00 PM + 45 minute(s) = 9/15/2013 12:45:00 PM
' 9/15/2013 12:00:00 PM + 60 minute(s) = 9/15/2013 1:00:00 PM
' 9/15/2013 12:00:00 PM + 180 minute(s) = 9/15/2013 3:00:00 PM
' 9/15/2013 12:00:00 PM + 1440 minute(s) = 9/16/2013 12:00:00 PM
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 breukgedeelte van een minuut. 4,5 is bijvoorbeeld gelijk aan 4 minuten, 30 seconden, 0 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.