View source for Template:Auc/doc

{{Documentation subpage}}
<!-- Add categories where indicated at the bottom of this page and interwikis at Wikidata -->

This template converts a [[Gregorian calendar|Gregorian]] or [[Astronomical year numbering|astronomical]] year to [[Ab urbe condita|Ab Urbe Condita]] and vice versa.

== Usage ==

{{markup
|<nowiki>{{auc|2020}}</nowiki>
|{{auc|2020}}

|<nowiki>{{auc|322|CE}}</nowiki>
|{{auc|322|CE}}

|<nowiki>{{auc|1|AUC}}</nowiki>
|{{auc|1|AUC}}

|<nowiki>{{auc|1|AD|disp=eq}}</nowiki>
|{{auc|1|AD|disp=eq}}

|<nowiki>{{auc|1|BC|disp=or}}</nowiki>
|{{auc|1|BC|disp=or}}

|<nowiki>{{auc|33|bc|abbr=greg}}</nowiki>
|{{auc|33|bc|abbr=greg}}

|<nowiki>{{auc|450|BCE|alinks=off}}</nowiki>
|{{auc|450|BCE|alinks=off}}

|<nowiki>{{auc|321|ad|disp=note}}</nowiki>
|{{auc|321|ad|disp=note}}

|<nowiki>{{auc|99|bce|swap=auc}}</nowiki>
|{{auc|99|bce|flip=auc}}
}}

=== Notes ===
{{notelist}}

== Parameters ==
{| class="wikitable sortable collapsible {{{state|uncollapsed}}}" style="width:100%;"
! colspan=4 style="background:#eee" | {{navbar-collapsible|'''Parameter options for {{tlx|auc}}'''|auc/doc}}
|-
! Parameter
! Value
! Description
! Note
|-
| {{para|1}}
| data-sort-value="1" | ''[number]''
| The year to convert to [[Ab urbe condita|Ab Urbe Condita]]
| This can be a number greater than zero, in accordance with the [[Gregorian calendar]], or zero or a negative number, in accordance with the [[Astronomical year numbering|astronomical calendar]].
|-
| rowspan=6 | {{para|2}}
| data-sort-value="2" | '''<code>ce</code>'''
| rowspan=4 | A [[Gregorian calendar|Gregorian year]] will be converted to [[Ab Urbe Condita]] ''(default)''
| "...&nbsp;[[Common Era|CE]]"
|-
| data-sort-value="ad" | <code>ad</code>
| "[[Anno Domini|AD]]&nbsp;..."
|-
| data-sort-value="bce" | <code>bce</code>
| "...&nbsp;[[Before Common Era|BCE]]"
|-
| data-sort-value="bc" | <code>bc</code>
| "...&nbsp;[[Before Christ|BC]]"
|-
| data-sort-value="auc" | <code>auc</code>
| rowspan=2 | A year ''Ab Urbe Condita'' will be converted to a Gregorian year
| "[[Ab Urbe Condita|AUC]]&nbsp;..."<br /><br />E.g.: <code><nowiki>{{auc|1|AUC}}</nowiki></code> &rarr; "{{auc|1|AUC}}"
|-
| data-sort-value="puc" | <code>puc</code>
| "[[Ab Urbe Condita|PUC]]&nbsp;..."<br /><br />E.g.: <code><nowiki>{{auc|233|PUC}}</nowiki></code> &rarr; "{{auc|233|PUC}}"
|-
| rowspan=2 | {{para|main}}
| data-sort-value="main" | '''<code>auc</code>'''
| The year ''Ab Urbe Condita'' is considered the main focus, therefore the Gregorian year will be shown in brackets ''(default)''
| E.g.: "{{auc|1997|CE|main=auc}}"
|-
| data-sort-value="greg" | <code>greg</code>
| The Gregorian year is considered the main focus, therefore the year ''Ab Urbe Condita'' will be shown in brackets 
| E.g.: "{{auc|1997|CE|main=greg}}"
|-
| rowspan=6 | {{para|abbr}}
| data-sort-value="on" | '''<code>on</code>'''
| rowspan=2 | Use the abbreviated name for all [[calendar era]]s ''(default)''
| rowspan=2 | Display "[[Ab urbe condita|AUC]]" instead of "[[Ab urbe condita|Ab Urbe Condita]]", "[[Ab urbe condita|PUC]]" instead of "[[Ab urbe condita|Pre Urbe Condita]]", "[[Common Era|CE]]" instead of "[[Common Era]]", "[[Anno Domini|AD]]" instead of "[[Anno Domini]]", "[[Before Common Era|BCE]]" instead of "[[Before Common Era]]", "[[Before Christ|BC]]" instead of "[[Before Christ|BC]]"
|-
| data-sort-value="all" | '''<code>all</code>'''
|-
| data-sort-value="greg" | <code>greg</code>
| Abbreviate only the [[calendar era]]s that refer to the [[Gregorian calendar]]
| Use the abbreviations "[[Common Era|CE]]", "[[Anno Domini|AD]]", "[[Before Common Era|BCE]]" and "[[Before Christ|BC]]", but do not abbreviate "[[Ab urbe condita|Ab Urbe Condita]]" and "[[Ab urbe condita|Pre Urbe Condita]]".
|-
| data-sort-value="auc" | <code>auc</code>
| Abbreviate only the [[calendar era]]s that refer to the [[Roman calendar]]
| Use the abbreviations "[[Ab urbe condita|AUC]]" and "[[Ab urbe condita|PUC]]", but do not abbreviate "[[Common Era]]", "[[Anno Domini]]", "[[Before Common Era]]" and "[[Before Christ]]"
|-
| data-sort-value="off" | <code>off</code>
| rowspan=2 | Use the long name for all [[calendar era]]s
| rowspan=2 | No abbreviations: all [[calendar era]]s will be expanded
|-
| data-sort-value="none" | <code>none</code>
|-
| rowspan=9 | {{para|disp}}
| data-sort-value="b" | '''<code>b</code>'''
| Join input and output using "...&nbsp;(...)" ''(default)''
| E.g.: "{{auc|554|BCE|disp=b}}"
|-
| data-sort-value="sqrb" | <code>sqrb</code>
| Join input and output using "...&nbsp;[...]"
| E.g.: "{{auc|33|AD|disp=sqrb}}"
|-
| data-sort-value="eq" | <code>eq</code>
| Join input and output using "...&nbsp;&equals;&nbsp;..."
| E.g.: "{{auc|600|BC|disp=eq}}"
|-
| data-sort-value="comma" | <code>comma</code>
| Join input and output using "...,&nbsp;..."
| E.g.: "{{auc|110|CE|disp=comma}}"
|-
| data-sort-value="or" | <code>or</code>
| Join input and output using "...&nbsp;or&nbsp;..."
| E.g.: "{{auc|400|BCE|disp=or}}"
|-
| data-sort-value="bor" | <code>bor</code>
| Join input and output using "...&nbsp;(or&nbsp;...)"
| E.g.: "{{auc|11|AD|disp=bor}}"
|-
| data-sort-value="note" | <code>note</code>
| Join input and output using <code><nowiki>...{{efn|...}}</nowiki></code>
| E.g.: "{{auc|121|BCE|disp=note}}"<br /><br />'''Notes'''<br />{{notelist}}
|-
| data-sort-value="alone" | <code>alone</code>
| Display only the number of years and the [[calendar era]] according to the {{para|main}} parameter
| E.g.: "{{auc|211|CE|disp=alone}}"
|-
| data-sort-value="number" | <code>number</code>
| Display only a [[natural number]] without any [[Calendar era|era]]
| If {{para|1}} is a Gregorian year, the number returned equals the value of that year in the [[Astronomical year numbering|astronomical calendar]] plus 753; if {{para|1}} is an year ''Ab Urbe Condita'', the number returned equals exactly the value of that year in the [[Astronomical year numbering|astronomical calendar]].<br /><br />E.g.: <code><nowiki>{{auc|1|disp=number}}</nowiki></code> &rarr; "{{auc|1|disp=number}}"
|-
| rowspan=6 | {{para|alinks}}
| data-sort-value="links" | '''<code>on</code>'''
| rowspan=3 | Create automatic links for the eras referred (<code>CE</code>, <code>BCE</code>, <code>AD</code>, <code>BC</code>, <code>AUC</code>, <code>PUC</code>) ''(default)''
| rowspan=3 | Default behavior
|-
| data-sort-value="none" | '''<code>yes</code>'''
|-
| data-sort-value="none" | '''<code>true</code>'''
|-
| data-sort-value="none" | <code>off</code>
| rowspan=3 | Do not create automatic links for the eras referred
| rowspan=3 | E.g.: "{{auc|12|BCE|alinks=off}}"
|-
| data-sort-value="none" | <code>no</code>
|-
| data-sort-value="none" | <code>false</code>
|-
| {{para|page}}
| data-sort-value="page" | ''<code><nowiki>[</nowiki>wiki-page-name<nowiki>]</nowiki></code>''
| rowspan=3 | Connects the years returned to specific pages; setting one of these parameters overrides the effects of the {{para|alinks}} parameter on that year
| Synonym of {{para|greg-page}}
|-
| {{para|greg-page}}
| data-sort-value="greg-page" | ''<code><nowiki>[</nowiki>wiki-page-name<nowiki>]</nowiki></code>''
| E.g.:<br /><code><nowiki>{{auc|12|CE|greg-page=AD 12}}</nowiki></code><br />↓<br />"{{auc|12|CE|greg-page=AD 12}}"
|-
| {{para|auc-page}}
| data-sort-value="auc-page" | ''<code><nowiki>[</nowiki>wiki-page-name<nowiki>]</nowiki></code>''
| E.g.:<br /><code><nowiki>{{auc|12|CE|auc-page=AD 12|alinks=off}}</nowiki></code><br />↓<br />"{{auc|12|CE|auc-page=AD 12|alinks=off}}"
|-
| rowspan=4 | {{para|flip}}
| data-sort-value="flip" | '''<code>none</code>'''
| Keep the normal order of year and era ''(default)''
| Default behavior
|-
| data-sort-value="auc" | <code>auc</code>
| Invert the order of year and era in the ''Ab Urbe Condita'' part
| E.g.: "{{auc|71|AD|flip=auc}}"
|-
| data-sort-value="greg" | <code>greg</code>
| Invert the order of year and era in the Gregorian part
| E.g.: "{{auc|71|AD|flip=greg}}"
|-
| data-sort-value="all" | <code>all</code>
| Invert the order of year and era everywhere
| E.g.: "{{auc|71|AD|flip=all}}"
|-
|}

== Aliases ==
* {{tl|Ab urbe condita}}
* {{tl|AUC}}

== Subtemplates ==
* {{tl|Auc/data/year}}
* {{tl|Auc/data/doublet}}
* {{tl|Auc/data/abbr}}

== See also ==
* [[Ab urbe condita]]
* [[Year zero]]
* {{tl|Year in various calendars}}

<includeonly>{{sandbox other||
<!-- Categories below this line; interwikis at Wikidata -->
[[Category:Date conversion templates]]
}}</includeonly>