DateTimeOffset.AddSeconds(Double) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
返回一个新的 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在执行日期和时间算术时不考虑特定时区的调整规则。