此方法用于返回一个新的DateTime,它将指定的秒数添加到此实例的值。
句法:
public DateTime AddSeconds (double value);
此处,值是整数秒的分数。值参数可以为负或正。
返回值:该方法返回一个对象,其值是此实例表示的日期和时间与value表示的秒数之和。
异常:如果生成的DateTime小于MinValue或大于MaxValue,则此方法将引发ArgumentOutOfRangeException 。
下面的程序说明了上述方法的用法:
范例1:
// C# program to demonstrate the
// DateTime.AddSeconds(Double) Method
using System;
class GFG {
// Main Method
public static void Main()
{
// defining the format of date
string dateFormat = "MM/dd/yyyy hh:mm:ss";
// Creating a DateTime object and
// taking a particular date and time
DateTime d1 = new DateTime(2018, 9, 7, 7, 0, 0);
Console.WriteLine("Original date: {0}",
d1.ToString(dateFormat));
// Taking seconds
int sec = 30;
// using method
DateTime d2 = d1.AddSeconds(sec);
Console.WriteLine("After Using Method: {0}",
d2.ToString(dateFormat));
}
}
输出:
Original date: 09/07/2018 07:00:00
After Using Method: 09/07/2018 07:00:30
范例2:
// C# program to demonstrate the
// DateTime.AddSeconds(Double) Method
using System;
class GFG {
// Main Method
public static void Main()
{
// defining the format of date
string dateFormat = "MM/dd/yyyy hh:mm:ss";
// Creating a DateTime object and
// taking a MaxValue of Date
DateTime d1 = DateTime.MaxValue;
Console.WriteLine("Original date: {0}",
d1.ToString(dateFormat));
// Taking seconds
int sec = 17;
// using method will give error as the
// resulting DateTime will be greater
// than the MaxValue
DateTime d2 = d1.AddSeconds(sec);
Console.WriteLine("After Using Method: {0}",
d2.ToString(dateFormat));
}
}
运行时错误:
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.addseconds?view=netframework-4.7.2