DateTimeOffset.AddSeconds(Double) 方法

定义

返回一个新的 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 对象所表示的日期和时间与 seconds 所表示的秒数之和。

例外

注解

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

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

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

注意

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

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

适用于

另请参阅