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で表される秒数を値とするオブジェクト。
例外
結果の DateTimeOffset 値が DateTimeOffset.MinValue 未満です。
-又は-
結果の DateTimeOffset 値が DateTimeOffset.MaxValue より大きくなります。
注釈
seconds パラメーターの小数部は、秒の小数部です。 秒の小数部の値を次の表に示します。
| 2 番目の値 | 同等物 |
|---|---|
| .1 秒 | 100 ミリ秒 |
| .01 秒 | 10 ミリ秒 |
| .001 秒 | 1 ミリ秒 |
.NET Framework では、 seconds パラメーターは最も近いミリ秒に丸められます。 .NET 7 以降のバージョンでは、Double パラメーターの完全なseconds有効桁数が使用されます。 ただし、浮動小数点演算の本質的な不正確さにより、結果の精度は異なります。
注
このメソッドは、新しい DateTimeOffset オブジェクトを返します。 現在のオブジェクトの日付と時刻に seconds を追加しても、現在のオブジェクトの値は変更されません。
DateTimeOffset オブジェクトは特定のタイム ゾーンの日付と時刻を表さないため、AddSeconds メソッドは日付と時刻の算術演算を実行するときに特定のタイム ゾーンの調整規則を考慮しません。