TimeSpan.FromMilliseconds Method (Double)
Returns a TimeSpan that represents a specified number of milliseconds.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- value
-
Type:
System.Double
A number of milliseconds.
| Exception | Condition |
|---|---|
| OverflowException | value is less than MinValue or greater than MaxValue. -or- value is Double.PositiveInfinity. -or- value is Double.NegativeInfinity. |
| ArgumentException | value is equal to Double.NaN. |
The value parameter is converted to ticks, and that number of ticks is used to initialize the new TimeSpan. Therefore, value will only be considered accurate to the nearest millisecond. Note that, because of the loss of precision of the Double data type, this conversion can generate an OverflowException for values that are near to but still in the range of either MinValue or MaxValue. For example, this causes an OverflowException in the following attempt to instantiate a TimeSpan object.
The following example creates several TimeSpan objects by using the FromMilliseconds method.
' Example of the TimeSpan.FromMilliseconds( Double ) method. Imports System Imports Microsoft.VisualBasic Module FromMillisecDemo Sub GenTimeSpanFromMillisec( millisec As Double ) ' Create a TimeSpan object and TimeSpan string from ' a number of milliseconds. Dim interval As TimeSpan = _ TimeSpan.FromMilliseconds( millisec ) Dim timeInterval As String = interval.ToString( ) ' Pad the end of the TimeSpan string with spaces if it ' does not contain milliseconds. Dim pIndex As Integer = timeInterval.IndexOf( ":"c ) pIndex = timeInterval.IndexOf( "."c, pIndex ) If pIndex < 0 Then timeInterval &= " " Console.WriteLine( "{0,21}{1,26}", millisec, timeInterval ) End Sub Sub Main( ) Console.WriteLine( "This example of " & _ "TimeSpan.FromMilliseconds( Double )" & _ vbCrLf & "generates the following output." & vbCrLf ) Console.WriteLine( "{0,21}{1,18}", _ "FromMilliseconds", "TimeSpan" ) Console.WriteLine( "{0,21}{1,18}", _ "----------------", "--------" ) GenTimeSpanFromMillisec( 1 ) GenTimeSpanFromMillisec( 1.5 ) GenTimeSpanFromMillisec( 12345.6 ) GenTimeSpanFromMillisec( 123456789.8 ) GenTimeSpanFromMillisec( 1234567898765.4 ) GenTimeSpanFromMillisec( 1000 ) GenTimeSpanFromMillisec( 60000 ) GenTimeSpanFromMillisec( 3600000 ) GenTimeSpanFromMillisec( 86400000 ) GenTimeSpanFromMillisec( 1801220200 ) End Sub End Module ' This example of TimeSpan.FromMilliseconds( Double ) ' generates the following output. ' ' FromMilliseconds TimeSpan ' ---------------- -------- ' 1 00:00:00.0010000 ' 1.5 00:00:00.0020000 ' 12345.6 00:00:12.3460000 ' 123456789.8 1.10:17:36.7900000 ' 1234567898765.4 14288.23:31:38.7650000 ' 1000 00:00:01 ' 60000 00:01:00 ' 3600000 01:00:00 ' 86400000 1.00:00:00 ' 1801220200 20.20:20:20.2000000
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1