Plantilla:Date table sorting

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

Dates

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

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

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

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

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

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

TemplateData

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

Paràmetres de la plantilla[Edita les dades de la plantilla]

Paràmetre		Descripció	Tipus	Estat
Data completa o any	1	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"	Cadena	obligatori
Mes	2	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	Cadena	opcional
Dia	3	Dia, opcionalment encoixinat Exemple 7 o 07	Nombre	opcional
Era	4	aC o dC. Té efecte només si el primer paràmetre és un nombre positiu.	Cadena	opcional
Format	format	Controla el format de sortida. Pot ser "dma" = "dmy", "dm", "mda" = "mdy", "md", "ma" = "my", "d", "m", "a" = "y" o "hide".	Cadena	opcional
Abreviatura	abbr	Abreuja el nom del mes Per defecte off Exemple on	Cadena	opcional
Clau d'ordenació addicional	addkey	Afegeix una altra clau d'ordenació per resoldre conflictes entre files amb la mateixa data Exemple 3	Nombre	opcional
Enllaç a l'any	yearlink	Crea un enllaç intern a la pàgina de l'any Exemple true	Booleà	opcional
Ajustament de la data	nowrap	Per desactivar la supressió dels ajustaments de paraules, utilitzeu el paràmetre "off" Per defecte off Exemple off	Booleà	opcional

La documentació de més amunt està transclosa de Plantilla:Date table sorting/ús. (modifica | historial)
Els editors poden fer proves amb aquesta plantilla al seu espai de proves (crea | modifica)
Afegiu categories en la subpàgina /ús. Vegeu les subpàgines d'aquesta plantilla, utilització de paràmetres.