DateTime.Hour Property

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Gets the hour component of the date represented by this instance.

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

Syntax

'Declaration
Public ReadOnly Property Hour As Integer
public int Hour { get; }

Property Value

Type: System.Int32
The hour component, expressed as a value between 0 and 23.

Remarks

The value of the Hour property is always expressed using a 24-hour clock. To retrieve a string that represents the hour of a date and time using a 12-hour clock, call the DateTime.ToString(String) or DateTime.ToString(String, IFormatProvider) method with the "h" custom format specifier. For example:

Dim date1 As Date = #4/1/2008 6:53:00 PM#
outputBlock.Text += date1.ToString("%h") + vbCrLf    ' Displays 6 
outputBlock.Text += date1.ToString("h tt") + vbCrLf  ' Displays 6 PM 
DateTime date1 = new DateTime(2008, 4, 1, 18, 53, 0);
outputBlock.Text += date1.ToString("%h") + "\n";              // Displays 6 
outputBlock.Text += date1.ToString("h tt") + "\n";            // Displays 6 PM

Examples

The following example demonstrates the Hour property.

Dim moment As New System.DateTime(1999, 1, 13, 3, 57, 32, 11)

' Year gets 1999.
Dim year As Integer = moment.Year

' Month gets 1 (January).
Dim month As Integer = moment.Month

' Day gets 13.
Dim day As Integer = moment.Day

' Hour gets 3.
Dim hour As Integer = moment.Hour

' Minute gets 57.
Dim minute As Integer = moment.Minute

' Second gets 32.
Dim second As Integer = moment.Second

' Millisecond gets 11.
Dim millisecond As Integer = moment.Millisecond
System.DateTime moment = new System.DateTime(
                        1999, 1, 13, 3, 57, 32, 11);
// Year gets 1999.
int year = moment.Year;

// Month gets 1 (January).
int month = moment.Month;

// Day gets 13.
int day = moment.Day;

// Hour gets 3.
int hour = moment.Hour;

// Minute gets 57.
int minute = moment.Minute;

// Second gets 32.
int second = moment.Second;

// Millisecond gets 11.
int millisecond = moment.Millisecond;

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.