Szablon:Dts/opis

To jest podstrona dokumentacji dla szablonu {{Dts}}.
Zawiera ona informacje na temat sposobu użycia, kategoryzacji szablonu i inną zawartość niebędącą częścią oryginalnej strony.

Dts to skrót od Data – Tabela – Sortowanie (ang. Date Table Sorting). Szablon jest używany, aby prawidłowo sortować daty w tabelach. Daty w tabelach były dawniej prawidłowo sortowane wyłącznie, gdy były podane w formacie cyfrowym [rrrr]-[mm]-[dd] (rok-miesiąc-dzień, np. 1999-11-22). Obecnie poprawnie sortowane są też daty w formacie cyfrowo-słownym [d(d)] [miesiąca] [rrrr], np. 2 listopada 1999, co sprawia, że stosowanie szablonu dts jest zazwyczaj zbędne.

Użycie

{{dts|dzień|miesiąc|rok}}

Wszystkie parametry są opcjonalne (możliwe jest „puste” wywołanie: {{dts|||}} / {{dts}}).

Nawet jeśli rok nie będzie podawany, dobrze jest zostawić dla niego miejsce ({{dts||sty|}}) dla edycji w przyszłości.

Szablon automatycznie dodaje ukryty kod 1776-07-04 umożliwiający sortowanie i wyświetla datę w preferowanym formacie „4 lipca 1776”.

Wywołania szablonu są oznaczane znacznikiem _(dts), który w przestrzeni artykułów (głównej) jest widoczny tylko podczas edycji w edytorze wizualnym (lub na podglądzie strony, jeśli używamy edytora kodu). Znacznik pomaga w odnajdywaniu dat wpisanych ręcznie, które mogą negatywnie wpływać na kolejność sortowania. Dodatkowe oznaczenia: _{(dts) tr} - obecny jest tylko rok, _{(dts) br} - informacja o nie podaniu roku wprost (patrz także Generowane klucze sortowania).

Parametry

Wywołanie szablonu używa trzech opcjonalnych parametrów, liczby poniżej 10 można podawać z wiodącym zerem.

| 1 = - dzień miesiąca (1-31), dodawany tylko wtedy gdy podano miesiąc

| 2 = - miesiąc w postaci słownej (3-lit. skrót, wikt:mianownik lub wikt:dopełniacz) lub liczbowej (1-12)

| 3 = - rok w postaci liczby, lub linku do liczby ([[2021]])

Przykładowe wywołania

Przykład 1

{{Dts|4|7|1776}}

wyświetla:

1776-07-04 4 lipca 1776_(dts)

Przykład 2

{{Dts|4|7|[[1776]]}}

wyświetla:

1776-07-04 4 lipca 1776_(dts)

Generowane klucze sortowania

{{dts}} -> _{(dts) tr}, klucz:

<span style="display:none">0000 </span>

{{dts|||2021}} -> 2021 2021_{(dts) tr}, klucz:
```
2021 
```
{{dts|12|sty|2021}} -> 2021-01-12 12 stycznia 2021_(dts), klucz:
```
2021-01-12 
```
{{dts|2|sty|}} -> 0000-01-02 2 stycznia_{(dts) br}, klucz:
```
0000-01-02 
```

Szczególne przypadki (milisekunda zapewnia pierwszeństwo mm przed mm-01):

{{dts|1|sty|}} -> 0000-01-01T00:00:00.001 1 stycznia_{(dts) br}, klucz:
```
0000-01-01T00:00:00.001 
```
{{dts||sty|}} -> 0000-01-01T00:00:00.000 stycznia_{(dts) br}, klucz:
```
0000-01-01T00:00:00.000 
```

Dokumentacja VE

Szablon służący do poprawnego sortowania dat w tabelach.

Parametry szablonu
Dla tego szablonu preferowane jest formatowanie parametrów w linii.
Parametr		Opis	Typ	Status
dzień	`1`	dzień miesiąca, wymaga podania miesiąca Sugerowane wartości `1-31` Wartość domyślna 01 Przykład 1, 01 Wartość automatyczna `{{subst:CURRENTDAY}}`	Liczba	sugerowany
miesiąc	`2`	nazwa miesiąca (3-lit. skrót, mianownik, dopełniacz) lub jego numer Sugerowane wartości `nazwa (3-lit. skrót, mianownik, dopełniacz)` `1-12` Wartość domyślna 01 Przykład sty, styczeń, stycznia, 1, 01 Wartość automatyczna `{{subst:CURRENTMONTH1}}`	Ciąg znaków	sugerowany
rok	`3`	rok w postaci liczby, lub liczba w postaci linku Wartość domyślna 0000 Przykład 2021, [[2021]] Wartość automatyczna `{{subst:CURRENTYEAR}}`	Liczba	sugerowany

Błędy

Błędne (niepełne) wywołania są zbierane w kategoriach:

Kategoria:Szablon dts bez wymaganych parametrów (edytuj • dysk. • historia • linkujące • obserwuj • rejestr • 0 elementów)
Kategoria:Szablon dts - przed rokiem 1000 (edytuj • dysk. • historia • linkujące • obserwuj • rejestr • 2 elementów)