Template:Digital clock/doc

This is a documentation subpage for Template:Digital clock.
It may contain usage information, categories and other content that is not part of the original template page.

This clock uses one of the most complicated structures to produce an digital clock that displays time in the offset you set!

This template does not put a working clock on your page. The clock will not update the time on your screen every minute. Instead, it records the 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".

Usage

To use this template, place the following on the page - {{Digital clock}}.
This template should never be substituted.
This template should be 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.

{{Digital clock |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) }}

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 - {{Digital clock|offset = +5.5}} will produce this clock:

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 {{Digital clock|format = 12}} will produce:

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 {{Digital clock|size = 20}} and it will display something like this:

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 {{Digital clock|color = cyan}} and it will display something like this:

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 <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): A complete list of borders is available at the User Page Design Center

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

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

Vertical clocks

Wrapping the clock in a <div> 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.

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

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. {{Digital clock |color = {{#switch:{{#expr:{{#time:U}} mod 6}} |0=red |1=orange |2=lime |3=yellow |4=cyan |5=magenta}}


Type	Adjustable	Current	Last	Next
Date and time	{{time}}	{{Currentdate}} (MDY) {{Plain now}} (DMY) {{Now}} (DMY in a complete sentence) {{Simple now}}
Date only	{{Dateonly}} {{Datedow}} (Has the day of the week)	{{Date}} (Chose format) {{DATE}} (prefixed by date=) {{TODAY}} (DMY)	{{Yesterday}} {{Day-1}}	{{Tomorrow}} {{Day+1}}
Time only	{{Timeonly}}	{{CURRENTTIME}} (12 h format) {{CURRENTTIME24}} (24 h format)
Banners		{{Right now}} (Blue with time and number of Wikipedia articles)
Timestamp		{{Timestamp}} (Format YYYYMMDDhhmmss)

Single units of time


Unit of time	Adjustable	Current	Last	Next
SECOND		{{CURRENTSECOND}}
MINUTE		{{CURRENTMINUTE}}
HOUR		{{CURRENTHOUR}}
WEEK		{{CURRENTWEEK}} {{CURRENTWEEKOFMONTH}}
Day of Week	{{DAYOFWEEK}}	{{CURRENTDAYNAME}} {{CURRENTWEEKDAYABBREV}} {{CURRENTWEEKDAY}}
MONTH	{{MONTHNAME}} {{MONTHABBREV}} {{MONTHNUMBER}} {{MONTH}} (zero padded)	{{CURRENTMONTHNAME}} {{CURRENTMONTHABBREV}} {{CURRENTMONTH1}} {{CURRENTMONTHDAYS}}	{{LASTMONTHNAME}}	{{NEXTMONTHNAME}}
Day of Month		{{CURRENTDAY}} {{CURRENTDAY2}} (zero padded)
YEAR		{{CURRENTYEARCC}} {{CURRENTYEARYY}} {{CURRENTISOYEAR}} {{CURRENTYEAR}}	{{LASTYEAR}}	{{NEXTYEAR}}
Day of Year		{{CURRENTDAYOFYEAR}}
DECADE	{{DECADE}}	{{CURRENTDECADE}}
CENTURY	{{CENTURY}}	{{CURRENTCENTURY}}
MILLENNIUM	{{MILLENNIUM}}

Date and time templates made for substitution:

Month:
{{Lmonth}} produces Error: Invalid time.
{{Nmonth}} produces Error: Invalid time.
{{LastMonth}} produces Error: Invalid time.
{{NextMonth}} produces Error: Invalid time.

Individual templates

Categories of templates