TimeSpan Constructor (Int32, Int32, Int32)

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

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

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

Syntax

Public Sub New ( _
    hours As Integer, _
    minutes As Integer, _
    seconds As Integer _
)
public TimeSpan(
    int hours,
    int minutes,
    int seconds
)

Parameters

Exceptions

Exception Condition
ArgumentOutOfRangeException

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

Remarks

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

Examples

The following code 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( Integer, Integer, Integer ) constructor.

Module Example

   ' Create a TimeSpan object and display its value.
   Sub CreateTimeSpan(ByVal outputBlock As System.Windows.Controls.TextBlock, ByVal hours As Integer, ByVal minutes As Integer, _
       ByVal seconds As Integer)

      Dim elapsedTime As New TimeSpan(hours, minutes, seconds)

      ' Format the constructor for display.
      Dim ctor As String = _
          String.Format("TimeSpan( {0}, {1}, {2} )", _
              hours, minutes, seconds)

      ' Display the constructor and its value.
      outputBlock.Text &= String.Format("{0,-37}{1,16}", _
          ctor, elapsedTime.ToString()) & vbCrLf
   End Sub

   Public Sub Demo(ByVal outputBlock As System.Windows.Controls.TextBlock)

      outputBlock.Text &= _
          "This example of the " & _
          "TimeSpan( Integer, Integer, Integer ) " & vbCrLf & _
          "constructor generates the following output." & vbCrLf & vbCrLf
      outputBlock.Text &= String.Format("{0,-37}{1,16}", "Constructor", "Value") & vbCrLf
      outputBlock.Text &= String.Format("{0,-37}{1,16}", "-----------", "-----") & vbCrLf

      CreateTimeSpan(outputBlock, 10, 20, 30)
      CreateTimeSpan(outputBlock, -10, 20, 30)
      CreateTimeSpan(outputBlock, 0, 0, 37230)
      CreateTimeSpan(outputBlock, 1000, 2000, 3000)
      CreateTimeSpan(outputBlock, 1000, -2000, -3000)
      CreateTimeSpan(outputBlock, 999999, 999999, 999999)
   End Sub
End Module

' This example of the TimeSpan( Integer, Integer, Integer )
' 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
// Example of the TimeSpan( int, int, int ) constructor.
using System;

class Example
{
   // Create a TimeSpan object and display its value.
   static void CreateTimeSpan(System.Windows.Controls.TextBlock outputBlock, int hours, int minutes,
       int seconds)
   {
      TimeSpan elapsedTime =
          new 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.
      outputBlock.Text += String.Format("{0,-37}{1,16}\n",
          ctor, elapsedTime.ToString());
   }

   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
   {
      outputBlock.Text +=
          "This example of the TimeSpan( int, int, int ) " +
          "\nconstructor generates the following output.\n" + "\n";
      outputBlock.Text += String.Format("{0,-37}{1,16}", "Constructor", "Value") + "\n";
      outputBlock.Text += String.Format("{0,-37}{1,16}", "-----------", "-----") + "\n";

      CreateTimeSpan(outputBlock, 10, 20, 30);
      CreateTimeSpan(outputBlock, -10, 20, 30);
      CreateTimeSpan(outputBlock, 0, 0, 37230);
      CreateTimeSpan(outputBlock, 1000, 2000, 3000);
      CreateTimeSpan(outputBlock, 1000, -2000, -3000);
      CreateTimeSpan(outputBlock, 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
*/

Version Information

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Platforms

Windows Phone

See Also

Reference

TimeSpan Structure

TimeSpan Overload

System Namespace

Int64