Auf Englisch lesen

Freigeben über


TimeSpan.FromDays Methode

Definition

Überlädt

FromDays(Double)

Gibt einen TimeSpan zurück, der eine angegebene Anzahl von Tagen darstellt, wobei die Spezifikation auf die nächste Millisekunden genau ist.

FromDays(Int32)

Initialisiert eine neue Instanz der TimeSpan Struktur auf eine angegebene Anzahl von Tagen.

FromDays(Int32, Int32, Int64, Int64, Int64, Int64)

Initialisiert eine neue Instanz der TimeSpan Struktur auf eine bestimmte Anzahl von Tagen, Stunden, Minuten, Sekunden, Millisekunden und Mikrosekunden.

FromDays(Double)

Quelle:
TimeSpan.cs
Quelle:
TimeSpan.cs
Quelle:
TimeSpan.cs

Gibt einen TimeSpan zurück, der eine angegebene Anzahl von Tagen darstellt, wobei die Spezifikation auf die nächste Millisekunden genau ist.

C#
public static TimeSpan FromDays (double value);

Parameter

value
Double

Eine Anzahl von Tagen, genau auf die nächste Millisekunden.

Gibt zurück

Ein Objekt, das valuedarstellt.

Ausnahmen

value ist kleiner als TimeSpan.MinValue oder größer als TimeSpan.MaxValue.

-oder-

value ist PositiveInfinity.

-oder-

value ist NegativeInfinity.

value ist gleich NaN.

Beispiele

Im folgenden Beispiel werden mehrere TimeSpan Objekte mithilfe der FromDays-Methode erstellt.

C#
// Example of the TimeSpan.FromDays( double ) method.
using System;

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

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

        GenTimeSpanFromDays( 0.000000006 );
        GenTimeSpanFromDays( 0.000000017 );
        GenTimeSpanFromDays( 0.000123456 );
        GenTimeSpanFromDays( 1.234567898 );
        GenTimeSpanFromDays( 12345.678987654 );
        GenTimeSpanFromDays( 0.000011574 );
        GenTimeSpanFromDays( 0.000694444 );
        GenTimeSpanFromDays( 0.041666666 );
        GenTimeSpanFromDays( 1 );
        GenTimeSpanFromDays( 20.84745602 );
    } 
} 

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

             FromDays          TimeSpan
             --------          --------
                6E-09          00:00:00.0010000
              1.7E-08          00:00:00.0010000
          0.000123456          00:00:10.6670000
          1.234567898        1.05:37:46.6660000
      12345.678987654    12345.16:17:44.5330000
           1.1574E-05          00:00:01
          0.000694444          00:01:00
          0.041666666          01:00:00
                    1        1.00:00:00
          20.84745602       20.20:20:20.2000000
*/

Hinweise

Der parameter value wird in Millisekunden konvertiert, der in Teilstriche konvertiert wird und diese Anzahl von Teilstrichen verwendet wird, um die neue TimeSpanzu initialisieren. Daher gilt value nur als genau für die nächste Millisekunden. Beachten Sie, dass diese Konvertierung aufgrund des Genauigkeitsverlusts des datentyps "Double" eine OverflowException für Werte verursachen kann, die sich in der Nähe befinden, sich aber weiterhin im Bereich von MinValue oder MaxValuebefinden. Dies führt z. B. zu einem OverflowException im folgenden Versuch, ein TimeSpan-Objekt zu instanziieren.

C#
// The following throws an OverflowException at runtime
TimeSpan maxSpan = TimeSpan.FromDays(TimeSpan.MaxValue.TotalDays);

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.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

FromDays(Int32)

Initialisiert eine neue Instanz der TimeSpan Struktur auf eine angegebene Anzahl von Tagen.

C#
public static TimeSpan FromDays (int days);

Parameter

days
Int32

Anzahl der Tage.

Gibt zurück

Gibt einen TimeSpan zurück, der eine angegebene Anzahl von Tagen darstellt.

Ausnahmen

Die Parameter geben einen TimeSpan Wert an, der kleiner als MinValue oder größer als MaxValue

Gilt für:

.NET 9
Produkt Versionen
.NET 9

FromDays(Int32, Int32, Int64, Int64, Int64, Int64)

Initialisiert eine neue Instanz der TimeSpan Struktur auf eine bestimmte Anzahl von Tagen, Stunden, Minuten, Sekunden, Millisekunden und Mikrosekunden.

C#
public static TimeSpan FromDays (int days, int hours = 0, long minutes = 0, long seconds = 0, long milliseconds = 0, long microseconds = 0);

Parameter

days
Int32

Anzahl der Tage.

hours
Int32

Anzahl der Stunden.

minutes
Int64

Anzahl der Minuten.

seconds
Int64

Anzahl der Sekunden.

milliseconds
Int64

Anzahl der Millisekunden.

microseconds
Int64

Anzahl der Mikrosekunden.

Gibt zurück

Gibt einen TimeSpan zurück, der eine angegebene Anzahl von Tagen, Stunden, Minuten, Sekunden, Millisekunden und Mikrosekunden darstellt.

Ausnahmen

Die Parameter geben einen TimeSpan Wert an, der kleiner als MinValue oder größer als MaxValue

Gilt für:

.NET 9
Produkt Versionen
.NET 9