DateTimeOffset.AddMinutes(Double) 方法

定义

命名空间:

System

程序集:

System.Runtime.dll

Source:

DateTimeOffset.cs

返回一个新的 DateTimeOffset 对象，它将由整数和小数部分组成的指定分钟数添加到此实例的值上。

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

由整数和小数部分组成的分钟数。 此数值可以是负数也可以是正数。

返回

DateTimeOffset

一个对象，其值是当前 DateTimeOffset 对象表示的日期和时间与 minutes 表示的分钟数之和。

例外

ArgumentOutOfRangeException

生成的 DateTimeOffset 值小于 DateTimeOffset.MinValue。

-或-

生成的 DateTimeOffset 值大于 DateTimeOffset.MaxValue。

注解

参数的小 minutes 数部分是分钟的小数部分。 例如，4.5 相当于 4 分 30 秒 0 毫秒。

在 .NET 6 及更早版本中， minutes 参数四舍五入为最接近的毫秒。 在 .NET 7 及更高版本中，使用 参数的minutes全Double精度。 但是，由于浮点数学固有的不精确性，生成的精度将有所不同。

注意

此方法返回一个新的 DateTimeOffset 对象。 它不会通过将 添加到 minutes 当前对象的日期和时间来修改其值。

DateTimeOffset由于 对象不表示特定时区中的日期和时间，因此该方法AddMinutes在执行日期和时间算术时不考虑特定时区的调整规则。

将小于一分钟的时间间隔转换为分数可能会降低精度。 (例如，1 秒为 0.01666 分钟。) 如果存在问题，可以使用 Add 方法，这样就可以在单个方法调用中指定多种类型的时间间隔，并且无需将时间间隔转换为分钟的小数部分。

另请参阅

• 使用日期和时间执行算术运算