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
- 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:
-
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.
Examples
open all close allBasic 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:
