Plantilla:Circa WD/ús

Aquesta és una subpàgina de documentació per a la Plantilla:Circa WD Té la informació d'ús, les categories i qualsevol altre contingut que no forma part essencial del codi de la plantilla.

Aquesta plantilla és utilitzada en més de 300000 pàgines. Per evitar la interrupció a gran escala i la innecessària càrrega del servidor, qualsevol canvi en aquesta plantilla primer hauria de ser provat en la subpàgina /proves, o en el vostre propi espai d'usuari. Els canvis assajats després es poden afegir a aquesta pàgina en una sola edició. Si us plau: considereu discutir qualsevol canvi en la pàgina de discussió abans d'implementar-los.

Funció per tractar dates de WD (la propietat que s'indiqui com a paràmetre 1) considerant els qualificadors:

• Circumstàncies de la font (P1480)
• Data més precisa (P4241)
• Després de (P1319)
• Abans de (P1326)

Les dates poden contenir valor desconegut o una data expressada amb diferent precisió. Quan les dates estan expressades en el nivell de detall apropiat pel concepte que reflecteixen (dia, per dates de naixement/defunció, esdeveniments, etc. / any, per una data de publicació o de creació d'una obra, etc. / dècada o segle, per un període històric, etc..) no fa falta fer servir aquests qualificadors. Ara bé, quan no és coneix amb precisió però si amb una certa aproximació, és quan aquests qualificadors ens ajuden a ajustar el valor dins la imprecisió.

Els valors gestionats són

• Per Circumstàncies de la font (P1480) està previst tractar "Circa (Q5727902)", "Presumiblement (Q18122778)" i "Presumiblement (Q18122778)"
• Per Data més precisa (P4241). Està previst tractar:

• parts, com A començament (Q40719727), A mitjan (Q40719748) i Al final (Q40719766)
• meitats, normalment aplicables a anys, dècades o segles Primera meitat (Q40719687) i Segona meitat (Q40719707)
• quarts, normalment aplicables a segles o mil·lennis: Primer quart (Q40690303), Segon quart (Q40719649), Tercer quart (Q40719662) i Darrer quart (Q40719674)

• En el cas de Abans de (P1326) i Després de (P1319) es convenient que el seu valor estigui expressat amb precisió d'any o major, ja que no tindria sentit fer servir una precisió genèrica en un qualificador que pretén concretar.

Detalls de funcionament

• L'ús d'aquests qualificadors, com s'ha explicat més amunt, no s'han de fer servir amb dates d'alta precisió.
• Els qualificadors P1480 i P4241 poden coexistir junts, però NO es mostraran si data = valor desconegut.
• Els qualificadors Abans de (P1326) i Després de (P1319) poden aparèixer simultàniament o separats. Si apareixen tots dos, no és mostrarà el valor de data
  • Quan es fa servir P1326 i/o P1319 el valor de data pot ser valor desconegut o un valor concret, com ara segle o dècada. En aquest segon cas, cal tenir cura que el valor de data no sigui inconsistent amb el contingut dels qualificadors. Exemple: data=dècada 1920 + abans de 1915 o després de 1925.
  • No té sentit fer servir P1326 i P1319 per indicar el primer i darrer any del període que indica data. Exemple: data=dècada 1920 + abans de 1929 + després de 1920.

Dates multivalor

Habitualment les propietats de data tenen només un valor, però en determinades circumstàncies hi ha multivalors en aquestes propietats. La funció pot tractar tots els valors que tingui una propietat (entre 1 i n). En aquest cas, el tractament dels qualificadors es fa independent per cada element de la llista de valors amb els qualificadors que tingui cadascun. Quan es vulgui forçar a que tant sols tracti un valor (el prefered o el primer de la llista) s'indicarà list=false.

{{circa WD|Pnnn|item=Qnnnnnn |formatting=  |separator=  |conjunction= |list= }}

• Pnnn = és la propietat de la data a recuperar. És posicional.
• item = codi ítem de WD sobre el que treballar. Opcional, si no s'informa, s'aplica a l'article en curs.
• formatting = Opcional. Permet indicar el format que se li vol aplicar a la data recuperada (independentment de que tingui o no algun dels qualificadors tractats). Veure possibles valors a Mòdul:Wikidata/ús
• separator = Opcional. Separador que es vol aplicar entre valors, cas que la propietat sigui multivalor. Per defecte és una coma.
• conjunction = Opcional. Separador entre els dos darrers valors, cas que la propietat sigui multivalor. Per defecte és una lletra "i".
• list = Opcional. Pot ser list=false per a indicar-li que només tracti el primer valor de la llista, list=firstrank per obtenir la llista dels valors amb el primer rang més alt. El valor per defecte és list=true, que tractarà tots els valors que trobi.