DateTime::AddMinutes Method (Double)
Returns a new DateTime that adds the specified number of minutes to the value of this instance.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- value
-
Type:
System::Double
A number of whole and fractional minutes. The value parameter can be negative or positive.
Return Value
Type: System::DateTimeAn object whose value is the sum of the date and time represented by this instance and the number of minutes represented by value.
| Exception | Condition |
|---|---|
| ArgumentOutOfRangeException |
This method does not change the value of this DateTime. Instead, it returns a new DateTime whose value is the result of this operation.
The fractional part of value is the fractional part of a minute. For example, 4.5 is equivalent to 4 minutes, 30 seconds, 0 milliseconds, and 0 ticks.
The value parameter is rounded to the nearest millisecond.
The following example uses the AddMinutes method to add a number of whole and fractional values to a date and time.
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
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1