Použití funkcí data a času

Stejně jako mnoho dalších pokročilých funkcí, jsou funkce pro práci s datem a časem poskytovány prostřednictvím pluginu, který je třeba nejprve načíst:
 

Plugin poskytuje metodu format(), která přijímá časovou hodnotu, formátovací řetězec a název národního prostředí. Všechny tyto parametry jsou volitelné. Pokud není určeno, tak výchozími hodnotami jsou aktuální systémový čas, výchozím formátem je ('% H:% M:% S% d-% b-% Y') a aktuálním místním nastavením je “en_US”. Výchozí hodnoty pro čas, formát a / nebo národní prostředí mohou být zadány jako pojmenované parametry direktivy USE.
 

Tímto dojde k nastavení výchozího formátování na evropský standardní formát d.m.r bez úvodních nul, např. 1.2.2020. Níže naleznete standardní zástupné symboly.

Nyní, když jsme nahráli plugin pro datum a čas, můžeme začít pracovat s hodnotami data a času. Základním krokem je vložení aktuálního data a času podle výchozího formátování:
 

Nezapomeňte však, že se jedná o aktuální datum a čas zpracování šablony. Znamená to tedy, že datum a čas v těle zprávy bude odpovídat okamžiku vygenerování zprávy. Pokud vaše zpráva bude obsahovat odkaz na zobrazení v prohlížeči, tento náhled pak zobrazí aktuální datum a čas, nikoliv čas kdy byla zpráva odeslána

Můžete také použít funkci pro formátování jakékoli hodnoty data a času do formátu předáním určitého data v parametru date.format(datumová_hodnota). Lze tedy funkci využít k formátování data a času odeslání zprávy (viz proměnné obsahu):
 

Dalším jednoduchým příkladem je získávání data poslední objednávky uložené v poli CUSTOM1 příjemce a manipulace s tímto datem (s uloženým přesným časem):
 

V případě, že pole obsahuje pouze datum bez času, jednoduše přidáme do hodnoty libovolný čas připojením _ ' 00:00:00' k hodnotě.

Datový plugin má také některé další vylepšené funkce, které umožňují manipulaci a výpočty data a času a ty mohou být předány jako hodnoty pro formátování. Výstup z komplexnějšího výpočtu, například formátovaná hodnota nadcházejícího dne za 7 dní od dnešního dne, bude následující:
 

Nebo můžete také přepsat výchozí formátování a vrátit datum ve formátu, který si vyberete pro tento konkrétní výstup. V tomto případě chceme vrátit datum dne 60 dní před dnešním dnem ve formátu USA, zatímco výchozí formát je nastaven na evropský:
 

Jak jste si možná všimli, ve výše uvedených voláních je nová funkce nazvaná manipulace týkající se pluginu nazvaného Date::Manip. Poskytuje širokou škálu funkcí manipulace s datem a časem, které mohou dále rozšiřovat úroveň automatizace v šablonách. Jako by to nestačilo, je k dispozici další plugin nazvaný Date::Calc, který poskytuje dodatečné výpočty gregoriánského kalendáře. 
 

Chtěli jste někdy zahrnout do šablon datum velikonoční neděle, aniž byste museli aktualizovat každý rok? Tento řádek se postará o tento trik a v kombinaci s dalšími možnostmi manipulace data a času, můžete snadno přidat do šablony velikonoční blok, který se začne zobrazovat 2 týdny před Velikonoční nedělí. K tomu je potřeba udělat 2 různé výpočty – jeden pro datum velikonoční:
 

A datum 20 dnů před Velikonocemi:
 

Nyní, když máme tato dvě čísla jako hodnotu ve formátu UnixDate, což je čas v sekundách od počátku času, můžeme vytvořit jednoduchou podmínku pro zobrazení obsahu:
 

Pokud bychom chtěli naši kampaň posunout ještě o kousek dále, můžeme také spočítat počet dnů, které zbývají do Velikonoc, a mít ještě zajímavější obsah. Pro výpočet zbývajících dnů použijeme funkci delta k zobrazení rozdílu mezi aktuálním datem a vypočítaným datem velikonoc:
 

[% daystogo =  date.calc.Delta_Days(date.format(date.now,'%Y'),date.format(date.now,'%m'),date.format(date.now,'%d'),date.format(easter,'%Y'),date.format(easter,'%m'),date.format(easter,'%d')) -%]

A tuto hodnotu použijeme v našem výsledném bloku:

[% easter = date.format(date.calc.Easter_Sunday(year).join('/') _ ' 00:00:00','%s') %]
[% pre_easter = date.manip.UnixDate(date.manip.DateCalc("20 days earlier", date.calc.Easter_Sunday(year).join('/')),'%s') %]
[% daystogo =  date.calc.Delta_Days(date.format(date.now,'%Y'),date.format(date.now,'%m'),date.format(date.now,'%d'),date.format(easter,'%Y'),date.format(easter,'%m'),date.format(easter,'%d')) -%]
[% IF date.now > pre_easter && date.now < easter -%]
  <h1>Easter is coming in [% daystogo -%] days!</h1>
[% END -%]

Celé by to bylo samozřejmě mnohem snazší pro Vánoce, které mají každý rok stejné datum, ale třeba budete chtít upravit Obsah podle toho, na jaký den připadnou Vánoce. Stejná matematika by mohla být použita pro jakoukoliv jinou příležitost, např. Automatizovaný dárkový kupon k narozeninám, narozeninový dárek pro partnera, výročí svatby atd. Limity využití jsou skoro nekonečné.

Standardní zástupné znaky pro formátování data času: