• Admite cualquier zona horaria, no solo el usuario o UTC.
• Admite varios relojes por página.
• Admite el horario de verano opcional.

Produce, con el estilo básico proporcionado, un reloj que se parece a:

Installation

Usage

Esta aplicación busca elementos HTML [normalmente <div>, pero podrían estar <span> o (renderizados) <td>] con la clase js-tzclock la página. Si no encuentra ninguno, se sale. Si encuentra alguno, se ejecuta.

Configuration

La configuración de cada reloj se incluye en la página wiki dentro de cada elemento con clase js-tzclock. La sintaxis de la configuración está adaptada de tzdata.

• Los comentarios opcionales comienzan con # (pound/octothorpe).
• Los espacios en cadenas deben usar _ (subrayado).

  El subrayado se reemplaza con un espacio cuando se ejecuta.

• + (plus) es opcional para compensaciones de tiempo offsets.
• La definición de zona básica debe ir antes que cualquier regla.
  • NAME es el nombre de la ubicación que se muestra en el reloj (cualquier cadena).
  • UTCOFF está desplazado de UTC ([+|-]hh[:mm]).
  • ZONE es el nombre de la zona horaria (cualquier cadena).
• Las reglas para el horario de verano, si las hay, deben estar en orden cronológico
  • IN es el nombre del mes para una regla (abreviatura en inglés de 3 letras).
  • ON es la fecha (numérica date, lastDay o Day>=date).

    Si se usa, Day es la abreviatura en inglés de 3 letras.

  • AT es la hora estándar a la que entra en vigor la regla (24 horas).
  • SAVE es la cantidad de tiempo agregado al tiempo estándar (hh[:mm]).
  • LETTERS es el nombre de la zona cuando la regla está en vigor (cualquier cadena).

Modo simple

Al establecer window.TZclockSimpleFormat en true, puede hacer que el reloj muestre una versión más simple de la hora.

Estilo

La hoja de estilo TZclock.css proporciona un estilo básico, lo que facilita centrar el texto del reloj dentro del elemento js-tzclock y subrayar el nombre de la ubicación. Hay tres clases adicionales disponibles para diseñar aún más los relojes. Se debe realizar un estilo adicional, si corresponde, en MediaWiki:Common.css de tu sitio.

js-tzclock-wrap

hijo de js-tzclock, envuelve tanto el nombre de la ubicación como la hora.

js-tzclock-lctn

hijo de js-tzclock-wrap, se aplica solo al nombre de la ubicación.

js-tzclock-time

hijo de js-tzclock-wrap, se aplica solo al tiempo.

Configuraciones de reloj de ejemplo

New York

<div class="js-tzclock"><nowiki>
# NAME          UTCOFF  ZONE
New_York        -5:00   EST
# IN    ON      AT      SAVE    LETTERS
Mar     Sun>=8  2:00    1       EDT # 2nd Sunday in March
Nov     Sun>=1  2:00    0       EST # 1st Sunday in November
</nowiki></div>

London

<div class="js-tzclock"><nowiki>
# NAME          UTCOFF  ZONE
London          0:00    GMT
# IN    ON      AT      SAVE    LETTERS
Mar     lastSun 1:00    1       BST # last Sunday in March
Oct     lastSun 1:00    0       GMT # last Sunday in October
</nowiki></div>

Tokyo

<div class="js-tzclock"><nowiki>
# NAME          UTCOFF  ZONE
Tokyo           9:00    JST # no daylight time in Japan
</nowiki></div>

Adelaide

<div class="js-tzclock"><nowiki>
# NAME          UTCOFF  ZONE
Adelaide        +9:30   CST
# IN    ON      AT      SAVE    LETTERS
Apr     Sun>=1  2:00    0       CST # 1st Sunday in April
Oct     Sun>=1  2:00    1       CDT # 1st Sunday in October
</nowiki></div>

<nowiki> Puede que no sea esencial para todas las configuraciones de reloj, pero se recomienda evitar que MediaWiki interfiera con ellas.