Шаблон:Дтс/док

Дтс (дате тиме сортинг) ис усед то цоррецтлy сорт анд дисплаy датес ин а сортабле табле (сее Хелп:Сортинг).

Wхат ит солвес

Нормаллy, фор пропер сортинг, датес муст бе ентеред ин YYYY-MM-ДД формат. Хоwевер, тхат формат доес нот цонформ то тхе фор дате дисплаy. Тхис темплате аутоматицаллy цреатес тхе хидден кеy фор сортинг пурпосес wхилст дисплаyинг тхе дате ин ан алтернативе формат (е.г. даy-монтх-yеар).

Параметерс

Датес

Тхе yеар, монтх анд даy цан еитхер бе ентеред сепарателy ор ас а сингле дате.

{{дтс|yеар|монтх|даy|БЦ}}

{{дтс|дате}}

1ст параметер – Yеар (оптионал иф монтх ис гивен) Поситиве нумбер (1 то 999,999,999,999) репресент yеарс АД ор БЦ (депендант он тхе фоуртх параметер). Негативе нумберс (−1 то −999,999,999,999) репресент yеарс БЦ (wитхоут тхе фоуртх параметер). Yеар нумберс муст нот цонтаин цоммас ор отхер форматтинг. 2нд параметер – Монтх (оптионал иф тхе даy ис нот гивен еитхер) Фулл монтх наме – е.г. Фебруарy Аббревиатед монтх наме – е.г. Феб Монтх нумбер – (еитхер зеро-паддед ор нот) е.г. 2 ор 02 3рд параметер – Даy (оптионал) Даy нумбер – (еитхер зеро-паддед ор нот) е.г. 7 ор 07 4тх параметер – (оптионал) Маy бе БЦ, АД, БЦЕ ор ЦЕ Усед wитх а поситиве yеар нумбер

1ст параметер – тхе фулл дате Бy дефаулт YYYY-MM-ДД формат бецомес монтх-даy-yеар формат wхиле отхер форматс ремаин ин тхе ордер тхеy аре инпут. Аббревиатед монтхс аре аццептед анд аре аббревиатед ин тхе оутпут. Цапиталисатион анд цомма мистакес аре цоррецтед. А сингле нумбер ис интерпретед ас а yеар, отхерwисе тхе дате ис парсед бy тхе модуле. Тхе фоллоwинг форматс аре аццептед: YYYY-MM-ДД ДД-MM-YYYY ДД Монтх YYYY Монтх ДД, YYYY YYYY-MM ДД Монтх Монтх ДД Монтх YYYY YYYY Монтх Даy анд монтх нумберс маy бе 1 ор 2 дигитс, анд yеар нумберс маy онлy бе 3 ор 4 дигитс. Иф yоу неед то инпут а нумбер лесс тхан 1000, усе леадинг зероес (е.г. "0700"). БЦ yеарс цан онлy бе парсед иф тхе дате ис онлy тхе yеар нумбер. Иф yоу неед то инцлуде тхе даy ор монтх фор БЦ yеарс ор yеарс греатер тхан 9999, yоу муст усе сепарате параметерс фор yеар, монтх анд даy.

Еxамплес

инпут стyле	инпут цоде	хидден сорт кеy	висибле оутпут
{{дтс|yеар}}	{{dts|1893}}	000000001893-01-01-0000	000000001893-01-01-00001893
	{{dts|-89}}	-999999999911-01-01-0000	-999999999911-01-01-000089 п. н. е.
	{{dts|-10000}}	-999999990000-01-01-0000	-999999990000-01-01-000010.000 п. н. е.
{{дтс|монтх}}	{{dts|октобар}}
{{дтс|монтх yеар}}	{{dts|фебруар 1767}}
{{дтс|даy монтх yеар}}	{{dts|12. август 1987}}
{{дтс|монтх даy, yеар}}	{{dts|јул 1, 1867}}
{{дтс|даy монтх}}	{{dts|25. октобар}}
{{дтс|монтх даy}}	{{dts|јануар 1}}
{{дтс|YYYY-MM-ДД}}	{{dts|2014-12-09}}	000000002014-12-09-0000	000000002014-12-09-0000децембар 9, 2014
{{дтс|yеар|монтх}}	{{dts|1990|10}}	000000001990-10-01-0000	000000001990-10-01-0000октобар 1990
	{{dts|1980|децембар}}
	{{dts|1970|август}}
{{дтс|yеар|монтх|даy}}	{{dts|2024|јун|12}}
	{{dts|-204|11|22}}	-999999999796-11-22-0000	-999999999796-11-22-0000новембар 22, 204 п. н. е.
{{дтс|yеар|монтх|даy|ера}}	{{dts|44|3|15|BC}}	-999999999956-03-15-0000	-999999999956-03-15-0000март 15, 44 п. н. е.
	{{dts|94|октобар|17|AD}}
{{дтс||монтх}}	{{dts||мај}}
{{дтс||монтх|даy}}	{{dts||септембар|12}}

Форматтинг

Усинг format продуцес а формат тхат депендс он, бут ис нот нецессарилy еqуал то тхе формат оф тхе супплиед дате. Тхе format параметер цан таке нине валуес.

Еxамплес

валуе	фунцтион	инпут цоде	хидден сорт кеy	висибле оутпут
	формат депендс он тхе инпут	{{dts|26. јануар 1788}}
		{{dts|март 12, 1557}}
		{{dts|1975-02-13}}	000000001975-02-13-0000	000000001975-02-13-0000фебруар 13, 1975
dmy	дисплаyс тхе дате ин даy-монтх-yеар формат	{{dts|септембар 13, 1888|format=dmy}}
		{{dts|1983-01-03|format=dmy}}	000000001983-01-03-0000	000000001983-01-03-00003 јануар 1983
dm	дисплаyс онлy тхе даy анд монтх ин даy-монтх формат	{{dts|фебруар 26, 1788|format=dm}}
		{{dts|2020-10-15|format=dm}}	000000002020-10-15-0000	000000002020-10-15-000015 октобар
mdy	дисплаyс тхе дате ин монтх-даy-yеар формат	{{dts|август 31, 1901|format=mdy}}
		{{dts|2006-11-08|format=mdy}}	000000002006-11-08-0000	000000002006-11-08-0000новембар 8, 2006
md	дисплаyс онлy тхе даy анд монтх ин монтх-даy формат	{{dts|26. јун 1988|format=md}}
		{{dts|2002-05-27|format=md}}	000000002002-05-27-0000	000000002002-05-27-0000мај 27
my	дисплаyс онлy тхе монтх анд yеар ин монтх-yеар формат	{{dts|16. новембар 1488|format=my}}
d	дисплаyс онлy тхе даy	{{dts|6. јул 1666|format=d}}
m	дисплаyс онлy тхе монтх	{{dts|1980-02-12|format=m}}	000000001980-02-12-0000	000000001980-02-12-0000фебруар
y	дисплаyс онлy тхе yеар	{{dts|-26|јануар|18|format=y}}
hide	хидес тхе дате	{{dts|15. октобар 1800|format=hide}}

Аббревиатион

Тхере аре тwо wаyс оф аббревиатинг тхе монтх наме.

1. Дирецтлy инпут ан аббревиатед монтх наме.
2. Усе тхе abbr=on параметер.

Еxамплес

аббревиатион метход	инпут цоде	хидден сорт кеy	висибле оутпут
ноне	{{dts|2000-01-01}}	000000002000-01-01-0000	000000002000-01-01-0000јануар 1, 2000
	{{dts|2000|1|1}}	000000002000-01-01-0000	000000002000-01-01-0000јануар 1, 2000
	{{dts|1. јануар 2000}}
	{{dts|2000|јануар|1}}
аббревиатед инпут	{{dts|1. јануар 2000}}
	{{dts|2000|јануар|1}}
abbr=on	{{dts|1. јануар 2000|abbr=on}}
	{{dts|2000|јануар|1|abbr=on}}
	{{dts|2000-01-01|abbr=on}}	000000002000-01-01-0000	000000002000-01-01-0000јан 1, 2000
	{{dts|2000|1|1|abbr=on}}	000000002000-01-01-0000	000000002000-01-01-0000јан 1, 2000

Аддитионал сорт кеy

Ин цасе тwо датес ин а табле аре идентицал тхеy маy бе ордеред усинг тхе addkey параметер.

Еxамплес

инпут цоде	хидден сорт кеy	висибле оутпут
{{dts|2010-10-10|addkey=3}}	000000002010-10-10-0003	000000002010-10-10-0003октобар 10, 2010
{{dts|2010-10-09}}	000000002010-10-09-0000	000000002010-10-09-0000октобар 9, 2010
{{dts|2010-10-10|addkey=1}}	000000002010-10-10-0001	000000002010-10-10-0001октобар 10, 2010
{{dts|2010-10-10}}	000000002010-10-10-0000	000000002010-10-10-0000октобар 10, 2010
{{dts|2010-10-10|addkey=4}}	000000002010-10-10-0004	000000002010-10-10-0004октобар 10, 2010
{{dts|2010-10-11}}	000000002010-10-11-0000	000000002010-10-11-0000октобар 11, 2010
{{dts|2010-10-10|addkey=2}}	000000002010-10-10-0002	000000002010-10-10-0002октобар 10, 2010

Wраппинг

То турн офф тхе суппрессион оф wорд wрапс, усе тхе nowrap=off параметер.

Нотес

Сортинг фор инцомплете датес

Wхоле монтхс ор yеарс

А wхоле yеар ор монтх (анд yеар) ис сортед аццординг то итс фирст даy.

Миссинг yеарс

Иф тхе yеар ис нот специфиед, тхе дате wилл бе сортед ас иф тхе yеар wере тхе цуррент yеар.

Бланк датес

Фор но дате инпут ат алл, тхе маxимум поссибле сорт кеy ис усед, со тхе ентрy wилл сорт ласт.

Еррор хандлинг

Ентеринг ан инвалид дате формат wилл (генераллy) продуце ан еррор мессаге (суцх ас тхе оне белоw, генератед бy {{dts|35. јун 1900}}).

Еррорс аре трацкед ин Цатегорy:Дтс темплатес wитх еррорс.

Цалендар цхоице

Тхе темплате ис нот цапабле оф дистингуисхинг Јулиан анд Грегориан цалендар датес. Алсо, ит ис нот цапабле оф такинг а дате ин оне цалендар ас инпут анд оутпуттинг а дате ин тхе отхер цалендар. Тхус, то инсуре пропер сортинг, едиторс муст еитхер усе оне цалендар фор алл датес, ор пицк а специфиц цхангеовер дате (фор еxампле, децидинг тхат 4 Оцтобер 1582 ис Јулиан анд алл латер датес аре Грегориан); тхис wоулд бе доне он ан артицле-бy артицле басис. Едиторс аре алсо респонсибле фор еxплаининг то тхе реадер wхетхер тхе висибле датес аре Јулиан ор Грегориан, иф тхере ис анy поссибилитy оф цонфусион.

Линкинг

Тхе темплате формерлy линкед датес аутоматицаллy, wитх link=off усед то суппресс линкинг. Ин аццорданце wитх цуррент гуиделинес линкинг оф датес ис но лонгер суппортед анд инстанцес оф link=off схоулд бе ремовед. Трансцлусионс усинг тхе |линк= параметер аре трацкед ин Цатегорy:Дтс темплатес wитх депрецатед параметерс.

Сее алсо

• м:Темплате:дтс (повратни линкови уреди), синце он Мета е.г. 09999 9999 индуцес нумериц сорт моде, "&" ис префиxед то форце стринг сорт моде.
• {{сорт}}, сортинг бy а специфиед кеy (алсо гоод фор цомплицатед нумберс, е.г. сциентифиц нотатион)
• {{сортнаме}}, фулл наме сортинг (усинг "ласт наме, фирст наме" ас дефаулт сорт кеy)
• {{ттс}}, фор сортинг тимес ин ресулт таблес оф атхлетиц евентс (онлy неедед ин цертаин цасес - сее темплате доцументатион)
• {{мсс}}, фор сортинг тимес ин таблес оф ецлипсес
• {{нтс}}, фор нумберс