Compartilhar via

DateTimeZone.From

Sintaxe

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

Sobre

Cria um datetimezone com base no valor fornecido.

  • 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 datetimezone valor:

  • text: retorna um datetimezone valor da representação textual. Consulte DateTimeZone.FromText para obter detalhes.
  • date: retorna um datetimezone com value como o componente de data, 12:00:00 AM como o componente de hora e o deslocamento correspondente ao fuso horário local.
  • datetime: retorna um datetimezone com value como data e hora e o deslocamento de tempo correspondente ao fuso horário local.
  • datetimezone: retorna value.
  • time: Retorna um datetimezone com a data equivalente da Data de Automação OLE de 0 como componente de data, value como componente de tempo e o deslocamento correspondente da hora local. A Data de Automação OLE consiste em um número de ponto 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 naquele dia dividida por 24. Por exemplo, meia-noite, 31 de dezembro de 1899 é representado por 1,0; 6 da manhã, 1 de janeiro de 1900 é representado por 2,25; meia-noite, 29 de dezembro de 1899 é representado por -1.0; e 6 da manhã, 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º de janeiro de 0100. O valor máximo é o último momento de 31 de dezembro de 9999.
  • number: Retorna um datetimezone com o datetime 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

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

Uso

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 em português brasileiro em um datetimezone valor.

Uso

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 representa 1º de janeiro de 2025 às 12:00 para um valor datetimezone. O fuso horário no resultado depende se o exemplo é executado localmente ou online.

Uso

DateTimeZone.From(45658.5)

Saída

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

Conteúdo relacionado

  • Last updated on