DateTimeOffset.AddTicks(Int64) メソッド

定義

このインスタンスの値に、指定されたタイマー刻みの数を加算した新しい DateTimeOffset オブジェクトを返します。Returns a new DateTimeOffset object that adds a specified number of ticks to the value of this instance.

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 ナノ秒タイマー刻み数。A number of 100-nanosecond ticks. 正数または負数を指定できます。The number can be negative or positive.

戻り値

現在の DateTimeOffset オブジェクトで表された日時に ticks で表されたタイマー刻みの数を加算した値を示すオブジェクト。An object whose value is the sum of the date and time represented by the current DateTimeOffset object and the number of ticks represented by ticks.

例外

結果として得られる DateTimeOffset 値は MinValue より小さい値です。The resulting DateTimeOffset value is less than MinValue.

- または --or- 結果として得られる DateTimeOffset 値が MaxValue を超えています。The resulting DateTimeOffset value is greater than MaxValue.

注釈

ティックは、100ナノ秒または1秒間の万を表します。A tick represents 100 nanoseconds, or one-ten millionth of a second. ティックは非常に小さく、正確な時間間隔であるため、有効桁数が失われることなく、より大きな時間単位をタイマー刻みの数として表すことができます。Because a tick is a very small and precise time interval, any larger time unit can be expressed as a number of ticks without a loss of precision.

注意

このメソッドは、新しい DateTimeOffset オブジェクトを返します。This method returns a new DateTimeOffset object. 日付と時刻に minutes を追加することによって、現在のオブジェクトの値を変更することはありません。It does not modify the value of the current object by adding minutes to its date and time.

次の表に、特定の時間間隔におけるタイマー刻みの数を示します。The following table lists the number of ticks in a particular time interval.

時間間隔Time interval タイマー刻みの数Number of ticks
SecondSecond 10,000,00010,000,000
MinuteMinute 600,000,000600,000,000
HourHour 36,000,000,00036,000,000,000
DayDay 864,000,000,000864,000,000,000
Week 6,048,000,000,0006,048,000,000,000
Month 月の日数に依存します。Depends on number of days in the month.
うるう年以外Non-leap year 315,360,000,000,000315,360,000,000,000
閏年Leap year 316,224,000,000,000316,224,000,000,000

DateTimeOffset オブジェクトは特定のタイムゾーンの日付と時刻を表していないため、AddTicks メソッドは、日付と時刻の演算を実行するときに特定のタイムゾーンの調整規則を考慮しません。Because a DateTimeOffset object does not represent the date and time in a specific time zone, the AddTicks method does not consider a particular time zone's adjustment rules when it performs date and time arithmetic.

適用対象

こちらもご覧ください