DateTime.AddMicroseconds(Double) Method

Definition

Namespace:

System

Assembly:

System.Runtime.dll

Source:

DateTime.cs

Returns a new DateTime that adds the specified number of microseconds to the value of this instance.

public:
 DateTime AddMicroseconds(double value);

public DateTime AddMicroseconds (double value);

member this.AddMicroseconds : double -> DateTime

Public Function AddMicroseconds (value As Double) As DateTime

Parameters

value

Double

A number of whole and fractional microseconds. The value parameter can be negative or positive. Note that this value is rounded to the nearest integer.

Returns

DateTime

An object whose value is the sum of the date and time represented by this instance and the number of microseconds represented by value.

Exceptions

ArgumentOutOfRangeException

The resulting DateTime is less than MinValue or greater than MaxValue.

Remarks

This method does not change the value of this DateTime. Instead, it returns a new DateTime whose value is the result of this operation.

The fractional part of value is the fractional part of a microsecond. For example, 4.5 is equivalent to 4 microseconds and 50 ticks, where one microsecond = 10 ticks.

The value parameter is rounded to the nearest integer.