返回一个新的 DateTime,它将指定的分钟数加到此实例的值上。
命名空间: System
程序集: mscorlib(mscorlib.dll 中)
语法
C#
public DateTime AddMinutes(
double value
)
参数
value
由整数和小数部分组成的分钟数。 value 参数可以是负数也可以是正数。
返回值
Type: System.DateTime
一个对象,其值是此实例所表示的日期和时间与 value 所表示的分钟数之和。
异常
Exception Condition
ArgumentOutOfRangeException
生成 DateTime 是小于 MinValue 或大于 MaxValue。
备注
此方法不会更改此值 DateTime。相反,它会返回一个新 DateTime 其值是此操作的结果。
小数部分 value 是一分钟的小数部分。例如,4.5 等效于 4 分 30 秒,0 毫秒,0 刻度。
value 参数将四舍五入为最接近的毫秒。
示例
下面的示例使用 AddMinutes 方法将大量的整数和小数部分值添加到日期和时间。
C#
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