TimeSpan.TotalHours Property

Reference

Definition

Namespace:: System

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Source:: TimeSpan.cs

Source:: TimeSpan.cs

Source:: TimeSpan.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

Double

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

Jaa