Last updated on April 23, 2015

Widget: Clock

Overview

The clock widget displays the current date and time on the system. It can be configured to display the time in the 24-hour or AM/PM format. Users can choose the preferred style, formatting, and additional display options (such as displaying date only or time only).

Editing a Clock Widget

Step 1

From within an existing application, click on the Clock widget (named Clock) within the designated layout.

Note

You are able to change/edit the name of the widget based on your preference or naming convention. The default name for the Clock widget is Time.

Step 2

From the APPEARANCE tab, select the DATE sub-tab to make font and display format changes for the date. You can also select the TIME sub-tab to make font and display format changes.

Step 3

Also under the APPEARANCE tab, you are able to edit the fields for the COMMON, VISIBILITY, and PROPERTIES sections. Refer to the following table for a description of the properties.


Properties Description
Show Date, Show Time Check these boxes to show or hide date and time.
Caps Check this box to capitalize the date.
Order Select the order of date and time.
Style Select single line or double line.
Time Zone Select the time zone. Note the timezone is an offset value applied to to the devices’ current time in UTC. Devices must have NTP sync for the timezones to display accurate values. The timezone property does not take into account daylight savings time changes.
Font, Size, Align, Color, Bold Choose the font, size, alignment, color and bold options. There are two separate tabs – Date and Time to allow you can choose different font properties for the Date and Time.
Date Display Format Visible in the DATE tab. Choose to use date pattern or a date, day, month and year format of your choice. Refer to the table below for a description and of the date and time pattern.
Time Display Format Visible in the TIME tab. Choose to use a time pattern or either 24-hour or AM/PM time format. Refer to the table below for a description of the date and time pattern.

Date and Time Pattern

The clock widget allows you to choose a predefined date and time format from the drop-down list. You can alternatively elect to check the Use Date Pattern or Use Time Pattern boxes to define a custom pattern (ignoring the pre-defined pattern formats). The following table lists the various possibilities of date and time patterns:

Pattern Date Time
MM/dd/yyyy 08/22/2006
dddd, dd MMMM yyyy Tuesday, 01 August 2006
ddd, d MMM yyyy H:mm Tue, 1 Aug 2006 6:30
dddd, dd MMMM yyyy hh:mm tt Tuesday, 01 August 2006 06:30 AM
dddd, dd MMMM yy H:mm Tuesday, 01 August 06 6:30
dddd, dd MMMM yyyy h:mm tt Tuesday, 01 August 2006 6:30 AM
dddd, dd MMMM yyyy HH:mm:ss Tuesday, 01 August 2006 06:30:07
MM/dd/yyyy HH:mm 08/22/2006 06:30
MM/dd/yyyy hh:mm tt 08/22/2006 06:30 AM
MM/dd/yyyy H:mm 08/22/2006 6:30
MM/dd/yyyy h:mm tt 08/22/2006 6:30 AM
MM/dd/yyyy h:mm tt 08/22/2006 6:30 AM
MM/dd/yyyy h:mm tt 08/22/2006 6:30 AM
MM/dd/yyyy HH:mm:ss 08/22/2006 06:30:07
MMMM d August 01
MMM dd Aug 01
HH:mm 06:30
hh:mm tt 06:30 AM
H:mm 6:30
h:mm tt 6:30 AM
HH:mm:ss 06:30:07
yyyy-MM-dd HH:mm:ss 2006-08-22 06:30:07
dddd, dd MMMM yyyy HH:mm:ss Tuesday, 22 August 2006 06:30:07
yyyy MMMM 2006 August
yyyy MMMM 2006 August

The following table details the definition of each pattern character:

Pattern Character Description
d Represents the day of the month as a number from 1 through 31. A single-digit day is formatted without a leading zero
dd Represents the day of the month as a number from 01 through 31. A single-digit day is formatted with a leading zero
ddd Represents the abbreviated name of the day of the week (Mon, Tues, Wed etc)
dddd Represents the full name of the day of the week (Monday, Tuesday etc)
h 12-hour clock hour (e.g. 7)
hh 12-hour clock, with a leading 0 (e.g. 07)
H 24-hour clock hour (e.g. 19)
HH 24-hour clock hour, with a leading 0 (e.g. 19)
m Minutes
mm Minutes with a leading zero
M Month number
MM Month number with leading zero
MMM Abbreviated Month Name (e.g. Dec)
MMMM Full month name (e.g. December)
s Seconds
ss Seconds with leading zero
t Abbreviated AM / PM (e.g. A or P)
tt AM / PM (e.g. AM or PM
y Year, no leading zero (e.g. 2001 would be 1)
yy Year, leadin zero (e.g. 2001 would be 01)
yyy Year, (e.g. 2001 would be 2001)
yyyy Year, (e.g. 2001 would be 2001)
: Represents the time separator. This separator is used to differentiate hours, minutes, and seconds.
/ Represents the date separator. This separator is used to differentiate years, months, and days.