A‌̱tyunta̱m:Kambai Akau/digiclock/doc

This clock started as an experiment on my part in MediaWiki template syntax and formatting, but it also makes a nice user page gadget. To use it, copy this code and fill in the values. All the parameters are optional.

{{User:Kambai Akau/digiclock

|format = 12 or 24 (default: 24)

|offset = number of hours + or - UTC (default: 0)

|size = width of each digit in pixels (default: 70)

|color = any color name or HTML color code (default: red)

}}

Like other user clocks at WP:CLOCK, this won't update in real time once the page has loaded, and due to the cache mechanism of the MediaWiki software, it may not update if the page is viewed often enough to be kept in the cache, unless you purge the page. But despite these limitations it usually works quite well.

Examples

Sizes and colors

You can have nearly any size, though the graphics have a base size of 70×112 pixels. You can have any color so long as it contrasts with black. ;)

Offsets

You can adjust the time by any number of hours and minutes. (The offset can be fractional.) E.g., offset=9.5 gives Australian Central Standard Time:

12-hour

Twelve-hour clocks get an extra segment for am/pm.

Borders

Normal HTML can be used to add borders and padding space. One tricky bit is that <div> 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):

<div style="background:black; padding:5px 15px; border:3px inset cyan; width:300px;">

{{User:Kambai Akau/digiclock|format=12|size=50|color=cyan}}

</div>

A proposed CSS3 property called border-radius allows round borders. It is not finalized but Gecko-based browsers (Firefox and friends) and Webkit-based browsers (Safari, Chrome) support early versions of it (use both).

<div style="background:black; padding:5px 15px; border:3px inset cyan; -moz-border-radius:15px; -webkit-border-radius:15px; width:300px;">

{{User:Kambai Akau/digiclock|format=12|size=50|color=cyan}}

</div>

See Wikipedia:User page design center/Style for more borders.

Vertical clocks

Wrapping the clock in a div with the same width as the segments will make it vertical. Borders work as normal.

<div style="float:right; width:40px; border:5px solid black">

{{User:Kambai Akau/digiclock|size=40}}

</div>

Random colors

Parser magic can be used to pick a random color each time the page is generated. E.g., {{#time:U}} is the number of seconds since New Year 1970, so {{#expr:{{#time:U}} mod 6}} will produce a random number from 0 to 5. So if we put that in a {{#switch}} we can make a list of colors to choose from:

{{User:Kambai Akau/digiclock

|size = 50

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

}}

Suggestions?

Message me → User talk:Kambai Akau

If the template has a separate documentation page (usually called "Template:template name/doc"), add
[[A‌̱tyunta̱m:Kambai Akau/digiclock/doc]]
to the <includeonly> section at the bottom of that page. Otherwise, add
<noinclude>[[A‌̱tyunta̱m:Kambai Akau/digiclock/doc]]</noinclude>
to the end of the template code, making sure it starts on the same line as the code's last character.

Note: This page is for templates that perform calculations related to time or provide similar functions. For templates whose subject is time, please do not use this category, but instead use Category:History and events templates.

Note: None of these templates put a working clock on your page. The clocks will not update the time on your screen every minute. Instead, they record the date or time that the page was most recently edited or purged. If you want a clock that constantly updates, then go to Special:Preferences#mw-prefsection-gadgets and enable the Appearance item, "Add a clock to the personal toolbar that displays the current time in UTC and provides a link to purge the current page". Ta‌̱mpi‌̱let:CatAutoTOC