Tekst źródłowy strony Szablon:Ramy czasowe zdarzenia/LSnK/doc

{{Podstrona dokumentacji}}
{{Spis treści}}
<!-- DODAWAJ KATEGORIE I INTERWIKI NA DOLE STRONY -->

== Przeznaczenie ==
Dany szablon (makro) przekształca podaną w sekundach długość trwania odcinka czasu na tekst opisowy wskazujący, że jest to czas albo dłuższy niż 30 dni albo oznaczający wyliczoną liczbę dni (dób), godzin, minut i sekund.

==Istotne dane szablonu ==
Parametry:
* szablon nie zawiera parametrów pozycyjnych (numerowych) i zawiera 1 parametr kluczowy (nazwany)
* wymaganie podania parametrów pozycyjnych: ''n/d''
* wymaganie szczególne dla parametrów kluczowych: nie ma
* uwarunkowanie ogólne parametrów kluczowych: wszystkie są w wywołaniu szablonu opcjonalne
* wykaz parametrów z dokładnym opisem jest podany w następnej sekcji

Pominięcie wszystkich parametrów nazwanych jest możliwe i nie powoduje błędu.

Wołane szablony (wikimakra):
* Dokumentacja

Wołane funkcje parsera:
<!-- * <nowiki><brak></nowiki> -->
* <code>#expr</code>
* <code>#ifexpr</code>
* <code>#floor</code>

Wołany przez szablon:
* {{s|Ramy_czasowe_zdarzenia/tabela}}

== Użycie ==
Szablon używany jest w standardowy sposób, przez wstawienie do kodu artykułu jego wywołania - tak jak jest podane w poniższych przykładach. W wywołaniu szablonu można nie podawać jedynego parametru nazwanego. 

W postaci ogólnej wywołanie szablonu ma poniższą postać - kursywą wskazano miejsca, w których należy wpisać [[wikt:adekwatność|adekwatny]] tekst:
 <nowiki>{{</nowiki>Ramy czasowe zdarzenia/tabela/LSnK|LS=''liczba sekund''<nowiki>}}</nowiki>

=== Parametry ===
Poniższa tabela podaje rozwinięty opis wszystkich parametrów makra.

W pierwszej kolumnie podano typ parametru:
* P - pozycyjny, identyfikowany przez pozycję w wywołaniu szablonu lub nazwę (klucz), którą jest liczba naturalna
* K - kluczowy, identyfikowany w wywołaniu szablonu wyłącznie przez nazwę (klucz)
Druga kolumna zawiera wskazanie, czy parametr jest:
* W - wymagany
* o - opcjonalny

{|class="wikitable"
! Nazwa
! Typ
! Rodz.
! colspan=2 | Opis, sposób nadania wartości i wynik
|-
| colspan=5 style="background:#f2f2f2;" |

|-
| rowspan=4 | '''LS'''
| rowspan=4 | K
| rowspan=4 | o
| colspan=2 | Długość odcinka czasowego w sekundach. Powinna to być liczba naturalna, czyli większa od zera, bez znaków grupowania cyfr. Wartość nienumeryczna wygeneruje komunikat o błędzie, wartość mniejsza od zera - informację o tym oznaczoną jako błąd, a wartość większa niż 2&nbsp;592&nbsp;000 informację, że jest to ponad 30 dni.<br>
Wartości:
|-
| LS='''1000'''
| odcinek liczy 1000 sekund
|-
| LS=
| zostanie podstawiona '''domyślna''' długość - 1 sekunda
|-
| ''<nowiki><brak></nowiki>''
| jw.
|-
| colspan=5 style="background:#f2f2f2;" |
|}

== Przykłady ==
Przykład ogólny wywołania ze wskazaniem parametru kluczowego, ale bez podania wartości dla niego. 
<pre style="width: 50em;">
{{Ramy czasowe zdarzenia/LSnK| LS = }}
</pre>


'''Przykład nr 1'''<br>
Przykład ten z kodem jak poniżej:
<pre style="width: 50em;">
{{Ramy czasowe zdarzenia/LSnK| LS = 1000000 }}</pre>
tworzy poniższy komunikat - tekst podający ile dni, godzin, minut i sekund stanowi jeden milion sekund:<br>
{|class="wikitable" style="width: 52em;"
|-
| style="background:#f2f2f2;" | {{Ramy czasowe zdarzenia/LSnK|LS=1000000}}
|}


'''Przykład nr 2'''<br>
Przykład ten z kodem jak poniżej podającym nienumeryczną wartość parametru LS:
<pre style="width: 50em;">
{{Ramy czasowe zdarzenia/LSnK|LS=abrakadabra}}
</pre>
tworzy komunikat o błędzie:
{|class="wikitable" style="width: 52em;"
|-
| style="background:#f2f2f2;" | {{Ramy czasowe zdarzenia/LSnK|LS=abrakadabra}}
|}

<!--
== Zobacz też ==
  -->
{{-}}
{{Wykorzystano|http://pl.wikipedia.org/wiki/Szablon:Ramy_czasowe_zdarzenia/LSnK/opis|Ency}}
<includeonly><!--
++++ DODAWAJ KATEGORIE I INTERWIKI PONIŻEJ TEJ LINII -->

[[Kategoria:Głosowania - szablony|{{PAGENAME}}]]
[[Kategoria:Szablony daty i czasu|{{PAGENAME}}]]
</includeonly>