DateTimeOffset.AddMinutes(Double) メソッド

定義

このインスタンスの値に、指定された整数部と小数部から成る分数を加算した新しい DateTimeOffset オブジェクトを返します。Returns a new DateTimeOffset object that adds a specified number of whole and fractional minutes to the value of this instance.

public:
 DateTimeOffset AddMinutes(double minutes);
public DateTimeOffset AddMinutes (double minutes);
member this.AddMinutes : double -> DateTimeOffset
Public Function AddMinutes (minutes As Double) As DateTimeOffset

パラメーター

minutes
Double

整数部と小数部から成る分数。A number of whole and fractional minutes. 正数または負数を指定できます。The number can be negative or positive.

戻り値

現在の DateTimeOffset オブジェクトで表された日時に minutes で表された分数を加算した値を示すオブジェクト。An object whose value is the sum of the date and time represented by the current DateTimeOffset object and the number of minutes represented by minutes.

例外

結果として得られる DateTimeOffset 値は MinValue より小さい値です。The resulting DateTimeOffset value is less than MinValue.

- または --or- 結果として得られる DateTimeOffset 値が MaxValue を超えています。The resulting DateTimeOffset value is greater than MaxValue.

注釈

minutes パラメーターの小数部は、分の小数部です。The fractional part of the minutes parameter is the fractional part of a minute. たとえば、4.5 は、4分、30秒、0ミリ秒に相当します。For example, 4.5 is equivalent to 4 minutes, 30 seconds, 0 milliseconds. minutes パラメーターは、ミリ秒単位で丸められます。The minutes parameter is rounded to the nearest millisecond.

注意

このメソッドは、新しい DateTimeOffset オブジェクトを返します。This method returns a new DateTimeOffset object. 日付と時刻に minutes を追加することによって、現在のオブジェクトの値を変更することはありません。It does not modify the value of the current object by adding minutes to its date and time.

DateTimeOffset オブジェクトは特定のタイムゾーンの日付と時刻を表していないため、AddMinutes メソッドは、日付と時刻の演算を実行するときに特定のタイムゾーンの調整規則を考慮しません。Because a DateTimeOffset object does not represent the date and time in a specific time zone, the AddMinutes method does not consider a particular time zone's adjustment rules when it performs date and time arithmetic.

1分未満の時間間隔を分数に変換すると、精度が失われる可能性があります。Converting time intervals of less than a minute to a fraction can involve a loss of precision. (たとえば、1秒は0.01666 分です)。この問題が発生した場合は、Add メソッドを使用できます。これにより、1回のメソッド呼び出しで複数の種類の時間間隔を指定できるようになり、時間間隔を分の小数部分に変換する必要がなくなります。(For example, one second is 0.01666 of a minute.) If this is problematic, you can use the Add method, which enables you to specify more than one kind of time interval in a single method call and eliminates the need to convert time intervals to fractional parts of a minute.

適用対象

こちらもご覧ください