DateTimeOffset.AddMilliseconds(Double) メソッド

定義

名前空間:

System

アセンブリ:

System.Runtime.dll

ソース:

DateTimeOffset.cs

指定されたミリ秒数をこのインスタンスの値に加算した新しい 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

現在の DateTimeOffset オブジェクトで表される日時に milliseconds で表される整数のミリ秒数を加算した値をもつオブジェクト。

例外

ArgumentOutOfRangeException

結果 DateTimeOffset の値が DateTimeOffset.MinValue 未満です。

\- または -

結果 DateTimeOffset の値が DateTimeOffset.MaxValue より大きい。

注釈

パラメーターの milliseconds 小数部は、ミリ秒の小数部です。 たとえば、4.5 は 4 ミリ秒と 5000 ティックに相当し、1 ミリ秒は 10,000 ティックと等しくなります。 ただし、.NET 6 以前のバージョンでは、 milliseconds は最も近いミリ秒に丸められ、.5 以上のすべての値が切り上げられます。 .NET 7 以降のバージョンでは、 パラメーターのmilliseconds完全なDouble有効桁数が使用されます。 ただし、浮動小数点演算の本質的な不正確さにより、結果の精度は異なります。

Note

このメソッドは、新 DateTimeOffset しいオブジェクトを返します。 現在のオブジェクトの値は、その日付と時刻に追加 milliseconds しても変更されません。

オブジェクトは DateTimeOffset 特定のタイム ゾーンの日付と時刻を表さないため、 AddMilliseconds メソッドは日付と時刻の算術演算を実行するときに特定のタイム ゾーンの調整規則を考慮しません。

こちらもご覧ください

• 日付と時刻を使用した算術演算の実行