Export (0) Print
Expand All

TimeSpan Addition Operator

Adds two specified TimeSpan instances.

[Visual Basic]
returnValue = TimeSpan.op_Addition(t1, t2)
[C#]
public static TimeSpan operator +(
 TimeSpan t1,
 TimeSpan t2
);
[C++]
public: static TimeSpan op_Addition(
 TimeSpan t1,
 TimeSpan t2
);
[JScript]
returnValue = t1 + t2;

[Visual Basic] In Visual Basic, you can use the operators defined by a type, but you cannot define your own. You can use the Add method instead of the TimeSpan addition operator.

[JScript] In JScript, you can use the operators defined by a type, but you cannot define your own.

Arguments [Visual Basic, JScript]

t1
A TimeSpan.
t2
A TimeSpan.

Parameters [C#, C++]

t1
A TimeSpan.
t2
A TimeSpan.

Return Value

A TimeSpan whose value is the sum of the values of t1 and t2.

Exceptions

Exception Type Condition
OverflowException The resulting TimeSpan is less than MinValue or greater than MaxValue.

Example

[Visual Basic, C#, C++] The following code example creates several pairs of TimeSpan objects and calculates their sum with the Addition operator.

[Visual Basic] 
' Example of the TimeSpan Addition and Subtraction operators.
Imports System
Imports Microsoft.VisualBasic

Module TimeSpanAddSubOpsDemo
    
    Const dataFmt As String = "{0,-38}{1,24}"

    ' Pad the end of a TimeSpan string with spaces if it does not 
    ' contain milliseconds.
    Function Align( interval As TimeSpan ) As String

        Dim intervalStr As String = interval.ToString( )
        Dim pointIndex  As Integer = intervalStr.IndexOf( ":"c )

        pointIndex = intervalStr.IndexOf( "."c, pointIndex )
        If pointIndex < 0 Then intervalStr &= "        "
        Align = intervalStr
    End Function
    
    ' Display TimeSpan parameters and their sum and difference.
    Sub ShowTimeSpanSumDiff( Left as TimeSpan, Right as TimeSpan )

        Console.WriteLine( )
        Console.WriteLine( dataFmt, "TimeSpan Left", Align( Left ) )
        Console.WriteLine( dataFmt, "TimeSpan Right", Align( Right ) )
        Console.WriteLine( dataFmt, _
            "TimeSpan.op_Addition( Left, Right )", _
            Align( TimeSpan.op_Addition( Left, Right ) ) )
        Console.WriteLine( dataFmt, _
            "TimeSpan.op_Subtraction( Left, Right )", _
            Align( TimeSpan.op_Subtraction( Left, Right ) ) )
    End Sub

    Sub Main( )
        Console.WriteLine( _
            "This example of the TimeSpan Addition and " & _
            "Subtraction " & vbCrLf & "operators " & _
            "generates the following output by creating " & vbCrLf & _
            "several pairs of TimeSpan objects and calculating " & _
            "and " & vbCrLf & "displaying the sum " & _
            "and difference of each." )

        ' Create pairs of TimeSpan objects.
        ShowTimeSpanSumDiff( _
            new TimeSpan( 1, 20, 0 ), _
            new TimeSpan( 0, 45, 10 ) )
        ShowTimeSpanSumDiff( _
            new TimeSpan( 1, 10, 20, 30, 40 ), _
            new TimeSpan( -1, 2, 3, 4, 5 ) )
        ShowTimeSpanSumDiff( _
            new TimeSpan( 182, 12, 30, 30, 505 ), _
            new TimeSpan( 182, 11, 29, 29, 495 ) )
        ShowTimeSpanSumDiff( _
            new TimeSpan( 888888888888888 ), _
            new TimeSpan( 999999999999999 ) )
    End Sub
End Module 

' This example of the TimeSpan Addition and Subtraction
' operators generates the following output by creating
' several pairs of TimeSpan objects and calculating and
' displaying the sum and difference of each.
' 
' TimeSpan Left                                 01:20:00
' TimeSpan Right                                00:45:10
' TimeSpan.op_Addition( Left, Right )           02:05:10
' TimeSpan.op_Subtraction( Left, Right )        00:34:50
' 
' TimeSpan Left                               1.10:20:30.0400000
' TimeSpan Right                               -21:56:55.9950000
' TimeSpan.op_Addition( Left, Right )           12:23:34.0450000
' TimeSpan.op_Subtraction( Left, Right )      2.08:17:26.0350000
' 
' TimeSpan Left                             182.12:30:30.5050000
' TimeSpan Right                            182.11:29:29.4950000
' TimeSpan.op_Addition( Left, Right )       365.00:00:00
' TimeSpan.op_Subtraction( Left, Right )        01:01:01.0100000
' 
' TimeSpan Left                            1028.19:21:28.8888888
' TimeSpan Right                           1157.09:46:39.9999999
' TimeSpan.op_Addition( Left, Right )      2186.05:08:08.8888887
' TimeSpan.op_Subtraction( Left, Right )   -128.14:25:11.1111111

[C#] 
// Example of the TimeSpan Addition and Subtraction operators.
using System;

class TimeSpanAddSubOpsDemo
{
    const string dataFmt = "{0,-18}{1,24}" ;

    // Pad the end of a TimeSpan string with spaces if it does not 
    // contain milliseconds.
    static string Align( TimeSpan interval )
    {
        string  intervalStr = interval.ToString( );
        int     pointIndex = intervalStr.IndexOf( ':' );

        pointIndex = intervalStr.IndexOf( '.', pointIndex );
        if( pointIndex < 0 ) intervalStr += "        ";
        return intervalStr;
    } 

    // Display TimeSpan parameters and their sum and difference.
    static void ShowTimeSpanSumDiff( TimeSpan Left, TimeSpan Right )
    {
        Console.WriteLine( );
        Console.WriteLine( dataFmt, "TimeSpan Left", Align( Left ) );
        Console.WriteLine( dataFmt, "TimeSpan Right", Align( Right ) );
        Console.WriteLine( dataFmt, "Left + Right", 
            Align( Left + Right ) );
        Console.WriteLine( dataFmt, "Left - Right", 
            Align( Left - Right ) );
    }

    static void Main( )
    {
        Console.WriteLine( "This example of the TimeSpan " +
            "Addition and Subtraction \noperators generates the " +
            "following output by creating \nseveral pairs of " +
            "TimeSpan objects and calculating and \ndisplaying " +
            "the sum and difference of each." );


        // Create pairs of TimeSpan objects.
        ShowTimeSpanSumDiff( 
            new TimeSpan( 1, 20, 0 ), 
            new TimeSpan( 0, 45, 10 ) );
        ShowTimeSpanSumDiff( 
            new TimeSpan( 1, 10, 20, 30, 40 ), 
            new TimeSpan( -1, 2, 3, 4, 5 ) );
        ShowTimeSpanSumDiff( 
            new TimeSpan( 182, 12, 30, 30, 505 ), 
            new TimeSpan( 182, 11, 29, 29, 495 ) );
        ShowTimeSpanSumDiff( 
            new TimeSpan( 888888888888888 ), 
            new TimeSpan( 999999999999999 ) );
    } 
} 

/*
This example of the TimeSpan Addition and Subtraction
operators generates the following output by creating
several pairs of TimeSpan objects and calculating and
displaying the sum and difference of each.

TimeSpan Left             01:20:00
TimeSpan Right            00:45:10
Left + Right              02:05:10
Left - Right              00:34:50

TimeSpan Left           1.10:20:30.0400000
TimeSpan Right           -21:56:55.9950000
Left + Right              12:23:34.0450000
Left - Right            2.08:17:26.0350000

TimeSpan Left         182.12:30:30.5050000
TimeSpan Right        182.11:29:29.4950000
Left + Right          365.00:00:00
Left - Right              01:01:01.0100000

TimeSpan Left        1028.19:21:28.8888888
TimeSpan Right       1157.09:46:39.9999999
Left + Right         2186.05:08:08.8888887
Left - Right         -128.14:25:11.1111111
*/ 

[C++] 
// Example of the TimeSpan Addition and Subtraction operators.
#using <mscorlib.dll>
using namespace System;

// Pad the end of a TimeSpan string with spaces if it does not 
// contain milliseconds.
String* Align( TimeSpan interval )
{
    String*  intervalStr = interval.ToString( );
    int pointIndex = intervalStr->IndexOf( ':' );

    pointIndex = intervalStr->IndexOf( '.', pointIndex );
    if( pointIndex < 0 ) 
        intervalStr = String::Concat( intervalStr, S"        " );
    return intervalStr;
}

// Display TimeSpan parameters and their sum and difference.
static void ShowTimeSpanSumDiff( TimeSpan Left, TimeSpan Right )
{
    String* dataFmt = S"{0,-18}{1,24}" ;

    Console::WriteLine( );
    Console::WriteLine( dataFmt, S"TimeSpan Left", Align( Left ) );
    Console::WriteLine( dataFmt, S"TimeSpan Right", Align( Right ) );
    Console::WriteLine( dataFmt, S"Left + Right", 
        Align( Left + Right ) );
    Console::WriteLine( dataFmt, S"Left - Right", 
        Align( Left - Right ) );
} 

void main( )
{
    Console::WriteLine( S"This example of the TimeSpan " 
        S"Addition and Subtraction \noperators generates the " 
        S"following output by creating \nseveral pairs of " 
        S"TimeSpan objects and calculating and \ndisplaying " 
        S"the sum and difference of each." );

    // Create pairs of TimeSpan objects.
    ShowTimeSpanSumDiff( 
        TimeSpan( 1, 20, 0 ), 
        TimeSpan( 0, 45, 10 ) );
    ShowTimeSpanSumDiff( 
        TimeSpan( 1, 10, 20, 30, 40 ), 
        TimeSpan( -1, 2, 3, 4, 5 ) );
    ShowTimeSpanSumDiff( 
        TimeSpan( 182, 12, 30, 30, 505 ), 
        TimeSpan( 182, 11, 29, 29, 495 ) );
    ShowTimeSpanSumDiff( 
        TimeSpan( 888888888888888 ), 
        TimeSpan( 999999999999999 ) );
}

/*
This example of the TimeSpan Addition and Subtraction
operators generates the following output by creating
several pairs of TimeSpan objects and calculating and
displaying the sum and difference of each.

TimeSpan Left             01:20:00
TimeSpan Right            00:45:10
Left + Right              02:05:10
Left - Right              00:34:50

TimeSpan Left           1.10:20:30.0400000
TimeSpan Right           -21:56:55.9950000
Left + Right              12:23:34.0450000
Left - Right            2.08:17:26.0350000

TimeSpan Left         182.12:30:30.5050000
TimeSpan Right        182.11:29:29.4950000
Left + Right          365.00:00:00
Left - Right              01:01:01.0100000

TimeSpan Left        1028.19:21:28.8888888
TimeSpan Right       1157.09:46:39.9999999
Left + Right         2186.05:08:08.8888887
Left - Right         -128.14:25:11.1111111
*/ 

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework, Common Language Infrastructure (CLI) Standard

See Also

TimeSpan Structure | TimeSpan Members | System Namespace

Show:
© 2014 Microsoft