Tipi di dati

Tecnicamente, una costante contiene sempre un tipo di dati. Nell’espressione letterale viene specificato solo il valore . Il tipo di dati può essere dedotto dal valore (ad esempio stringa, numero intero, decimale e così via). Per casi specifici, come l’ora della data, utilizziamo funzioni dedicate per la rappresentazione.

Le sezioni seguenti forniscono informazioni sulle diverse espressioni del tipo di dati e sulla relativa rappresentazione.

string

Descrizione

Sequenza comune di caratteri. Non ha dimensioni specifiche, tranne quella implicita che proviene dall'ambiente, come la quantità di memoria disponibile.

Formato JSON: Stringa

Formato di serializzazione: UTF-8

Rappresentanza letterale

"<value>"

'<value>'

Esempio

"hello world"

'hello world'

integer

Descrizione

Valore intero da -2^63 a 2^63-1.

Formato JSON: Numero

Rappresentanza letterale

<integer value>

Esempio

42

decimale

Descrizione

Numero decimale. Rappresenta un valore mobile:

• valore finito positivo maggiore di tipo doppio, (2-2^-52)x21023
• valore normale positivo più piccolo del tipo doppio, 2-1022
• valore positivo minore diverso da zero di tipo doppio, 2 p-1074

Formato JSON: Numero

Formato di serializzazione: utilizzo di '.' come separatore decimale.

Rappresentanza letterale

<integer value>.<integer value>

Esempio

3.14

booleano

Descrizione

Valore booleano scritto in minuscolo: true o false

Formato JSON: Booleano

Rappresentanza letterale

true

false

Esempio

true

dateTimeOnly 

Descrizione

Rappresenta un’ora di data senza un fuso orario, visualizzata come anno-mese-giorno-ora-minuto-secondo-millisecondi.

Non memorizza o rappresenta un fuso orario. Invece, è una descrizione della data, come utilizzato per i compleanni, combinato con l'ora locale come visto su un orologio a muro.

Non può rappresentare un istante sulla linea temporale senza informazioni aggiuntive, ad esempio un offset o un fuso orario.

Formato di serializzazione: Formato data-ora offset esteso ISO-8601.

Utilizza DateTimeForsubject ISO_LOCAL_DATE_TIME per deserializzare e serializzare il valore. Ulteriori informazioni

Rappresentanza letterale

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

dateTime

Descrizione

Costante di data che considera anche il fuso orario. Rappresenta una data-ora con un offset da UTC.

Può essere visualizzato come un istante nel tempo con le informazioni aggiuntive dell'offset. È un modo per rappresentare un "momento" specifico in un certo luogo del mondo.

Formato JSON: Stringa.

Deve essere incapsulato in una funzione toDateTime .

Formato di serializzazione: Formato data-ora offset esteso ISO-8601.

Utilizza DateTimeForsubject ISO_OFFSET_DATE_TIME per deserializzare e serializzare il valore. Ulteriori informazioni

È inoltre possibile passare un numero intero che passa un valore epoch. Ulteriori informazioni

Il fuso orario può essere specificato da un codice di offset o di fuso orario (ad esempio: Europa/Parigi, Z - significato UTC).

Rappresentanza letterale

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

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

Esempio

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)

durata

Descrizione

Rappresenta una quantità di tempo basata sul tempo, ad esempio "34,5 secondi". Modella una quantità o una quantità di tempo in millisecondi.

Le unità temporali supportate sono: millisecondi, secondi, minuti, ore, giorni in cui un giorno è uguale a 24 ore. Gli anni e i mesi non sono supportati in quanto non rappresentano un periodo di tempo fisso.

Formato JSON: Stringa.

Deve essere incapsulato in una funzione toDuration.

Formato di serializzazione: Per deserializzare un ID di fuso orario, utilizza la funzione java java.time.

Duration.parse: i formati accettati sono basati sul formato di durata ISO-8601 PnDTnHnMn.nS con giorni considerati esattamente 24 ore. Ulteriori informazioni

Rappresentanza letterale

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

toDuration(<duration in milliseconds>)

Esempio

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

Descrizione

Elenco di espressioni separate da virgola che utilizzano parentesi quadre come delimitatori.

Polimorfismo non supportato, pertanto tutte le espressioni contenute nell'elenco devono avere lo stesso tipo.

Rappresentanza letterale

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

Esempio

["value1","value2"]

[3,5]

[toDuration(500),toDuration(800)]