DateTime.TimeOfDay Property

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Gets the time of day for this instance.

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

Syntax

Public ReadOnly Property TimeOfDay As TimeSpan
public TimeSpan TimeOfDay { get; }

Property Value

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

Remarks

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.

Examples

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.

Version Information

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Platforms

Windows Phone

See Also

Reference

DateTime Structure

System Namespace

TimeSpan