Шаблён:Сартаваньне датаў у табліцы/Дакумэнтацыя

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

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

Сартаваньне датаў у табліцы прымяняецца для карэктнага сартаваньня і вываду датаў у сартавальнай табліцы. Такім чынам ён дазваляе абысьці такія недарэчныя выпадкі, калі дата „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}}
	{{Сартаваньне датаў у табліцы|1970|August}}
{{Сартаваньне датаў у табліцы|год|месяц|дзень}}	{{Сартаваньне датаў у табліцы|2024|чэр|12}}		12 чэр 2024
	{{Сартаваньне датаў у табліцы|-204|11|22}}		22 лістапад 204 да н. э.
{{Сартаваньне датаў у табліцы|год|месяц|дзень|эра}}	{{Сартаваньне датаў у табліцы|44|3|15|да Н. Хр.}}
	{{Сартаваньне датаў у табліцы|94|Oct|17|AD}}
{{Сартаваньне датаў у табліцы|месяц}}	{{Сартаваньне датаў у табліцы||травень}}		травень
{{Сартаваньне датаў у табліцы|месяц|дзень}}	{{Сартаваньне датаў у табліцы||верасень|12}}		12 верасень

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

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

Прыклады

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

Скарачэньне

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

1. Адразу ўвесьці скарочаную назву месяцу.
2. У любым месцы шаблёну задаць парамэтар |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.

Глядзіце таксама

• {{Сартаваньне}}
• {{Сартаваць імя}}
• {{Сартаваньне лікаў у табліцы}}