TimeSpan Constructor (Int32, Int32, Int32)

 

Initializes a new instance of the TimeSpan structure 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.

Exception Condition
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
*/

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
Show: