Pang-bô͘:Date table sorting/doc
 |
Che sī chi̍t phiⁿ soat-bêng chhù-ia̍h, sī ūi Pang-bô͘:Date table sorting siá--ê. Chia ū hâm sú-iōng chu-sìn, lūi-pia̍t kap kî-tha bô sio̍k goân-pún pang-bô͘ ia̍h ê chi̍t pō͘-hūn. |
 | Sú-iōng Lua thêng-sek: |
為正常顯示白話字，請暫時用{{Date table sorting/nan}}代替此模板。
DTS代表Date Table Sorting（以日期排序），用於在能排序表格裡整理和顯示日期（幫助：排序(英文)）。
它解決的問題
siu-kái通常如果要排序的話，日期必須要使用YYYY-MM-DD的格式輸入。但是，這格式與格式手冊中指定的格式不同。這模板會自動製作用作排序的排序键，但會以另外的形式顯示輸出（例如年-月-日）。
參數
siu-kái日期
siu-kái| {{dts|年|月|日|時代}} | {{dts|日期}} |
|---|---|
|
|
- 例子
| 輸入風格 | 輸入碼 | 隱藏排序键 | 顯示的輸出 |
|---|---|---|---|
{{Date_table_sorting|1893}}
|
000000001893-01-01-0000 | 1893年 | |
{{Date_table_sorting|-89}}
|
-999999999911-01-01-0000 | 公元前89年 | |
{{Date_table_sorting|Oct}}
|
000000002024-10-01-0000 | 10月 | |
{{Date_table_sorting|February 1767}}
|
000000001767-02-01-0000 | 1767年2月 | |
{{Date_table_sorting|12 Aug 1987}}
|
000000001987-08-12-0000 | 1987年8月12日 | |
{{Date_table_sorting|July 1, 1867}}
|
000000001867-07-01-0000 | 1867年7月1日 | |
{{Date_table_sorting|25 October}}
|
000000002024-10-25-0000 | 2024年10月25日 | |
{{Date_table_sorting|Jan 1}}
|
000000002024-01-01-0000 | 2024年1月1日 | |
{{Date_table_sorting|2014-12-09}}
|
000000002014-12-09-0000 | 2014年12月9日 | |
{{Date_table_sorting|1990|10}}
|
000000001990-10-01-0000 | 1990年10月 | |
{{Date_table_sorting|1980|Dec}}
|
000000001980-12-01-0000 | 1980年12月 | |
{{Date_table_sorting|1970|August}}
|
000000001970-08-01-0000 | 1970年8月 | |
{{Date_table_sorting|2024|Jun|12}}
|
000000002024-06-12-0000 | 2024年6月12日 | |
{{Date_table_sorting|-204|11|22}}
|
-999999999796-11-22-0000 | 公元前204年11月22日 | |
{{Date_table_sorting|44|3|15|BC}}
|
-999999999956-03-15-0000 | 公元前44年3月15日 | |
{{Date_table_sorting|94|Oct|17|AD}}
|
000000000094-10-17-0000 | 94年10月17日 | |
{{Date_table_sorting||May}}
|
000000002024-05-01-0000 | 5月 | |
{{Date_table_sorting||Sep|12}}
|
000000002024-09-12-0000 | 9月12日 |
格式化
siu-kái使用format可以做出一個依賴但不需要相同於提供日期的格式。這需要多次調用函數 {{#time:}}，減少一個頁面中使用本模板的最多召喚次數到最差88次，參見下方。format 參數可以用九個數值。
- 例子
| 值 | 輸出格式 | 輸入碼 | 隱藏排序键 | 顯示的輸出 |
|---|---|---|---|---|
{{Date_table_sorting|26 Jan 1788}}
|
000000001788-01-26-0000 | 1788年1月26日 | ||
{{Date_table_sorting|March 12, 1557}}
|
000000001557-03-12-0000 | 1557年3月12日 | ||
{{Date_table_sorting|1975-02-13}}
|
000000001975-02-13-0000 | 1975年2月13日
| ||
{{Date_table_sorting|August 31, 1901|format=ymd}}
|
000000001901-08-31-0000 | 1901年8月31日 | ||
{{Date_table_sorting|2006-11-08|format=ymd}}
|
000000002006-11-08-0000 | 2006年11月8日 | ||
{{Date_table_sorting|1888|5|8|format=ymd}}
|
000000001888-05-08-0000 | 1888年5月8日 | ||
{{Date_table_sorting|-56|08|09|format=ymd}}
|
-999999999944-08-09-0000 | 公元前56年8月9日
| ||
{{Date_table_sorting|26 Jun 1988|format=md}}
|
000000001988-06-26-0000 | 6月26日 | ||
{{Date_table_sorting|2002-05-27|format=md}}
|
000000002002-05-27-0000 | 5月27日 | ||
{{Date_table_sorting|Feb 26, 1788|format=dm}}
|
000000001788-02-26-0000 | 2月26日 | ||
{{Date_table_sorting|2020-10-15|format=dm}}
|
000000002020-10-15-0000 | 10月15日
| ||
{{Date_table_sorting|16 November 1488|format=my}}
|
000000001488-11-16-0000 | 1488年11月
| ||
{{Date_table_sorting|6 July 1666|format=d}}
|
000000001666-07-06-0000 | 6日
| ||
{{Date_table_sorting|1980-02-12|format=m}}
|
000000001980-02-12-0000 | 2月
| ||
{{Date_table_sorting|-26|Jan|18|format=y}}
|
-999999999974-01-18-0000 | 公元前26年
| ||
{{Date_table_sorting|15 October 1800|format=hide}}
|
000000001800-10-15-0000 | |||
| 注意：以下格式的值皆視為無效 | ||||
{{Date_table_sorting|Sep 13, 1888|format=dmy}}
|
000000001888-09-13-0000 | 1888年9月13日 | ||
{{Date_table_sorting|1983-01-03|format=dmy}}
|
000000001983-01-03-0000 | 1983年1月3日
| ||
{{Date_table_sorting|August 31, 1901|format=mdy}}
|
000000001901-08-31-0000 | 1901年8月31日 | ||
{{Date_table_sorting|2006-11-08|format=mdy}}
|
000000002006-11-08-0000 | 2006年11月8日 | ||
当处理单一的日期参数时，除非只有一个数字（那么它将被解释为年份），模板将根据php date/time format来解释参数。但由於中文習慣的格式的影響，預設皆是使用年-月-日。Pang-bô͘:What
縮寫
siu-kái在中文版本，只有一個方法縮寫日期：使用 abbr=on 參數。
- 例子
| 縮寫方法 | 輸入碼 | 隱藏排序键 | 顯示的輸出 |
|---|---|---|---|
{{Date_table_sorting|2000-01-01}}
|
000000002000-01-01-0000 | 2000年1月1日 | |
{{Date_table_sorting|2000|1|1}}
|
000000002000-01-01-0000 | 2000年1月1日 | |
{{Date_table_sorting|1 January 2000}}
|
000000002000-01-01-0000 | 2000年1月1日 | |
{{Date_table_sorting|2000|January|1}}
|
000000002000-01-01-0000 | 2000年1月1日 | |
{{Date_table_sorting|1 Jan 2000}}
|
000000002000-01-01-0000 | 2000年1月1日 | |
{{Date_table_sorting|2000|Jan|1}}
|
000000002000-01-01-0000 | 2000年1月1日 | |
{{Date_table_sorting|1 January 2000|abbr=on}}
|
000000002000-01-01-0000 | 2000/1/1 | |
{{Date_table_sorting|2000|January|1|abbr=on}}
|
000000002000-01-01-0000 | 2000/1/1 | |
{{Date_table_sorting|2000-01-01|abbr=on}}
|
000000002000-01-01-0000 | 2000/1/1 | |
{{Date_table_sorting|2000|1|1|abbr=on}}
|
000000002000-01-01-0000 | 2000/1/1 |
額外排序键
siu-kái如果表格內的兩個日期一樣，它們可以利用參數 addkey 排序。
- 例子
| 輸入碼 | 隱藏排序键 | 顯示的輸出 |
|---|---|---|
{{Date_table_sorting|2010-10-10|addkey=3}}
|
000000002010-10-10-0003 | 2010年10月10日 |
{{Date_table_sorting|2010-10-09}}
|
000000002010-10-09-0000 | 2010年10月9日 |
{{Date_table_sorting|2010-10-10|addkey=1}}
|
000000002010-10-10-0001 | 2010年10月10日 |
{{Date_table_sorting|2010-10-10}}
|
000000002010-10-10-0000 | 2010年10月10日 |
{{Date_table_sorting|2010-10-10|addkey=4}}
|
000000002010-10-10-0004 | 2010年10月10日 |
{{Date_table_sorting|2010-10-11}}
|
000000002010-10-11-0000 | 2010年10月11日 |
{{Date_table_sorting|2010-10-10|addkey=2}}
|
000000002010-10-10-0002 | 2010年10月10日 |
文字換行
siu-kái要關閉自動換行的話，請使用nowrap=off參數。
註解
siu-kái排序非完整日期
siu-kái完整年份或月份
siu-kái完整年份或月份（或完整年月），例如{{dts|2020}}、{{dts|Jan}}和{{dts|2020|1}}，系統會按其第一個日子排序。
沒有年份
siu-kái如果未指定年份，系統將會視年份為現時年份來進行排序。
處理錯誤
siu-kái輸入無效的日期格式（通常）會產生一條錯誤消息，例如{{dts||維基百科}}會產生以下內容：
Module:Date table sorting錯誤：給出的月份「維基百科」月不合理。
曆法選擇
siu-kái本模板無法區分儒略曆和公曆日期。另外，它不能從一個曆法輸入日期並按另一曆法輸出日期。所以，要確保排序良好，用戶必須把日期統一於一個曆法，或者確定一個轉折日（例如，確定1582年10月4日為儒略曆，以後的所有日期為公曆），這可以用一條條的方法實現。如果可能造成混淆，用家有責任解釋給讀者究竟顯示的日期是儒略曆還是公曆。
链接
siu-kái本模板默认自动链接到日期。若要关闭链接，则可使用参数link=off。根据目前的指引，此模板不再支持日期的内部链接。请不要使用此参数，并请将此参数从目前的模板调用中移除。
參見
siu-kái- {{sort}}，以一個特定的鑰匙排序
- {{sortname}}，排序人名（用姓氏和名稱作為預設排序鑰匙）。
- {{tts}}，用於在體育賽事結果表中排序時間（只需要用於一定情況——參見該模板的文档页面）
- {{number table sorting}}，為數字而設