--=REKLAMA=--
--=REKLAMA=--
Szablon tworzy w miejscu jego umieszczenia tabliczkę wskazującej ramy czasowe jakiegoś zdarzenia - przeszłego, trwającego lub przyszłego, oraz odnoszący się do tego czasu stan tego zdarzenia. W tabliczce podawane są informacje opisowe, czy zdarzenie jeszcze się nie rozpoczęło, trwa czy już się zakończyło, a także wskazywane są daty (momenty) początku i końca zdarzenia.
Tabliczki takie są przydatne na stronach głosowań, dyskusji, sondaży i innych przedsięwzięć z narzuconymi ograniczeniami czasowymi, a informacja o aktualnym odniesieniu zdarzenia do czasu jest istotna dla uczestników/obserwatorów zdarzenia.
Parametry:
Wołane szablony (wikimakra):
Wołane funkcje parsera:
#if
#time
Wołany przez szablon:
Szablon prawidłowo używany jest w niestandardowy sposób, przez konstrukcję subst: z odpowiednim wskazaniem nazwy szablonu i parametrów (opcjonalnie).
W postaci ogólnej użycie szablonu ma poniższą postać - kursywą wskazano miejsca, w których należy wpisać adekwatny tekst (zwróć uwagę na sekcję Znane błędy dalej w treści dokumentacji):
{{subst:Ramy czasowe zdarzenia| zdarzenie=nazwa zdarzenia| rgz=rodzaj gramatyczny zdarzenia| wkLS=czy podać czas do zakończenia| liczba dni trwania zdarzenia| rok startu| mc startu| dzień startu| godz. startu:minuta startu| sekunda startu| czas startu letni/zimowy}}
Wartości parametrów pozycyjnych nie mogą mieć przed nimi ani za nimi spacji – ich obecność spowoduje błędne działanie kodu!
Wywołanie danego szablonu w standardowy sposób, czyli {{Ramy czasowe zdarzenia}} spowoduje wyświetlenie tabeli z informacjami o błędach.
Poniższa tabela podaje rozwinięty opis wszystkich parametrów makra.
W pierwszej kolumnie podano typ parametru:
Druga kolumna zawiera wskazanie, czy parametr jest:
| Nazwa | Typ | Rodz. | Opis, sposób nadania wartości i wynik | |
|---|---|---|---|---|
| zdarzenie | K | o | Nazwa zdarzenia, dla którego podawane są ramy czasowe oraz stan zdarzenia wynikający z odniesienia ram do bieżącego momentu. W pierwszym wierszu tabeli podawany jest tekst składający się z niniejszej nazwy zdarzenia (w odpowiednim rodzaju gramatycznym wskazanym przez parametr rgz) oraz aktualny stan zdarzenia (zgodnie z wartościami odpowiednich pozostałych parametrów), tj. że jest planowane, trwa, lub jest zakończone. Wartości: | |
| zdarzenie=Lot | tabelka będzie odnosiła się do zdarzenia "Lot" | |||
| zdarzenie= | w tabelce NIE pojawi się nazwa zdarzenia, co jest pozbawione sensu | |||
| <brak> | zostanie podstawiona domyślna nazwa zdarzenia - "Głosowanie" | |||
| rgz | K | o | Wskazanie rodzaju gramatycznego zdarzenia - pierwszej litery z określenia: męski, żeński, nijaki, co pozwoli użyć właściwych końcówek w określeniu stanu zdarzenia. Wartości: | |
| rgz=[m|ż|n] | wskazanie odpowiedniego rodzaju gramatycznego opisywanego zdarzenia | |||
| rgz= | w określeniu w przypadku pewnych użytych słów zabraknie końcówki lub będzię ona nieodpowiednia, co jest błędem | |||
| <brak> | zostanie podstawiona domyślny rodzaj - "n", czyli nijaki zgodny z rodzajem rzeczownika (też domyślnego) "Głosowanie" | |||
| wkLS | K | o | Wskazanie, że będzie wyświetlony komunikat podający, ile w ogólnym przypadku dla stanu trwającego zdarzenia pozostało dni, godzin, minut i sekund do zakończenia tego zdarzenia - dla okresu dłuższego niż 30 dni podany zostanie komunikat, że zdarzenie potrwa ponad 30 dni. W przypadku wskazania dla pierwszego parametru pozycyjnego wartości "---" dany parametr nie ma znaczenia, jest on pomijany. Wartości: | |
| wkLS=TAK | wyświetlenie komunikatu (jest to działanie domyślne) | |||
| <brak> | jw. | |||
| wkLS=NIE lub dowolny inny niż powyżej | komunikat nie będzie wyświetlony | |||
| 1 | P | o | Liczba dni trwania zdarzenia lub wskazanie trybu planowania zdarzenia (dla wyświetlenia odpowiedniej tymczasowej tabeli informacyjnej). Wartości: | |
| 100 | wskazanie, że okres trwania zdarzenia to 100 dni | |||
| <brak> | brak wartości spowoduje przyjęcie wartości domyślnej 7 dni | |||
| --- | wskazanie trybu planowania zdarzenia (wartością parametru są trzy znaki minus - kod ASCII dziesiętny 45, zostanie on wyświetlony w polu tabeli "Rozpoczęcie") | |||
| 2, 3, 4, 5, 6 | P | o | Rok, miesiąc, dzień godzina z minutami oraz oddzielnie sekundą początku zdarzania. W przypadku wskazania dla pierwszego parametru pozycyjnego wartości "---" dane parametry nie mają znaczenia, są one pomijane. Wartości: | |
| |2009 |4 |20 |19:15 |31 | wskazanie, że początek zdarzenia to 20 kwietnia 2009 r. o godzinie 19:15:31 | |||
| <brak> | brak którejkolwiek z wartości spowoduje przyjęcie wartości domyślnej – odpowiedniej bieżącej dla momentu wykonania konstrukcji subst:
| |||
| 7 | P | o | Aktualna dla początku zdarzenia strefa czasowa w Polsce. W przypadku wskazania dla pierwszego parametru pozycyjnego wartości "---" dany parametr nie ma znaczenia, jest on pomijany. Wartości: | |
| CET lub CEST | wskazanie odpowiednio czasu zimowego (CET) lub letniego (CEST) | |||
| <brak> | brak wartość spowoduje przyjęcie wartości pustej | |||
| inna wartość | podanie wartości innej niż CET, CEST lub pusta spowoduje wyświetlenie komunikatu Błąd w wyrażeniu – nieoczekiwany operator < | |||
Przykład ogólny wywołania ze wskazaniem wszystkich parametrów kluczowych, ale bez podania wartości dla nich. Należy pamiętać, że parametry nie muszą być w wywołaniu szablonu podawane w przytoczonej kolejności, natomiast wartości parametrów pozycyjnych nie mogą mieć przed nimi ani za nimi spacji – ich obecność spowoduje błędne działanie kodu!.
{{subst:Ramy czasowe zdarzenia|zdarzenie= |rgz= |wkLS= |liczba-dni|rok|nr-miesiąca|dzień|godzina:minuty|sekundy|czas-zimowy/letni}}
Przykład nr 1
Przykładowe wypełnienie dla zdarzenia z wszystkimi wartościami domyślnymi i zapisane 5 maja 2009 o godzinie 14:32:19:
{{subst:Ramy czasowe zdarzenia}}
spowodowało podstawienie w jego miejsce poniższego kodu:
{{Ramy czasowe zdarzenia/tabela|start=5 maja 2009 14:32:19|stop=12 maja 2009 14:32:19|startU=1241526739|stopU={{#expr:1241526739+7*86400}}}}
co dało taki efekt:
| Głosowanie zakończone | |
| Rozpoczęcie: 5 maja 2009 14:32:19 | Zakończenie: 12 maja 2009 14:32:19 |
Przykład nr 2
Przykładowe wypełnienie 30 kwietnia 2009 o godzinie 15:53:16 dla zdarzenia trwającego 12 dni i z wszystkimi pozostałymi wartościami domyślnymi:
{{subst:Ramy czasowe zdarzenia|12}}
spowodowało podstawienie w jego miejsce poniższego kodu:
{{Ramy czasowe zdarzenia/tabela|zdarzenie=Głosowanie|rgz=n|wkLS=NIE|start=30 kwietnia 2009 15:53:16|stop=12 maja 2009 15:53:16|startU=1241099596|stopU={{#expr:1241099596+12*86400}}}}
z poniższym efektem:
| Głosowanie zakończone | |
| Rozpoczęcie: 30 kwietnia 2009 15:53:16 | Zakończenie: 12 maja 2009 15:53:16 |
Przykład nr 3
Przykładowe wypełnienie dla zdarzenia "głosowanie" trwającego 7 dni rozpoczętego 20 stycznia 2009 o godzinie 21:23:11 czasu zimowego (CET):
{{subst:Ramy czasowe zdarzenia|7|2009|1|20|21:23|11|CET}}
spowoduje podstawienie w jego miejsce poniższego kodu:
{{Ramy czasowe zdarzenia/tabela|zdarzenie=Głosowanie|rgz=n|wkLS=NIE|start=20 stycznia 2009 21:23:11|stop=27 stycznia 2009 21:23:11|startU=1232482991|stopU={{#expr:1232482991+7*86400}}}}
który da poniższy efekt:
| Głosowanie zakończone | |
| Rozpoczęcie: 20 stycznia 2009 21:23:11 | Zakończenie: 27 stycznia 2009 21:23:11 |
Przykład nr 4
Zdarzenie "Lot" trwające 30 dni rozpoczęte 28 kwietnia 2009 o godzinie 21:23:11 z podaniem ile jeszcze zostało dni do końca - komunikat ten będzie w przykładzie widoczny tylko do 26 maja 2009 r.:
{{subst:Ramy czasowe zdarzenia|zdarzenie=Lot|rgz=m|wkLS=TAK|30|2009|4|27|21:23|11|CET}}
spowoduje podstawienie w jego miejsce poniższego kodu:
{{Ramy czasowe zdarzenia/tabela|zdarzenie=Lot|rgz=m|wkLS=TAK|start=27 kwietnia 2009 21:23:11|stop=27 maja 2009 21:23:11|startU=1240863791|stopU={{#expr:1240863791+30*86400}}}}
który da poniższy efekt:
| Lot zakończony | |
| Rozpoczęcie: 27 kwietnia 2009 21:23:11 | Zakończenie: 27 maja 2009 21:23:11 |
5 maja 2009 roku o g. 11:58 tabela wyglądała jak poniżej:
| Lot trwa jeszcze 22 dni 10 godz. 25 min 45 s | |
| Rozpoczęcie: 27 kwietnia 2009 21:23:11 | Zakończenie: 27 maja 2009 21:23:11 |
Przykład nr 5
Dla wstawienia tabliczki informacyjnej np. o planowanym spływie należy użyć konstrukcji::
{{subst:Ramy czasowe zdarzenia|zdarzenie=Spływ|rgz=m|---}}
co spowoduje podstawienie w jego miejsce poniższego kodu:
{{Ramy czasowe zdarzenia/tabela|start=---|stop=---|startU=|stopU=|zdarzenie=Spływ|rgz=m|}}
który da poniższy efekt:
| Spływ planowany | |
| Rozpoczęcie: --- | Zakończenie: --- |
{{Głosowanie/wynik}}