Article
11/18/2011

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.

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.

Note:
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.

Partager via