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