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:
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,lastDayoDay>=date).- Si se usa,
Dayes la abreviatura en inglés de 3 letras.
- Si se usa,
- 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.