TimeSpan.Subtraction(TimeSpan, TimeSpan) Operator

Definition

Namespace:

System

Assembly:

System.Runtime.dll

Source:

TimeSpan.cs

Subtracts a specified TimeSpan from another specified TimeSpan.

public:
 static TimeSpan operator -(TimeSpan t1, TimeSpan t2);

public static TimeSpan operator - (TimeSpan t1, TimeSpan t2);

static member ( - ) : TimeSpan * TimeSpan -> TimeSpan

Public Shared Operator - (t1 As TimeSpan, t2 As TimeSpan) As TimeSpan

Parameters

t1

TimeSpan

The minuend.

t2

TimeSpan

The subtrahend.

Returns

TimeSpan

An object whose value is the result of the value of t1 minus the value of t2.

Exceptions

OverflowException

The return value is less than TimeSpan.MinValue or greater than TimeSpan.MaxValue.

Examples

The following example uses the TimeSpan subtraction operator to calculate the total length of the weekly work day. It also uses the TimeSpan addition operator to compute the total time of the daily breaks before using it in a subtraction operation to compute the total actual daily working time.

var startWork = new TimeSpan(08,00,00);
var endWork = new TimeSpan(18,30,00);
var lunchBreak = new TimeSpan(1, 0, 0);
var breaks = new TimeSpan(0, 30, 0);

Console.WriteLine("Length of work day: {0}", 
                  endWork - startWork);
Console.WriteLine("Actual time worked: {0}",
                  endWork - startWork - (lunchBreak + breaks));                  

// The example displays the following output:
//     Length of work day: 10:30:00
//     Actual time worked: 09:00:00

let startWork = TimeSpan(08,00,00)
let endWork = TimeSpan(18,30,00)
let lunchBreak = TimeSpan(1, 0, 0)
let breaks = TimeSpan(0, 30, 0)

printfn $"Length of work day: {endWork - startWork}"
printfn $"Actual time worked: {endWork - startWork - (lunchBreak + breaks)}"

// The example displays the following output:
//     Length of work day: 10:30:00
//     Actual time worked: 09:00:00

Module Example
   Public Sub Main()
      Dim startWork As New TimeSpan(08,00,00)
      Dim endWork As New TimeSpan(18,30,00)
      Dim lunchBreak As New TimeSpan(1, 0, 0)
      Dim breaks As New TimeSpan(0, 30, 0)
      
      Console.WriteLine("Length of work day: {0}", 
                        endWork - startWork)
      Console.WriteLine("Actual time worked: {0}",
                        endwork - startwork - (lun\chBreak + breaks))                  
   End Sub
End Module
' The example displays the following output:
'     Length of work day: 10:30:00
'     Actual time worked: 09:00:00

Remarks

The equivalent method for this operator is TimeSpan.Subtract(TimeSpan)