https://arolstar52-zhtest.hf.space/index.php?action=history&feed=atom&title=Template%3ADate_table_sorting%2Fdoc
Template:Date table sorting/doc - 版本历史
2026-07-01T16:30:53Z
本wiki上该页面的版本历史
MediaWiki 1.43.8
https://arolstar52-zhtest.hf.space/index.php?title=Template:Date_table_sorting/doc&diff=654544&oldid=prev
2025年9月24日 (三) 11:26 imported>SunAfterRain
2025-09-24T11:26:50Z
<p></p>
<p><b>新页面</b></p><div>{{NoteTA/MediaWiki}}<br />
{{Documentation subpage}}<br />
{{Lua|Module:Date_table_sorting|Module:Date_Convert}}<br />
<templatestyles src="楷體/styles.css" /><br />
'''DTS'''代表<big>'''D'''</big>ate <big>'''T'''</big>able <big>'''S'''</big>orting（以日期排序），用於在能排序表格裡整理和顯示日期（[[:en:Help:Sorting|幫助：排序(英文)]]）。<br />
<br />
==簡介==<br />
通常如果要排序的話，日期必須要使用YYYY-MM-DD的格式輸入。但是，這格式與[[WP:MOSDATE|格式手冊]]中指定的格式不同。這模板會自動製作用作排序的排序键，但會以另外的形式顯示輸出（例如年-月-日）。<br />
<br />
==參數==<br />
<br />
===日期===<br />
{|class=wikitable<br />
|-<br />
|+年月日不一定要分開輸入。<br />
|-<br />
!width=50%|{{tlf|dts|''年''|''月''|''日''|''時代''}}<br />
!width=50%|{{tlf|dts|''日期''}}<br />
|-valign=top<br />
|<br />
*第一個參數 – 年份（如月份不空缺就非必要）<br />
**正數（1 到 9999）代表公元前或公元後年份（視乎第四个参数），第四个参数空缺的話，默認代表公元後年份。<br />
**負數（−1 到 −9999）代表公元前年份（第四个参数必須空缺）。<br />
*第二个参数 – 月份（如日子空缺就非必要）<br />
**月份的全称 – February 或 february<br />
**月份的缩写– Feb 或 feb<br />
**月份的数字 – 2 或者 02<br />
*第三个参数 – 日子（非必要）<br />
**日期数字 – 7 或 07<br />
*第四个参数 – （非必要）<br />
**可以是 BC、AD、BCE 或 CE<br />
**当年份值为正时使用<br />
|<br />
*第一个参数 – 完整日期。国际格式、{{what|美国格式}}或 YYYY-MM-DD 格式<br />
**国际格式的日期不会被改变。YYYY-MM-DD 式日期默认会转换到US格式。<br />
**可以接受月份缩写<br />
**大小写和逗号错误将被改正<br />
**模板使用{{tlxm|#time|<span></span>}}，所以它也受解析器函数的限制（例如不支持公元100年以下）<!--won't go beyond 100 AD --><br />
|}<br />
<br />
;例子<br />
{| class="wikitable sortable"<br />
!輸入風格<br />
!輸入碼<br />
!隱藏排序键<br />
!顯示的輸出<br />
{{/row|1893|top= {{/rowtop|{{tlx|Date_table_sorting|''年''}}|2}} }}<br />
{{/row|-89}}<br />
{{/row|Oct|top= {{/rowtop|{{tlx|Date_table_sorting|''月''}}}} }}<br />
{{/row|February 1767|top= {{/rowtop|{{tlx|Date_table_sorting|''月 年''}}}} }}<br />
{{/row|12 Aug 1987|top= {{/rowtop|{{tlx|Date_table_sorting|''日 月 年''}}}} }}<br />
{{/row|July 1, 1867|top= {{/rowtop|{{tlx|Date_table_sorting|''月 日, 年''}}}} }}<br />
{{/row|25 October|top= {{/rowtop|{{tlx|Date_table_sorting|''日 月''}}}} }}<br />
{{/row|Jan 1|top= {{/rowtop|{{tlx|Date_table_sorting|''月 日''}}}} }}<br />
{{/row|2014-12-09|top= {{/rowtop|{{tlx|Date_table_sorting|''YYYY-MM-DD''}}}} }}<br />
{{/row|1990|10|top= {{/rowtop|{{tlx|Date_table_sorting|''年''|''月''}}|3}} }}<br />
{{/row|1980|Dec}}<br />
{{/row|1970|August}}<br />
{{/row|2024|Jun|12|top= {{/rowtop|{{tlx|Date_table_sorting|''年''|''月''|''日''}}|2}} }}<br />
{{/row|-204|11|22}}<br />
{{/row|44|3|15|BC|top= {{/rowtop|{{tlx|Date_table_sorting|''年''|''月''|''日''|''時代''}}|2}} }}<br />
{{/row|94|Oct|17|AD}}<br />
{{/row||May|top= {{/rowtop|{{tlx|Date_table_sorting|<span></span>|''月''}}}} }}<br />
{{/row||Sep|12|top= {{/rowtop|{{tlx|Date_table_sorting|<span></span>|''月''|''日''}}}} }}<br />
|}<br />
<br />
===格式化===<br />
使用<code>format</code>可以做出一個依賴但不需要相同於提供日期的格式。這需要多次調用函數 {{tlxm|#time|<span></span>}}，減少一個頁面中使用本模板的最多召喚次數到最差88次，參見下方。<code>format</code> 參數可以用九個數值。<br />
<br />
;例子<br />
{|class="wikitable sortable"<br />
|-<br />
!值<br />
!輸出格式<br />
!輸入碼<br />
!隱藏排序键<br />
!顯示的輸出<br />
{{/row|26 Jan 1788|top= {{/rowtop||3}} |top2= {{/rowtop|年-月-日|3}} }}<br />
{{/row|March 12, 1557}}<br />
{{/row|1975-02-13}}<br />
<br />
{{/row|August 31, 1901|format=ymd |top= {{/rowtop|<code>ymd</code>|4}} |top2= {{/rowtop|年-月-日（預設）|4}} }}<br />
{{/row|2006-11-08|format=ymd}}<br />
{{/row|1888|5|8|format=ymd}}<br />
{{/row|-56|08|09|format=ymd}}<br />
<br />
{{/row|26 Jun 1988|format=md |top= {{/rowtop|<code>md</code>|2}} |top2= {{/rowtop|月-日|2}} }}<br />
{{/row|2002-05-27|format=md}}<br />
<br />
{{/row|6 July 1666|format=d |top= {{/rowtop|<code>d</code>}} |top2= {{/rowtop|日}} }}<br />
<br />
{{/row|1980-02-12|format=m |top= {{/rowtop|<code>m</code>}} |top2= {{/rowtop|月份}} }}<br />
<br />
{{/row|-26|Jan|18|format=y |top= {{/rowtop|<code>y</code>}} |top2= {{/rowtop|年份}} }}<br />
<br />
{{/row|15 October 1800|format=hide |top= {{/rowtop|<code>hide</code>}} |top2= {{/rowtop|隱藏日期}} }}<br />
<br />
|-<br />
| class="template-kai" style="background:yellow;color:blue;text-align: center;" colspan="5"| <span style="font-size:200%;">'''{{red|注意：}}以下格式雖然有效，但不符合中文習慣，請勿使用</span><br />
|-<br />
<br />
{{/row|Feb 26, 1788|format=dm |top= {{/rowtop|<code>dm</code>|2}} |top2= {{/rowtop|月-日|2}} }}<br />
{{/row|2020-10-15|format=dm}}<br />
<br />
{{/row|16 November 1488|format=my |top= {{/rowtop|<code>my</code>}} |top2= {{/rowtop|年-月}} }}<br />
<br />
{{/row|Sep 13, 1888|format=dmy |top= {{/rowtop|<code>dmy</code>|2}} |top2= {{/rowtop|日-月-年|2}} }}<br />
{{/row|1983-01-03|format=dmy}}<br />
<br />
{{/row|August 31, 1901|format=mdy |top= {{/rowtop|<code>mdy</code>|2}} |top2= {{/rowtop|月-日-年|2}} }}<br />
{{/row|2006-11-08|format=mdy}}<br />
|}<br />
<br />
当处理单一的日期参数时，除非只有一个数字（那么它将被解释为年份），模板将根据[http://www.php.net/manual/en/datetime.formats.php php date/time format]来解释参数。但由於中文習慣的格式的影響，預設皆是使用<code>年-月-日</code>。{{what|由於本模板調用函數{{tlxm|#time|<span></span>}}，因此單一頁面中最多僅能使用本模板1200次。}}<br />
<br />
===縮寫===<br />
在中文版本，只有一個方法縮寫日期：使用 <code>abbr=on</code> 參數。<br />
<br />
;例子<br />
{|class="wikitable sortable"<br />
|-<br />
!縮寫方法<br />
!輸入碼<br />
!隱藏排序键<br />
!顯示的輸出<br />
{{/row|2000-01-01|top= {{/rowtop|無|4}} }}<br />
{{/row|2000|1|1}}<br />
{{/row|1 January 2000}}<br />
{{/row|2000|January|1}}<br />
{{/row|1 Jan 2000|top= {{/rowtop|輸入月份縮寫|2}} }}<br />
{{/row|2000|Jan|1}}<br />
{{/row|1 January 2000|abbr=on|top= {{/rowtop|<code>abbr&#61;on</code>|4}} }}<br />
{{/row|2000|January|1|abbr=on}}<br />
{{/row|2000-01-01|abbr=on}}<br />
{{/row|2000|1|1|abbr=on}}<br />
|}<br />
<br />
===額外排序键===<br />
如果表格內的兩個日期一樣，它們可以利用參數 <code>addkey</code> 排序。<br />
<br />
;例子<br />
{|class="wikitable sortable"<br />
|-<br />
!輸入碼<br />
!隱藏排序键<br />
!顯示的輸出<br />
{{/row|2010-10-10|addkey=3}}<br />
{{/row|2010-10-09}}<br />
{{/row|2010-10-10|addkey=1}}<br />
{{/row|2010-10-10}}<br />
{{/row|2010-10-10|addkey=4}}<br />
{{/row|2010-10-11}}<br />
{{/row|2010-10-10|addkey=2}}<br />
|}<br />
<br />
===文字換行===<br />
要關閉自動換行的話，請使用<code>nowrap=off</code>參數。<br />
<br />
===高級用法===<br />
除了內建格式，模板也支援使用以下變數自定義格式。'''{{red|為避免混亂，請不要在條目中使用。}}'''<br />
{|class="wikitable sortable"<br />
|-<br />
!格式代碼!!說明<br />
|-<br />
|%X||模板預設格式使用的年格式（不含「年」字）<br />
|-<br />
|%x||模板啟用縮寫後使用的年格式<br />
|-<br />
|%Y||年分，數字位數補0補到4位數<br />
|-<br />
|%y||年分，未補0<br />
|-<br />
|%M||月分，數字位數補0補到2位數<br />
|-<br />
|%m||月分，未補0<br />
|-<br />
|%D||日期，數字位數補0補到2位數<br />
|-<br />
|%d||日期，未補0<br />
|-<br />
|%%||跳脫<br />
|}<br />
<br />
{|class="wikitable sortable"<br />
|-<br />
!輸入碼<br />
!隱藏排序键<br />
!顯示的輸出<br />
{{/row|999-01-01|format2=%y.%m.%d}}<br />
{{/row|2010-01-01|format2=%Y.%M.%D}}<br />
|}<br />
<br />
==註解==<br />
<br />
===排序非完整日期===<br />
====完整年份或月份====<br />
完整年份或月份（或完整年月），例如<code><nowiki>{{dts|2020}}</nowiki></code>、<code><nowiki>{{dts|Jan}}</nowiki></code>和<code><nowiki>{{dts|2020|1}}</nowiki></code>，系統會按其第一個日子排序。<br />
<br />
====沒有年份====<br />
如果未指定年份，系統將會視年份為現時年份來進行排序。<br />
<br />
===處理錯誤===<br />
輸入無效的日期格式（通常）會產生一條錯誤消息，例如{{tlx|dts|<span></span>|維基百科}}會產生以下內容：<br />
<blockquote>{{dts||維基百科}}</blockquote><br />
<br />
===曆法選擇===<br />
本模板無法區分儒略曆和公曆日期。另外，它不能從一個曆法輸入日期並按另一曆法輸出日期。所以，要確保排序良好，用戶必須把日期統一於一個曆法，或者確定一個轉折日（例如，確定1582年10月4日為儒略曆，以後的所有日期為公曆），這可以用一條條的方法實現。如果可能造成混淆，用家有責任解釋給讀者究竟顯示的日期是儒略曆還是公曆。<br />
<br />
===链接===<br />
本模板默认自动链接到日期。若要关闭链接，则可使用参数<code>link=off</code>。根据目前的指引，此模板不再支持日期的内部链接。请不要使用此参数，并请将此参数从目前的模板调用中移除。<br />
<br />
==參見==<br />
* {{tl|sort}}，以一個特定的鑰匙排序<br />
* {{tl|sortname}}，排序人名（用姓氏和名稱作為預設排序鑰匙）。<br />
* {{tl|tts}}，用於在體育賽事結果表中排序時間（只需要用於一定情況——參見該模板的文档页面）<br />
* {{tl|number table sorting}}，為數字而設<br />
<br />
<includeonly>{{Sandbox other||<!-- 本行下加入模板的分類 --><br />
[[Category:排序模板]]<br />
[[Category:日期计算模板]]<br />
}}</includeonly></div>
imported>SunAfterRain