DateTimeOffset.AddTicks Method

Updated: April 2009

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

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

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
A DateTimeOffset 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.

ExceptionCondition
ArgumentOutOfRangeException

The resulting DateTimeOffset value is less than MinValue.

-or-

The resulting DateTimeOffset value is greater than MaxValue.

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

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5 SP1, 3.0 SP1, 2.0 SP1

Date

History

Reason

April 2009

Corrected the number of ticks per second in the table.

Customer feedback.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft