DateTimeOffset.AddTicks Method

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

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

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

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.

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.

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5 SP1, 3.0 SP1, 2.0 SP1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

.NET for Windows Store apps

Supported in: Windows 8

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft