Sdílet prostřednictvím


Time.ToText

Syntaxe

Time.ToText(
    time as nullable time,
    optional options as any,
    optional culture as nullable text
) as nullable text

Informace

Vrátí textovou reprezentaci time. Volitelný record parametr , optionsmůže být zadán k určení dalších vlastností. culture se používá pouze pro starší pracovní postupy. Může record obsahovat následující pole:

  • Format text: Hodnota označující formát, který se má použít. Další podrobnosti naleznete v sekci řetězce standardního formátu data a času a řetězce vlastního formátu data a času. Vynechání tohoto pole nebo zadání null způsobí formátování data pomocí výchozího nastavení definovaného hodnotou Culture.

  • Culture: Pokud Format není null, Culture řídí některé specifikátory formátu. Například v "en-US""tt" je "AM" or "PM", zatímco v "ar-EG""tt" je "ص" or "م". Pokud Format je , nullCultureurčuje výchozí formát, který se má použít. Pokud je Culturenull nebo vynecháte, použije se Culture.Current.

Pro podporu starších pracovních postupů mohou být options a culture také textové hodnoty. Toto má stejné chování jako kdyby options = [Format = options, Culture = culture].

Příklad 1

Převede #time(01, 30, 25) na text hodnotu. Výstup se může lišit v závislosti na aktuální kultuře.

Využití

Time.ToText(#time(11, 56, 2))

Výstup

"11:56 AM"

Příklad 2

Převeďte pomocí vlastního formátu a německého kulturního nastavení.

Využití

Time.ToText(#time(11, 56, 2), [Format="hh:mm", Culture="de-DE"])

Výstup

"11:56"

Příklad 3

Převod pomocí standardního formátu času

Využití

Time.ToText(#time(11, 56, 2), [Format="T", Culture="de-DE"])

Výstup

"11:56:02"