DateTimeOffset.AddTicks(Int64) Method

Definition

Returns a new DateTimeOffset object that adds a specified number of ticks to the value of this instance.

public DateTimeOffset AddTicks (long ticks);

Parameters

ticks
Int64

A number of 100-nanosecond ticks. The number can be negative or positive.

Returns

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.

Exceptions

The resulting DateTimeOffset value is less than DateTimeOffset.MinValue.

-or-

The resulting DateTimeOffset value is greater than DateTimeOffset.MaxValue.

Remarks

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.

Note

This method returns a new DateTimeOffset object. It does not modify the value of the current object by adding ticks to its date and time.

The following table lists the number of ticks in a particular time interval.

Time interval Number of ticks
Second 10,000,000
Minute 600,000,000
Hour 36,000,000,000
Day 864,000,000,000
Week 6,048,000,000,000
Month Depends on number of days in the month.
Non-leap year 315,360,000,000,000
Leap year 316,224,000,000,000

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.

Applies to

Product Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

See also