This documentation is archived and is not being maintained.

TimeSpan Constructor (Int32, Int32, Int32)

Initializes a new TimeSpan to a specified number of hours, minutes, and seconds.

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

public:
TimeSpan(
	int hours, 
	int minutes, 
	int seconds
)

Parameters

hours
Type: System::Int32
Number of hours.
minutes
Type: System::Int32
Number of minutes.
seconds
Type: System::Int32
Number of seconds.

ExceptionCondition
ArgumentOutOfRangeException

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

The specified hours, minutes, and seconds are converted to ticks, and that value initializes this instance.

The following example creates several TimeSpan objects using the constructor overload that initializes a TimeSpan to a specified number of hours, minutes, and seconds.


// Example of the TimeSpan( int, int, int ) constructor.
using namespace System;

// Create a TimeSpan object and display its value.
static void CreateTimeSpan( int hours, int minutes, int seconds )
{
   TimeSpan elapsedTime = TimeSpan(hours,minutes,seconds);

   // Format the constructor for display.
   String^ ctor = String::Format( "TimeSpan( {0}, {1}, {2} )", hours, minutes, seconds );

   // Display the constructor and its value.
   Console::WriteLine( "{0,-37}{1,16}", ctor, elapsedTime.ToString() );
}

int main()
{
   Console::WriteLine( "This example of the TimeSpan( int, int, int ) "
   "\nconstructor generates the following output.\n" );
   Console::WriteLine( "{0,-37}{1,16}", "Constructor", "Value" );
   Console::WriteLine( "{0,-37}{1,16}", "-----------", "-----" );
   CreateTimeSpan( 10, 20, 30 );
   CreateTimeSpan(  -10, 20, 30 );
   CreateTimeSpan( 0, 0, 37230 );
   CreateTimeSpan( 1000, 2000, 3000 );
   CreateTimeSpan( 1000, -2000, -3000 );
   CreateTimeSpan( 999999, 999999, 999999 );
}

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

Constructor                                     Value
-----------                                     -----
TimeSpan( 10, 20, 30 )                       10:20:30
TimeSpan( -10, 20, 30 )                     -09:39:30
TimeSpan( 0, 0, 37230 )                      10:20:30
TimeSpan( 1000, 2000, 3000 )              43.02:10:00
TimeSpan( 1000, -2000, -3000 )            40.05:50:00
TimeSpan( 999999, 999999, 999999 )     42372.15:25:39
*/


.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: