Controls – TimeLabel

The TimeLabel control lets you display a time in a clear and unambiguous way. The TimeLabel control may display:

An exact time
A time marked as approximate
A time marked as ongoing
A null index time where the exact text displayed can be defined by the Independent Software Vendor

Example ASP.NET control (embedded):

13:15	A TimeLabel displaying an exact time.
Approx 13:15	A TimeLabel displaying an approximate time.
01:15:00 (pm)	A TimeLabel displaying an exact time, including seconds, in 12-hour clock format with a PM indicator.
Ongoing	A TimeLabel displaying a null index time.

Properties

The TimeLabel control is initialized with the following code:

<NhsCui:TimeLabel ID="TimeLabel1" TimeValue="13:15" runat="server"/>

DisplayAMPM – specifies whether an AM/PM suffix should be included
Display12Hour – specifies whether the hours value should be displayed in 12-hour or 24-hour format
DisplaySeconds – specifies whether seconds should be displayed
NullIndex – a number identifying a null type where the index has no meaning in and of itself; the meaning is implied by the NullStrings property
NullStrings – a list of localized strings that identify different types of null index times
ToolTip – the text displayed when the mouse pointer hovers over the Web server control
Value – the time to be displayed in the label

Additional Information

DisplayAMPM has a default value of “False”
Display12Hour has a default value of “False”
DisplaySeconds has a default value of “False”
NullStrings has a default value of an empty list of strings

Example WinForms control (screenshot):

	A TimeLabel displaying an exact time.
	A TimeLabel displaying an approximate time.
	A TimeLabel displaying an exact time, including seconds.
	A TimeLabel displaying a null index time.

Further information on this control, and the full source code, can be found in the Microsoft Health Common User Interface Toolkit, which can be downloaded from our CodePlex site.

Associated Design Guidance and Samples

Design Guidance	Samples
Time Input and Display