TimeSpan.TotalDays 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 days.

public:
 property double TotalDays { double get(); };

public double TotalDays { get; }

member this.TotalDays : double

Public ReadOnly Property TotalDays As Double

Property Value

Double

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

Jaa