TimeSpan.TotalDays Property

Definition

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

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

Property Value

The total number of days represented by this instance.

Examples

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

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

Console.WriteLine("{0:N5} days, as follows:", interval.TotalDays);
Console.WriteLine("   Days:         {0,3}", interval.Days);
Console.WriteLine("   Hours:        {0,3}", 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: 3.16:42:45.7500000
//       3.69636 days, as follows:
//          Days:           3
//          Hours:         16
//          Minutes:       42
//          Seconds:       45
//          Milliseconds: 750
// Define an interval of 3 days, 16+ hours.
let interval = TimeSpan(3, 16, 42, 45, 750) 
printfn $"Value of TimeSpan: {interval}"
 
printfn $"{interval.TotalDays:N5} days, as follows:" 
printfn $"   Days:         {interval.Days,3}" 
printfn $"   Hours:        {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: 3.16:42:45.7500000
//       3.69636 days, as follows:
//          Days:           3
//          Hours:         16
//          Minutes:       42
//          Seconds:       45
//          Milliseconds: 750
Module Example
   Public Sub Main()
      ' Define an interval of 3 days, 16+ hours.
      Dim interval As New TimeSpan(3, 16, 42, 45, 750) 
      Console.WriteLine("Value of TimeSpan: {0}", interval)
      
      Console.WriteLine("{0:N5} days, as follows:", interval.TotalDays)
      Console.WriteLine("   Days:         {0,3}", interval.Days)
      Console.WriteLine("   Hours:        {0,3}", 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: 3.16:42:45.7500000
'       3.69636 days, as follows:
'          Days:           3
'          Hours:         16
'          Minutes:       42
'          Seconds:       45
'          Milliseconds: 750

Remarks

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

The TotalDays property represents whole and fractional days, whereas the Days property represents whole days.

Applies to

See also