TimeSpan.FromHours 方法

定義

命名空間:

System

組件:

netstandard.dll, System.Runtime.dll

多載

名稱	Description
FromHours(Double)	回傳 a TimeSpan 代表指定小時數，且規格精確至最接近毫秒。
FromHours(Int32)	初始化結構的新實例 TimeSpan 到指定小時數。
FromHours(Int32, Int64, Int64, Int64, Int64)	將結構的新實例 TimeSpan 初始化為指定的小時、分鐘、秒、毫秒及微秒。

FromHours(Double)

來源:

TimeSpan.cs

回傳 a TimeSpan 代表指定小時數，且規格精確至最接近毫秒。

public:
 static TimeSpan FromHours(double value);

public static TimeSpan FromHours(double value);

static member FromHours : double -> TimeSpan

Public Shared Function FromHours (value As Double) As TimeSpan

參數

value

Double

精確到最接近毫秒的小時數。

傳回

TimeSpan

一個代表 value的物件。

例外狀況

OverflowException

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

-或-

value 是 PositiveInfinity。

-或-

value 是 NegativeInfinity。

ArgumentException

value 等於 NaN。

範例

以下範例使用此TimeSpan方法創建多個FromHours物件。

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

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

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

        GenTimeSpanFromHours( 0.0000002 );
        GenTimeSpanFromHours( 0.0000003 );
        GenTimeSpanFromHours( 0.0012345 );
        GenTimeSpanFromHours( 12.3456789 );
        GenTimeSpanFromHours( 123456.7898765 );
        GenTimeSpanFromHours( 0.0002777 );
        GenTimeSpanFromHours( 0.0166666 );
        GenTimeSpanFromHours( 1 );
        GenTimeSpanFromHours( 24 );
        GenTimeSpanFromHours( 500.3389445 );
    } 
} 

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

            FromHours          TimeSpan
            ---------          --------
                2E-07          00:00:00.0010000
                3E-07          00:00:00.0010000
            0.0012345          00:00:04.4440000
           12.3456789          12:20:44.4440000
       123456.7898765     5144.00:47:23.5550000
            0.0002777          00:00:01
            0.0166666          00:01:00
                    1          01:00:00
                   24        1.00:00:00
          500.3389445       20.20:20:20.2000000
*/

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

let genTimeSpanFromHours hours =
    // Create a TimeSpan object and TimeSpan string from 
    // a number of hours.
    let interval = TimeSpan.FromHours hours
    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 $"{hours,21}{timeInterval,26}"

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

genTimeSpanFromHours 0.0000002
genTimeSpanFromHours 0.0000003
genTimeSpanFromHours 0.0012345
genTimeSpanFromHours 12.3456789
genTimeSpanFromHours 123456.7898765
genTimeSpanFromHours 0.0002777
genTimeSpanFromHours 0.0166666
genTimeSpanFromHours 1
genTimeSpanFromHours 24
genTimeSpanFromHours 500.3389445

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

            FromHours          TimeSpan
            ---------          --------
                2E-07          00:00:00.0010000
                3E-07          00:00:00.0010000
            0.0012345          00:00:04.4440000
           12.3456789          12:20:44.4440000
       123456.7898765     5144.00:47:23.5550000
            0.0002777          00:00:01
            0.0166666          00:01:00
                    1          01:00:00
                   24        1.00:00:00
          500.3389445       20.20:20:20.2000000
*)

' Example of the TimeSpan.FromHours( Double ) method.
Module FromHoursDemo

    Sub GenTimeSpanFromHours( hours As Double )

        ' Create a TimeSpan object and TimeSpan string from 
        ' a number of hours.
        Dim interval As TimeSpan = _
            TimeSpan.FromHours( hours )
        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}", hours, timeInterval )
    End Sub 

    Sub Main( )

        Console.WriteLine( "This example of " & _
            "TimeSpan.FromHours( Double )" & _
            vbCrLf & "generates the following output." & vbCrLf )
        Console.WriteLine( "{0,21}{1,18}", _
            "FromHours", "TimeSpan" )    
        Console.WriteLine( "{0,21}{1,18}", _
            "---------", "--------" )    

        GenTimeSpanFromHours( 0.0000002 )
        GenTimeSpanFromHours( 0.0000003 )
        GenTimeSpanFromHours( 0.0012345 )
        GenTimeSpanFromHours( 12.3456789 )
        GenTimeSpanFromHours( 123456.7898765 )
        GenTimeSpanFromHours( 0.0002777 )
        GenTimeSpanFromHours( 0.0166666 )
        GenTimeSpanFromHours( 1 )
        GenTimeSpanFromHours( 24 )
        GenTimeSpanFromHours( 500.3389445 )
    End Sub 
End Module 

' This example of TimeSpan.FromHours( Double )
' generates the following output.
' 
'             FromHours          TimeSpan
'             ---------          --------
'                 2E-07          00:00:00.0010000
'                 3E-07          00:00:00.0010000
'             0.0012345          00:00:04.4440000
'            12.3456789          12:20:44.4440000
'        123456.7898765     5144.00:47:23.5550000
'             0.0002777          00:00:01
'             0.0166666          00:01:00
'                     1          01:00:00
'                    24        1.00:00:00
'           500.3389445       20.20:20:20.2000000

備註

value參數轉換為毫秒，毫秒再轉換為刻數，該刻數用來初始化新的 TimeSpan。 因此，僅 value 被視為精確到最接近毫秒的精度。 請注意，由於資料型別 Double 精度的損失，此轉換可能產生 OverflowException 一個 ，該值接近但仍在 或 MinValueMaxValue範圍內。 例如，這會導致以下 OverflowException 嘗試實例化物件 TimeSpan 。

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

// The following throws an OverflowException at runtime
let maxSpan = TimeSpan.FromHours TimeSpan.MaxValue.TotalHours

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

另請參閱

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

FromHours(Int32)

來源:

TimeSpan.cs

初始化結構的新實例 TimeSpan 到指定小時數。

public:
 static TimeSpan FromHours(int hours);

public static TimeSpan FromHours(int hours);

static member FromHours : int -> TimeSpan

Public Shared Function FromHours (hours As Integer) As TimeSpan

參數

hours

Int32

時數。

傳回

TimeSpan

回傳代表指定小時數的 a TimeSpan 。

例外狀況

ArgumentOutOfRangeException

參數指定一個 TimeSpan 小於 MinValue 或大於的值 MaxValue

FromHours(Int32, Int64, Int64, Int64, Int64)

來源:

TimeSpan.cs

將結構的新實例 TimeSpan 初始化為指定的小時、分鐘、秒、毫秒及微秒。

public static TimeSpan FromHours(int hours, long minutes = 0, long seconds = 0, long milliseconds = 0, long microseconds = 0);

static member FromHours : int * int64 * int64 * int64 * int64 -> TimeSpan

Public Shared Function FromHours (hours As Integer, Optional minutes As Long = 0, Optional seconds As Long = 0, Optional milliseconds As Long = 0, Optional microseconds As Long = 0) As TimeSpan

參數

hours

Int32

時數。

minutes

Int64

分鐘數。

seconds

Int64

秒數。

milliseconds

Int64

毫秒數。

microseconds

Int64

微秒數。

傳回

TimeSpan

回傳代表指定小時、分鐘、秒、毫秒及微秒數的 a TimeSpan 。

例外狀況

ArgumentOutOfRangeException

參數指定一個 TimeSpan 小於 MinValue 或大於的值 MaxValue