Fandom Developers Wiki

TZclock es una aplicación de JavaScript que muestra relojes ajustados por zona horaria.

  • 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:

# 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

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.