陈斌彬的技术博客

Stay foolish,stay hungry

DateTime.AddMinutes 方法 (Double)

返回一个新的 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

Resource Reference