TimeSpan.FromHours メソッド

定義

名前空間:

System

アセンブリ:

System.Runtime.dll

オーバーロード

FromHours(Double)

指定した時間数を表す TimeSpan を返します。指定は最も近いミリ秒に正確です。

FromHours(Double)

ソース:

TimeSpan.cs

指定した時間数を表す TimeSpan を返します。指定は最も近いミリ秒に正確です。

C#

public static TimeSpan FromHours (double value);

パラメーター

value

Double

最も近いミリ秒に正確な時間数。

戻り値

TimeSpan

valueを表すオブジェクト。

例外

OverflowException

が TimeSpan.MinValue より小さいか、TimeSpan.MaxValueより大きい値です。

-又は-

value は PositiveInfinityです。

-又は-

value は NegativeInfinityです。

ArgumentException

value は NaNと等しくなります。

例

次の例では、FromHours メソッドを使用して複数の TimeSpan オブジェクトを作成します。

C#

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

注釈

value パラメーターはミリ秒に変換され、ティックに変換され、そのティック数を使用して新しい TimeSpanを初期化します。 したがって、value は最も近いミリ秒に対してのみ正確と見なされます。 Double データ型の精度が失われるため、この変換により、MinValue または MaxValueの範囲内にある値の OverflowException が生成される可能性があることに注意してください。 たとえば、次の試行で TimeSpan オブジェクトをインスタンス化しようとすると、OverflowException が発生します。

C#

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

こちらもご覧ください

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