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