Share via


DateTimeOffset.AddTicks Method

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Adds a specified number of ticks to the current DateTimeOffset object.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Function AddTicks ( _
    ticks As Long _
) As DateTimeOffset
public DateTimeOffset AddTicks(
    long ticks
)

Parameters

  • ticks
    Type: System.Int64
    A number of 100-nanosecond ticks. The number can be negative or positive.

Return Value

Type: System.DateTimeOffset
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

Exception Condition
ArgumentOutOfRangeException

The resulting DateTimeOffset value is less than MinValue.

-or-

The resulting DateTimeOffset value is greater than 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.

NoteNote:

This method returns a new DateTimeOffset object. 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

Second

10,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.

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.