TimeSpan.FromSeconds Método

Definição

Espaço de Nomes:
System
Assemblagens:
mscorlib.dll, System.Runtime.dll
Assemblagens:
netstandard.dll, System.Runtime.dll
Assemblagem:
System.Runtime.dll
Assemblagem:
mscorlib.dll
Assemblagem:
netstandard.dll

Sobrecargas

Name Description
FromSeconds(Double)

Devolve a TimeSpan que representa um número especificado de segundos, onde a especificação é precisa até ao milissegundo mais próximo.
FromSeconds(Int64)

Inicializa uma nova instância da TimeSpan estrutura para um número especificado de segundos.
FromSeconds(Int64, Int64, Int64)

Inicializa uma nova instância da TimeSpan estrutura para um número especificado de segundos, milissegundos e microssegundos.

FromSeconds(Double)

Origem:
TimeSpan.cs
Origem:
TimeSpan.cs
Origem:
TimeSpan.cs
Origem:
TimeSpan.cs
Origem:
TimeSpan.cs

Devolve a TimeSpan que representa um número especificado de segundos, onde a especificação é precisa até ao milissegundo mais próximo.

public:
 static TimeSpan FromSeconds(double value);
public static TimeSpan FromSeconds(double value);
static member FromSeconds : double -> TimeSpan
Public Shared Function FromSeconds (value As Double) As TimeSpan

Parâmetros

value
Double

Um número de segundos, preciso até ao milissegundo mais próximo.

Devoluções

TimeSpan

Um objeto que representa value.

Exceções

OverflowException

value é menor que TimeSpan.MinValue ou maior que TimeSpan.MaxValue.

-ou-

value é PositiveInfinity.

-ou-

value é NegativeInfinity.

ArgumentException

value é igual a NaN.

Exemplos

O exemplo seguinte cria vários TimeSpan objetos usando o FromSeconds método.

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

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

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

        GenTimeSpanFromSeconds( 0.001 );
        GenTimeSpanFromSeconds( 0.0015 );
        GenTimeSpanFromSeconds( 12.3456 );
        GenTimeSpanFromSeconds( 123456.7898 );
        GenTimeSpanFromSeconds( 1234567898.7654 );
        GenTimeSpanFromSeconds( 1 );
        GenTimeSpanFromSeconds( 60 );
        GenTimeSpanFromSeconds( 3600 );
        GenTimeSpanFromSeconds( 86400 );
        GenTimeSpanFromSeconds( 1801220.2 );
    } 
} 

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

          FromSeconds          TimeSpan
          -----------          --------
                0.001          00:00:00.0010000
               0.0015          00:00:00.0020000
              12.3456          00:00:12.3460000
          123456.7898        1.10:17:36.7900000
      1234567898.7654    14288.23:31:38.7650000
                    1          00:00:01
                   60          00:01:00
                 3600          01:00:00
                86400        1.00:00:00
            1801220.2       20.20:20:20.2000000
*/

// Example of the TimeSpan.FromSeconds( double ) method.
open System

let genTimeSpanFromSeconds seconds =
    // Create a TimeSpan object and TimeSpan string from 
    // a number of seconds.
    let interval = TimeSpan.FromSeconds seconds
    let timeInterval = string interval

    // Pad the end of the TimeSpan string with spaces if it 
    // does not contain milliseconds.
    let pIndex = timeInterval.IndexOf ':'
    let pIndex = timeInterval.IndexOf('.', pIndex)
    let timeInterval =
        if pIndex < 0 then timeInterval + "        "
        else timeInterval

    printfn $"{seconds,21}{timeInterval,26}"

printfn "This example of TimeSpan.FromSeconds( double )\ngenerates the following output.\n"
printfn "%21s%18s" "FromSeconds" "TimeSpan"
printfn "%21s%18s" "-----------" "--------"

genTimeSpanFromSeconds 0.001
genTimeSpanFromSeconds 0.0015
genTimeSpanFromSeconds 12.3456
genTimeSpanFromSeconds 123456.7898
genTimeSpanFromSeconds 1234567898.7654
genTimeSpanFromSeconds 1
genTimeSpanFromSeconds 60
genTimeSpanFromSeconds 3600
genTimeSpanFromSeconds 86400
genTimeSpanFromSeconds 1801220.2

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

          FromSeconds          TimeSpan
          -----------          --------
                0.001          00:00:00.0010000
               0.0015          00:00:00.0020000
              12.3456          00:00:12.3460000
          123456.7898        1.10:17:36.7900000
      1234567898.7654    14288.23:31:38.7650000
                    1          00:00:01
                   60          00:01:00
                 3600          01:00:00
                86400        1.00:00:00
            1801220.2       20.20:20:20.2000000
*)

' Example of the TimeSpan.FromSeconds( Double ) method.
Module FromSecondsDemo

    Sub GenTimeSpanFromSeconds( seconds As Double )

        ' Create a TimeSpan object and TimeSpan string from 
        ' a number of seconds.
        Dim interval As TimeSpan = _
            TimeSpan.FromSeconds( seconds )
        Dim timeInterval As String = interval.ToString( )

        ' Pad the end of the TimeSpan string with spaces if it 
        ' does not contain milliseconds.
        Dim pIndex As Integer = timeInterval.IndexOf( ":"c )
        pIndex = timeInterval.IndexOf( "."c, pIndex )
        If pIndex < 0 Then   timeInterval &= "        "

        Console.WriteLine( "{0,21}{1,26}", seconds, timeInterval )
    End Sub 

    Sub Main( )

        Console.WriteLine( "This example of " & _
            "TimeSpan.FromSeconds( Double )" & _
            vbCrLf & "generates the following output." & vbCrLf )
        Console.WriteLine( "{0,21}{1,18}", _
            "FromSeconds", "TimeSpan" )    
        Console.WriteLine( "{0,21}{1,18}", _
            "-----------", "--------" )    

        GenTimeSpanFromSeconds( 0.001 )
        GenTimeSpanFromSeconds( 0.0015 )
        GenTimeSpanFromSeconds( 12.3456 )
        GenTimeSpanFromSeconds( 123456.7898 )
        GenTimeSpanFromSeconds( 1234567898.7654 )
        GenTimeSpanFromSeconds( 1 )
        GenTimeSpanFromSeconds( 60 )
        GenTimeSpanFromSeconds( 3600 )
        GenTimeSpanFromSeconds( 86400 )
        GenTimeSpanFromSeconds( 1801220.2 )
    End Sub
End Module 

' This example of TimeSpan.FromSeconds( Double )
' generates the following output.
' 
'           FromSeconds          TimeSpan
'           -----------          --------
'                 0.001          00:00:00.0010000
'                0.0015          00:00:00.0020000
'               12.3456          00:00:12.3460000
'           123456.7898        1.10:17:36.7900000
'       1234567898.7654    14288.23:31:38.7650000
'                     1          00:00:01
'                    60          00:01:00
'                  3600          01:00:00
'                 86400        1.00:00:00
'             1801220.2       20.20:20:20.2000000

Observações

O value parâmetro é convertido em milissegundos, que é convertido em tiques, e esse número de tiques é usado para inicializar o novo TimeSpan. Portanto, value só será considerado preciso até ao milissegundo mais próximo. Note que, devido à perda de precisão do Double tipo de dado, isto pode gerar um OverflowException para valores que estão próximos mas ainda no intervalo de ou MinValueMaxValue , Esta é a causa de um OverflowException, por exemplo, na tentativa seguinte de instanciar um TimeSpan objeto.

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

// The following throws an OverflowException at runtime
let maxSpan = TimeSpan.FromSeconds TimeSpan.MaxValue.TotalSeconds

' The following throws an OverflowException at runtime
Dim maxSpan As TimeSpan = TimeSpan.FromSeconds(TimeSpan.MaxValue.TotalSeconds)

Ver também

Aplica-se a

FromSeconds(Int64)

Origem:
TimeSpan.cs
Origem:
TimeSpan.cs
Origem:
TimeSpan.cs

Inicializa uma nova instância da TimeSpan estrutura para um número especificado de segundos.

public:
 static TimeSpan FromSeconds(long seconds);
public static TimeSpan FromSeconds(long seconds);
static member FromSeconds : int64 -> TimeSpan
Public Shared Function FromSeconds (seconds As Long) As TimeSpan

Parâmetros

seconds
Int64

Número de segundos.

Devoluções

TimeSpan

Retorna a TimeSpan que representa um número especificado de segundos.

Exceções

ArgumentOutOfRangeException

Os parâmetros especificam um TimeSpan valor menor ou maior que MinValueMaxValue.

Aplica-se a

FromSeconds(Int64, Int64, Int64)

Origem:
TimeSpan.cs
Origem:
TimeSpan.cs
Origem:
TimeSpan.cs

Inicializa uma nova instância da TimeSpan estrutura para um número especificado de segundos, milissegundos e microssegundos.

public static TimeSpan FromSeconds(long seconds, long milliseconds = 0, long microseconds = 0);
static member FromSeconds : int64 * int64 * int64 -> TimeSpan
Public Shared Function FromSeconds (seconds As Long, Optional milliseconds As Long = 0, Optional microseconds As Long = 0) As TimeSpan

Parâmetros

seconds
Int64

Número de segundos.

milliseconds
Int64

Número de milissegundos.

microseconds
Int64

Número de microssegundos.

Devoluções

TimeSpan

Devolve a TimeSpan que representa um número especificado de segundos, milissegundos e microssegundos.

Exceções

ArgumentOutOfRangeException

Os parâmetros especificam um TimeSpan valor menor ou maior que MinValueMaxValue.

Aplica-se a