Funkce el. výkaznictví DATETIMEFORMAT
Funkce DATETIMEFORMAT vrátí hodnotu typu řetězec, která představuje zadanou hodnotu data/času jako text v určeném formátu a ve volitelně zadané jazykové verzi. Informace o podporovaných formátech: standardní a vlastní.
Syntaxe 1
DATETIMEFORMAT (datetime, format)
Syntaxe 2
DATETIMEFORMAT (datetime, format, culture)
Argumenty
datetime: DateTime
Hodnota data/času, která představuje datum a čas pro zformátování.
format: Řetězec
Formát výstupního řetězce. Informace o podporovaných formátech: standardní a vlastní.
Poznámka
Ve formátu řetězce se rozlišují velká a malá písmena, pokud používáte standardní formát nebo vlastní formát. Například standardní specifikátor formátu „d“ vrací datum pomocí vzoru krátkého data, zatímco standardní specifikátor formátu „D“ vrací datum pomocí vzoru dlouhého data. Navíc vlastní specifikátor formátu „M“ vrací měsíc od 1 do 12, zatímco specifikátor formátu „m“ vrací minutu od 0 do 59.
culture: Řetězec
Jazyková verze, která má být použita pro formátování. Informace o podporovaných jazykových verzích viz jazyková verze.
Vrácené hodnoty
Řetězec
Výsledná hodnota řetězce.
Poznámky k použití
Pokud není jazyková verze definována jako argument volané funkce, hodnota culture je definovaná kontextem volání. Například, pokud je funkce DATETIMEFORMAT volána pomocí syntaxe 1 ve formátu elektronického výkaznictví (ER) pro prvek FILE, který je konfigurován pro použití německé jazykové verze, převod se provede pomocí německé jazykové verze. Výchozí hodnota culture je EN-US.
Když funkce DATETIMEFORMAT převádí zadanou hodnotu data/času, bere v potaz nastavení časového pásma uživatele aplikace, který používá formát elektronického výkaznictví, v jehož kontextu je funkce volána.
Příklad 1
DATETIMEFORMAT (NOW(), "dd-MM-yyyy") vrátí aktuální datum/čas aplikačního serveru, například 24. prosince 2015 jako "24-12-2015" na základě zadaného vlastního formátu.
Příklad 2
DATETIMEFORMAT (SESSIONNOW(), "d", "DE") vrátí aktuální datum a čas relace aplikace, 24. prosince 2015, jako "24.12.2015" na základě vybrané německé jazykové verze a zadaného formátu.
Příklad 3
Funkce DATETIMEFORMAT (DATETIMEVALUE( "2019-11-12T09:00:00.0000000-07:00", "O"), "O") vrátí řetězcovou hodnotu 2019-11-12T 08:00:00.0000000-08:00, když je volána během procesu, který byl iniciován uživatelem aplikace, který má hodnotu časového pásma (GMT-08:00) Tichomoří (USA a Kanada) v sekci Předvolby jazyka a země/oblasti.