DateTimeOffset.AddMinutes(Double) 方法

定義

命名空間:

System

組件:

netstandard.dll, System.Runtime.dll

來源:

DateTimeOffset.cs

回傳一個新 DateTimeOffset 物件，為該實例的值加上指定數量的整分鐘與分分鐘。

public:
 DateTimeOffset AddMinutes(double minutes);

public DateTimeOffset AddMinutes(double minutes);

member this.AddMinutes : double -> DateTimeOffset

Public Function AddMinutes (minutes As Double) As DateTimeOffset

參數

minutes

Double

整分鐘和分數分鐘。 這個數字可以是負數或正數。

傳回

DateTimeOffset

一個物件，其值為當前 DateTimeOffset 物件所代表的日期與時間與所代表 minutes的分鐘數之和。

例外狀況

ArgumentOutOfRangeException

所得值 DateTimeOffset 小於 DateTimeOffset.MinValue。

-或-

所得值 DateTimeOffset 大於 DateTimeOffset.MaxValue。

備註

參數的 minutes 分數部分是分鐘的分數部分。 例如，4.5 相當於 4 分 30 秒 0 毫秒。

在 .NET Framework 中，參數 minutes 會四捨五入到最接近的毫秒。 在 .NET 7 及之後版本中，參數的精確度會被使用。Doubleminutes 然而，由於浮點數學本身的不精確性，所得精度會有所不同。

備註

此方法回傳一個新 DateTimeOffset 物件。 它不會透過增加 minutes 日期和時間來改變當前物件的值。

由於物件 DateTimeOffset 不代表特定時區的日期與時間， AddMinutes 該方法在執行日期與時間運算時，不會考慮該時區的調整規則。

將少於一分鐘的時間間隔轉換為分數，可能會損失精確度。 （例如，一秒是0.01666分鐘。）如果這有問題，你可以使用這個 Add 方法，它讓你能在單一方法呼叫中指定多種時間區間，省去將時間區間轉換成分鐘的分數。

另請參閱

• 使用日期與時間進行算術運算