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

Зьвесткі зь Вікіпэдыі — вольнай энцыкляпэдыі
Скарачэньне:
{{СДТ}}

Выкарыстаньне[рэдагаваць крыніцу]

Сартаваньне датаў у табліцы прымяняецца для карэктнага сартаваньня і вываду датаў у сартавальнай табліцы. Такім чынам ён дазваляе абысьці такія недарэчныя выпадкі, калі дата „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
{{Сартаваньне датаў у табліцы|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}} Памылка ў шаблёне Сартаваньне датаў у табліцы: '26 Чэр 1988' — няслушная дата Памылка ў шаблёне Сартаваньне датаў у табліцы: '26 Чэр 1988' — няслушная дата
{{Сартаваньне датаў у табліцы|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' — няслушная дата

Скарачэньне[рэдагаваць крыніцу]

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

  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.

Глядзіце таксама[рэдагаваць крыніцу]