C: 1 revision imported

2025-11-15T02:44:46Z

1 revision imported

← Older revision	Revision as of 02:44, 15 November 2025
(No difference)

w>GhostInTheMachine: modify the notice

2023-10-01T14:53:14Z

modify the notice

New page

{{Documentation subpage}}
{{Warning
|heading=This template does '''not''' put a working clock on your page.
| This template adds a clock that shows the time when the page was last updated (or re-cached) and will not update each minute.<br />If you do want a clock that constantly updates, then go to [[Special:Preferences#mw-prefsection-gadgets|your Preferences]] and enable the item:<br />"Add a clock to the personal toolbar that displays the current time in UTC and provides a link to purge the current page" under Appearance.
}}

This template displays a digital clock.

==Usage==
# To use this template, place the following on the page - <code><nowiki>{{Digital clock}}</nowiki></code>.
# This template should never be [[WP:Substitution|substituted]].
# This template should be [[WP:Purge|purged]] to reflect current time.
# If your area follows DST, you will have to change the time manually.

==Parameters==
All parameters given below are optional and not necessarily be used.

<code>
{{Digital clock <br>
|format = 12 or 24 (default: 24) <br>
|offset = number of hours + or - UTC (default: 0) <br>
|size = width of each digit in pixels (default: 70) <br>
|color = any color name or HTML color code (default: red) <br>
}}
</code>

===Offset===
The clock has a parameter that allows you to give an offset from UTC time. The offset can be fractional to adjust the time by any number of hours and minutes. Therefore this code -
<code> <nowiki>{{Digital clock|offset = +5.5}}</nowiki> </code> will produce this clock:
{{Digital clock|offset = +5.5}}

===Format (12 or 24 hours)===
You can set the format parameter to 12 or 24 to get a 12 or 24 hour time format! 12 hour clocks get an additional segment space for displaying am/pm. Therefore <code> <nowiki>{{Digital clock|format = 12}}</nowiki> </code> will produce: {{Digital clock|format = 12}}

===Size===
You can set nearly all sizes for the clock to display. It defaults to 70x112px. To set a size of 20 pixels you will have to type <code> <nowiki>{{Digital clock|size = 20}}</nowiki> </code> and it will display something like this: {{Digital clock|size = 20}}

===Color===
You can set all types of colors for the clock to display. It defaults to red. You can use a HTML color code or directly write the color name. To display a clock with cyan color you will have to type <code> <nowiki>{{Digital clock|color = cyan}}</nowiki> </code> and it will display something like this: {{Digital clock|color = cyan}}

===Borders===
This is actually not a parameter but a way to design different types of borders for the clock. Normal HTML can be used to add borders and padding space. One tricky bit is that <nowiki><div></nowiki> elements expand to the full width of their container, which will make the box too wide. So we must specify an exact width for it, by multiplying the segment size by 5 (for 24-hour clocks) or 6 (for 12-hour clocks): A complete list of borders is available at the [[WP:User Page Design Center/Style|User Page Design Center]]

<code> <nowiki><div style="background:black; padding:5px 15px; border:3px inset cyan; width:300px;">
{{Digital clock}}
</div>
</nowiki> </code>

<div style="background:black; padding:5px 15px; border:3px inset cyan; width:300px;">
{{User:Anakin101/digiclock|format=12|size=50|color=cyan}}
</div>

<code> <nowiki><div style="background:black; padding:5px 15px; border:3px inset cyan; border-radius:15px; width:300px;">
{{Digital clock}}
</div></nowiki> </code>

<div style="background:black; padding:5px 15px; border:3px inset cyan; border-radius:15px; width:300px;">
{{User:Anakin101/digiclock|format=12|size=50|color=cyan}}
</div>

===Vertical clocks===
Wrapping the clock in a <nowiki><div></nowiki> with the same width as the segments will make it vertical. Borders work as normal. The vertical clock isn't displayed to prevent inconvenience but this code works perfectly.

<code> <nowiki><div style="float:right; width:40px; border:5px solid black">
{{Digital clock}}
</div></nowiki> </code>

===Random colors===
Parser magic can be used to pick a random color each time the page is generated. Use the following code to pick random colors from the colors specified. Note - You can change the colors given according to your preference. This code will produce the clock given below.
<code> <nowiki>{{Digital clock |color = {{#switch:{{#expr:{{#time:U}} mod 6}} |0=red |1=orange |2=lime |3=yellow |4=cyan |5=magenta}}</nowiki> </code>

{{Digital clock
|size = 50
|color = {{#switch:{{#expr:{{#time:U}} mod 6}} |0=red |1=orange |2=lime |3=yellow |4=cyan |5=magenta}}
}}

==See also==
{{Date and time templates}}
{{When on basepage|
[[Category:Time, date, and time zone user templates]]
}}

Template:Digital clock/doc - Revision history

C: 1 revision imported

w>GhostInTheMachine: modify the notice