DateTime.AddMilliseconds Method
Microsoft Silverlight will reach end of support after October 2021. Learn more.
Returns a new DateTime that adds the specified number of milliseconds to the value of this instance.
Namespace: System
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
Public Function AddMilliseconds ( _
value As Double _
) As DateTime
public DateTime AddMilliseconds(
double value
)
Parameters
- value
Type: System.Double
The number of whole and fractional milliseconds to add. This value can be positive or negative, and is rounded to the nearest integer.
Return Value
Type: System.DateTime
An object whose value is the sum of the date and time represented by this instance and the number of milliseconds represented by value.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentOutOfRangeException | The resulting DateTime is earlier than DateTime.MinValue or later than DateTime.MaxValue. |
Remarks
This method does not change the value of this DateTime. Instead, a new DateTime is returned whose value is the result of this operation.
The fractional part of value is the fractional part of a millisecond. For example, 4.5 is equivalent to 4 milliseconds and 5000 ticks, where one millisecond = 10000 ticks.
The value parameter is rounded to the nearest integer.
Examples
The following example uses the AddMilliseconds method to add one millisecond and 1.5 milliseconds to a DateTime value. It then displays each new value and displays the difference between it and the original value. The difference is displayed both as a time span and as a number of ticks. The example makes it clear that one millisecond equals 10,000 ticks. It also shows that fractional milliseconds are rounded before performing the addition; the DateTime value that results from adding 1.5 milliseconds to the original date is 2 milliseconds greater than the original date.
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.