Plantilla:Date table sorting

De Viquipèdia
Salta a la navegació Salta a la cerca
Icona de documentació de mòdul Documentació de la plantilla [ mostra ] [ modifica el codi ] [ mostra l'historial ] [ refresca ]

L'ordenació de taules de dates s'utilitza per ordenar i mostrar correctament les dates en una taula ordenable (vegeu Ajuda:Taula#Taules amb ordenació). L'abreviació d'aquesta plantilla és {{Dts}}.

Paràmetres[modifica]

Dates[modifica]

L'any, el mes i el dia es poden introduir com a paràmetres separats (on l'any és el 1r. paràmetre, el mes és el 2n. i el dia el 3r.) o bé com a data única.
{{Date table sorting|any| mes| dia| aC}} {{Date table sorting|data}}
  • 1r paràmetre - Any (opcional si es dóna el mes)
    • El nombre positiu (de l'1 al 999.999.999.999) representa els anys dC o aC (depèn del quart paràmetre).
    • Els nombres negatius (−1 a −999.999.999.999) representen els anys abans de Crist (sense el quart paràmetre).
    • Els números de l'any no poden contenir comes ni cap altre format.
  • 2n paràmetre - Mes (opcional si tampoc no es dóna el dia)
    • Nom del mes complet, p. Ex. Febrer
    • Nom abreujat del mes, p. Ex. Feb
    • Número de mes - (sigui encoixinat o no), p. Ex. 2 o 02
  • 3r paràmetre - Dia (opcional)
    • Número de dia (amb zero o no), p. Ex. 7 o 07
  • 4t paràmetre - (opcional)
    • Pot ser aC o dC (abans o després de Crist, respectivament)
    • S'utilitza amb un any positiu
  • 1r paràmetre: la data completa
    • Per defecte, el format AAAA-MM-DD es converteix en format mes-dia-any i el format DD-MM-AAAA es converteix en dia-mes-any, mentre que la resta de formats es mantenen en l'ordre d'entrada.
    • S'accepten els mesos abreujats i s'abreugen a la sortida.
    • Es corregeixen els errors de majúscula i coma.
    • Un sol número s’interpreta com a any, en cas contrari la data és analitzada pel mòdul. S’accepten els formats següents:
      • AAAA-MM-DD
      • DD-MM-AAAA
      • DD Mes AAAA
      • Mes DD, AAAA
      • AAAA-MM
      • DD Mes
      • Mes DD
      • Mes AAAA
      • AAAA
      • Mes
    • Els números de dia i mes poden ser d'1 o 2 dígits i els de l'any només poden ser de 3 o 4 dígits. Si heu d'introduir un nombre inferior a 1000, utilitzeu zeros inicials (per exemple, "0700").
    • Els anys aC només es poden analitzar si la data és només el número de l'any.
    • Si heu d'incloure el dia o el mes per a anys de la dC o anys superiors a 9999, heu d'utilitzar paràmetres separats per a l'any, el mes i el dia.

Format de sortida[modifica]

L'ús de format produeix un format que depèn de, però no necessàriament és igual al format de la data proporcionada. El paràmetre format pot tenir diversos valors:

Valor Funció Codi Resultat
el format depèn de l'entrada {{Dts|26 Gen 1788}} 26 gen 1788
{{Dts|Març 12, 1557}} març 12, 1557
{{Dts|1975-02-13}} 13 febrer 1975
{{Dts|2001|2|3}} 3 febrer 2001
dmy dma mostra la data en format dia-mes-any {{Dts|1888|9|13|format=dma}} 13 setembre 1888
dm mostra només el dia i el mes en format dia-mes {{Dts|1788|Feb|26|format=dm}} 26 feb
md mostra només el dia i el mes en format mes-dia {{Dts|26 Jun 1988|format=md}} jun 26
my ma mostra només el mes i l'any en format mes-any {{Dts|16 Novembre 1488|format=ma}} novembre 1488
d mostra només el dia {{Dts|6 Jul 1666|format=d}} 6
m mostra només el mes {{Dts|1980-02-12|format=m}} febrer
y a mostra només l'any {{Dts|-26|Gen|18|format=a}} 26 aC
hide amaga la data {{Dts|15 Octubre 1800|format=hide}}

Abreviatura del mes[modifica]

Es pot forçar l'abreviatura del més amb el paràmetre abbr=on.

Exemple

{{Dts|2001|2|3|abbr=on}} produeix 3 feb 2001

Clau d'ordenació addicional[modifica]

En cas que dues dates d'una taula siguin idèntiques, es poden demanar mitjançant el paràmetre addkey.

Examples
codi resultat
{{Dts|2010-10-10|addkey=3}} 10 octubre 2010
{{Dts|2010-10-09}} 9 octubre 2010
{{Dts|2010-10-10|addkey=1}} 10 octubre 2010
{{Dts|2010-10-10}} 10 octubre 2010
{{Dts|2010-10-10|addkey=4}} 10 octubre 2010
{{Dts|2010-10-11}} 11 octubre 2010
{{Dts|2010-10-10|addkey=2}} 10 octubre 2010

Enllaç per l'any[modifica]

Posa un enllaç a l'any amb el paràmetre yearlink=true. Aquesta funció no existeix en la versió anglesa.

Exemple

{{Dts|2010-10-09|yearlink=true}} retorna 9 octubre 2010

Ajustament de la data mostrada[modifica]

Per desactivar la supressió dels ajustaments de paraules, utilitzeu el paràmetre nowrap=off.

TemplateData[modifica]

Aquesta plantilla s'utilitza per ordenar i mostrar correctament les dates en una taula ordenable.

Paràmetres de la plantilla

ParàmetreDescripcióTipusEstat
Data completa o any1

Data completa si no s'especifiquen els paràmetres del segon al quart, en cas contrari, l'any. La data completa es pot incloure als formats "AAAA-MM-DD", "DD-MM-AAAA", "DD Mes AAAA", "Mes DD, AAAA", "AAAA-MM", "DD Mes", "Mes DD", "Mes YYYY" o "Mes". Any és un número positiu o negatiu. Si no s'especifica el quart paràmetre, els nombres negatius s'interpreten com a anys de l'era de la nostra era. El paràmetre és opcional si s'especifica el segon paràmetre.

Exemple
"1893", "-89", "-10000", "Oct", "Febrer 1767", "12 Ago 1987", "Juliol 1, 1867", "25 Octubre", "Gen 1", "2014-12-09"
Cadenaobligatori
Mes2

Nom de mes complet o abreujat o, alternativament, un número de mes que es pot emplenar a zero. El paràmetre és opcional si no s'especifica el tercer paràmetre.

Exemple
February, Feb, 2 o 02
Cadenaopcional
Dia3

Dia, opcionalment encoixinat

Exemple
7 o 07
Nombreopcional
Era4

aC o dC. Té efecte només si el primer paràmetre és un nombre positiu.

Cadenaopcional
Formatformat

Controla el format de sortida. Pot ser "dma" = "dmy", "dm", "mda" = "mdy", "md", "ma" = "my", "d", "m", "a" = "y" o "hide".

Cadenaopcional
Abreviaturaabbr

Abreuja el nom del mes

Per defecte
off
Exemple
on
Cadenaopcional
Clau d'ordenació addicionaladdkey

Afegeix una altra clau d'ordenació per resoldre conflictes entre files amb la mateixa data

Exemple
3
Nombreopcional
Enllaç a l'anyyearlink

Crea un enllaç intern a la pàgina de l'any

Exemple
true
Booleàopcional
Ajustament de la datanowrap

Per desactivar la supressió dels ajustaments de paraules, utilitzeu el paràmetre "off"

Per defecte
off
Exemple
off
Booleàopcional