TimeSpan.FromMilliseconds 方法

參考

定義

命名空間:: System

組件:: System.Runtime.dll

組件:: mscorlib.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

FromMilliseconds(Int64, Int64)	將 TimeSpan 結構的新實例初始化為指定的毫秒數，以及毫秒數。
FromMilliseconds(Double)	傳回代表指定毫秒數的 TimeSpan。

FromMilliseconds(Int64, Int64)

將 TimeSpan 結構的新實例初始化為指定的毫秒數，以及毫秒數。

public static TimeSpan FromMilliseconds (long milliseconds, long microseconds = 0);

static member FromMilliseconds : int64 * int64 -> TimeSpan

Public Shared Function FromMilliseconds (milliseconds As Long, Optional microseconds As Long = 0) As TimeSpan

參數

milliseconds: Int64

毫秒數。

microseconds: Int64

微秒數。

傳回

TimeSpan

會傳回代表指定毫秒數和微秒的 TimeSpan。

例外狀況

ArgumentOutOfRangeException

參數會指定小於 MinValue 或大於 MaxValue TimeSpan 值

適用於

FromMilliseconds(Double)

來源:: TimeSpan.cs

來源:: TimeSpan.cs

來源:: TimeSpan.cs

傳回代表指定毫秒數的 TimeSpan。

public:
 static TimeSpan FromMilliseconds(double value);

public static TimeSpan FromMilliseconds (double value);

static member FromMilliseconds : double -> TimeSpan

Public Shared Function FromMilliseconds (value As Double) As TimeSpan

參數

value: Double

毫秒數。

傳回

TimeSpan

物件，表示 value。

例外狀況

OverflowException

value 小於 TimeSpan.MinValue 或大於 TimeSpan.MaxValue。

-或-

value PositiveInfinity。

-或-

value NegativeInfinity。

ArgumentException

value 等於 NaN。

範例

下列範例會使用 FromMilliseconds 方法來建立數個 TimeSpan 物件。

// Example of the TimeSpan::FromMilliseconds( double ) method.
using namespace System;
void GenTimeSpanFromMillisec( Double millisec )
{
   
   // Create a TimeSpan object and TimeSpan string from 
   // a number of milliseconds.
   TimeSpan interval = TimeSpan::FromMilliseconds( millisec );
   String^ timeInterval = interval.ToString();
   
   // Pad the end of the TimeSpan string with spaces if it 
   // does not contain milliseconds.
   int pIndex = timeInterval->IndexOf( ':' );
   pIndex = timeInterval->IndexOf( '.', pIndex );
   if ( pIndex < 0 )
      timeInterval = String::Concat( timeInterval, "        " );

   Console::WriteLine( "{0,21}{1,26}", millisec, timeInterval );
}

int main()
{
   Console::WriteLine( "This example of TimeSpan::FromMilliseconds( double )\n"
   "generates the following output.\n" );
   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 );
}

/*
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
*/

// Example of the TimeSpan.FromMilliseconds( double ) method.
using System;

class FromMillisecDemo
{
    static void GenTimeSpanFromMillisec( Double millisec )
    {
        // Create a TimeSpan object and TimeSpan string from 
        // a number of milliseconds.
        TimeSpan    interval = TimeSpan.FromMilliseconds( millisec );
        string      timeInterval = interval.ToString( );

        // Pad the end of the TimeSpan string with spaces if it 
        // does not contain milliseconds.
        int pIndex = timeInterval.IndexOf( ':' );
        pIndex = timeInterval.IndexOf( '.', pIndex );
        if( pIndex < 0 )   timeInterval += "        ";

        Console.WriteLine( "{0,21}{1,26}", millisec, timeInterval );
    } 

    static void Main( )
    {
        Console.WriteLine(
            "This example of TimeSpan.FromMilliseconds( " +
            "double )\ngenerates the following output.\n" );
        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 );
    } 
} 

/*
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
*/

// Example of the TimeSpan.FromMilliseconds( double ) method.
open System

let genTimeSpanFromMillisec millisec =
    // Create a TimeSpan object and TimeSpan string from 
    // a number of milliseconds.
    let interval = TimeSpan.FromMilliseconds millisec
    let timeInterval = string interval

    // Pad the end of the TimeSpan string with spaces if it 
    // does not contain milliseconds.
    let pIndex = timeInterval.IndexOf ':'
    let pIndex = timeInterval.IndexOf('.', pIndex)
    let timeInterval =
        if pIndex < 0 then timeInterval + "        "
        else timeInterval

    printfn $"{millisec,21}{timeInterval,26}"

printfn "This example of TimeSpan.FromMilliseconds( double )\ngenerates the following output.\n"
printfn "%21s%18s" "FromMilliseconds" "TimeSpan"
printfn "%21s%18s" "----------------" "--------"

genTimeSpanFromMillisec 1
genTimeSpanFromMillisec 1.5
genTimeSpanFromMillisec 12345.6
genTimeSpanFromMillisec 123456789.8
genTimeSpanFromMillisec 1234567898765.4
genTimeSpanFromMillisec 1000
genTimeSpanFromMillisec 60000
genTimeSpanFromMillisec 3600000
genTimeSpanFromMillisec 86400000
genTimeSpanFromMillisec 1801220200

(*
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
*)

' Example of the TimeSpan.FromMilliseconds( Double ) method.
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

備註

value 參數會轉換成刻度，而該刻度數則用來初始化新的 TimeSpan。因此，value 只會被視為精確到最接近的毫秒。請注意，由於遺失 Double 數據類型的有效位數，此轉換可能會針對接近但仍在 MinValue 或 MaxValue範圍內的值產生 OverflowException。例如，這會導致下列嘗試具現化 TimeSpan 物件中的 OverflowException。

// The following throws an OverflowException at runtime
TimeSpan maxSpan = TimeSpan.FromMilliseconds(TimeSpan.MaxValue.TotalMilliseconds);

// The following throws an OverflowException at runtime
let maxSpan = TimeSpan.FromMilliseconds TimeSpan.MaxValue.TotalMilliseconds

' The following throws an OverflowException at runtime
Dim maxSpan As TimeSpan = TimeSpan.FromMilliseconds(TimeSpan.MaxValue.TotalMilliseconds)

另請參閱

適用於

共用方式為

TimeSpan.FromMilliseconds 方法

定義

多載

FromMilliseconds(Int64, Int64)

參數

傳回

例外狀況

適用於

FromMilliseconds(Double)

參數

傳回

例外狀況

範例

備註

另請參閱

適用於

其他資源