编辑“︁模板:Wikidata/doc”︁（章节）

== Flags ==
The following (optional) flags are available which can be used to alter this {{lcfirst:{{NAMESPACE}}}}'s behaviour. They must be given after the (first) {{Background color|#cddae3|command}} and before the {{Background color|#ffdfc4|positional arguments}}. For convenience, empty flags (i.e. <code>||</code>) are allowed and will simply be ignored.

=== Command flags ===
These flags (<code>{{Background color|#cddae3|flag1*}}</code>, <code>{{Background color|#dce5ec|flag2*}}</code>, ...) apply to the command that precedes them directly.
{| class="wikitable"
|-
! Flag
! Description
|-
! style="text-align:left;" | <code>raw</code>
| Returns the raw value if applicable.

If this flag is used with item or property datatypes, then this will return the Q-identifier or P-identifier instead of the regular label.

For quantity datatypes, this flag will strip off any units of measurement, unless the <code>unit</code> flag is also given in which case the raw unit of measurement (its Q-identifier) will be returned.

If this flag is used with time datatypes, then the returned date will be in the format of <code>yyyy-mm-dd</code> (e.g. <code>1731-02-11</code>), or <code>yyyy-mm</code>, or <code>yyyy</code> depending on the date's precision. Dates in the Julian calendar stored with a precision of days through millenniums will have <code>/Julian</code> attached to the output (e.g. <code>1731-02-11/Julian</code>, which may be split off using the [[mw:Help:Extension:ParserFunctions#.23titleparts|<nowiki>{{#titleparts}}</nowiki> parser function]]).

If it is used with globe coordinate datatypes, then it replaces the various symbols with forward slashes in the returned value (e.g. <code>52/5/3/N/4/19/3/E</code>, which may be split into parts using the [[mw:Help:Extension:ParserFunctions#.23titleparts|<nowiki>{{#titleparts}}</nowiki> parser function]]).
|-
! style="text-align:left;" | <code>linked</code>
| Creates a link to the Wikipedia article that is connected to the property or qualifier if it exists. Also links units of measurement that may be appended to values.

If this parameter is omitted, then the plain property or qualifier value will be returned.
|-
! style="text-align:left;" | <code>short</code>
| '''<code>{{color|red|[EXPENSIVE]}}</code>''' Returns the {{wpl|P1813}} of any entity returned if they have one attached. If that is not the case, then the default behaviour of returning the entity's label will occur.
|-
! style="text-align:left;" | <code>multilanguage</code>
| Returns monolingual text values in any available language, not just the current wiki's language.
|-
! style="text-align:left;" | <code>unit</code>
| Returns only the unit of measurement for quantity datatypes.
|}

=== Configuration flags ===
These flags (<code>{{Background color|#c1debf|flag0*}}</code>) are general configuration flags and can be given anywhere after the first {{Background color|#cddae3|command}} (but before the {{Background color|#ffdfc4|positional arguments}}).
{| class="wikitable"
|-
!
! Flag
! Description
! Command class
|-
| rowspan="4" style="text-align:right;" | {{nowrap|Combination of:}}
! style="text-align:left;" | <code>preferred</code>
| rowspan="4" | Sets a rank constraint for the selected claim(s).

The first three set the ranks for which claim(s) will be selected. They can optionally be followed by a <code>+</code> or a <code>-</code>, e.g. <code>normal+</code> or <code>preferred-</code>, where the first selects claims with a 'normal' rank ''or higher'' and the second selects claims with a 'preferred' rank ''or lower''. To get claims of all ranks, use <code>preferred-</code> or <code>deprecated+</code>.

If the <code>best</code> flag is given additionally, then only the claims that have the highest rank amongst the selected claims will be returned.

The default is <code>normal+|best</code> (so by default claims with a 'deprecated' rank are never returned).

Output is always sorted from highest rank to lowest (regardless of any of these flags being set).
| rowspan="4" | [[#Claim class|claim]]
|-
! style="text-align:left;" | <code>normal</code>
|-
! style="text-align:left;" | <code>deprecated</code>
|-
! style="text-align:left;" | <code>best</code>
|-
| rowspan="3" style="text-align:right;" | {{nowrap|Combination of:}}
! style="text-align:left;" | <code>future</code>
| rowspan="3" | Sets a time constraint for the selected claim(s). Uses the claims' qualifiers of {{wpl|P580}} and {{wpl|P582}} to determine if the claim is valid for the selected time period(s).

The default is <code>future|current|former</code> (so by default claims that are valid for any time period are returned), except when <code>date=</code> is given ([[#Named arguments|see below]]) in which case the default is <code>current</code>.
| rowspan="3" | claim
|-
! style="text-align:left;" | <code>current</code>
|-
! style="text-align:left;" | <code>former</code>
|-
|
! style="text-align:left;" | <code>mdy</code>
| Returns date values in month-day-year order instead of day-month-year order.
| claim
|-
|
! style="text-align:left;" | <code>single</code>
| Returns only a single claim instead of multiple (if multiple claims match). Has no effect if the <code>property</code>/<code>properties</code> command is given, in which case this flag would be redundant.
| claim
|-
|
! style="text-align:left;" | <code>sourced</code>
| Only returns claims that have at least one non-empty reference. (References having only [[#Ignored parameters|ignored parameters]] are considered empty.)
| claim
|-
| rowspan="2" style="text-align:right;" | {{nowrap|One of:}}
! style="text-align:left;" | <code>edit</code>
| rowspan="2" | Adds a clickable icon after the output that may be used by readers to edit the returned claim on Wikidata.

If <code>edit@end</code> is used, then the icon will be placed at the end of the line for neat alignment in infoboxes.
| rowspan="2" | claim, [[#General class|general]]
|-
! style="text-align:left;" | <code>edit@end</code>
|- style="display:none;"
| colspan="4" | <!-- non-displayed row to avoid breaking table with sticky headers gadget -->
|}