データタイプ data-types

厳密に言えば、定数には常にデータタイプが含まれています。リテラル式では、値のみを指定します。このデータタイプは、値(文字列、整数、小数など)から推測できます。 日時などの特定のケースでは、表現に専用の関数を使用します。

以降の節では、様々なデータタイプ式とその表現方法について説明します。

文字列 string

説明

文字の一般的なシーケンス。使用可能なメモリ量など、環境に起因する暗黙のサイズを除き、特定のサイズはありません。

JSON 形式:文字列

シリアル化形式:UTF-8

リテラル表現

"<value>"
'<value>'

"hello world"
'hello world'

整数 integer

説明

-2^63 から 2^63-1 の整数値。

JSON 形式:数値

リテラル表現

<integer value>

42

小数 decimal

説明

小数値です。 次のような浮動小数点値を表します。

  • 倍精度浮動小数点数型の正の最大有限値は (2-2 -52)x2 1023
  • 倍精度浮動小数点数型の正の最小通常値は 2-1022
  • 倍精度浮動小数点数型の正の最小非ゼロ値は 2-1074

JSON 形式:数値

シリアル化形式:「.」を小数点として使用します。

リテラル表現

<integer value>.<integer value>

3.14

ブール値 boolean

説明

小文字で書かれたブール値:true または false

JSON 形式:ブール値

リテラル表現

true
false

true

日付のみ date-only

説明

タイムゾーンを含まずに日付のみを表し、年-月-日として表示されます。

生年月日に使用される日付を記述したものです。

JSON 形式:文字列

形式は YYYY-MM-DD(ISO-8601)です。例:「2021-03-11」

toDateOnly 関数でカプセル化できます。

値の逆シリアル化とシリアル化に DateTimeFormatter ISO_LOCAL_DATE_TIME を使用します。詳細情報

リテラル表現

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

date("2021-02-19")

日時のみ date-time-only

説明

タイムゾーンのない日時を表し、年-月-日-時間-分-秒-ミリ秒と表示されます。

JSON 形式:文字列

タイムゾーンは保存も表現もされません。代わりに、生年月日に使用される日付と、壁掛け時計に表示される現地時間を結合した記述になります。

オフセットやタイムゾーンなどの追加情報がなければ、タイムライン上の瞬間を表現できません。

toDateTimeOnly 関数でカプセル化できます。

シリアル化形式:ISO-8601 拡張オフセット日時形式。

値の逆シリアル化とシリアル化に DateTimeFormatter ISO_LOCAL_DATE_TIME を使用します。詳細情報.

リテラル表現

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

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

日時 date-time

説明

タイムゾーンも考慮した日時定数。UTC からのオフセットを持つ日時を表します。

オフセットの追加情報を含んだある瞬間と見なすことができます。これは、世界のある場所で特定の「瞬間」を表す方法です。

JSON 形式:文字列

toDateTime 関数でカプセル化できます。

シリアル化形式:ISO-8601 拡張オフセット日時形式。

値の逆シリアル化とシリアル化に DateTimeFormatter ISO_OFFSET_DATE_TIME を使用します。詳細情報.

エポック値を表す整数を渡すこともできます。詳細を表示.

タイムゾーンは、オフセットまたはタイムゾーンコード(例:Europe/Paris、Z は UTC を意味)で指定できます。

リテラル表現

toDateTime("<dateTime in ISO-8601 format>")
date("<dateTime in ISO-8601 format>")
toDateTime(<integer value of an epoch in milliseconds>)

date("2024-02-19T00.00.000Z")
toDateTime("1977-04-22T06:00:00Z")
toDateTime("2023-12-03T15:15:30Z")
toDateTime("2023-12-03T15:15:30.123Z")
toDateTime("2023-12-03T15:15:30.123+02:00")
toDateTime("2023-12-03T15:15:30.123-00:20")
toDateTime(1560762190189)

期間 duration

説明

「34.5 秒」といった時間的間隔を表します。時間の長さをミリ秒単位でモデル化します。

サポートされている時間単位は、ミリ秒、秒、分、時間、日です(日は 24 時間に等しい)。年と月は一定の時間ではないので、サポートされていません。

JSON 形式:文字列

toDuration 関数でカプセル化する必要があります。

シリアル化形式:タイムゾーン ID を逆シリアル化するには、java 関数の java.time を使用します。

Duration.parse:許可される形式は、ISO-8601 期間形式 PnDTnHnMn.nS に基づいており、日は正確に 24 時間と見なされます。詳細情報.

リテラル表現

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

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

説明

角括弧を区切り文字として使用した、式のコンマ区切りリスト。

ポリモーフィズムはサポートされていないので、リストに含まれている式はすべて同じタイプにする必要があります。

リテラル表現

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

["value1","value2"]
[3,5]
[toDuration(500),toDuration(800)]
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76