Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

TimeSpan.FromSeconds Method

Definition

Namespace:
System
Assemblies:
mscorlib.dll, System.Runtime.dll
Assemblies:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Overloads

Name Description
FromSeconds(Double)

Returns a TimeSpan that represents a specified number of seconds, where the specification is accurate to the nearest millisecond.

FromSeconds(Int64)

Initializes a new instance of the TimeSpan structure to a specified number of seconds.

FromSeconds(Int64, Int64, Int64)

Initializes a new instance of the TimeSpan structure to a specified number of seconds, milliseconds, and microseconds.

FromSeconds(Double)

Source:
TimeSpan.cs
Source:
TimeSpan.cs
Source:
TimeSpan.cs
Source:
TimeSpan.cs
Source:
TimeSpan.cs

Returns a TimeSpan that represents a specified number of seconds, where the specification is accurate to the nearest millisecond.

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

Parameters

value
Double

A number of seconds, accurate to the nearest millisecond.

Returns

An object that represents value.

Exceptions

value is less than TimeSpan.MinValue or greater than TimeSpan.MaxValue.

-or-

value is PositiveInfinity.

-or-

value is NegativeInfinity.

value is equal to NaN.

Examples

The following example creates several TimeSpan objects using the FromSeconds method.

// 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

Remarks

The value parameter is converted to milliseconds, which is converted to ticks, and that number of ticks is used to initialize the new TimeSpan. Therefore, value will only be considered accurate to the nearest millisecond. Note that, because of the loss of precision of the Double data type, this can generate an OverflowException for values that are near but still in the range of either MinValue or MaxValue, This is the cause of an OverflowException, for example, in the following attempt to instantiate a TimeSpan object.

// 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)

See also

Applies to

FromSeconds(Int64)

Source:
TimeSpan.cs
Source:
TimeSpan.cs
Source:
TimeSpan.cs

Initializes a new instance of the TimeSpan structure to a specified number of seconds.

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

Parameters

seconds
Int64

Number of seconds.

Returns

Returns a TimeSpan that represents a specified number of seconds.

Exceptions

The parameters specify a TimeSpan value less than MinValue or greater than MaxValue.

Applies to

FromSeconds(Int64, Int64, Int64)

Source:
TimeSpan.cs
Source:
TimeSpan.cs
Source:
TimeSpan.cs

Initializes a new instance of the TimeSpan structure to a specified number of seconds, milliseconds, and microseconds.

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

Parameters

seconds
Int64

Number of seconds.

milliseconds
Int64

Number of milliseconds.

microseconds
Int64

Number of microseconds.

Returns

Returns a TimeSpan that represents a specified number of seconds, milliseconds, and microseconds.

Exceptions

The parameters specify a TimeSpan value less than MinValue or greater than MaxValue.

Applies to


Feedback

Was this page helpful?