This documentation is archived and is not being maintained.

TimeSpan.TimeSpan(Int64) Constructor

Initializes a new TimeSpan to the specified number of ticks.

Namespace: System
Assembly: mscorlib (in mscorlib.dll)

public TimeSpan (
	long ticks
)
public TimeSpan (
	long ticks
)
public function TimeSpan (
	ticks : long
)
Not applicable.

Parameters

ticks

A time period expressed in 100-nanosecond units.

The following code example creates several TimeSpan objects using the constructor overload that initializes a TimeSpan to a specified number of ticks.

// Example of the TimeSpan( long ) constructor.
using System;

class TimeSpanCtorLDemo
{
    // Create a TimeSpan object and display its value.
    static void CreateTimeSpan( long ticks )
    {
        TimeSpan elapsedTime = new TimeSpan( ticks );

        // Format the constructor for display.
        string ctor = String.Format( "TimeSpan( {0} )", ticks );

        // Pad the end of a TimeSpan string with spaces if
        // it does not contain milliseconds.
        string  elapsedStr = elapsedTime.ToString( );
        int     pointIndex = elapsedStr.IndexOf( ':' );

        pointIndex = elapsedStr.IndexOf( '.', pointIndex );
        if( pointIndex < 0 ) elapsedStr += "        ";

        // Display the constructor and its value.
        Console.WriteLine( "{0,-33}{1,24}", ctor, elapsedStr );
    }
    
    static void Main( )
    {
        Console.WriteLine( 
            "This example of the TimeSpan( long ) constructor " +
            "\ngenerates the following output.\n" );
        Console.WriteLine( "{0,-33}{1,16}", "Constructor", "Value" );
        Console.WriteLine( "{0,-33}{1,16}", "-----------", "-----" );

        CreateTimeSpan( 1 );                
        CreateTimeSpan( 999999 );                
        CreateTimeSpan( -1000000000000 );        
        CreateTimeSpan( 18012202000000 );        
        CreateTimeSpan( 999999999999999999 );    
        CreateTimeSpan( 1000000000000000000 );   
    } 
} 

/*
This example of the TimeSpan( long ) constructor
generates the following output.

Constructor                                 Value
-----------                                 -----
TimeSpan( 1 )                            00:00:00.0000001
TimeSpan( 999999 )                       00:00:00.0999999
TimeSpan( -1000000000000 )            -1.03:46:40
TimeSpan( 18012202000000 )            20.20:20:20.2000000
TimeSpan( 999999999999999999 )   1157407.09:46:39.9999999
TimeSpan( 1000000000000000000 )  1157407.09:46:40
*/

// Example of the TimeSpan( long ) constructor.
import System.*;

class TimeSpanCtorLDemo
{
    // Create a TimeSpan object and display its value.
    static void CreateTimeSpan(long ticks)
    {
        TimeSpan elapsedTime = new TimeSpan(ticks);

        // Format the constructor for display.
        String ctor = String.Format("TimeSpan( {0} )", String.valueOf(ticks));

        // Pad the end of a TimeSpan string with spaces if
        // it does not contain milliseconds.
        String elapsedStr = elapsedTime.ToString();
        int pointIndex = elapsedStr.IndexOf(':');
        pointIndex = elapsedStr.IndexOf('.', pointIndex);
        if (pointIndex < 0) {
            elapsedStr += "        ";
        }

        // Display the constructor and its value.
        Console.WriteLine("{0,-33}{1,24}", ctor, elapsedStr);
    } //CreateTimeSPan

    public static void main(String[] args)
    {
        Console.WriteLine(("This example of the TimeSpan( long ) constructor "
            + "\ngenerates the following output.\n"));
        Console.WriteLine("{0,-33}{1,16}", "Constructor", "Value");
        Console.WriteLine("{0,-33}{1,16}", "-----------", "-----");
        CreateTimeSpan(1);
        CreateTimeSpan(999999);
        CreateTimeSpan(-1000000000000L);
        CreateTimeSpan(18012202000000L);
        CreateTimeSpan(999999999999999999L);
        CreateTimeSpan(1000000000000000000L);
    } //main
} //TimeSpanCtorLDemo

/*
This example of the TimeSpan( long ) constructor
generates the following output.

Constructor                                 Value
-----------                                 -----
TimeSpan( 1 )                            00:00:00.0000001
TimeSpan( 999999 )                       00:00:00.0999999
TimeSpan( -1000000000000 )            -1.03:46:40
TimeSpan( 18012202000000 )            20.20:20:20.2000000
TimeSpan( 999999999999999999 )   1157407.09:46:39.9999999
TimeSpan( 1000000000000000000 )  1157407.09:46:40
*/

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

XNA Framework

Supported in: 1.0
Show: