DateTimeOffset.AddSeconds(Double) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
傳回新的 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 不會考慮特定時區的調整規則。