Tipos de dados

Tecnicamente, uma constante sempre contém um tipo de dados. Na expressão literal, especificamos apenas o valor. O tipo de dados pode ser inferido a partir do valor (por exemplo, string, inteiro, decimal etc.). Para casos específicos, como data e hora, usamos funções dedicadas para a representação.

As seções abaixo fornecem informações sobre as diferentes expressões de tipos de dados e como elas são representadas.

string

Descrição

Sequência comum de caracteres. Ele não tem um tamanho específico, exceto o implícito que vem do ambiente, como a quantidade de memória disponível.

Formato JSON: string

Formato de serialização: UTF-8

Representação literal

"<value>"

'<value>'

Exemplo

"hello world"

'hello world'

inteiro

Descrição

Valor inteiro de -2^63 a 2^63-1.

Formato JSON: número

Representação literal

<integer value>

Exemplo

42

decimal

Descrição

Número decimal. Ele representa um valor flutuante:

  • maior valor finito positivo do tipo double, (2-2-52)x21023
  • menor valor normal positivo do tipo double, 2-1022
  • menor valor positivo diferente de zero do tipo double, 2 p-1074

Formato JSON: número

Formato de serialização: usando '.' como separador decimal.

Representação literal

<integer value>.<integer value>

Exemplo

3.14

booleano

Descrição

Valor booleano gravado em minúsculas: verdadeiro ou falso

Formato JSON: booleano

Representação literal

true

false

Exemplo

true

dateOnly 

Descrição

Representa uma data somente sem um fuso horário, visualizado como um dia-mês-ano.

É uma descrição da data, como usada para aniversários.

Formato JSON: cadeia de caracteres.

O formato é: AAAA-MM-DD (ISO-8601), por exemplo: "2021-03-11".

Ele pode ser encapsulado em uma função toDateOnly.

Ele usa DateTimeFormatter ISO_LOCAL_DATE_TIME para desserializar e serializar o valor. Saiba mais

Representação literal

date("<dateOnly in ISO-8601 format>")

Exemplo

date("2021-02-19")

dateTimeOnly 

Descrição

Representa uma data e hora sem um fuso horário, visualizado como ano-mês-dia-hora-minuto-segundo-milissegundo.

Formato JSON: cadeia de caracteres.

Ele não armazena ou representa um fuso horário. Em vez disso, é uma descrição da data, como usada para aniversários, combinada com a hora local, como visto em um relógio de parede.

Ele não pode representar um instante na linha do tempo sem informações adicionais, como um deslocamento ou fuso horário.

Ele pode ser encapsulado em uma função toDateTimeOnly.

Formato de serialização: formato de data-hora de deslocamento estendido ISO-8601.

Ele usa DateTimeFormatter ISO_LOCAL_DATE_TIME para desserializar e serializar o valor. Saiba mais

Representação literal

date("<dateTimeOnly in ISO-8601 format>")

Exemplos

date("2021-02-19T00.00.000")
date("2021-02-19T00.00")

dateTime

Descrição

Constante de data e hora que também considera o fuso horário. Ele representa uma data e hora com um deslocamento de UTC.

Ele pode ser visto como um instante de tempo com as informações adicionais do deslocamento. É uma forma de representar um "momento" específico em um determinado lugar do mundo.

Formato JSON: cadeia de caracteres.

Ele pode ser encapsulado em uma função toDateTime.

Formato de serialização: formato de data-hora de deslocamento estendido ISO-8601.

Ele usa DateTimeFormatter ISO_OFFSET_DATE_TIME para desserializar e serializar o valor. Saiba mais

Você também pode passar um número inteiro passando um valor de época. Leia mais

O fuso horário pode ser especificado por um deslocamento ou um código de fuso horário (por exemplo: Europa/Paris, Z - significando UTC).

Representação literal

toDateTime("<dateTime in ISO-8601 format>")

date("<dateTime in ISO-8601 format>")

toDateTime(<integer value of an epoch in milliseconds>)

Exemplos

date("2021-02-19T00.00.000Z")

toDateTime("1977-04-22T06:00:00Z")

toDateTime("2011-12-03T15:15:30Z")

toDateTime("2011-12-03T15:15:30.123Z")

toDateTime("2011-12-03T15:15:30.123+02:00")

toDateTime("2011-12-03T15:15:30.123-00:20")

toDateTime(1560762190189)

duração

Descrição

Ela representa uma quantidade de tempo baseada no tempo, como "34,5 segundos". Ele modela uma quantidade ou quantidade de tempo em termos de milissegundos.

As unidades temporais suportadas são: milissegundos, segundos, minutos, horas, dias onde um dia equivale a 24 horas. Não há suporte para anos e meses, pois eles não são uma quantidade fixa de tempo.

Formato JSON: cadeia de caracteres.

Ele deve ser encapsulado em uma função toDuration.

Formato de serialização: para desserializar uma ID de fuso horário, ele usa a função java java.time.

Duration.parse: os formatos aceitos são baseados no formato de duração ISO-8601 PnDTnHnMn.nS com dias considerados exatamente 24 horas. Saiba mais

Representação literal

toDuration("<duration in ISO-8601 format>")

toDuration(<duration in milliseconds>)

Exemplo

toDuration("PT5S") -- parses as 5 seconds

toDuration(500) -- parses as 500ms

toDuration("PT20.345S") -- parses as "20.345 seconds"

toDuration("PT15M") -- parses as "15 minutes" (where a minute is 60 seconds)

toDuration("PT10H")  -- parses as "10 hours" (where an hour is 3600 seconds)

toDuration("P2D") -- parses as "2 days" (where a day is 24 hours or 86400 seconds)

toDuration("P2DT3H4M") -- parses as "2 days, 3 hours and 4 minutes"

toDuration("P-6H3M") -- parses as "-6 hours and +3 minutes"

toDuration("-P6H3M") -- parses as "-6 hours and -3 minutes"

toDuration("-P-6H+3M") -- parses as "+6 hours and -3 minutes"

list

Descrição

Lista separada por vírgulas de expressões usando colchetes como delimitadores.

Não há suporte para polimorfismo, portanto, todas as expressões contidas na lista devem ter o mesmo tipo.

Representação literal

[<expression>, <expression>, ... ]

Exemplo

["value1","value2"]

[3,5]

[toDuration(500),toDuration(800)]

Nesta página