Export (0) Print
Expand All

TimeSpan.FromHours Method

Returns a TimeSpan that represents a specified number of hours, where the specification is accurate to the nearest millisecond.

Namespace: System
Assembly: mscorlib (in mscorlib.dll)

public static TimeSpan FromHours (
	double value
)
public static TimeSpan FromHours (
	double value
)
public static function FromHours (
	value : double
) : TimeSpan

Parameters

value

A number of hours accurate to the nearest millisecond.

Return Value

A TimeSpan that represents value.

Exception typeCondition

OverflowException

value is less than MinValue or greater than MaxValue.

ArgumentException

value is equal to Double.NaN.

The value parameter is converted to milliseconds, which is converted to ticks, and that number of ticks is used to intialize the new TimeSpan. Therefore, value will only be considered accurate to the nearest millisecond.

If value is Double.PositiveInfinity, MaxValue is returned. If value is Double.NegativeInfinity, MinValue is returned.

The following code example creates several TimeSpan objects using the FromHours method.

// 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.
import 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}", new Object[] { (System.Double)hours,
                timeInterval });
    } //GenTimeSpanFromHours

    public static void main(String[] args)
    {
        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(2E-07);
        GenTimeSpanFromHours(3E-07);
        GenTimeSpanFromHours(0.0012345);
        GenTimeSpanFromHours(12.3456789);
        GenTimeSpanFromHours(123456.7898765);
        GenTimeSpanFromHours(0.0002777);
        GenTimeSpanFromHours(0.0166666);
        GenTimeSpanFromHours(1);
        GenTimeSpanFromHours(24);
        GenTimeSpanFromHours(500.3389445);
    } //main
} //FromHoursDemo

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

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

Community Additions

ADD
Show:
© 2014 Microsoft