模板:Date table sorting/sandbox
| File:Sandbox.svg | 這是Template:Date table sorting（差異）的沙盒。 |
.svg){kind=link}
| File:Lua-Logo.svg | 此模板使用Lua語言： |
DTS代表Date Table Sorting（以日期排序），用於在能排序表格裡整理和顯示日期（幫助：排序(英文)）。
簡介[編輯]
通常如果要排序的話，日期必須要使用YYYY-MM-DD的格式輸入。但是，這格式與格式手冊中指定的格式不同。這模板會自動製作用作排序的排序鍵，但會以另外的形式顯示輸出（例如年-月-日）。
參數[編輯]
日期[編輯]
| {{dts|年|月|日|時代}} | {{dts|日期}} |
|---|---|
|
- 例子
格式化[編輯]
使用format可以做出一個依賴但不需要相同於提供日期的格式。這需要多次調用函數 {{#time:}}，減少一個頁面中使用本模板的最多召喚次數到最差88次，參見下方。format 參數可以用九個數值。
- 例子
當處理單一的日期參數時，除非只有一個數字（那麼它將被解釋為年份），模板將根據php date/time format來解釋參數。但由於中文習慣的格式的影響，預設皆是使用年-月-日。由於本模板調用函數{{#time:}}，因此單一頁面中最多僅能使用本模板1200次。[需要解釋]
縮寫[編輯]
在中文版本，只有一個方法縮寫日期：使用 abbr=on 參數。
- 例子
額外排序鍵[編輯]
如果表格內的兩個日期一樣，它們可以利用參數 addkey 排序。
- 例子
文字換行[編輯]
要關閉自動換行的話，請使用nowrap=off參數。
高級用法[編輯]
除了內建格式，模板也支援使用以下變數自訂格式。為避免混亂，請不要在條目中使用。
| 格式代碼 | 說明 |
|---|---|
| %X | 模板預設格式使用的年格式（不含「年」字） |
| %x | 模板啟用縮寫後使用的年格式 |
| %Y | 年分，數字位數補0補到4位數 |
| %y | 年分，未補0 |
| %M | 月分，數字位數補0補到2位數 |
| %m | 月分，未補0 |
| %D | 日期，數字位數補0補到2位數 |
| %d | 日期，未補0 |
| %% | 跳脫 |
| 輸入碼 | 隱藏排序鍵 | 顯示的輸出
Template:Date table sorting/sandbox/row Template:Date table sorting/sandbox/row |
|---|
註解[編輯]
排序非完整日期[編輯]
完整年份或月份[編輯]
完整年份或月份（或完整年月），例如{{dts|2020}}、{{dts|Jan}}和{{dts|2020|1}}，系統會按其第一個日子排序。
沒有年份[編輯]
如果未指定年份，系統將會視年份為現時年份來進行排序。
處理錯誤[編輯]
輸入無效的日期格式（通常）會產生一條錯誤消息，例如{{dts||維基百科}}會產生以下內容：
Module:Date table sorting錯誤：給出的月份「維基百科」月不合理。
曆法選擇[編輯]
本模板無法區分儒略曆和公曆日期。另外，它不能從一個曆法輸入日期並按另一曆法輸出日期。所以，要確保排序良好，使用者必須把日期統一於一個曆法，或者確定一個轉折日（例如，確定1582年10月4日為儒略曆，以後的所有日期為公曆），這可以用一條條的方法實現。如果可能造成混淆，用家有責任解釋給讀者究竟顯示的日期是儒略曆還是公曆。
連結[編輯]
本模板預設自動連結到日期。若要關閉連結，則可使用參數link=off。根據目前的指引，此模板不再支持日期的內部連結。請不要使用此參數，並請將此參數從目前的模板調用中移除。
參見[編輯]
- {{sort}}，以一個特定的鑰匙排序
- {{sortname}}，排序人名（用姓氏和名稱作為預設排序鑰匙）。
- {{tts}}，用於在體育賽事結果表中排序時間（只需要用於一定情況——參見該模板的文檔頁面）
- {{number table sorting}}，為數字而設