TimeSpan.FromHours Metoda

Definicja

Przeciążenia

FromHours(Double)

Zwraca TimeSpan reprezentującą określoną liczbę godzin, gdzie specyfikacja jest dokładna do najbliższej milisekundy.

FromHours(Int32)

Inicjuje nowe wystąpienie struktury TimeSpan do określonej liczby godzin.

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

Inicjuje nowe wystąpienie struktury TimeSpan do określonej liczby godzin, minut, sekund, milisekund i mikrosekund.

FromHours(Double)

Źródło:
TimeSpan.cs
Źródło:
TimeSpan.cs
Źródło:
TimeSpan.cs

Zwraca TimeSpan reprezentującą określoną liczbę godzin, gdzie specyfikacja jest dokładna do najbliższej milisekundy.

public static TimeSpan FromHours (double value);

Parametry

value
Double

Liczba godzin dokładności do najbliższej milisekundy.

Zwraca

Obiekt reprezentujący value.

Wyjątki

value jest mniejsza niż TimeSpan.MinValue lub większa niż TimeSpan.MaxValue.

-lub-

value jest PositiveInfinity.

-lub-

value jest NegativeInfinity.

value jest równa NaN.

Przykłady

Poniższy przykład tworzy kilka obiektów TimeSpan przy użyciu metody 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
*/

Uwagi

Parametr value jest konwertowany na milisekundy, który jest konwertowany na znaczniki, a ta liczba kleszczy jest używana do inicjowania nowego TimeSpan. W związku z tym value zostaną uznane za dokładne tylko dla najbliższej milisekundy. Należy pamiętać, że ze względu na utratę dokładności typu danych Double ta konwersja może wygenerować OverflowException dla wartości zbliżonych do, ale nadal w zakresie MinValue lub MaxValue. Na przykład powoduje to OverflowException w poniższej próbie utworzenia wystąpienia obiektu TimeSpan.

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

Zobacz też

Dotyczy

.NET 9 i inne wersje
Produkt Wersje
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

FromHours(Int32)

Inicjuje nowe wystąpienie struktury TimeSpan do określonej liczby godzin.

public static TimeSpan FromHours (int hours);

Parametry

hours
Int32

Liczba godzin.

Zwraca

Zwraca TimeSpan reprezentującą określoną liczbę godzin.

Wyjątki

Parametry określają wartość TimeSpan mniejszą niż MinValue lub większą niż MaxValue

Dotyczy

.NET 9
Produkt Wersje
.NET 9

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

Inicjuje nowe wystąpienie struktury TimeSpan do określonej liczby godzin, minut, sekund, milisekund i mikrosekund.

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

Parametry

hours
Int32

Liczba godzin.

minutes
Int64

Liczba minut.

seconds
Int64

Liczba sekund.

milliseconds
Int64

Liczba milisekund.

microseconds
Int64

Liczba mikrosekund.

Zwraca

Zwraca TimeSpan reprezentującą określoną liczbę godzin, minut, sekund, milisekund i mikrosekund.

Wyjątki

Parametry określają wartość TimeSpan mniejszą niż MinValue lub większą niż MaxValue

Dotyczy

.NET 9
Produkt Wersje
.NET 9