ClockGauge

ClockGauge[]

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)

Generate an analog clock for the current local time:

Generate a clock from a DateObject:

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

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

Scope  (13)

Data and Layouts  (2)

Date lists are converted to standard normalized form:

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

Styling and Appearance  (8)

Use a theme to control the overall appearance:

Use explicit styles for the markers:

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

Change the type of markers used:

Place graphics or images as the markers:

Change the style of the face of the gauge:

Change the style of the frame around the gauge:

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

Labeling and Legending  (3)

Use GaugeLabels to add a label to the gauge face:

Add a display of the scale value:

Use a list to specify more than one label:

Options  (69)

AspectRatio  (2)

AspectRatio is automatic by default, resulting in perfect circles:

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

Background  (1)

Insert a background color behind the gauge:

Use GaugeFaceStyle to set the face style:

Frame  (4)

ClockGauge does not use a frame by default:

Use FrameTrue to draw a frame around the gauge:

Draw a frame on the left and right edges:

Draw a frame on the left and bottom edges:

FrameStyle  (2)

Specify a style for the frame:

Specify a style for each frame edge:

GaugeFaceElementFunction  (3)

List built-in settings for GaugeFaceElementFunction:

For detailed settings, use Palettes Chart Element Schemes:

Write a custom GaugeFaceElementFunction:

GaugeFaceStyle  (3)

Specify the style for the gauge face:

Use None to turn off the face:

Use a Texture as a dial face:

GaugeFrameElementFunction  (3)

List built-in settings for GaugeFrameElementFunction:

For detailed settings, use Palettes Chart Element Schemes:

Construct a custom rendering function:

GaugeFrameSize  (3)

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

Use None to turn off the frame:

Use named sizes for the frame:

GaugeFrameStyle  (1)

Use directives to change the rendering of the gauge frame:

GaugeLabels  (3)

Include a textual display of the time:

Use a list to specify more than one label:

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

GaugeMarkers  (3)

Turn the markers on and off:

List built-in settings for GaugeMarkers:

For detailed settings, use Palettes Chart Element Schemes:

Use an image or graphic for a marker:

GaugeStyle  (4)

Style the gauge markers:

By default, different styles are chosen for multiple markers:

Specify a list of styles:

Use any gradient or indexed color schemes from ColorData:

ImageSize  (8)

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

Specify the width of the plot:

Specify the height of the plot:

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

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

Setting AspectRatioFull will fill the available space:

Use maximum sizes for the width and height:

Use ImageSizeFull to fill the available space in an object:

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

LabelStyle  (2)

Style the labels:

Styles apply to scale and gauge labels:

PerformanceGoal  (1)

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

PlotTheme  (3)

Create gauges using a variety of base themes:

Specify a theme with minimal elements:

Change the gauge color:

ScaleDivisions  (2)

Specify the total number of divisions:

Specify the number of major and minor divisions:

ScaleOrigin  (1)

Use ScaleOrigin to specify a radial position for the scale:

ScaleRanges  (7)

Highlight a range of values on the scale:

Specify multiple ranges:

Style the entire region behind the scale:

Ranges need not be contiguous or distinct:

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

ScaleRanges appears in front of the gauge face:

Change the scale range width:

ScaleRangeStyle  (8)

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

Apply a style to every range:

Use a list of directives to style each range separately:

Styles will repeat cyclically if necessary:

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

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

Color the scale ranges with built-in color schemes:

Define a one-dimensional color function:

TicksStyle  (2)

Specify overall ticks style:

Use None to not draw ticks:

TimeZone  (3)

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

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

Show the time in GMT:

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

Applications  (1)

Create an animated display of times in large cities:

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).

CMS

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

BibTeX

@misc{reference.wolfram_2023_clockgauge, author="Wolfram Research", title="{ClockGauge}", year="2015", howpublished="\url{https://reference.wolfram.com/language/ref/ClockGauge.html}", note=[Accessed: 19-March-2024 ]}

BibLaTeX

@online{reference.wolfram_2023_clockgauge, organization={Wolfram Research}, title={ClockGauge}, year={2015}, url={https://reference.wolfram.com/language/ref/ClockGauge.html}, note=[Accessed: 19-March-2024 ]}