Saltar para o conteúdo principal

Time.FromText

Cria uma Hora a partir dos formatos de Hora locais, universais e personalizados.

Syntax​

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

Remarks​

Cria um valor time a partir de uma representação textual, text. Pode ser fornecido um parâmetro record opcional, options, para especificar propriedades adicionais. O record pode conter os seguintes campos:

  • Format: Um valor de text que indica o formato a utilizar. Aceda a https://go.microsoft.com/fwlink/?linkid=2180104 e https://go.microsoft.com/fwlink/?linkid=2180105. Omitir este campo ou fornecer null resultará na análise da hora com o melhor esforço.
  • Culture: Quando o Format não é nulo, a Culture controla alguns especificadores de formato. Por exemplo, em "en-US", "tt" é "AM" ou "PM", ao passo que em "ar-EG", "tt" é "ص" ou "م". Quando Format é null, Culture controla o formato a utilizar. Quando Culture é null ou omitido, é utilizado Culture.Current.
Para suportar fluxos de trabalho legados, options poderá também ser um valor de texto. O comportamento é idêntico ao caso em que options = [Format = null, Culture = options].

Examples​

Example #1​

Converter <code>"10:12:31am"</code> num valor de Hora.

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

Result:

#time(10, 12, 31)

Example #2​

Converter <code>"1012"</code> num valor de hora (Time).

Time.FromText("1012")

Result:

#time(10, 12, 00)

Example #3​

Converter <code>"10"</code> num valor de hora (Time).

Time.FromText("10")

Result:

#time(10, 00, 00)

Category​

Time