DateTimeOffset.AddMilliseconds(Double) 方法

定义

命名空间:

System

程序集:

System.Runtime.dll

Source:

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精度。 但是，由于浮点数学固有的不精确性，生成的精度将有所不同。

注意

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

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

另请参阅

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