DateTimeOffset.AddMilliseconds(Double) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
このインスタンスの値に指定したミリ秒を加算する新しい DateTimeOffset オブジェクトを返します。
public:
DateTimeOffset AddMilliseconds(double milliseconds);
public DateTimeOffset AddMilliseconds(double milliseconds);
member this.AddMilliseconds : double -> DateTimeOffset
Public Function AddMilliseconds (milliseconds As Double) As DateTimeOffset
パラメーター
- milliseconds
- Double
整数ミリ秒と小数部ミリ秒の数。 数値は負または正の値にすることができます。
返品
現在の DateTimeOffset オブジェクトで表される日付と時刻の合計と、 millisecondsで表されるミリ秒単位の数を値とするオブジェクト。
例外
結果の DateTimeOffset 値が DateTimeOffset.MinValue 未満です。
-又は-
結果の DateTimeOffset 値が DateTimeOffset.MaxValue より大きくなります。
注釈
milliseconds パラメーターの小数部は、ミリ秒の小数部です。 たとえば、4.5 は 4 ミリ秒と 5000 ティックに相当し、1 ミリ秒は 10,000 ティックです。 ただし、.NET Framework では、 milliseconds は最も近いミリ秒に丸められ、.5 以上のすべての値が切り上げられます。 .NET 7 以降のバージョンでは、Double パラメーターの完全なmilliseconds有効桁数が使用されます。 ただし、浮動小数点演算の本質的な不正確さにより、結果の精度は異なります。
注
このメソッドは、新しい DateTimeOffset オブジェクトを返します。 現在のオブジェクトの日付と時刻に milliseconds を追加しても、現在のオブジェクトの値は変更されません。
DateTimeOffset オブジェクトは特定のタイム ゾーンの日付と時刻を表さないため、AddMilliseconds メソッドは日付と時刻の算術演算を実行するときに特定のタイム ゾーンの調整規則を考慮しません。