WOLFRAM

draws an analog clock face showing the local time with hours, minutes, and seconds.

ClockGauge[time]

draws an analog clock face showing the time corresponding to an AbsoluteTime, DateObject, or TimeObject specification.

ClockGauge[{h,m,s}]

draws an analog clock face showing hour h, minute m, and seconds s.

ClockGauge[{y,m,d,h,m,s}]

draws an analog clock face showing the time corresponding to the date list in a DateList specification.

ClockGauge["string"]

draws an analog clock face showing the time DateList["string"].

Details and Options

Examples

open allclose all

Basic Examples  (4)Summary of the most common use cases

Generate an analog clock for the current local time:

Out[1]=1

Generate a clock from a DateObject:

Out[1]=1

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

Out[1]=1

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

Out[1]=1

Scope  (13)Survey of the scope of standard use cases

Data and Layouts  (2)

Date lists are converted to standard normalized form:

Out[1]=1

Day, hour, minute, and second values in input date lists can be noninteger:

Out[1]=1

Styling and Appearance  (8)

Use a theme to control the overall appearance:

Out[1]=1

Use explicit styles for the markers:

Out[1]=1

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

Out[1]=1

Change the type of markers used:

Out[1]=1

Place graphics or images as the markers:

Out[1]=1

Change the style of the face of the gauge:

Out[1]=1

Change the style of the frame around the gauge:

Out[1]=1

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

Out[1]=1

Labeling and Legending  (3)

Use GaugeLabels to add a label to the gauge face:

Out[1]=1

Add a display of the scale value:

Out[1]=1
Out[2]=2

Use a list to specify more than one label:

Out[1]=1

Options  (69)Common values & functionality for each option

AspectRatio  (2)

AspectRatio is automatic by default, resulting in perfect circles:

Out[1]=1

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

Out[1]=1

Background  (1)

Insert a background color behind the gauge:

Out[1]=1

Use GaugeFaceStyle to set the face style:

Out[2]=2

Frame  (4)

ClockGauge does not use a frame by default:

Out[1]=1

Use FrameTrue to draw a frame around the gauge:

Out[1]=1

Draw a frame on the left and right edges:

Out[1]=1

Draw a frame on the left and bottom edges:

Out[1]=1

FrameStyle  (2)

Specify a style for the frame:

Out[1]=1

Specify a style for each frame edge:

Out[1]=1

GaugeFaceElementFunction  (3)

List built-in settings for GaugeFaceElementFunction:

Out[1]=1

For detailed settings, use Palettes Chart Element Schemes:

Out[1]=1

Write a custom GaugeFaceElementFunction:

Out[2]=2

GaugeFaceStyle  (3)

Specify the style for the gauge face:

Out[1]=1

Use None to turn off the face:

Out[1]=1

Use a Texture as a dial face:

Out[1]=1
Out[2]=2

GaugeFrameElementFunction  (3)

List built-in settings for GaugeFrameElementFunction:

Out[1]=1

For detailed settings, use Palettes Chart Element Schemes:

Out[1]=1

Construct a custom rendering function:

Out[2]=2

GaugeFrameSize  (3)

Use an explicit radial width in the graphics coordinate system to draw the frame:

Out[1]=1

Use None to turn off the frame:

Out[1]=1

Use named sizes for the frame:

Out[1]=1

GaugeFrameStyle  (1)

Use directives to change the rendering of the gauge frame:

Out[1]=1

GaugeLabels  (3)

Include a textual display of the time:

Out[1]=1

Use a list to specify more than one label:

Out[1]=1

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

Out[1]=1
Out[2]=2

GaugeMarkers  (3)

Turn the markers on and off:

Out[1]=1

List built-in settings for GaugeMarkers:

Out[1]=1

For detailed settings, use Palettes Chart Element Schemes:

Out[2]=2

Use an image or graphic for a marker:

Out[1]=1

GaugeStyle  (4)

Style the gauge markers:

Out[1]=1

By default, different styles are chosen for multiple markers:

Out[1]=1

Specify a list of styles:

Out[1]=1

Use any gradient or indexed color schemes from ColorData:

Out[1]=1

ImageSize  (8)

Use named sizes such as Tiny, Small, Medium and Large:

Out[1]=1

Specify the width of the plot:

Out[1]=1

Specify the height of the plot:

Out[2]=2

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

Out[1]=1

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

Out[1]=1

Setting AspectRatioFull will fill the available space:

Out[1]=1

Use maximum sizes for the width and height:

Out[1]=1

Use ImageSizeFull to fill the available space in an object:

Out[1]=1

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

Out[1]=1

LabelStyle  (2)

Style the labels:

Out[1]=1

Styles apply to scale and gauge labels:

Out[1]=1

PerformanceGoal  (1)

Set the default styles so that the graphics are generated faster:

Out[1]=1

PlotTheme  (3)

Create gauges using a variety of base themes:

Out[1]=1

Specify a theme with minimal elements:

Out[1]=1

Change the gauge color:

Out[1]=1

ScaleDivisions  (2)

Specify the total number of divisions:

Out[1]=1

Specify the number of major and minor divisions:

Out[1]=1

ScaleOrigin  (1)

Use ScaleOrigin to specify a radial position for the scale:

Out[1]=1

ScaleRanges  (7)

Highlight a range of values on the scale:

Out[1]=1

Specify multiple ranges:

Out[1]=1

Style the entire region behind the scale:

Out[1]=1

Ranges need not be contiguous or distinct:

Out[1]=1

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

Out[1]=1

ScaleRanges appears in front of the gauge face:

Out[1]=1

Change the scale range width:

Out[1]=1
Out[2]=2

ScaleRangeStyle  (8)

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

Out[1]=1

Apply a style to every range:

Out[1]=1

Use a list of directives to style each range separately:

Out[1]=1

Styles will repeat cyclically if necessary:

Out[1]=1

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

Out[1]=1

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

Out[1]=1

Color the scale ranges with built-in color schemes:

Out[1]=1

Define a one-dimensional color function:

Out[2]=2

TicksStyle  (2)

Specify overall ticks style:

Out[1]=1

Use None to not draw ticks:

Out[1]=1

TimeZone  (3)

By default, ClockGauge uses the time zone included in the time:

Out[3]=3

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

Out[4]=4

Show the time in GMT:

Out[1]=1

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

Out[1]=1

Applications  (1)Sample problems that can be solved with this function

Create an animated display of times in large cities:

Out[1]=1
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).

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 ]}

@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 ]}

@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 ]}