此方法用於返回一個新的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參數四舍五入到最接近的毫秒數。
參考:
相關用法
注:本文由純淨天空篩選整理自Kirti_Mangal大神的英文原創作品 DateTime.AddMinutes() Method in C#。非經特殊聲明,原始代碼版權歸原作者所有,本譯文未經允許或授權,請勿轉載或複製。