DateTimeOffset.AddMilliseconds(Double) 方法

定义

返回一个新的 DateTimeOffset 对象,它将指定的毫秒数加到此实例的值上。

public DateTimeOffset AddMilliseconds (double milliseconds);

参数

milliseconds
Double

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

返回

一个对象,其值为当前 DateTimeOffset 对象表示的时间和日期与 milliseconds 对象表示的整毫秒数之和。

例外

注解

参数的小 milliseconds 数部分是毫秒的小数部分。 例如,4.5 相当于 4 毫秒和 5000 个时钟周期,其中 1 毫秒等于 10,000 个时钟周期。 但是,在 .NET 6 及更早版本中, milliseconds 舍入到最接近的毫秒,并且所有 .5 或更大的值都会向上舍入。 在 .NET 7 及更高版本中,使用 参数的millisecondsDouble精度。 但是,由于浮点数学固有的不精确性,生成的精度将有所不同。

备注

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

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

适用于

产品 版本
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

另请参阅