Saltar para o conteúdo principal

DateTimeZone.FromText

Cria um datetimezone a partir de formatos de datetimezone locais, universais e personalizados.

Syntax​

DateTimeZone.FromText(
    text as text,
    optional options as any
) as datetimezone

Remarks​

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

  • Format: Um valor de text que indica o formato a utilizar. Para mais detalhes, 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 data com o melhor esforço.
  • Culture: Quando o Format não é nulo, a Culture controla alguns especificadores de formato.. Por exemplo, em "en-US" "MMM" é "Jan", "Feb", "Mar", ..., enquanto que "ru-RU" "MMM" é "янв", "фев", "мар", .... Quando Format é null, Culture controla o formato a utilizar. Quando Culture é null ou omitido Culture.Current é utilizado.
Para apoiar fluxos de trabalho de legado, options poderá também ser um valor de texto. Isto tem o mesmo comportamento que se options = [Format = null, Culture = options].

Examples​

Example #1​

Converter <code>"2010-12-31T01:30:00-08:00"</code> num valor <code>datetimezone</code>.

DateTimeZone.FromText("2010-12-31T01:30:00-08:00")

Result:

#datetimezone(2010, 12, 31, 1, 30, 0, -8, 0)

Example #2​

Converter com um formato personalizado e a cultura alemã.

DateTimeZone.FromText("30 Dez 2010 02:04:50.369730 +02:00", [Format="dd MMM yyyy HH:mm:ss.ffffff zzz", Culture="de-DE"])

Result:

#datetimezone(2010, 12, 30, 2, 4, 50.36973, 2, 0)

Example #3​

Converter com ISO 8601.

DateTimeZone.FromText("2009-06-15T13:45:30.0000000-07:00", [Format="O", Culture="en-US"])

Result:

#datetimezone(2009, 6, 15, 13, 45, 30, -7, 0)

Category​

DateTimeZone