Шаблён:Сартаваньне датаў у табліцы

Дакумэнтацыя

Калі ласка, падумайце перад выкарыстаньнем, ці сапраўды вам так ужо патрэбны гэты шаблён. Дапомнае сартаваньне датаў не працуе для месяцаў-гадоў, запісаных словамі, для датаў у выглядзе „год-месяц“ і для гадоў менш за 100; у іншых выпадках павінна працаваць.

Скарачэньне: {{СДТ}}

Гэты шаблён выкарыстоўвае Lua:

Модуль:Сартаваньне датаў у табліцы

Выкарыстаньне

Сартаваньне датаў у табліцы прымяняецца для карэктнага сартаваньня і вываду датаў у сартавальнай табліцы. Такім чынам ён дазваляе абысьці такія недарэчныя выпадкі, калі дата „1 верасьня 1998 году“ ідзе раней за „5 сакавіка 1967“ толькі таму, што „1“ менш за „5“.

Парамэтры

Даты

Год, месяц і дзень могуць быць уведзеныя як асобна, так і адной датай.
{{Сартаваньне датаў у табліцы\|год\|месяц\|дзень\|да Н. Хр.}}	{{Сартаваньне датаў у табліцы\|дата}}
1-ы парамэтар — год (неабавязковы, калі зададзены месяц) Дадатныя лікі (1—999 999 999 999) азначаюць гады н. э. або да н. э. (у залежнасьці ад чацьвертага парамэтру). Адмоўныя лікі (−1 — −999 999 999 999) азначаюць гады да н. э. (без чацьвертага парамэтру). Гады павінны быць без разьдзяляльнікаў ці якога-кольвек фарматаваньня. 2-і парамэтар — месяц (неабавязковы, калі дзень таксама не зададзены) Поўная назва месяцу — напр. Люты Скарочаная назва месяцу — напр. Лют Нумар месяцу — (можа быць з папярэднім нулём ці без) напр. 2 або 02 3-і парамэтар — дзень (неабавязковы) Парадкавы нумар — (можа быць з папярэднім нулём ці без) напр. 7 або 07 4-ы парамэтар (неабавязковы) Дапушчальныя значэньні да н. э., да Н. Хр., н. э. або па Н. Хр. Прымяняюцца з дадатным нумарам году	1-ы парамэтар — поўная дата Дапомна фармат YYYY-MM-DD пераводзіцца ў месяц-дзень-год, а DD-MM-YYYY — у дзень-месяц-год; іншыя фарматы не зьмяняюцца. Дапушчальныя скарочаныя назвы месяцаў, якія адпаведна будуць і ў вывадзе. Вялікія літары і памылковыя коскі выпраўляюцца. Адзін лік лічыцца годам, іншыя фарматы разьбірае модуль. Дапушчальныя такія фарматы: YYYY-MM-DD DD-MM-YYYY DD Месяц YYYY Месяц DD, YYYY YYYY-MM DD Месяц Месяц DD Месяц YYYY YYYY Месяц Лічбавыя значэньні дзён і месяцоў могуць быць 1—2-хразраднымі, а гадоў — толькі 3 або 4-хразраднымі. Калі хочаце ўвесьці значэньне, меншае за 1000, дапоўніце яго сьпераду нулямі (напр. „0070“). Гады да н. э. могуць быць разабраныя, калі ва ўваходнай даце зададзены толькі год. Каб дадаць да даты да н. э. ці для году больш за 9999 дзень і месяц, давядзецца ўжыць асобныя парамэтры для году, месяцу і дня.

Прыклады
фармат уводу	уваходны код	схаваны ключ сартаваньня	вывад на экран
{{Сартаваньне датаў у табліцы\|год}}	`{{Сартаваньне датаў у табліцы\|1893}}`		1893
	`{{Сартаваньне датаў у табліцы\|-89}}`		89 да н. э.
	`{{Сартаваньне датаў у табліцы\|-10000}}`		10 000 да н. э.
	`{{Сартаваньне датаў у табліцы\|-1}}`		1 да н. э.
	`{{Сартаваньне датаў у табліцы\| 1}}`		1 (Зьвярніце ўвагу, што 0 год не існуе, таму выдаецца памылка)
{{Сартаваньне датаў у табліцы\|месяц}}	`{{Сартаваньне датаў у табліцы\|кас}}`		кас
{{Сартаваньне датаў у табліцы\|месяц год}}	`{{Сартаваньне датаў у табліцы\|люты 1767}}`		люты 1767
{{Сартаваньне датаў у табліцы\|дзень месяц год}}	`{{Сартаваньне датаў у табліцы\|12 жні 1987}}`		12 жні 1987
{{Сартаваньне датаў у табліцы\|месяц дзень, год}}	`{{Сартаваньне датаў у табліцы\|ліпень 1, 1867}}`		ліпень 1, 1867
{{Сартаваньне датаў у табліцы\|дзень месяц}}	`{{Сартаваньне датаў у табліцы\|25 кастрычнік}}`		25 кастрычнік
{{Сартаваньне датаў у табліцы\|месяц дзень}}	`{{Сартаваньне датаў у табліцы\|сту 1}}`		сту 1
{{Сартаваньне датаў у табліцы\|YYYY-MM-DD}}	`{{Сартаваньне датаў у табліцы\|2014-12-09}}`		9 сьнежань 2014
{{Сартаваньне датаў у табліцы\|DD-MM-YYYY}}	`{{Сартаваньне датаў у табліцы\|15-05-2019}}`		15 травень 2019
{{Сартаваньне датаў у табліцы\|год\|месяц}}	`{{Сартаваньне датаў у табліцы\|1990\|10}}`		кастрычнік 1990
	`{{Сартаваньне датаў у табліцы\|1980\|Dec}}`	Памылка ў шаблёне Сартаваньне датаў у табліцы: 'Dec' — няслушны месяц	Памылка ў шаблёне Сартаваньне датаў у табліцы: 'Dec' — няслушны месяц
	`{{Сартаваньне датаў у табліцы\|1970\|August}}`	Памылка ў шаблёне Сартаваньне датаў у табліцы: 'August' — няслушны месяц	Памылка ў шаблёне Сартаваньне датаў у табліцы: 'August' — няслушны месяц
{{Сартаваньне датаў у табліцы\|год\|месяц\|дзень}}	`{{Сартаваньне датаў у табліцы\|2024\|чэр\|12}}`		12 чэр 2024
{{Сартаваньне датаў у табліцы\|год\|месяц\|дзень}}	`{{Сартаваньне датаў у табліцы\|-204\|11\|22}}`		22 лістапад 204 да н. э.
{{Сартаваньне датаў у табліцы\|год\|месяц\|дзень\|эра}}	`{{Сартаваньне датаў у табліцы\|44\|3\|15\|да Н. Хр.}}`	Памылка ў шаблёне Сартаваньне датаў у табліцы: 'да Н. Хр.' — няслушная эра (магчымыя 'да н. э.', 'да Н. Хр.', 'н. э.' або 'па Н. Хр.')	Памылка ў шаблёне Сартаваньне датаў у табліцы: 'да Н. Хр.' — няслушная эра (магчымыя 'да н. э.', 'да Н. Хр.', 'н. э.' або 'па Н. Хр.')
{{Сартаваньне датаў у табліцы\|год\|месяц\|дзень\|эра}}	`{{Сартаваньне датаў у табліцы\|94\|Oct\|17\|AD}}`	Памылка ў шаблёне Сартаваньне датаў у табліцы: 'Oct' — няслушны месяц	Памылка ў шаблёне Сартаваньне датаў у табліцы: 'Oct' — няслушны месяц
{{Сартаваньне датаў у табліцы\|месяц}}	`{{Сартаваньне датаў у табліцы\|\|травень}}`		травень
{{Сартаваньне датаў у табліцы\|месяц\|дзень}}	`{{Сартаваньне датаў у табліцы\|\|верасень\|12}}`		12 верасень

Фарматаваньне

Парамэтар |format = задае фармат, які залежыць, але неабавязкова ідэнтычны фармату ўваходнай даты. Парамэтар можа прымаць дзевяць значэньняў.

Прыклады
значэньне	функцыя	уваходны код	схаваны ключ сартаваньня	вывад на экран
	фармат залежыць ад уваходнага	`{{Сартаваньне датаў у табліцы\|26 сту 1788}}`		26 сту 1788
		`{{Сартаваньне датаў у табліцы\|сакавік 12, 1557}}`		сакавік 12, 1557
		`{{Сартаваньне датаў у табліцы\|1975-02-13}}`		13 люты 1975
`dmy`	выводзіць дату ў фармаце дзень-месяц-год	`{{Сартаваньне датаў у табліцы\|вер 13, 1888\|format=dmy}}`		13 вер 1888
`dmy`	выводзіць дату ў фармаце дзень-месяц-год	`{{Сартаваньне датаў у табліцы\|1983-01-03\|format=dmy}}`		3 студзень 1983
`dm`	выводзіць толькі дзень і месяц у фармаце дзень-месяц	`{{Сартаваньне датаў у табліцы\|лют 26, 1788\|format=dm}}`		26 лют
`dm`	выводзіць толькі дзень і месяц у фармаце дзень-месяц	`{{Сартаваньне датаў у табліцы\|2020-10-15\|format=dm}}`		15 кастрычнік
`mdy`	выводзіць дату ў фармаце месяц-дзень-год	`{{Сартаваньне датаў у табліцы\|жнівень 31, 1901\|format=mdy}}`		жнівень 31, 1901
`mdy`	выводзіць дату ў фармаце месяц-дзень-год	`{{Сартаваньне датаў у табліцы\|2006-11-08\|format=mdy}}`		лістапад 8, 2006
`md`	выводзіць толькі дзень і месяц у фармаце месяц-дзень	`{{Сартаваньне датаў у табліцы\|26 Чэр 1988\|format=md}}`	Памылка ў шаблёне Сартаваньне датаў у табліцы: '26 Чэр 1988' — няслушная дата	Памылка ў шаблёне Сартаваньне датаў у табліцы: '26 Чэр 1988' — няслушная дата
`md`	выводзіць толькі дзень і месяц у фармаце месяц-дзень	`{{Сартаваньне датаў у табліцы\|2002-02-27\|format=md}}`		люты 27
`my`	выводзіць толькі месяц і год у фармаце месяц-год	`{{Сартаваньне датаў у табліцы\|16 лістапад 1488\|format=my}}`		лістапад 1488
`d`	выводзіць толькі дзень	`{{Сартаваньне датаў у табліцы\|6 Ліпень 1666\|format=d}}`	Памылка ў шаблёне Сартаваньне датаў у табліцы: '6 Ліпень 1666' — няслушная дата	Памылка ў шаблёне Сартаваньне датаў у табліцы: '6 Ліпень 1666' — няслушная дата
`m`	выводзіць толькі месяц	`{{Сартаваньне датаў у табліцы\|1980-02-12\|format=m}}`		люты
`y`	выводзіць толькі год	`{{Сартаваньне датаў у табліцы\|-26\|Сту\|18\|format=y}}`	Памылка ў шаблёне Сартаваньне датаў у табліцы: 'Сту' — няслушны месяц	Памылка ў шаблёне Сартаваньне датаў у табліцы: 'Сту' — няслушны месяц
`hide`	хавае дату	`{{Сартаваньне датаў у табліцы\|15 Кастрычнік 1800\|format=hide}}`	Памылка ў шаблёне Сартаваньне датаў у табліцы: '15 Кастрычнік 1800' — няслушная дата	Памылка ў шаблёне Сартаваньне датаў у табліцы: '15 Кастрычнік 1800' — няслушная дата

Скарачэньне

Існуюць два спосабы скарачэньня назвы месяцу.

Адразу ўвесьці скарочаную назву месяцу.
У любым месцы шаблёну задаць парамэтар |abbr = on.

Прыклады
спосаб скарачэньня	уваходны код	вывад на экран
ніякі	`{{Сартаваньне датаў у табліцы\|2000-01-01}}`	1 студзень 2000
	`{{Сартаваньне датаў у табліцы\|2000\|1\|1}}`	1 студзень 2000
	`{{Сартаваньне датаў у табліцы\|1 студзень 2000}}`	1 студзень 2000
	`{{Сартаваньне датаў у табліцы\|2000\|студзень\|1}}`	1 студзень 2000
скарочаны ўвод	`{{Сартаваньне датаў у табліцы\|1 сту 2000}}`	1 сту 2000
скарочаны ўвод	`{{Сартаваньне датаў у табліцы\|2000\|сту\|1}}`	1 сту 2000
`abbr=on`	`{{Сартаваньне датаў у табліцы\|1 студзень 2000\|abbr=on}}`	1 сту 2000
	`{{Сартаваньне датаў у табліцы\|2000\|студзень\|1\|abbr=on}}`	1 сту 2000
	`{{Сартаваньне датаў у табліцы\|2000-01-01\|abbr=on}}`	1 сту 2000
	`{{Сартаваньне датаў у табліцы\|2000\|1\|1\|abbr=on}}`	1 сту 2000

Дадатковы ключ сартаваньня

Калі ў табліцы трапіліся дзьве аднолькавыя даты, іх можна адсартаваць з дапамогай парамэтру |addkey = .

Прыклады
уваходны код	схаваны ключ сартаваньня	вывад на экран
`{{Сартаваньне датаў у табліцы\|2010-10-10\|addkey=3}}`		10 кастрычнік 2010
`{{Сартаваньне датаў у табліцы\|2010-10-09}}`		9 кастрычнік 2010
`{{Сартаваньне датаў у табліцы\|2010-10-10\|addkey=1}}`		10 кастрычнік 2010
`{{Сартаваньне датаў у табліцы\|2010-10-10}}`		10 кастрычнік 2010
`{{Сартаваньне датаў у табліцы\|2010-10-10\|addkey=4}}`		10 кастрычнік 2010
`{{Сартаваньне датаў у табліцы\|2010-10-11}}`		11 кастрычнік 2010
`{{Сартаваньне датаў у табліцы\|2010-10-10\|addkey=2}}`		10 кастрычнік 2010

Пераносы

Каб адключыць забарону пераносу словаў, скарыстайцеся парамэтрам |nowrap = off.

фармат уводу	уваходны код	схаваны ключ сартаваньня	вывад на экран
{{Сартаваньне датаў у табліцы\|год}}	`{{Сартаваньне датаў у табліцы\|1893}}`		1893
	`{{Сартаваньне датаў у табліцы\|-89}}`		89 да н. э.
	`{{Сартаваньне датаў у табліцы\|-10000}}`		10 000 да н. э.
	`{{Сартаваньне датаў у табліцы\|-1}}`		1 да н. э.
	`{{Сартаваньне датаў у табліцы\| 1}}`		1 (Зьвярніце ўвагу, што 0 год не існуе, таму выдаецца памылка)
{{Сартаваньне датаў у табліцы\|месяц}}	`{{Сартаваньне датаў у табліцы\|кас}}`		кас
{{Сартаваньне датаў у табліцы\|месяц год}}	`{{Сартаваньне датаў у табліцы\|люты 1767}}`		люты 1767
{{Сартаваньне датаў у табліцы\|дзень месяц год}}	`{{Сартаваньне датаў у табліцы\|12 жні 1987}}`		12 жні 1987
{{Сартаваньне датаў у табліцы\|месяц дзень, год}}	`{{Сартаваньне датаў у табліцы\|ліпень 1, 1867}}`		ліпень 1, 1867
{{Сартаваньне датаў у табліцы\|дзень месяц}}	`{{Сартаваньне датаў у табліцы\|25 кастрычнік}}`		25 кастрычнік
{{Сартаваньне датаў у табліцы\|месяц дзень}}	`{{Сартаваньне датаў у табліцы\|сту 1}}`		сту 1
{{Сартаваньне датаў у табліцы\|YYYY-MM-DD}}	`{{Сартаваньне датаў у табліцы\|2014-12-09}}`		9 сьнежань 2014
{{Сартаваньне датаў у табліцы\|DD-MM-YYYY}}	`{{Сартаваньне датаў у табліцы\|15-05-2019}}`		15 травень 2019
{{Сартаваньне датаў у табліцы\|год\|месяц}}	`{{Сартаваньне датаў у табліцы\|1990\|10}}`		кастрычнік 1990
	`{{Сартаваньне датаў у табліцы\|1980\|Dec}}`	Памылка ў шаблёне Сартаваньне датаў у табліцы: 'Dec' — няслушны месяц	Памылка ў шаблёне Сартаваньне датаў у табліцы: 'Dec' — няслушны месяц
	`{{Сартаваньне датаў у табліцы\|1970\|August}}`	Памылка ў шаблёне Сартаваньне датаў у табліцы: 'August' — няслушны месяц	Памылка ў шаблёне Сартаваньне датаў у табліцы: 'August' — няслушны месяц
{{Сартаваньне датаў у табліцы\|год\|месяц\|дзень}}	`{{Сартаваньне датаў у табліцы\|2024\|чэр\|12}}`		12 чэр 2024
{{Сартаваньне датаў у табліцы\|год\|месяц\|дзень}}	`{{Сартаваньне датаў у табліцы\|-204\|11\|22}}`		22 лістапад 204 да н. э.
{{Сартаваньне датаў у табліцы\|год\|месяц\|дзень\|эра}}	`{{Сартаваньне датаў у табліцы\|44\|3\|15\|да Н. Хр.}}`	Памылка ў шаблёне Сартаваньне датаў у табліцы: 'да Н. Хр.' — няслушная эра (магчымыя 'да н. э.', 'да Н. Хр.', 'н. э.' або 'па Н. Хр.')	Памылка ў шаблёне Сартаваньне датаў у табліцы: 'да Н. Хр.' — няслушная эра (магчымыя 'да н. э.', 'да Н. Хр.', 'н. э.' або 'па Н. Хр.')
{{Сартаваньне датаў у табліцы\|год\|месяц\|дзень\|эра}}	`{{Сартаваньне датаў у табліцы\|94\|Oct\|17\|AD}}`	Памылка ў шаблёне Сартаваньне датаў у табліцы: 'Oct' — няслушны месяц	Памылка ў шаблёне Сартаваньне датаў у табліцы: 'Oct' — няслушны месяц
{{Сартаваньне датаў у табліцы\|месяц}}	`{{Сартаваньне датаў у табліцы\|\|травень}}`		травень
{{Сартаваньне датаў у табліцы\|месяц\|дзень}}	`{{Сартаваньне датаў у табліцы\|\|верасень\|12}}`		12 верасень