DateTimeOffset.AddTicks(Int64) 方法

定义

命名空间:

System

程序集:

System.Runtime.dll

Source:

DateTimeOffset.cs

返回一个新的 DateTimeOffset 对象，它将指定的计时周期数加到此实例的值上。

public:
 DateTimeOffset AddTicks(long ticks);

public DateTimeOffset AddTicks (long ticks);

member this.AddTicks : int64 -> DateTimeOffset

Public Function AddTicks (ticks As Long) As DateTimeOffset

参数

ticks

Int64

以 100 纳秒为单位的计时周期数。 此数值可以是负数也可以是正数。

返回

DateTimeOffset

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

例外

ArgumentOutOfRangeException

生成的 DateTimeOffset 值小于 DateTimeOffset.MinValue。

-或-

生成的 DateTimeOffset 值大于 DateTimeOffset.MaxValue。

注解

刻度表示 100 纳秒，即 1000 万分之一秒。 由于计时周期非常小且精确，因此任何较大的时间单位都可以表示为一个时钟周期数，而不会损失精度。

注意

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

下表列出了特定时间间隔内的时钟周期数。

时间间隔	时钟周期数
秒	10,000,000
Minute	600,000,000
小时	36,000,000,000
天	864,000,000,000
周	6,048,000,000,000
Month	取决于当月的天数。
非闰年	315,360,000,000,000
闰年	316,224,000,000,000

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

另请参阅

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