Time.ToText

  • Статья

Синтаксис

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

О программе

Возвращает текстовое представление time. Для указания дополнительных свойств может быть предоставлен необязательный параметр record — options. culture используется только для устаревших рабочих процессов. record может содержать следующие поля:

  • Format: значение text, указывающее используемый формат. Дополнительные сведения см. в https://go.microsoft.com/fwlink/?linkid=2180104 и https://go.microsoft.com/fwlink/?linkid=2180105. В случае пропуска этого поля или указания null форматирование даты будет выполняться с использованием значения по умолчанию, заданного параметром Culture.

  • Culture: когда Format не имеет значение NULL, Culture управляет некоторыми описателями формата. Например, в "en-US""tt" указывается как "AM" or "PM", а в "ar-EG""tt" — как "ص" or "م". Если Format имеет значение null, Culture определяет используемый формат по умолчанию. Если Culture имеет значение null или пропущен, используется Culture.Current.

Для поддержки устаревших рабочих процессов options и culture могут также быть текстовыми значениями. Это аналогично тому, как если бы options = [Format = options, Culture = culture].

Пример 1

Преобразование #time(01, 30, 25) в text значение. Итоговые выходные данные могут зависеть от текущего языка и региональных параметров.

Использование

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

Выходные данные

"11:56 AM"

Пример 2

Преобразование с использованием пользовательского формата и немецкого языка и региональных параметров.

Использование

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

Выходные данные

"11:56"

Пример 3

Преобразование с помощью стандартного формата времени.

Использование

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

Выходные данные

"11:56:02"