DateTimeOffset.AddMinutes(Double) 方法

定義

命名空間:

System

組件:

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 6 和舊版中 minutes ，參數會四捨五入至最接近的毫秒。 在 .NET 7 和更新版本中，會使用 參數的完整 Doubleminutes 精確度。 不過，由於浮點數數學的固有不精確性，因此產生的精確度會有所不同。

注意

這個方法會傳回新的 DateTimeOffset 物件。 它不會藉由新增 minutes 至目前物件的日期和時間來修改其值。

DateTimeOffset因為 物件不代表特定時區中的日期和時間，所以當方法執行日期和時間算術時， AddMinutes 不會考慮特定時區的調整規則。

將小於一分鐘的時間間隔轉換為分數，可能會牽涉到精確度遺失。 例如， (一秒是 0.01666 分鐘。) 如果這有問題，您可以使用 Add 方法，這可讓您在單一方法呼叫中指定一種以上的時間間隔，並不需要將時間間隔轉換為分鐘的小數部分。

另請參閱

• 使用日期和時間執行算數運算