Перейти к основному содержимому

Time.FromText

Создает значение времени с применением локальных, универсальных и пользовательских форматов времени.

Syntax​

Time.FromText(
    text as text,
    optional options as any
) as time

Remarks​

Создает значение time из текстового представления text. При необходимости можно задать необязательный параметр options типа record для указания дополнительных свойств. В состав record могут входить следующие поля:

  • Format. Значение типа text, указывающее используемый формат. Дополнительные сведения: https://go.microsoft.com/fwlink/?linkid=2180104 и https://go.microsoft.com/fwlink/?linkid=2180105. Если пропустить это поле или указать NULL, распознавание времени будет выполняться по принципу наилучшего возможного варианта.
  • Culture: если Format не имеет значения NULL, Culture управляет определенными спецификаторами формата. Например, при использовании "en-US" значение "tt" представляется как "AM" или "PM", тогда как для "ar-EG" значение "tt" выглядит как "ص" или "م". Если Format имеет значение NULL, Culture задает формат, используемый по умолчанию. Если значение Culture равно NULL или пропущено, используется Culture.Current.
Для поддержки прежних версий рабочих процессов options также может быть текстовым значением. При этом происходит то же самое, что и при options = [Format = null, Culture = options].

Examples​

Example #1​

Преобразовать <code>"10:12:31am"</code> в значение времени.

Time.FromText("10:12:31am")

Result:

#time(10, 12, 31)

Example #2​

Преобразование <code>"1012"</code> в значение Time.

Time.FromText("1012")

Result:

#time(10, 12, 00)

Example #3​

Преобразование <code>"10"</code> в значение Time.

Time.FromText("10")

Result:

#time(10, 00, 00)

Category​

Time