TimeSpan.FromSeconds 方法

定義

命名空間:

System

組件:

System.Runtime.dll

多載

FromSeconds(Double)

會傳回代表指定秒數的 TimeSpan，其中規格精確到最接近毫秒。

FromSeconds(Double)

來源:

TimeSpan.cs

會傳回代表指定秒數的 TimeSpan，其中規格精確到最接近毫秒。

C#

public static TimeSpan FromSeconds (double value);

參數

value

Double

秒數，精確到最接近毫秒。

傳回

TimeSpan

物件，表示 value。

例外狀況

OverflowException

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

-或-

value PositiveInfinity。

-或-

value NegativeInfinity。

ArgumentException

value 等於 NaN。

範例

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

C#

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

class FromSecondsDemo
{
    static void GenTimeSpanFromSeconds( double seconds )
    {
        // Create a TimeSpan object and TimeSpan string from 
        // a number of seconds.
        TimeSpan    interval = TimeSpan.FromSeconds( seconds );
        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}", seconds, timeInterval );
    } 

    static void Main( )
    {
        Console.WriteLine(
            "This example of TimeSpan.FromSeconds( double )\n" +
            "generates the following output.\n" );
        Console.WriteLine( "{0,21}{1,18}",
            "FromSeconds", "TimeSpan" );
        Console.WriteLine( "{0,21}{1,18}", 
            "-----------", "--------" );

        GenTimeSpanFromSeconds( 0.001 );
        GenTimeSpanFromSeconds( 0.0015 );
        GenTimeSpanFromSeconds( 12.3456 );
        GenTimeSpanFromSeconds( 123456.7898 );
        GenTimeSpanFromSeconds( 1234567898.7654 );
        GenTimeSpanFromSeconds( 1 );
        GenTimeSpanFromSeconds( 60 );
        GenTimeSpanFromSeconds( 3600 );
        GenTimeSpanFromSeconds( 86400 );
        GenTimeSpanFromSeconds( 1801220.2 );
    } 
} 

/*
This example of TimeSpan.FromSeconds( double )
generates the following output.

          FromSeconds          TimeSpan
          -----------          --------
                0.001          00:00:00.0010000
               0.0015          00:00:00.0020000
              12.3456          00:00:12.3460000
          123456.7898        1.10:17:36.7900000
      1234567898.7654    14288.23:31:38.7650000
                    1          00:00:01
                   60          00:01:00
                 3600          01:00:00
                86400        1.00:00:00
            1801220.2       20.20:20:20.2000000
*/

備註

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

C#

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

另請參閱

• Double
• FromTicks(Int64)
• FromMilliseconds(Double)
• FromMinutes(Double)
• FromHours(Double)
• FromDays(Double)