TimeSpan.FromMinutes 方法

定義

多載

FromMinutes(Int64)

TimeSpan 結構的新實例初始化為指定的分鐘數。

FromMinutes(Int64, Int64, Int64, Int64)

TimeSpan 結構的新實例初始化為指定的分鐘、秒、毫秒和微秒數。

FromMinutes(Double)

傳回代表指定分鐘數的 TimeSpan,其中規格精確到最接近毫秒。

FromMinutes(Int64)

TimeSpan 結構的新實例初始化為指定的分鐘數。

public static TimeSpan FromMinutes (long minutes);

參數

minutes
Int64

分鐘數。

傳回

傳回代表指定分鐘數的 TimeSpan

例外狀況

參數會指定小於 MinValue 或大於 MaxValueTimeSpan

適用於

.NET 9
產品 版本
.NET 9

FromMinutes(Int64, Int64, Int64, Int64)

TimeSpan 結構的新實例初始化為指定的分鐘、秒、毫秒和微秒數。

public static TimeSpan FromMinutes (long minutes, long seconds = 0, long milliseconds = 0, long microseconds = 0);

參數

minutes
Int64

分鐘數。

seconds
Int64

秒數。

milliseconds
Int64

毫秒數。

microseconds
Int64

微秒數。

傳回

會傳回 TimeSpan,代表指定的分鐘數、秒數、毫秒數和微秒數。

例外狀況

參數會指定小於 MinValue 或大於 MaxValueTimeSpan

適用於

.NET 9
產品 版本
.NET 9

FromMinutes(Double)

來源:
TimeSpan.cs
來源:
TimeSpan.cs
來源:
TimeSpan.cs

傳回代表指定分鐘數的 TimeSpan,其中規格精確到最接近毫秒。

public static TimeSpan FromMinutes (double value);

參數

value
Double

精確到最接近毫秒的分鐘數。

傳回

物件,表示 value

例外狀況

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

-或-

value PositiveInfinity

-或-

value NegativeInfinity

value 等於 NaN

範例

下列範例會使用 FromMinutes 方法建立數個 TimeSpan 物件。

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

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

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

        GenTimeSpanFromMinutes( 0.00001 );
        GenTimeSpanFromMinutes( 0.00002 );
        GenTimeSpanFromMinutes( 0.12345 );
        GenTimeSpanFromMinutes( 1234.56789 );
        GenTimeSpanFromMinutes( 12345678.98765 );
        GenTimeSpanFromMinutes( 0.01666 );
        GenTimeSpanFromMinutes( 1 );
        GenTimeSpanFromMinutes( 60 );
        GenTimeSpanFromMinutes( 1440 );
        GenTimeSpanFromMinutes( 30020.33667 );
    } 
} 

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

          FromMinutes          TimeSpan
          -----------          --------
                1E-05          00:00:00.0010000
                2E-05          00:00:00.0010000
              0.12345          00:00:07.4070000
           1234.56789          20:34:34.0730000
       12345678.98765     8573.09:18:59.2590000
              0.01666          00:00:01
                    1          00:01:00
                   60          01:00:00
                 1440        1.00:00:00
          30020.33667       20.20:20:20.2000000
*/

備註

value 參數會轉換成毫秒,它會轉換成刻度,而該刻度數則用來初始化新的 TimeSpan。 因此,value 只會被視為精確到最接近的毫秒。 請注意,由於遺失 Double 數據類型的有效位數,此轉換可能會針對接近但仍在 MinValueMaxValue範圍內的值產生 OverflowException。 例如,這會導致下列嘗試具現化 TimeSpan 物件中的 OverflowException

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

另請參閱

適用於

.NET 9 及其他版本
產品 版本
.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