Commands Reference, Volume 6

xclock Command

Purpose

Continuously displays the current time of day.

Syntax

xclock [ -Xtoolkitoption ... ] [ -analog | -digital ] [ -chime ] [ -hd Color ] [ -help ] [ -hl Color ] [ -padding Number ] [ -update Seconds ]

Description

The xclock command gets the time from the system clock, then displays and updates it in the form of a digital or analog clock. Select the -analog or -digital flag to display the clock in analog or digital formats. You can also select flags to specify the presentation of the clock, including chime and update frequency, colors, and border width.

This command uses the Athena clock widget, which understands core resource names and classes. To specify these resources, you need to know the hierarchy of the widgets that comprise the xclock command. In the following example, the indented items indicate the hierarchical structure. The widget class name is given first, followed by the widget instance name:

XClock xclock
        Clock clock

The following examples demonstrate the possible ways to specify resources for this client:

xclock.clock.background

XClock*background

xclock*background

Note: Specifying resources as xclock.background which worked with the previous version of xclock will not work with this version.

Flags

-Xtoolkitoption	The xclock command accepts all of the standard X Toolkit command-line option flags in addition to the specific flags listed. See the List of Enhanced X-Windows Protocols, Toolkit, and Extension Functions for detailed information on the available options.
-analog	Sets the analog display mode, which is the default mode. Draws a conventional 12-hour clock face with ticks for each minute and stroke marks on each hour.
-chime	Specifies the sounding of a chime once on the half hour and twice on the hour.
-digital	Sets the 24-hour digital display mode. Displays the date and time in digital form.
-hd Color	Specifies the color of the hands in analog mode on color displays. The default is black.
-help	Prints a brief summary of the allowed options.
-hl Color	(lowercase HL) Specifies the highlight color of the edges of the hands of the analog clock. The default is black.
-padding Number	Specifies the width in pixels of the padding between the window border and the clock text or picture. The default is 8.
-update Seconds	Specifies the frequency in seconds that the xclock command updates its display. If the xclock window is obscured and then exposed, the xclock command redisplays immediately. The specification of an update frequency less than 30 seconds enables the second hand in the analog mode. The default update frequency is 60 seconds.

.Xdefaults Keywords

Use the following keywords to set the defaults for the xclock command.

analog (class Boolean)	Specifies an analog clock instead of a digital clock. The default is true.
chime (class Boolean)	Specifies whether a bell sounds on the hour and half hour.
fontSet (class FontSet)	Specifies the fontset for the digital clock. Variable-width fonts do not always display correctly.
foreground (class Foreground)	Specifies the color of tick marks on color displays. If reverseVideo is specified, the default is white, otherwise the default is black.
hands (class Foreground)	Specifies the color on the inside of the hands in the analog clock on color displays. If reverseVideo is specified, the default is white, otherwise the default is black.
highlight (class Foreground)	Specifies the color used to highlight the clock's hands. If reverseVideo is specified, the default is white, otherwise the default is black.
height (class Height)	Specifies the height of the clock. The default for the analog clock is 164 pixels. The default for the digital clock is whatever is required to hold the clock when displayed in the chosen font.
padding (class Margin)	Specifies the amount of internal padding in pixels. The default is 8.
update (class Interval)	Specifies the frequency in seconds in which the xclock command updates its display.
width (class Width)	Specifies the width of the clock. The default for the analog clock is 164 pixels. The default for the digital clock is whatever is needed to hold the clock when displayed in the chosen font.

Environment Variables

DISPLAY	Gets the default host and display number.
XENVIRONMENT	Gets the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

Examples

To specify a digital clock display, enter:
```
xclock -digital
```
To specify red hands on an analog clock, enter:
```
xclock -hd red
```

File

/usr/lib/X11/app-defaults/XClock

Specifies the required resources.