Mostra la font per a Plantilla:Date table sorting/ús

{{Subpàgina d'ús}}
{{lua|Mòdul:Date table sorting}}
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 '''{{tl|Dts}}'''.

==Paràmetres==
===Dates===
{|class=wikitable
|-
|+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.
|-
! style="width: 50%;" |{{tlf|{{BASEPAGENAME}}|''any'' | ''mes'' | ''dia'' | ''aC''}}
! style="width: 50%;" |{{tlf|{{BASEPAGENAME}}|''data''}}
|- style="vertical-align:top;"
|
* 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 <code>format</code> produeix un format que depèn de, però no necessàriament és igual al format de la data proporcionada. El paràmetre <code>format</code> pot tenir diversos valors:

{|class=wikitable
! colspan="2"|Valor !! Funció !! Codi !! Resultat
|-
| rowspan="4" colspan="2"| || rowspan="4" |el format depèn de l'entrada || <nowiki>{{Dts|26 Gen 1788}}</nowiki> || {{Dts|26 Gen 1788}}
|-
| <nowiki>{{Dts|Març 12, 1557}}</nowiki> || {{Dts|Març 12, 1557}}
|-
| <nowiki>{{Dts|1975-02-13}}</nowiki> || {{Dts|1975-02-13}}
|-
| <nowiki>{{Dts|2001|2|3}}</nowiki> || {{Dts|2001|2|3}}
|-
|dmy || dma || mostra la data en format dia-mes-any || <nowiki>{{Dts|1888|9|13|format=dma}}</nowiki> || {{Dts|1888|9|13|format=dma}}
|-
|colspan="2"|dm || mostra només el dia i el mes en format dia-mes || <nowiki>{{Dts|1788|Feb|26|format=dm}}</nowiki> || {{Dts|1788|Feb|26|format=dm}}
|-
|colspan="2"|md || mostra només el dia i el mes en format mes-dia || <nowiki>{{Dts|26 Jun 1988|format=md}}</nowiki> || {{Dts|26 Jun 1988|format=md}}
|-
|my || ma || mostra només el mes i l'any en format mes-any || <nowiki>{{Dts|16 Novembre 1488|format=ma}}</nowiki> || {{Dts|16 Novembre 1488|format=ma}}
|-
|colspan="2"|d || mostra només el dia || <nowiki>{{Dts|6 Jul 1666|format=d}}</nowiki> || {{Dts|6 Jul 1666|format=d}}
|-
|colspan="2"|m || mostra només el mes || <nowiki>{{Dts|1980-02-12|format=m}}</nowiki> || {{Dts|1980-02-12|format=m}}
|-
|y || a || mostra només l'any || <nowiki>{{Dts|-26|Gen|18|format=a}}</nowiki> || {{Dts|-26|Gen|18|format=a}}
|-
|colspan="2"|hide || amaga la data || <nowiki>{{Dts|15 Octubre 1800|format=hide}}</nowiki> ||
|}

===Abreviatura del mes===
Es pot forçar l'abreviatura del més amb el paràmetre <code>abbr=on</code>.

;Exemple
<nowiki>{{Dts|2001|2|3|abbr=on}}</nowiki> produeix {{Dts|2001|2|3|abbr=on}}

=== Clau d'ordenació addicional ===
En cas que dues dates d'una taula siguin idèntiques, es poden demanar mitjançant el paràmetre <code>addkey</code>.

{|class="wikitable sortable"
|+ Examples
|-
!codi
!resultat
|-
|<nowiki>{{Dts|2010-10-10|addkey=3}}</nowiki> || {{Dts|2010-10-10|addkey=3}}
|-
|<nowiki>{{Dts|2010-10-09}}</nowiki> || {{Dts|2010-10-09}}
|-
|<nowiki>{{Dts|2010-10-10|addkey=1}}</nowiki> || {{Dts|2010-10-10|addkey=1}}
|-
|<nowiki>{{Dts|2010-10-10}}</nowiki> || {{Dts|2010-10-10}}
|-
|<nowiki>{{Dts|2010-10-10|addkey=4}}</nowiki> || {{Dts|2010-10-10|addkey=4}}
|-
|<nowiki>{{Dts|2010-10-11}}</nowiki> || {{Dts|2010-10-11}}
|-
|<nowiki>{{Dts|2010-10-10|addkey=2}}</nowiki> || {{Dts|2010-10-10|addkey=2}}
|}

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

;Exemple
<nowiki>{{Dts|2010-10-09|yearlink=true}}</nowiki> retorna {{Dts|2010-10-09|yearlink=true}}

=== Ajustament de la data mostrada ===
Per desactivar la supressió dels ajustaments de paraules, utilitzeu el paràmetre <code>nowrap=off</code>.

==TemplateData==
<templatedata>
{
	"params": {
		"1": {
			"label": "Data completa o any",
			"description": "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.",
			"example": "\"1893\", \"-89\", \"-10000\", \"Oct\", \"Febrer 1767\", \"12 Ago 1987\", \"Juliol 1, 1867\", \"25 Octubre\", \"Gen 1\", \"2014-12-09\"",
			"required": true,
			"type": "string"
		},
		"2": {
			"label": "Mes",
			"description": "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.",
			"example": "February, Feb, 2 o 02",
			"type": "string"
		},
		"3": {
			"label": "Dia",
			"description": "Dia, opcionalment encoixinat",
			"example": "7 o 07",
			"type": "number"
		},
		"4": {
			"label": "Era",
			"description": "aC o dC. Té efecte només si el primer paràmetre és un nombre positiu.",
			"type": "string"
		},
		"format": {
			"label": "Format",
			"description": "Controla el format de sortida. Pot ser \"dma\" = \"dmy\", \"dm\", \"mda\" = \"mdy\", \"md\", \"ma\" = \"my\", \"d\", \"m\", \"a\" = \"y\" o \"hide\".",
			"type": "string"
		},
		"abbr": {
			"label": "Abreviatura",
			"description": "Abreuja el nom del mes",
			"example": "on",
			"type": "string",
			"default": "off"
		},
		"addkey": {
			"label": "Clau d'ordenació addicional",
			"description": "Afegeix una altra clau d'ordenació per resoldre conflictes entre files amb la mateixa data",
			"example": "3",
			"type": "number"
		},
		"yearlink": {
			"label": "Enllaç a l'any",
			"description": "Crea un enllaç intern a la pàgina de l'any",
			"example": "true",
			"type": "boolean"
		},
		"nowrap": {
			"label": "Ajustament de la data",
			"description": "Per desactivar la supressió dels ajustaments de paraules, utilitzeu el paràmetre \"off\"",
			"example": "off",
			"type": "boolean",
			"default": "off"
		}
	},
	"description": "Aquesta plantilla s'utilitza per ordenar i mostrar correctament les dates en una taula ordenable."
}
</templatedata>


<includeonly>
[[Categoria:Plantilles d'ordenació]]
</includeonly>