Ler em inglês

Compartilhar via


TimeSpan.FromSeconds Método

Definição

Sobrecargas

FromSeconds(Double)

Retorna um TimeSpan que representa um número especificado de segundos, em que a especificação é precisa para o milissegundo mais próximo.

FromSeconds(Int64)

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

FromSeconds(Int64, Int64, Int64)

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

FromSeconds(Double)

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

Retorna um TimeSpan que representa um número especificado de segundos, em que a especificação é precisa para o milissegundo mais próximo.

C#
public static TimeSpan FromSeconds (double value);

Parâmetros

value
Double

Um número de segundos, preciso para o milissegundo mais próximo.

Retornos

Um objeto que representa value.

Exceções

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

-ou-

value é PositiveInfinity.

-ou-

value é NegativeInfinity.

value é igual a NaN.

Exemplos

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

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

Comentários

O parâmetro value é convertido em milissegundos, que é convertido em tiques e esse número de tiques é usado para inicializar o novo TimeSpan. Portanto, value só será considerada precisa para o milissegundo mais próximo. Observe que, devido à perda de precisão do tipo de dados Double, isso pode gerar uma OverflowException para valores próximos, mas ainda no intervalo de MinValue ou MaxValue, essa é a causa de um OverflowException, por exemplo, na tentativa a seguir de instanciar um objeto TimeSpan.

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

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.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

FromSeconds(Int64)

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

C#
public static TimeSpan FromSeconds (long seconds);

Parâmetros

seconds
Int64

Número de segundos.

Retornos

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

Exceções

Os parâmetros especificam um valor de TimeSpan menor que MinValue ou maior que MaxValue.

Aplica-se a

.NET 9
Produto Versões
.NET 9

FromSeconds(Int64, Int64, Int64)

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

C#
public static TimeSpan FromSeconds (long seconds, long milliseconds = 0, long microseconds = 0);

Parâmetros

seconds
Int64

Número de segundos.

milliseconds
Int64

Número de milissegundos.

microseconds
Int64

Número de microssegundos.

Retornos

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

Exceções

Os parâmetros especificam um valor de TimeSpan menor que MinValue ou maior que MaxValue.

Aplica-se a

.NET 9
Produto Versões
.NET 9