Plantilla:Intervalo tiempo/doc

De ProleWiki, la enciclopedia proletaria

Plantilla:Documentation subpage Plantilla:Lua

AVISO: Esta plantilla proviene de la Wikipedia en inglés, es por eso que todas las funciones mantienen sus nombres originales.


Esta plantilla calcula la diferencia entre dos fechas. Soporta fechas en el Calendario Gregoriano entre el 9999 a. C. y el 9999 d. C.
Se recomienda revisar la documentación de Módulo:Edad donde se explican los parámetros que acepta la plantilla y otras plantillas implementadas.

Sintaxis

  • {{intervalo tiempo|fecha1|fecha2|parámetros}}

Hay dos argumentos posicionales (fecha1 y fecha2) cuyo valore por defecto es la fecha y hora actuales.

El texto resultante muestra el intervalo de tiempo entre fecha1 y fecha2 (fecha2 - fecha1).

Las fechas y horas deben estar en UTC — zonas horarias y horas locales no están soportadas.

Las fechas son validadas antes de retornar nada así que por ejemplo se acepta el 29 de febrero del 2000, pero no el 29 de febrero del 1900.

Las fechas pueden incluir una era o una hora y se aceptan variedad de formatos. Algunos ejemplos son:

1900-02-01
1900-2-1
1900-02-01 14:45
1 FEB 1900
febrero 1, 1900
febrero 1 1900 14:45
2:45 pm 1 de febrero de 1900
1 de febrero de 1900 2:45 p.m.
BC 1 feb 120

Ejemplos:

  • {{intervalo tiempo|1 ene 2001|marzo 4, 2002}} → 1 año, 2 meses y 3 días
  • {{intervalo tiempo|1 ene 2001|marzo 4, 2002|abbr=on}} → 1a 2m 3d
  • {{intervalo tiempo|B.C.E. 1 feb 120|28 FEB 1900}} → 2019 años y 27 días

Parámetros

Parámetro Descripción
Abreviaturas abbr=off Usar las unidades completas (por defecto): year, month, day, hour, minute.
abbr=on Usar las unidades acortadas con una única letra y sin espacio entre esta y el número: y, m, d, h, m.
Datos a mostrar (automático) disp=age Si no se indica el parámetro show, se muestran los años si el resultado es mayor que 3 años, los años y meses si está entre 1 y 3 años y los meses y días si es inferior a 1 año. Por defecto se utiliza el sep=space.
disp=raw Mostrar solo los números utilizando sep=space.
Duración duration=on Indica si es una duración y debe incluir la fecha de fin.
Formato format=commas Se usa una coma como separador de enteros para números superiores al 999.
format=raw Usar un guión (-) en vez de un menos (−) para indicar diferencias negativas; un guión permitiría usar el resultado en un cálculo.
Separadores sep=comma El separador entre los elementos será la coma: 1 year, 2 months, 3 days. Por defecto es 1 year, 2 months and 3 days.
sep=, Atajo para el sep=comma.
sep=serialcomma Usar la Coma de Oxford: 1 year, 2 months, and 3 days.
sep=space Usar espacios: 1 year 2 months 3 days.
sc=y Cambiar el separador por defecto a la coma de Oxford. También acepta sc=yes y sc=on.
Datos a mostrar (manual show=y años
show=ym años y meses
show=ymd años, meses y días (por defecto)
show=ymw años, meses y semanas
show=ymwd años, meses, semanas y días
show=yd años y días
show=m meses
show=md meses y días
show=w semanas
show=wd semanas y días
show=d días
show=dh días y horas
show=dhm días, horas y minutes
show=dhms días, horas, minutos y segundos
show=ymdh ymd + horas
show=ymdhm ymd + horas y minutos
show=ymwdh ymwd + horas
show=ymwdhm ymwd + horas y minutos
show=h horas (el resultado serían 48 horas para una diferencia de 2 días)
show=hm horas and minutos
show=hms horas, minutos y segundos
Redondeos round=on Redondear la unidad menos significativa especificada en el parámetro show=.
round=months Redondear al mes más cercano usando show=ym.
round=weeks Redondear a la semana más cercana usando show=ymw.
round=days Redondear al día más cercano usando show=ymd.
round=hours Redondear a la hora más cercana usando show=ymdh.
Ordenaciones sortable=on Devolver una clave oculta para poder ordenar diferencias basada en el número de días que hay de diferencia (incluyendo fracciones de día para manejar diferencias correctamente).
sortable=off Sin clave oculta para ordenar diferencias (por defecto).
sortable=debug Devolver una clave visible para realizar pruebas.

Redirecciones

Ver También