TimeSpan.TotalHours Property

Definition

Gets the value of the current TimeSpan structure expressed in whole and fractional hours.

public:
 property double TotalHours { double get(); };
public double TotalHours { get; }
member this.TotalHours : double
Public ReadOnly Property TotalHours As Double

Property Value

The total number of hours represented by this instance.

Examples

The following example instantiates a TimeSpan object and displays the value its TotalHours property. It also displays the value of each component (hours, minutes, seconds, and milliseconds) that forms the fractional part of the value of its TotalHours property.

// Define an interval of 1 day, 15+ hours.
TimeSpan interval = new TimeSpan(1, 15, 42, 45, 750); 
Console.WriteLine("Value of TimeSpan: {0}", interval);

Console.WriteLine("{0:N5} hours, as follows:", interval.TotalHours);
Console.WriteLine("   Hours:        {0,3}", 
                  interval.Days * 24 + interval.Hours);
Console.WriteLine("   Minutes:      {0,3}", interval.Minutes);
Console.WriteLine("   Seconds:      {0,3}", interval.Seconds);
Console.WriteLine("   Milliseconds: {0,3}", interval.Milliseconds);

// The example displays the following output:
//       Value of TimeSpan: 1.15:42:45.7500000
//       39.71271 hours, as follows:
//          Hours:         39
//          Minutes:       42
//          Seconds:       45
//          Milliseconds: 750
// Define an interval of 1 day, 15+ hours.
let interval = TimeSpan(1, 15, 42, 45, 750) 
printfn $"Value of TimeSpan: {interval}"

printfn $"{interval.TotalHours:N5} hours, as follows:"
printfn $"   Hours:        {interval.Days * 24 + interval.Hours,3}"
printfn $"   Minutes:      {interval.Minutes,3}" 
printfn $"   Seconds:      {interval.Seconds,3}" 
printfn $"   Milliseconds: {interval.Milliseconds,3}"

// The example displays the following output:
//       Value of TimeSpan: 1.15:42:45.7500000
//       39.71271 hours, as follows:
//          Hours:         39
//          Minutes:       42
//          Seconds:       45
//          Milliseconds: 750
Module Example
   Public Sub Main()
      ' Define an interval of 1 day, 15+ hours.
      Dim interval As New TimeSpan(1, 15, 42, 45, 750) 
      Console.WriteLine("Value of TimeSpan: {0}", interval)
      
      Console.WriteLine("{0:N5} hours, as follows:", interval.TotalHours)
      Console.WriteLine("   Hours:        {0,3}", _
                        interval.Days * 24 + interval.Hours)
      Console.WriteLine("   Minutes:      {0,3}", interval.Minutes)
      Console.WriteLine("   Seconds:      {0,3}", interval.Seconds)
      Console.WriteLine("   Milliseconds: {0,3}", interval.Milliseconds)
   End Sub
End Module
' The example displays the following output:
'       Value of TimeSpan: 1.15:42:45.7500000
'       39.71271 hours, as follows:
'          Hours:         39
'          Minutes:       42
'          Seconds:       45
'          Milliseconds: 750

Remarks

This property converts the value of this instance from ticks to hours. This number might include whole and fractional hours.

The TotalHours property represents whole and fractional hours, whereas the Hours property represents whole hours.

Applies to

See also