C＃中的DateTime.AddMinutes()方法

此方法用于返回一个新的DateTime，该日期将指定的分钟数添加到此实例的值中。

句法：

public DateTime AddMinutes (double value);

在这里，值是整数分钟的一部分。值参数可以为负或正。

返回值：该方法返回一个对象，该对象的值是此实例表示的日期和时间与value表示的分钟数之和。

异常：如果生成的DateTime小于MinValue或大于MaxValue，则此方法将引发ArgumentOutOfRangeException 。

下面的程序说明了上述方法的用法：

范例1：

// C# program to demonstrate the
// DateTime.AddMinutes(Double) Method
using System;
  
class GFG {
  
// Main Method
public static void Main()
{
  
    // Creating a DateTime object
    DateTime d1 = new DateTime(2018, 9,
                            7, 7, 0, 0);
  
    // Taking minutes
    double[] m1 = {.01567, .06743, 12.12347,
                           .89, .6666, 250.0};
  
    foreach(double m2 in m1)
    {
  
        // using the method
        Console.WriteLine("{0} + {1} minute(s) = {2}", d1,
                                   m2, d1.AddMinutes(m2));
    }                    
}
}

输出：

09/07/2018 07:00:00 + 0.01567 minute(s) = 09/07/2018 07:00:00
09/07/2018 07:00:00 + 0.06743 minute(s) = 09/07/2018 07:00:04
09/07/2018 07:00:00 + 12.12347 minute(s) = 09/07/2018 07:12:07
09/07/2018 07:00:00 + 0.89 minute(s) = 09/07/2018 07:00:53
09/07/2018 07:00:00 + 0.6666 minute(s) = 09/07/2018 07:00:39
09/07/2018 07:00:00 + 250 minute(s) = 09/07/2018 11:10:00

范例2：

// C# program to demonstrate the
// DateTime.AddMinutes(Double) Method
using System;
  
class GFG {
  
// Main Method
public static void Main()
{
  
    // Creating a DateTime object
    // by taking it MaxValue
    DateTime d1 = DateTime.MaxValue;
  
    // Taking minute variable
    double m1 = 1.7;
  
    // Using the Method will error as the
    // resulting DateTime is greater than 
    // MaxValue
    Console.WriteLine(d1.AddMinutes(m1));
}
}

运行时错误：

Unhandled Exception:
System.ArgumentOutOfRangeException: The added or subtracted value results in an un-representable DateTime.
Parameter name: value

笔记：

• 此方法不会更改此DateTime的值。而是返回一个新的DateTime，其值是此操作的结果。
• 值的小数部分是一分钟的小数部分。例如，7.5等于7分钟，30秒，0毫秒和0个滴答。
• value参数将四舍五入到最接近的毫秒数。

参考：

• https://docs.microsoft.com/zh-cn/dotnet/api/system.datetime.addminutes?view=netframework-4.7.2