DateTimeOffset.AddSeconds(Double) 方法

定義

傳回新的 DateTimeOffset 物件,將這個執行個體的值加上指定的整數和小數秒數。

public:
 DateTimeOffset AddSeconds(double seconds);
public DateTimeOffset AddSeconds (double seconds);
member this.AddSeconds : double -> DateTimeOffset
Public Function AddSeconds (seconds As Double) As DateTimeOffset

參數

seconds
Double

整數和小數的秒數。 可以是負數或正數。

傳回

物件,其值為目前 DateTimeOffset 物件所表示之日期和時間加上 seconds 所表示之秒數的總和。

例外狀況

備註

參數的小 seconds 數部分是第二個的小數部分。 下表顯示第二個小數部分的值。

第二個值 對等用法
.1 秒 100 毫秒
.01 秒 10 毫秒
.001 秒 1 毫秒

在 .NET 6 和舊版中 seconds ,參數會四捨五入至最接近的毫秒。 在 .NET 7 和更新版本中,會使用 參數的完整 Doubleseconds 精確度。 不過,由於浮點數數學的固有不精確性,因此產生的精確度會有所不同。

注意

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

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

適用於

另請參閱