ClockGauge
✖
ClockGauge
draws an analog clock face showing the time corresponding to an AbsoluteTime, DateObject, or TimeObject specification.
draws an analog clock face showing the time corresponding to the date list in a DateList specification.
Details and Options




- By default, ClockGauge will use the time zone specified by a TimeObject or DateObject.
- For time specifications that don't include a time zone, the time zone is taken to be $TimeZone.
- Undefined values or bad input is taken to be missing, and typically displays 0.
- ClockGauge has the same options as Graphics, with the following additions and changes: [List of all options]
-
GaugeFaceElementFunction Automatic function to draw the face GaugeFaceStyle Automatic style for the clock face GaugeFrameElementFunction Automatic function to draw the frame GaugeFrameSize Automatic how large to make the frame around the face GaugeFrameStyle Automatic style for the frame GaugeLabels Automatic labels to put on the clock face GaugeMarkers Automatic appearence for the clock hands GaugeStyle Automatic style for the hands on the clock PerformanceGoal $PerformanceGoal aspects of performance to try to optimize PlotTheme $PlotTheme theme to use for drawing the clock ScaleDivisions Automatic the number and distribution of ticks on the clock face ScaleRanges None the sections of the scale to be styled ScaleRangeStyle Automatic how to draw the scale ranges ScalingFunctions None how to scale individual coordinates TimeZone Automatic time zone to use - GaugeLabels can take the following forms:
-
None no gauge labels Automatic include date as a label Full,All include date and time as labels "Value","Time" include time as a label label use label as a label {e1,e2,…} use DateString elements e1, e2, … as labels Placed[label,pos] place label at position pos {label1,label2,…} use multiple labels - GaugeLabels->Placed[label,pos] can use the positions pos:
-
Top,Bottom,Left,Right,Center positions within the dial bs position along the scale Scaled[bs] scaled position along the scale {bx,by} scaled position {bx,by} in the gauge {pos,{lx,ly}} scaled position {lx,ly} in the label at the general position pos in the gauge - A list of built-in settings for GaugeMarkers, GaugeFaceElementFunction, and GaugeFrameElementFunction can be obtained from ChartElementData["ClockGauge"]. A visual gallery is available in the Chart Element Schemes palette.
- GaugeMarkers->Placed[marker,location] can be used to control where the marker is placed in the gauge. The possible locations are:
-
"Center" center of the dial face "DivisionCenter" cumulative markers centered on division marks "DivisionInterval" cumulative markers between division marks "Scale" within the scale region "OutsideScale" outside the scale region "InsideScale" inside the scale region "ScaleRange" cumulative marker within the scale region "Frame" within the dial frame - By default, the styles used for the gauge markers, reference markers, and scale ranges are based on GaugeStyle.
-
AlignmentPoint Center the default point in the graphic to align with AspectRatio Automatic ratio of height to width Axes False whether to draw axes AxesLabel None axes labels AxesOrigin Automatic where axes should cross AxesStyle {} style specifications for the axes Background None background color for the plot BaselinePosition Automatic how to align with a surrounding text baseline BaseStyle {} base style specifications for the graphic ContentSelectable Automatic whether to allow contents to be selected CoordinatesToolOptions Automatic detailed behavior of the coordinates tool Epilog {} primitives rendered after the main plot FormatType TraditionalForm the default format type for text Frame False whether to put a frame around the plot FrameLabel None frame labels FrameStyle {} style specifications for the frame FrameTicks Automatic frame ticks FrameTicksStyle {} style specifications for frame ticks GaugeFaceElementFunction Automatic function to draw the face GaugeFaceStyle Automatic style for the clock face GaugeFrameElementFunction Automatic function to draw the frame GaugeFrameSize Automatic how large to make the frame around the face GaugeFrameStyle Automatic style for the frame GaugeLabels Automatic labels to put on the clock face GaugeMarkers Automatic appearence for the clock hands GaugeStyle Automatic style for the hands on the clock GridLines None grid lines to draw GridLinesStyle {} style specifications for grid lines ImageMargins 0. the margins to leave around the graphic ImagePadding All what extra padding to allow for labels etc. ImageSize Automatic the absolute size at which to render the graphic LabelStyle {} style specifications for labels Method Automatic details of graphics methods to use PerformanceGoal $PerformanceGoal aspects of performance to try to optimize PlotLabel None an overall label for the plot PlotRange All range of values to include PlotRangeClipping False whether to clip at the plot range PlotRangePadding Automatic how much to pad the range of values PlotRegion Automatic the final display region to be filled PlotTheme $PlotTheme theme to use for drawing the clock PreserveImageOptions Automatic whether to preserve image options when displaying new versions of the same graphic Prolog {} primitives rendered before the main plot RotateLabel True whether to rotate y labels on the frame ScaleDivisions Automatic the number and distribution of ticks on the clock face ScaleRanges None the sections of the scale to be styled ScaleRangeStyle Automatic how to draw the scale ranges ScalingFunctions None how to scale individual coordinates Ticks Automatic axes ticks TicksStyle {} style specifications for axes ticks TimeZone Automatic time zone to use

List of all options




Examples
open allclose allBasic Examples (4)Summary of the most common use cases
Generate an analog clock for the current local time:

https://wolfram.com/xid/0btnc52cv3oe-7j3vnk

Generate a clock from a DateObject:

https://wolfram.com/xid/0btnc52cv3oe-io5vsj

Generate an analog clock for a time interpreted from a list of {hour,min,sec}:

https://wolfram.com/xid/0btnc52cv3oe-rqt60u

Generate an analog clock for a time interpreted from a string as specified by DateList:

https://wolfram.com/xid/0btnc52cv3oe-dcidxx

Scope (13)Survey of the scope of standard use cases
Data and Layouts (2)
Styling and Appearance (8)
Use a theme to control the overall appearance:

https://wolfram.com/xid/0btnc52cv3oe-qi0uqz

Use explicit styles for the markers:

https://wolfram.com/xid/0btnc52cv3oe-9mc3ni

Use any gradient or indexed color schemes from ColorData to style the markers:

https://wolfram.com/xid/0btnc52cv3oe-2eqh46

Change the type of markers used:

https://wolfram.com/xid/0btnc52cv3oe-ieo7ly

Place graphics or images as the markers:

https://wolfram.com/xid/0btnc52cv3oe-xrt5y9

Change the style of the face of the gauge:

https://wolfram.com/xid/0btnc52cv3oe-x04esx

Change the style of the frame around the gauge:

https://wolfram.com/xid/0btnc52cv3oe-n9oudl

Specify ranges of the scale to be colored by the index on the dial face:

https://wolfram.com/xid/0btnc52cv3oe-6z2ohz

Labeling and Legending (3)
Use GaugeLabels to add a label to the gauge face:

https://wolfram.com/xid/0btnc52cv3oe-z3h43a

Add a display of the scale value:

https://wolfram.com/xid/0btnc52cv3oe-sj8663


https://wolfram.com/xid/0btnc52cv3oe-rk1zd8

Use a list to specify more than one label:

https://wolfram.com/xid/0btnc52cv3oe-osgfju

Options (69)Common values & functionality for each option
AspectRatio (2)
AspectRatio is automatic by default, resulting in perfect circles:

https://wolfram.com/xid/0btnc52cv3oe-kcrhm

Use a fixed ratio to change the shape of the gauge:

https://wolfram.com/xid/0btnc52cv3oe-cyaeiv

Background (1)
Insert a background color behind the gauge:

https://wolfram.com/xid/0btnc52cv3oe-keda1x

Use GaugeFaceStyle to set the face style:

https://wolfram.com/xid/0btnc52cv3oe-gbxlvg

Frame (4)
ClockGauge does not use a frame by default:

https://wolfram.com/xid/0btnc52cv3oe-192r11

Use FrameTrue to draw a frame around the gauge:

https://wolfram.com/xid/0btnc52cv3oe-int4mk

Draw a frame on the left and right edges:

https://wolfram.com/xid/0btnc52cv3oe-6xdlwz

Draw a frame on the left and bottom edges:

https://wolfram.com/xid/0btnc52cv3oe-fvvmwl

FrameStyle (2)
GaugeFaceElementFunction (3)
List built-in settings for GaugeFaceElementFunction:

https://wolfram.com/xid/0btnc52cv3oe-iuo5q3

For detailed settings, use Palettes ▶ Chart Element Schemes:

https://wolfram.com/xid/0btnc52cv3oe-p5npij

Write a custom GaugeFaceElementFunction:

https://wolfram.com/xid/0btnc52cv3oe-8ulplh

https://wolfram.com/xid/0btnc52cv3oe-rmzr2q

GaugeFaceStyle (3)
Specify the style for the gauge face:

https://wolfram.com/xid/0btnc52cv3oe-is6ce2

Use None to turn off the face:

https://wolfram.com/xid/0btnc52cv3oe-v164u3

Use a Texture as a dial face:

https://wolfram.com/xid/0btnc52cv3oe-i41etf


https://wolfram.com/xid/0btnc52cv3oe-74086x

GaugeFrameElementFunction (3)
List built-in settings for GaugeFrameElementFunction:

https://wolfram.com/xid/0btnc52cv3oe-nt2nf5

For detailed settings, use Palettes ▶ Chart Element Schemes:

https://wolfram.com/xid/0btnc52cv3oe-xojot2

Construct a custom rendering function:

https://wolfram.com/xid/0btnc52cv3oe-i2mo8n

https://wolfram.com/xid/0btnc52cv3oe-p5dyoz

GaugeFrameSize (3)
Use an explicit radial width in the graphics coordinate system to draw the frame:

https://wolfram.com/xid/0btnc52cv3oe-f6lf5c

Use None to turn off the frame:

https://wolfram.com/xid/0btnc52cv3oe-2b3jt5

Use named sizes for the frame:

https://wolfram.com/xid/0btnc52cv3oe-orrhfw

GaugeFrameStyle (1)
GaugeLabels (3)
Include a textual display of the time:

https://wolfram.com/xid/0btnc52cv3oe-zqjccz

Use a list to specify more than one label:

https://wolfram.com/xid/0btnc52cv3oe-0tselc

Use a list of strings from DateString to create a label:

https://wolfram.com/xid/0btnc52cv3oe-celoru


https://wolfram.com/xid/0btnc52cv3oe-8huwse

GaugeMarkers (3)

https://wolfram.com/xid/0btnc52cv3oe-t8ch7j

List built-in settings for GaugeMarkers:

https://wolfram.com/xid/0btnc52cv3oe-tf9r82

For detailed settings, use Palettes ▶ Chart Element Schemes:

https://wolfram.com/xid/0btnc52cv3oe-8hjkou

Use an image or graphic for a marker:

https://wolfram.com/xid/0btnc52cv3oe-0r749l

GaugeStyle (4)

https://wolfram.com/xid/0btnc52cv3oe-gx9lx0

By default, different styles are chosen for multiple markers:

https://wolfram.com/xid/0btnc52cv3oe-hvkiv3


https://wolfram.com/xid/0btnc52cv3oe-rz86mp

Use any gradient or indexed color schemes from ColorData:

https://wolfram.com/xid/0btnc52cv3oe-wbwk5d

ImageSize (8)
Use named sizes such as Tiny, Small, Medium and Large:

https://wolfram.com/xid/0btnc52cv3oe-ozmh6f

Specify the width of the plot:

https://wolfram.com/xid/0btnc52cv3oe-xqopl

Specify the height of the plot:

https://wolfram.com/xid/0btnc52cv3oe-htp19c

Allow the width and height to be up to a certain size:

https://wolfram.com/xid/0btnc52cv3oe-bqghx9

Specify the width and height for a graphic, padding with space if necessary:

https://wolfram.com/xid/0btnc52cv3oe-cx5cal

Setting AspectRatioFull will fill the available space:

https://wolfram.com/xid/0btnc52cv3oe-benwf3

Use maximum sizes for the width and height:

https://wolfram.com/xid/0btnc52cv3oe-59v1t

Use ImageSizeFull to fill the available space in an object:

https://wolfram.com/xid/0btnc52cv3oe-ninbxk

Specify the image size as a fraction of the available space:

https://wolfram.com/xid/0btnc52cv3oe-gh64fj

LabelStyle (2)
PerformanceGoal (1)
PlotTheme (3)
ScaleDivisions (2)
ScaleOrigin (1)
Use ScaleOrigin to specify a radial position for the scale:

https://wolfram.com/xid/0btnc52cv3oe-66h0y

ScaleRanges (7)
Highlight a range of values on the scale:

https://wolfram.com/xid/0btnc52cv3oe-n13yos


https://wolfram.com/xid/0btnc52cv3oe-n08uhh

Style the entire region behind the scale:

https://wolfram.com/xid/0btnc52cv3oe-7pgo4q

Ranges need not be contiguous or distinct:

https://wolfram.com/xid/0btnc52cv3oe-peh69z

Directly associate a style with a range with range->style:

https://wolfram.com/xid/0btnc52cv3oe-hfk982

ScaleRanges appears in front of the gauge face:

https://wolfram.com/xid/0btnc52cv3oe-j00xsg


https://wolfram.com/xid/0btnc52cv3oe-45q432


https://wolfram.com/xid/0btnc52cv3oe-e8rr6b

ScaleRangeStyle (8)
By default, the scale ranges are colored with a gradient based on the marker color:

https://wolfram.com/xid/0btnc52cv3oe-j5r3n7


https://wolfram.com/xid/0btnc52cv3oe-364szm

Use a list of directives to style each range separately:

https://wolfram.com/xid/0btnc52cv3oe-olgqyl

Styles will repeat cyclically if necessary:

https://wolfram.com/xid/0btnc52cv3oe-6xmbiu

Use ScaleRangeStyle->{None,style} to apply a style to the scale only:

https://wolfram.com/xid/0btnc52cv3oe-m9owsc

Apply a style to the backgrounds and foregrounds of all the ranges:

https://wolfram.com/xid/0btnc52cv3oe-qty6dn

Color the scale ranges with built-in color schemes:

https://wolfram.com/xid/0btnc52cv3oe-nt7cy6

Define a one-dimensional color function:

https://wolfram.com/xid/0btnc52cv3oe-oaahh5

https://wolfram.com/xid/0btnc52cv3oe-1xl39d

TicksStyle (2)

https://wolfram.com/xid/0btnc52cv3oe-vq0t3t

Use None to not draw ticks:

https://wolfram.com/xid/0btnc52cv3oe-2f4qkd

TimeZone (3)
By default, ClockGauge uses the time zone included in the time:

https://wolfram.com/xid/0btnc52cv3oe-8ff10m

$TimeZone is used if there isn't a time zone specified:

https://wolfram.com/xid/0btnc52cv3oe-nmgr7m


https://wolfram.com/xid/0btnc52cv3oe-ybn544

Show the time in GMT for a time in $TimeZone:

https://wolfram.com/xid/0btnc52cv3oe-i6t61z

Wolfram Research (2012), ClockGauge, Wolfram Language function, https://reference.wolfram.com/language/ref/ClockGauge.html (updated 2015).
Text
Wolfram Research (2012), ClockGauge, Wolfram Language function, https://reference.wolfram.com/language/ref/ClockGauge.html (updated 2015).
Wolfram Research (2012), ClockGauge, Wolfram Language function, https://reference.wolfram.com/language/ref/ClockGauge.html (updated 2015).
CMS
Wolfram Language. 2012. "ClockGauge." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2015. https://reference.wolfram.com/language/ref/ClockGauge.html.
Wolfram Language. 2012. "ClockGauge." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2015. https://reference.wolfram.com/language/ref/ClockGauge.html.
APA
Wolfram Language. (2012). ClockGauge. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/ClockGauge.html
Wolfram Language. (2012). ClockGauge. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/ClockGauge.html
BibTeX
@misc{reference.wolfram_2025_clockgauge, author="Wolfram Research", title="{ClockGauge}", year="2015", howpublished="\url{https://reference.wolfram.com/language/ref/ClockGauge.html}", note=[Accessed: 30-April-2025
]}
BibLaTeX
@online{reference.wolfram_2025_clockgauge, organization={Wolfram Research}, title={ClockGauge}, year={2015}, url={https://reference.wolfram.com/language/ref/ClockGauge.html}, note=[Accessed: 30-April-2025
]}