DateTime.AddMinutes(Double) Methode

  • Referenz

Definition

Namespace:
System
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Quelle:
DateTime.cs
Quelle:
DateTime.cs
Quelle:
DateTime.cs

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

public:
 DateTime AddMinutes(double value);
public DateTime AddMinutes (double value);
member this.AddMinutes : double -> DateTime
Public Function AddMinutes (value As Double) As DateTime

Parameter

value
Double

Eine Zahl, die aus ganzen Minuten und dem Bruchteil einer Minute 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 Minuten ist.

Ausnahmen

ArgumentOutOfRangeException

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

Beispiele

Im folgenden Beispiel wird die AddMinutes -Methode verwendet, um einem Datum und einer Uhrzeit eine Reihe von Ganzen- und Bruchwerten hinzuzufügen.

using namespace System;

void main()
{
   DateTime dateValue(2013, 9, 15, 12, 0, 0);
   
   array<Double>^ minutes = { .01667, .08333, .16667, .25, .33333, 
                              .5, .66667, 1, 2, 15, 30, 17, 45, 
                              60, 180, 60 * 24 };
   
   for each (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

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

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 Minute. Beispielsweise entspricht 4,5 4 Minuten, 30 Sekunden, 0 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