Plantilla:Data/ús

Descripció

Aquesta plantilla converteix una data a un format estàndard adequat per la Viquipèdia en català. Aquesta plantilla s'hauria d'usar només internament en altres plantilles.

Sintaxi

La plantilla té dos paràmetres opcionals:

{{data|<data a formatar>|<estil de format>}}

• <data a formatar> és la data (opcional) a aplicar el format.

  Si no s'especifica cap data, la plantilla treu la data actual.
  Per exemple, {{data}} dóna: 12 desembre.

  Si es proporciona una data, però no es pot reconèixer el format, retorna el text tal qual. Tanmateix, la majoria de formats usuals de dates es poden reconèixer, incloent diverses variacions, espais en blanc addicionals, etc.

  Notes:

  * Per un tractament correcte de les dates amb format numèric, és recomanable usar guions pel format europeu d-m-a; amb barres inclinades s'interpreta el format americà m/d/a.

  * Algunes dates es converteixen encara que no ho siguin realment, i algunes altres dates no es converteixen encara que sí que ho siguin. Vegeu els problemes coneguts més avall.

  * Només suporta dates entre l'1 gener 1000 i 31 desembre 9999. Les dates amb anys de dos dígits poden tenir resultats inesperats. Altres dates fora del rang 1000–9999 seran tractades con si el segon paràmetre fos igual a "none".

• <estil de format> controla el format amb el que es presentarà la data. Els valors reconeguts pel segon paràmetre són:

  * none no aplica cap format

  * dmy mostra d mes aaaa (p. ex. 25 desembre 2011). Aquest és el format per defecte.

  * mdy mostra mes d, aaaa (p. ex. desembre 25, 2011)

  * ymd mostra aaaa mes dd (p. ex. 2011 desembre 25)

  * iso mostra l'estil ISO 8601 aaaa-mm-dd (p. ex. 2011-12-25)

  Si es proporciona una data però sense cap estil especificat, la plantilla usa el format per defecte "d mes aaaa". Si no s'especifica cap data, retorna la data actual sense l'any, amb format "d mes" per defecte dmy o bé "mes d" per els estils de format mdy, ymd i iso.

  Notes:

  * Encara que aquests són els quatre formats tractats pel MediaWiki, només el format dmy és adequat per la Viquipèdia en català. L'ús del format iso està desaconsellat en el text d'un article, però pot ser útil per l'ordenació de dates en taules.

Exemples

Amb resultat vàlid

Format	Entrada	Sortida
Sense cap format	{{data|2006-08-04}}	4 agost 2006
	{{data|Aug 4, 2006}}	4 agost 2006
	{{data|4 Aug 2006}}	4 agost 2006
	{{data|4 juny 2006}}	4 juny 2006
	{{data|4 Aug}}	4 agost
	{{data|Aug 4}}	4 agost
	{{data}}	12 desembre
format none	{{data|2006-08-04|none}}	2006-08-04
	{{data|Aug 4, 2006|none}}	aug 4, 2006
	{{data|4 Aug 2006|none}}	4 aug 2006
	{{data|4 Aug|none}}	4 aug
	{{data|Aug 4|none}}	aug 4
	{{data||none}}
format dmy	{{data|2006-08-04|dmy}}	4 agost 2006
	{{data|Aug 4, 2006|dmy}}	4 agost 2006
	{{data|4 Aug 2006|dmy}}	4 agost 2006
	{{data|4 Aug|dmy}}	4 agost
	{{data|Aug 4|dmy}}	4 agost
	{{data||dmy}}	12 desembre
format mdy	{{data|2006-08-04|mdy}}	agost 4, 2006
	{{data|Aug 4, 2006|mdy}}	agost 4, 2006
	{{data|4 Aug 2006|mdy}}	agost 4, 2006
	{{data|4 Aug|mdy}}	agost 4
	{{data|Aug 4|mdy}}	agost 4
	{{data||mdy}}	desembre 12
format ymd	{{data|2006-08-04|ymd}}	2006 agost 4
	{{data|Aug 4, 2006|ymd}}	2006 agost 4
	{{data|4 Aug 2006|ymd}}	2006 agost 4
	{{data|4 Aug|ymd}}	agost 4
	{{data|Aug 4|ymd}}	agost 4
	{{data||ymd}}	desembre 12
format iso	{{data|2006-08-04|iso}}	2006-08-04
	{{data|Aug 4, 2006|iso}}	2006-08-04
	{{data|4 Aug 2006|iso}}	2006-08-04
	{{data|4 Aug|iso}}	agost 4
	{{data|Aug 4|iso}}	agost 4
	{{data||iso}}	desembre 12

Altres entrades acceptables

Altres formats diversos són tractats correctament per la plantilla:

Entrada	Sortida
{{data|1st December 2008}} (format anglès amb ordinal)	1 desembre 2008
{{data|June 24 2006}} (format anglès sense la coma)	24 juny 2006
{{data|24 Juny 2006}} (mes en majúscula)	24 juny 2006
{{data|24 jun}} (abreviatura anglesa del mes)	24 juny
{{data|June 2006}}	juny 2006

Resultats no vàlids

Si la plantilla no pot formatar la data d'entrada, retorna el mateix text. Això inclou dates amb enllaços.

Entrada	Sortida
{{data|23007-031-24}}	23007-031-24
{{data|1 [[desembre]] [[2008]]|ymd}}	1 desembre 2008
{{data|1 December [[2008 en els vols espacials|2008]]|mdy}}	1 december 2008
{{data|1/12/2008}}	12 gener 2008 (amb barres s'interpreta com a format anglès mm/dd/aaaa, a diferència de l'europeu dd-mm-aaaa)

Problemes coneguts

Mesos en català

• Els valors en text dels mesos són en anglès, en la seva forma completa o abreujada. L'entrada dels noms dels mesos en català fa que la plantilla retorni el mateix valor (només converteix de majúscula a minúscula), excepte el mes de juny que té una problemàtica especial que la plantilla tracta de corregir en particular (tema:Sila69ae0uq7sd8m).

Valors fora del rang que són convertits

• La llibreria PHP de la que depèn en última instància aquesta plantilla converteix els valors fora de rang al valor més aproximat dintre del rang. Com a resultat, alguns valors que no són realment dates es converteixin de totes formes. Això inclou...
  • Totes les dates amb el dia zero. El dia zero d'un mes es converteix en el darrer dia del mes anterior.
    Per exemple, {{data|June 0, 2006}} dóna: 31 maig 2006.
    Igualment, {{date|0-1-2006}} es converteix en: 31 desembre 2005.
  • Totes les dates amb un valor de dia superior al nombre de dies del mes especificat es converteixen incrementant els dies en el mes següent.
    Per exemple, {{data|31 nov 2008}} resulta: 1 desembre 2008.
    Igualment, {{data|29 February 2007}} resulta: 1 març 2007 (l'any 2007 no era de traspàs).
    Nota: Degut a una particularitat en la llibreria PHP, 'December 32' i '32 December' són tractats de forma diferent, la darrera dóna una error (la plantilla retorna el mateix text) i només la primera salta al mes següent.

Dates només en calendari gregorià

• La llibreria PHP de la que depèn en última instància aquesta plantilla assumeix que totes les dates, independentment del context, són del calendari gregorià. En conseqüència:
  • Algunes dates que serien vàlides en un context no gregorià són tractades com a dates fora de rang i convertides al valor més aproximats dins del rang. Per exemple, {{data|30 feb 1712}} resulta: 1 març 1712 (encara que és una data vàlida en el calendari suec, el febrer del 1712 només tenia 29 dies en el calendari gregorià).
  • Hi ha deu dates que no són tractades: el 29 de febrer i l'1 de març dels anys 1000, 1100, 1300, 1400 i 1500. El motiu és el mateix que la data sueca del 30 de febrer de 1712.
  • Algunes dates que no serien vàlides en algun context es converteixen de forma normal. Per exemple, 29 febrer 1912 o 1 febrer 1918 no són vàlides en un context rus, però perfectament vàlides en un de gregorià.

Format ISO 8601 no adequat per anys abans del 1583

L'estàndard ISO 8601 demana un acord mutu pels que utilitzin el format per anys anteriors al 1583. Com que no és possible un acord amb els nostres lectors, aquest format no s'hauria d'utilitzar per aquests anys, com tampoc cap data fora del calendari gregorià.