Export (0) Print
Expand All

DateTime.TimeOfDay Property

Gets the time of day for this instance.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)

public TimeSpan TimeOfDay { get; }

Property Value

Type: System.TimeSpan
A time interval that represents the fraction of the day that has elapsed since midnight.

Unlike the Date property. which returns a DateTime value that represents a date without its time component, the TimeOfDay property returns a TimeSpan value that represents a DateTime value's time component.

If you want to display the time of day or retrieve the string representation of the time of day of a DateTime value, you can instead call an overload of the ToString method that has a format parameter or use the composite formatting feature with the "t" or "T" standard format string.

The following example displays the value of the TimeOfDay property for an array of DateTime values. It also contrasts the return value with the string returned by the "t" standard format string in a composite formatting operation.

using System;

public class Example
{
   public static void Main()
   {
      DateTime[] dates = { DateTime.Now, 
                           new DateTime(2013, 9, 14, 9, 28, 0),
                           new DateTime(2011, 5, 28, 10, 35, 0),
                           new DateTime(1979, 12, 25, 14, 30, 0) };
      foreach (var date in dates) {
         Console.WriteLine("Day: {0:d} Time: {1:g}", date.Date, date.TimeOfDay);
         Console.WriteLine("Day: {0:d} Time: {0:t}\n", date);
      }                              
   }
}
// The example displays output like the following: 
//    Day: 7/25/2012 Time: 10:08:12.9713744 
//    Day: 7/25/2012 Time: 10:08 AM 
//     
//    Day: 9/14/2013 Time: 9:28:00 
//    Day: 9/14/2013 Time: 9:28 AM 
//     
//    Day: 5/28/2011 Time: 10:35:00 
//    Day: 5/28/2011 Time: 10:35 AM 
//     
//    Day: 12/25/1979 Time: 14:30:00 
//    Day: 12/25/1979 Time: 2:30 PM

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

.NET for Windows Store apps

Supported in: Windows 8

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft