DateTimeOffset.AddTicks(Int64) 方法

定義

命名空間:

System

組件:

System.Runtime.dll

來源:

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 奈秒，或 100 萬秒。 由於刻度非常小且精確的時間間隔，因此任何較大的時間單位都可以以數個刻度表示，而不會遺失精確度。

注意

這個方法會傳回新的 DateTimeOffset 物件。 它不會藉由將 新增 ticks 至物件的日期和時間來修改目前物件的值。

下表列出特定時間間隔中的刻度數目。

時間間隔	刻度數目
Second	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 所以此方法在執行日期和時間算術時，不會考慮特定時區的調整規則。

另請參閱

• 使用日期和時間執行算數運算