De Wikipedia, la enciclopedia libre
Saltar a navegación Saltar a búsqueda

La función de hora , o #time , es la función del analizador de MediaWiki para mostrar una fecha / hora en otros formatos. Por ejemplo ( Purgar para actualizar):

  • {{#time:j F Y}}                shows: 16 February 2021, the current UTC date
  • {{#time:F j, Y}}               shows: February 16, 2021, the current date in mdy format
  • {{#time:Y-m-d}}                shows: 2021-02-16, current ISO 8601 date
  • {{#time:H:i:s}}                shows: 23:03:19, current time-of-day
  • {{#time:l}}                    shows  "Tuesday" as current day of week
  • {{#time:\d\a\y D}}             shows  "day Tue" as current 3-letter day
  • {{#time:j. F Y|7 May 2013|de}} shows  "7. Mai 2013" as a date in German
  • {{#time:xij xiF xiY}}          shows  "28 Bahman 1399" as current date in Iranian calendar

Hay más de 35 códigos de formato de fecha (consulte a continuación: Códigos de formato de hora ) para reorganizar el día-mes-año o la hora-minuto-segundo (como 'j' para día, 'H' para hora o el 'l' para mostrar el día de la semana). Otras letras se tratan como texto literal, o usan barra invertida para escapar del formato ( '\d'muestra 'd'). El parámetro 2 puede designar otra fecha / hora (en cualquiera de varios formatos típicos), mientras que se puede especificar un código de idioma de 2 letras como parámetro 3 para traducir el nombre de un mes a otro idioma.

Más allá del calendario gregoriano , la función #time también puede convertir una fecha en otros calendarios utilizando códigos x (x_): islámico (xm), iraní (xi), hebreo (xj), tailandés (xk), minguo (xo ) o el calendario japonés (xt). Por ejemplo, para mostrar la fecha islámica , como mes y año: {{#time: xmF xmY}} → Rajab 1442.

La función #time puede mostrar números en algunos otros sistemas numéricos mediante el uso de códigos x (x_), que incluyen: hindi (xn o xN), hebreo (xh) y números romanos (xr). Por ejemplo, para mostrar la hora actual, H: i: s, en números romanos: {{#time: xrH: xri: xrs}} → XXIII: III: XIX. Vea más ejemplos a continuación: Códigos de formato de hora .

Características generales [ editar ]

La función analizador #time toma una fecha y / o una hora (en el calendario gregoriano ) y la formatea de acuerdo con la sintaxis dada. Se puede especificar un objeto de fecha / hora; el valor predeterminado es el valor de la palabra mágica {{CURRENTTIMESTAMP}} , es decir, la hora en que la página se renderizó por última vez en HTML.

{{#time: format string }}
{{#time: format string | date/time object }}
{{#time: format string | date/time object | language code }}

La lista de códigos de formato aceptados se proporciona en la siguiente tabla . Cualquier carácter de la cadena de formato que no se reconozca se pasa sin alterar; esto se aplica también a los espacios en blanco (el sistema no los necesita para interpretar los códigos). También hay dos formas de escapar caracteres dentro de la cadena de formato:

  1. Una barra invertida seguida de un carácter de formato se interpreta como un carácter literal único
  2. Los caracteres entre comillas dobles se consideran caracteres literales y las comillas se eliminan.

Además, el dígrafo xxse interpreta como una única "x" literal.

{{#time: Y-m-d }}2021-02-16
{{#time: [[Y]] m d }}2021 02 16
{{#time: [[Y (year)]] }}2021 (21UTCpm martes, 16 de febrero de 2021 23:03:19 +0000)
{{#time: [[Y "(year)"]] }}2021 (año)
{{#time: i's" }}03'19 "

El date/time objectpuede estar en cualquier formato aceptado por PHP strtotime () función. Se aceptan tiempos absolutos (p. Ej., 20 December 2000) Y relativos (p. Ej., +20 hours).

{{#time: r|now}}mar, 16 de febrero de 2021 23:03:19 +0000
{{#time: r|+2 hours}}mié, 17 feb 2021 01:03:19 +0000
{{#time: r|now + 2 hours}}mié, 17 feb 2021 01:03:19 +0000
{{#time: r|20 December 2000}}miércoles, 20 de diciembre de 2000 00:00:00 +0000
{{#time: r|December 20, 2000}}miércoles, 20 de diciembre de 2000 00:00:00 +0000
{{#time: r|2000-12-20}}miércoles, 20 de diciembre de 2000 00:00:00 +0000
{{#time: r|2000 December 20}}Error: hora no válida.

El código de idioma de dos letras en ISO 639-1 permite que la cadena se muestre en el idioma elegido.

{{#time:d F Y|1988-02-28|nl}}28 de febrero de 1988
{{#time:l|now|uk}}вівторок
{{#time:d xg Y|20 June 2010|pl}}20 czerwca 2010

Si ha calculado una marca de tiempo de Unix, puede usarla en los cálculos de fecha pre-pendiente de un @símbolo.

{{#time: U | now }}1613516599
{{#time: r|@1613516599}}mar, 16 de febrero de 2021 23:03:19 +0000

Se pueden especificar fechas absolutas completas o parciales; la función "completará" partes de la fecha que no estén especificadas usando los valores actuales :

{{#time: Y | January 1 }}2021

Se proporcionan muchas opciones.

Códigos de formato de hora [ editar ]

La siguiente tabla explica los 35 códigos diferentes para formatos de fecha / hora, más los códigos para meses en otros idiomas, y los códigos x (x_) para convertir a otros calendarios o sistemas numéricos.

Ver también [ editar ]

  • Plantilla: Hora , la fecha / hora actual
  • Plantilla: ahora , muestra una oración con la fecha / hora actual
  • Plantilla: HOY , muestra solo la fecha actual, en forma típica de dmy
  • Plantilla: Today , un cuadro de navegación sobre el programa de entrevistas de televisión diario de EE. UU. Today
  • mw: Help: Extension: ParserFunctions # #time , página de documentación del desarrollador
  • Tiempo de Unix