Partilhar via

DateTimeZone.From

Sintaxe

DateTimeZone.From(value as any, optional culture as nullable text) as nullable datetimezone

Sobre nós

Cria um datetimezone a partir do valor dado.

  • value: O valor usado para criar um datetimezone.
  • culture: (Opcional) A cultura a ser usada ao transformar o valor (por exemplo, "en-US").

Os valores dos seguintes tipos podem ser convertidos em um valor datetimezone:

  • text: Devolve um datetimezone valor da representação textual. Consulte DateTimeZone.FromText para obter detalhes.
  • date: Devolve um datetimezone com value como componente de data, 12:00:00 AM como componente de hora e o deslocamento correspondente ao fuso horário local.
  • datetime: Devolve um datetimezone com value como data e hora e o offset correspondente ao fuso horário local.
  • datetimezone: Retorna value.
  • : Retorna um com a data equivalente do OLE Automation Date de como componente de data, como componente de hora, e o desvio correspondente ao fuso horário local. A Data de Automação OLE consiste em um número de vírgula flutuante cujo componente integral é o número de dias antes ou depois da meia-noite, 30 de dezembro de 1899, e cujo componente fracionário representa a hora nesse dia dividida por 24. Por exemplo, meia-noite, 31 de dezembro de 1899 é representado por 1,0; 6 A.M., 1 de janeiro de 1900 é representado por 2.25; meia-noite, 29 de dezembro de 1899 é representado por -1,0; e 6 A.M., 29 de dezembro de 1899 é representado por -1.25. O valor base é meia-noite, 30 de dezembro de 1899. O valor mínimo é meia-noite, 1 janeiro 0100. O valor máximo é o último momento de 31 de dezembro de 9999.
  • number: Retorna um datetimezone com a data e hora equivalente à data de automação OLE expressa por value e o deslocamento correspondente ao fuso horário local.
  • null: Retorna null.

Se value for de qualquer outro tipo, um erro será retornado.

O valor do deslocamento correspondente ao fuso horário local é diferente ao executar essa função localmente em vez de executá-la online. Quando executado localmente, o fuso horário local é retornado. Quando executado online, o fuso horário UTC (+00:00) é retornado.

Exemplo 1

Converter a representação textual de uma data, hora e fuso horário em um datetimezone valor.

Utilização

DateTimeZone.From("2020-10-30T01:30:00-08:00")

Saída

#datetimezone(2020, 10, 30, 01, 30, 00, -8, 00)

Exemplo 2

Converta a representação textual de data, hora e fuso horário do português brasileiro para um valor datetimezone.

Utilização

DateTimeZone.From("13 de agosto de 2025 15:43:00 -03:00", "pt-BR")

Saída

#datetimezone(2025, 08, 13, 15, 43, 00, -3, 00)

Exemplo 3

Converta um número que represente o valor de 1 de janeiro de 2025 às 12h no formato datetimezone. O fuso horário no resultado depende se o exemplo é executado localmente ou online.

Utilização

DateTimeZone.From(45658.5)

Saída

#datetimezone(2025, 01, 01, 12, 00, 00, 0, 00)

Conteúdo relacionado

  • Last updated on