Jump to content

User:Davidgothberg/clock

From Wikipedia, the free encyclopedia

This is the documentation for the DavidClock user script.

This script puts an UTC clock in the upper right corner of all pages, like this:

...    My talk    My preferences    My watchlist    My contributions    Log out    10:25    10:22    1 Nov

It can show one or several of these things:

  • A ticking clock in UTC time. Same time as the Wikipedia servers use.
  • A static clock that shows when the page was loaded.
  • A static date that shows when the page was loaded.

As a bonus the clocks are links to purge the page and to edit section 0.

Note that this clock runs of your local computer clock. If you have the wrong time in your computer then this clock will also be wrong.

Usage

[edit]

To use this script put the below code in your personal /vector.js page. (If you are using another skin, here's a link to your personal skin file.)

importScript( "User:Davidgothberg/clock.js" );

Nowadays scripts here on Wikipedia usually start working immediately (on next page load). But if not, then you need to wait one minute for the servers to update, then bypass your browser cache to load the clock the first time.

Advanced usage

[edit]

The default is to show both the ticking and the static clock, and the clock ticks once a minute. This can be changed by adding one of the lines below to your "/monobook.js" page:

window.davidClock = -60;  //Only ticking clock, every minute.
window.davidClock = -5;   //Only ticking clock, every 5 seconds.
window.davidClock = 0;    //Only static clock
window.davidClock = 5;    //Static + ticking clock, every 5 seconds.
window.davidClock = 60;   //Static + ticking clock, every minute.
window.davidClock = 120;  //Static + ticking clock, every 2 minutes.

Don't set below 60 seconds on slow computers.

The current default is to show the date. To disable or enable the date add one of the lines below to your "/monobook.js" page:

window.davidClockDate = 0;  //Don't show the date.
window.davidClockDate = 1;  //Show the date.

We might change this default if people don't like it. Tell me what you think on my talk page. The reason we use 0/1 instead of false/true is that we might want to add more date styles later on, then we might need "window.davidClockDate = 2;" and so on.

Technical details

[edit]

Tested and works in Firefox 2.0, Opera 9.02 and Internet Explorer 5.5.

Works in the following Wikipedia skins: Vector, MonoBook, Chick, Modern, MySkin, Simple. Has no effect in the other skins.

The script itself (the javascript code) is at User:Davidgothberg/clock.js.

The only thing that runs on each tick is the small inner function updateTimeMinutes() or updateTimeSeconds(), thus very efficient.

Based on code from AzaToth, Ilmari Karonen and Voice of All. This script was created by and is maintained by: David Göthberg

See also

[edit]