Modelo:Circa WD

Función para tratar datas de WD (a propiedade que se indique como parámetro 1) considerando os cualificadores:

• Circunstancias da fonte (P1480)
• Data máis precisa (P4241)
• Despois de (P1319)
• Antes de (P1326)

As datas poden conter valor descoñecido ou unha data expresada con diferente precisión. Cando as datas están expresadas no nivel de detalle apropiado polo concepto que reflicten (día, por datas de nacemento/defunción, acontecementos, etc. / ano, por unha data de publicación ou de creación dunha obra, etc. / década ou século, por un período histórico, etc..) non fai falta usar estes cualificadores. Agora ben, cando non se coñece con precisión pero si cunha certa aproximación, é cando estes cualificadores axudan a axustar o valor dentro da imprecisión.

Os valores xestionados son

• Para Circunstancias da fonte (P1480) está previsto tratar "Circa (Q5727902)", "Presumiblemente (Q18122778)" e "Presumiblemente (Q18122778)"
• Para Data máis precisa (P4241). Está previsto tratar:

• partes, como a principios (Q40719727), a mediados (Q40719748) e a finais (Q40719766)
• metades, normalmente aplicables a anos, décadas ou séculos primeira metade (Q40719687) e segunda metade (Q40719707)
• cuartos, normalmente aplicables en séculos ou milenios: primeiro cuarto (Q40690303), segundo cuarto (Q40719649), terceiro cuarto (Q40719662) e último cuarto (Q40719674)

• No caso de Antes de (P1326) e Despois de (P1319) é conveniente que o seu valor estea expresado con precisión de ano ou maior, posto que non tería sentido usar unha precisión xenérica nun cualificador que pretende concretar.

Detalles de funcionamento

• O uso destes cualificadores, como se explicou máis arriba, non se teñen que usar con datas de alta precisión.
• Os cualificadores P1480 e P4241 poden coexistir xuntos, pero NON se mostrarán se data = valor descoñecido.
• Os cualificadores Antes de (P1326) e Despois de (P1319) poden aparecer simultaneamente ou separados. Se aparecen os dous, non se mostrará o valor de data
  • Cando se usa P1326 e/ou P1319 o valor de data pode ser valor descoñecido ou un valor concreto, por exemplo século ou década. Neste segundo caso, hai que ter en conta que o valor de data non sexa inconsistente co contido dos cualificadores. Exemplo: data=década 1920 + antes de 1915 ou despois de 1925.
  • Non ten sentido usar P1326 e P1319 para indicar o primeiro e último ano do período que indica data. Exemplo: data=década 1920 + antes de 1929 + despois de 1920.

Datas multivalor

Habitualmente as propiedades de data teñen só un valor, pero en determinadas circunstancias hai multivalores nestas propiedades. A función pode tratar todos os valores que teña unha propiedade (entre 1 e n). Neste caso, o tratamento dos cualificadores faise de forma independente por cada elemento da lista de valores cos cualificadores que teña cada un. Cando se queira forzar a que tanto só trate un valor (o prefered ou o primeiro da lista) indicarase list=false.

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

• Pnnn = é a propiedade da data a recuperar. É posicional.
• item = código ítem de WD sobre o que traballar. Opcional, se non se informa, aplícase ao artigo en curso.
• formatting = Opcional. Permite indicar o formato que se lle quere aplicar á data recuperada (independentemente de que teña ou non algún dos cualificadores tratados). Ver posibles valores en Módulo:Wikidata/uso
• separator = Opcional. Separador que se quere aplicar entre valores, en caso de que a propiedade sexa multivalor. Por defecto é unha coma.
• conjunction = Opcional. Separador entre os dous últimos valores, en caso de que a propiedade sexa multivalor. Por defecto é unha letra "e".
• list = Opcional. Pode ser list=false para indicarlle que só trate o primeiro valor da lista, list=firstrank para obter a lista dos valores co primeiro rango máis alto. O valor por defecto é list=true, que tratará todos os valores que atope.