Difference between revisions of "Template:Date precision/doc"

From blackwiki
Jump to navigation Jump to search
imported>RexxS
(Creating Template:Date precision documentation)
 
imported>Pppery
Line 1: Line 1:
 
{{Documentation subpage}}
 
{{Documentation subpage}}
 +
{{lua|Module:WikidataIB}}
 
<!-- Add categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
 
<!-- Add categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
 
This template develops the <code>getDatePrecision()</code> function from [[Module:WikidataIB]] for use in comparisons.
 
This template develops the <code>getDatePrecision()</code> function from [[Module:WikidataIB]] for use in comparisons.

Revision as of 21:31, 10 July 2020

This template develops the getDatePrecision() function from Module:WikidataIB for use in comparisons.

The getDatePrecision() function takes a property-ID (as the first unnamed parameter) and an entity-ID (as |qid=) and returns the precision of the first best date value for the given property of the given entity. If the entity-ID is not given, the entity-ID connected to the current page is used.

The precisions are an integer from 0 to 11, where the values are defined at mw:Wikibase/DataModel#Dates_and_times:

  • 0 - billion years, 1 - hundred million years, ..., 6 - millenia, 7 - century, 8 - decade, 9 - year, 10 - month, 11 - day

The getDatePrecision() function returns an empty string when there is no precision, or the property is not a date, or the current page is not connected. This can cause problems in templates if an attempt is made to compare the returned value with a number, so this template traps that and returns either the second unnamed parameter or 0 if that is not supplied.

Examples

Testing for precision can be done like this, and the default output can be changed by assigning the default a large number: