Time.ToText

Синтаксис

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

О программе

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

  • Format: значение text, указывающее используемый формат. Дополнительные сведения см. в строках стандартного формата даты и времени и строках пользовательского формата даты и времени. В случае пропуска этого поля или указания 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"