DateTimeOffset.AddSeconds(Double) 方法

定义

命名空间:

System

程序集:

System.Runtime.dll

Source:

DateTimeOffset.cs

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

public:
 DateTimeOffset AddSeconds(double seconds);

public DateTimeOffset AddSeconds (double seconds);

member this.AddSeconds : double -> DateTimeOffset

Public Function AddSeconds (seconds As Double) As DateTimeOffset

参数

seconds

Double

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

返回

DateTimeOffset

一个对象，其值为当前的 DateTimeOffset 对象所表示的日期和时间与 seconds 所表示的秒数之和。

例外

ArgumentOutOfRangeException

生成的 DateTimeOffset 值小于 DateTimeOffset.MinValue。

-或-

生成的 DateTimeOffset 值大于 DateTimeOffset.MaxValue。

注解

参数的小 seconds 数部分是秒的小数部分。 下表显示了秒的小数部分的值。

第二个值	等效
0.1 秒	100 毫秒
0.01 秒	10 毫秒
.001 秒	1 毫秒

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

注意

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

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

另请参阅

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