型変換関数

データ変換に関する一般的な問題

to<type> 関数と cast は、いくつかのケースで異なる動作をします。たとえば、LowCardinality の場合：cast は LowCardinality 特性を削除しますが、to<type> 関数は削除しません。Nullable でも同様で、この動作は SQL 標準と互換性がなく、cast_keep_nullable 設定を使用して変更できます。

注記

データ型の値がより小さいデータ型に変換される場合（たとえば Int64 から Int32 へ）や、互換性のないデータ型間（たとえば String から Int へ）で変換されると、データ損失の可能性があることに注意してください。結果が期待通りであるかを慎重に確認してください。

例:

SELECT
    toTypeName(toLowCardinality('') AS val) AS source_type,
    toTypeName(toString(val)) AS to_type_result_type,
    toTypeName(CAST(val, 'String')) AS cast_result_type

┌─source_type────────────┬─to_type_result_type────┬─cast_result_type─┐
│ LowCardinality(String) │ LowCardinality(String) │ String           │
└────────────────────────┴────────────────────────┴──────────────────┘

SELECT
    toTypeName(toNullable('') AS val) AS source_type,
    toTypeName(toString(val)) AS to_type_result_type,
    toTypeName(CAST(val, 'String')) AS cast_result_type

┌─source_type──────┬─to_type_result_type─┬─cast_result_type─┐
│ Nullable(String) │ Nullable(String)    │ String           │
└──────────────────┴─────────────────────┴──────────────────┘

SELECT
    toTypeName(toNullable('') AS val) AS source_type,
    toTypeName(toString(val)) AS to_type_result_type,
    toTypeName(CAST(val, 'String')) AS cast_result_type
SETTINGS cast_keep_nullable = 1

┌─source_type──────┬─to_type_result_type─┬─cast_result_type─┐
│ Nullable(String) │ Nullable(String)    │ Nullable(String) │
└──────────────────┴─────────────────────┴──────────────────┘

`toString` 関数に関する注意事項

toString ファミリーの関数は、数値、文字列（固定文字列を除く）、日時と日付の間の変換を可能にします。これらのすべての関数は1つの引数を受け入れます。

文字列への変換や文字列からの変換の場合、値は TabSeparated 形式（およびほぼすべての他のテキスト形式）の同じルールを使用してフォーマットまたは解析されます。文字列が解析できない場合、例外がスローされ、リクエストはキャンセルされます。
日付を数値に変換する場合、またはその逆の場合、日付は Unix エポックの開始以来の日数に対応します。
時間を含む日付を数値に変換する場合、またはその逆の場合、時間を含む日付は Unix エポックの開始以来の秒数に対応します。
DateTime 引数の toString 関数は、タイムゾーンの名前を含む2番目の String 引数を受け取ることができます。たとえば、Europe/Amsterdam のような形式です。この場合、時間は指定されたタイムゾーンに基づいてフォーマットされます。

`toDate` / `toDateTime` 関数に関する注意事項

toDate / toDateTime 関数のための日付と時間を含まない日付のフォーマットは次のように定義されています。

YYYY-MM-DD
YYYY-MM-DD hh:mm:ss

特例として、UInt32、Int32、UInt64、または Int64 数値型から日付に変換する場合、数値が 65536 以上の場合、数値は Unix タイムスタンプとして解釈（および日数としてではなく）され、日付に丸められます。これにより、toDate(unix_timestamp) と書く一般的なケースをサポートできます。そうしないとエラーとなり、より面倒な toDate(toDateTime(unix_timestamp)) と書かなければなりません。

日付と時間を含む日付間の変換は自然な方法で行われます：時間を null に追加するか、時間を削除するかです。

数値型間の変換は、C++ における異なる数値型間の代入と同じルールを使用します。

例

クエリ:

SELECT
    now() AS ts,
    time_zone,
    toString(ts, time_zone) AS str_tz_datetime
FROM system.time_zones
WHERE time_zone LIKE 'Europe%'
LIMIT 10

結果:

┌──────────────────ts─┬─time_zone─────────┬─str_tz_datetime─────┐
│ 2023-09-08 19:14:59 │ Europe/Amsterdam  │ 2023-09-08 21:14:59 │
│ 2023-09-08 19:14:59 │ Europe/Andorra    │ 2023-09-08 21:14:59 │
│ 2023-09-08 19:14:59 │ Europe/Astrakhan  │ 2023-09-08 23:14:59 │
│ 2023-09-08 19:14:59 │ Europe/Athens     │ 2023-09-08 22:14:59 │
│ 2023-09-08 19:14:59 │ Europe/Belfast    │ 2023-09-08 20:14:59 │
│ 2023-09-08 19:14:59 │ Europe/Belgrade   │ 2023-09-08 21:14:59 │
│ 2023-09-08 19:14:59 │ Europe/Berlin     │ 2023-09-08 21:14:59 │
│ 2023-09-08 19:14:59 │ Europe/Bratislava │ 2023-09-08 21:14:59 │
│ 2023-09-08 19:14:59 │ Europe/Brussels   │ 2023-09-08 21:14:59 │
│ 2023-09-08 19:14:59 │ Europe/Bucharest  │ 2023-09-08 22:14:59 │
└─────────────────────┴───────────────────┴─────────────────────┘

また、toUnixTimestamp 関数も参照してください。

toBool

入力値を Bool 型の値に変換します。エラーが発生した場合は例外がスローされます。

構文

toBool(expr)

引数

expr — 数字または文字列を返す式。式。

サポートされている引数:

(U)Int8/16/32/64/128/256 型の値。
Float32/64 型の値。
大文字と小文字を区別しない文字列 true または false。

返される値

引数の評価に基づいて true または false を返します。Bool。

例

クエリ:

SELECT
    toBool(toUInt8(1)),
    toBool(toInt8(-1)),
    toBool(toFloat32(1.01)),
    toBool('true'),
    toBool('false'),
    toBool('FALSE')
FORMAT Vertical

結果:

toBool(toUInt8(1)):      true
toBool(toInt8(-1)):      true
toBool(toFloat32(1.01)): true
toBool('true'):          true
toBool('false'):         false
toBool('FALSE'):         false

toInt8

入力値を Int8 型の値に変換します。エラーが発生した場合は例外がスローされます。

構文

toInt8(expr)

引数

expr — 数字または数値の文字列表現を返す式。式。

サポートされている引数:

(U)Int8/16/32/64/128/256 型の値または文字列表現。
Float32/64 型の値。

サポートされていない引数:

Float32/64 型の値の文字列表現（NaN や Inf を含む）。
バイナリおよび16進数値の文字列表現、例えば SELECT toInt8('0xc0fe');。

注記

入力値が Int8 の範囲内で表現できない場合、オーバーフローまたはアンダーフローが発生します。これはエラーとは見なされません。たとえば: SELECT toInt8(128) == -128;。

返される値

8 ビット整数値。Int8。

注記

この関数はゼロに向けての丸めを使用しており、数の小数点以下の桁を切り捨てます。

例

クエリ:

SELECT
    toInt8(-8),
    toInt8(-8.8),
    toInt8('-8')
FORMAT Vertical;

結果:

Row 1:
──────
toInt8(-8):   -8
toInt8(-8.8): -8
toInt8('-8'): -8

参照

toInt8OrZero。
toInt8OrNull。
toInt8OrDefault。

toInt8OrZero

toInt8 のように、この関数は入力値を Int8 型の値に変換しますが、エラーが発生した場合は 0 を返します。

構文

toInt8OrZero(x)

引数

x — 数字の文字列表現。String。

サポートされている引数:

(U)Int8/16/32/128/256 の文字列表現。

サポートされていない引数（0 を返す）:

通常の Float32/64 の文字列表現（NaN や Inf を含む）。
バイナリおよび16進数値の文字列表現、e.g. SELECT toInt8OrZero('0xc0fe');。

注記

入力値が Int8 の範囲内で表現できない場合、オーバーフローまたはアンダーフローが発生します。これはエラーとは見なされません。

返される値

成功した場合は 8 ビット整数値、それ以外の場合は 0。Int8。

注記

この関数はゼロに向けての丸めを使用しており、数の小数点以下の桁を切り捨てます。

例

クエリ:

SELECT
    toInt8OrZero('-8'),
    toInt8OrZero('abc')
FORMAT Vertical;

結果:

Row 1:
──────
toInt8OrZero('-8'):  -8
toInt8OrZero('abc'): 0

参照

toInt8。
toInt8OrNull。
toInt8OrDefault。

toInt8OrNull

toInt8 のように、この関数は入力値を Int8 型の値に変換しますが、エラーが発生した場合は NULL を返します。

構文

toInt8OrNull(x)

引数

x — 数字の文字列表現。String。

サポートされている引数:

(U)Int8/16/32/128/256 の文字列表現。

サポートされていない引数（\N を返す）:

Float32/64 型の値の文字列表現（NaN や Inf を含む）。
バイナリおよび16進数値の文字列表現、例えば SELECT toInt8OrNull('0xc0fe');。

注記

入力値が Int8 の範囲内で表現できない場合、オーバーフローまたはアンダーフローが発生します。これはエラーとは見なされません。

返される値

成功した場合は 8 ビット整数値、それ以外の場合は NULL。Int8 / NULL。

注記

この関数はゼロに向けての丸めを使用しており、数の小数点以下の桁を切り捨てます。

例

クエリ:

SELECT
    toInt8OrNull('-8'),
    toInt8OrNull('abc')
FORMAT Vertical;

結果:

Row 1:
──────
toInt8OrNull('-8'):  -8
toInt8OrNull('abc'): ᴺᵁᴸᴸ

参照

toInt8。
toInt8OrZero。
toInt8OrDefault。

toInt8OrDefault

toInt8 のように、この関数は入力値を Int8 型の値に変換しますが、エラーが発生した場合はデフォルト値を返します。 default 値が渡されていない場合、エラーが発生した場合は 0 が返されます。

構文

toInt8OrDefault(expr[, default])

引数

expr — 数字または数値の文字列表現を返す式。式 / String。
default (オプション) — Int8 型へのパースが不成功の場合に返すデフォルト値。Int8。

サポートされている引数:

(U)Int8/16/32/64/128/256 の値または文字列表現。
Float32/64 型の値。

デフォルト値が返される引数:

Float32/64 型の値の文字列表現（NaN や Inf を含む）。
バイナリおよび16進数値の文字列表現、e.g. SELECT toInt8OrDefault('0xc0fe', CAST('-1', 'Int8'));。

注記

入力値が Int8 の範囲内で表現できない場合、オーバーフローまたはアンダーフローが発生します。これはエラーとは見なされません。

返される値

成功した場合は 8 ビット整数値、それ以外の場合は渡されたデフォルト値、ない場合は 0 を返します。Int8。

注記

この関数はゼロに向けての丸めを使用しており、数の小数点以下の桁を切り捨てます。
デフォルト値の型はキャスト型と同じである必要があります。

例

クエリ:

SELECT
    toInt8OrDefault('-8', CAST('-1', 'Int8')),
    toInt8OrDefault('abc', CAST('-1', 'Int8'))
FORMAT Vertical;

結果:

Row 1:
──────
toInt8OrDefault('-8', CAST('-1', 'Int8')):  -8
toInt8OrDefault('abc', CAST('-1', 'Int8')): -1

参照

toInt8。
toInt8OrZero。
toInt8OrNull。

toInt16

入力値を Int16 型の値に変換します。エラーが発生した場合は例外がスローされます。

構文

toInt16(expr)

引数

expr — 数字または数値の文字列表現を返す式。式。

サポートされている引数:

(U)Int8/16/32/64/128/256 型の値または文字列表現。
Float32/64 型の値。

サポートされていない引数:

Float32/64 型の値の文字列表現（NaN や Inf を含む）。
バイナリおよび16進数値の文字列表現、e.g. SELECT toInt16('0xc0fe');。

注記

入力値が Int16 の範囲内で表現できない場合、オーバーフローまたはアンダーフローが発生します。これはエラーとは見なされません。たとえば: SELECT toInt16(32768) == -32768;。

返される値

16 ビット整数値。Int16。

注記

この関数はゼロに向けての丸めを使用しており、数の小数点以下の桁を切り捨てます。

例

クエリ:

SELECT
    toInt16(-16),
    toInt16(-16.16),
    toInt16('-16')
FORMAT Vertical;

結果:

Row 1:
──────
toInt16(-16):    -16
toInt16(-16.16): -16
toInt16('-16'):  -16

参照

toInt16OrZero。
toInt16OrNull。
toInt16OrDefault。

toInt16OrZero

toInt16 のように、この関数は入力値を Int16 型の値に変換しますが、エラーが発生した場合は 0 を返します。

構文

toInt16OrZero(x)

引数

x — 数字の文字列表現。String。

サポートされている引数:

(U)Int8/16/32/128/256 の文字列表現。

サポートされていない引数（0 を返す）:

Float32/64 型の値の文字列表現（NaN や Inf を含む）。
バイナリおよび16進数値の文字列表現、e.g. SELECT toInt16OrZero('0xc0fe');。

注記

入力値が Int16 の範囲内で表現できない場合、オーバーフローまたはアンダーフローが発生します。これはエラーとは見なされません。

返される値

成功した場合は 16 ビット整数値、それ以外の場合は 0。Int16。

注記

この関数はゼロに向けての丸めを使用しており、数の小数点以下の桁を切り捨てます。

例

クエリ:

SELECT
    toInt16OrZero('-16'),
    toInt16OrZero('abc')
FORMAT Vertical;

結果:

Row 1:
──────
toInt16OrZero('-16'): -16
toInt16OrZero('abc'): 0

参照

toInt16。
toInt16OrNull。
toInt16OrDefault。

toInt16OrNull

toInt16 のように、この関数は入力値を Int16 型の値に変換しますが、エラーが発生した場合は NULL を返します。

構文

toInt16OrNull(x)

引数

x — 数字の文字列表現。String。

サポートされている引数:

(U)Int8/16/32/128/256 の文字列表現。

サポートされていない引数（\N を返す）:

Float32/64 型の値の文字列表現（NaN や Inf を含む）。
バイナリおよび16進数値の文字列表現、e.g. SELECT toInt16OrNull('0xc0fe');。

注記

入力値が Int16 の範囲内で表現できない場合、オーバーフローまたはアンダーフローが発生します。これはエラーとは見なされません。

返される値

成功した場合は 16 ビット整数値、それ以外の場合は NULL。Int16 / NULL。

注記

この関数はゼロに向けての丸めを使用しており、数の小数点以下の桁を切り捨てます。

例

クエリ:

SELECT
    toInt16OrNull('-16'),
    toInt16OrNull('abc')
FORMAT Vertical;

結果:

Row 1:
──────
toInt16OrNull('-16'): -16
toInt16OrNull('abc'): ᴺᵁᴸᴸ

参照

toInt16。
toInt16OrZero。
toInt16OrDefault。

toInt16OrDefault

toInt16 のように、この関数は入力値を Int16 型の値に変換しますが、エラーが発生した場合はデフォルト値を返します。 default 値が渡されていない場合、エラーが発生した場合は 0 が返されます。

構文

toInt16OrDefault(expr[, default])

引数

expr — 数字または数値の文字列表現を返す式。式 / String。
default (オプション) — Int16 型へのパースが不成功の場合に返すデフォルト値。Int16。

サポートされている引数:

(U)Int8/16/32/64/128/256 の値または文字列表現。
Float32/64 型の値。

デフォルト値が返される引数:

Float32/64 型の値の文字列表現（NaN や Inf を含む）。
バイナリおよび16進数値の文字列表現、e.g. SELECT toInt16OrDefault('0xc0fe', CAST('-1', 'Int16'));。

注記

入力値が Int16 の範囲内で表現できない場合、オーバーフローまたはアンダーフローが発生します。これはエラーとは見なされません。

返される値

成功した場合は 16 ビット整数値、それ以外の場合は渡されたデフォルト値、ない場合は 0 を返します。Int16。

注記

この関数はゼロに向けての丸めを使用しており、数の小数点以下の桁を切り捨てます。
デフォルト値の型はキャスト型と同じである必要があります。

例

クエリ:

SELECT
    toInt16OrDefault('-16', CAST('-1', 'Int16')),
    toInt16OrDefault('abc', CAST('-1', 'Int16'))
FORMAT Vertical;

結果:

Row 1:
──────
toInt16OrDefault('-16', CAST('-1', 'Int16')): -16
toInt16OrDefault('abc', CAST('-1', 'Int16')): -1

参照

toInt16。
toInt16OrZero。
toInt16OrNull。

toInt32

入力値を Int32 型の値に変換します。エラーが発生した場合は例外がスローされます。

構文

toInt32(expr)

引数

expr — 数字または数値の文字列表現を返す式。式。

サポートされている引数:

(U)Int8/16/32/64/128/256 型の値または文字列表現。
Float32/64 型の値。

サポートされていない引数:

Float32/64 型の値の文字列表現（NaN や Inf を含む）。
バイナリおよび16進数値の文字列表現、e.g. SELECT toInt32('0xc0fe');。

注記

入力値が Int32 の範囲内で表現できない場合、結果がオーバーフローまたはアンダーフローします。これはエラーとは見なされません。たとえば: SELECT toInt32(2147483648) == -2147483648;。

返される値

32 ビット整数値。Int32。

注記

この関数はゼロに向けての丸めを使用しており、数の小数点以下の桁を切り捨てます。

例

クエリ:

SELECT
    toInt32(-32),
    toInt32(-32.32),
    toInt32('-32')
FORMAT Vertical;

結果:

Row 1:
──────
toInt32(-32):    -32
toInt32(-32.32): -32
toInt32('-32'):  -32

参照

toInt32OrZero。
toInt32OrNull。
toInt32OrDefault。

toInt32OrZero

toInt32 のように、この関数は入力値を Int32 型の値に変換しますが、エラーが発生した場合は 0 を返します。

構文

toInt32OrZero(x)

引数

x — 数字の文字列表現。String。

サポートされている引数:

(U)Int8/16/32/128/256 の文字列表現。

サポートされていない引数（0 を返す）:

Float32/64 型の値の文字列表現（NaN や Inf を含む）。
バイナリおよび16進数値の文字列表現、e.g. SELECT toInt32OrZero('0xc0fe');。

注記

入力値が Int32 の範囲内で表現できない場合、オーバーフローまたはアンダーフローが発生します。これはエラーとは見なされません。

返される値

成功した場合は 32 ビット整数値、それ以外の場合は 0。Int32。

注記

この関数はゼロに向けての丸めを使用しており、数の小数点以下の桁を切り捨てます。

例

クエリ:

SELECT
    toInt32OrZero('-32'),
    toInt32OrZero('abc')
FORMAT Vertical;

結果:

Row 1:
──────
toInt32OrZero('-32'): -32
toInt32OrZero('abc'): 0

参照

toInt32。
toInt32OrNull。
toInt32OrDefault。

toInt32OrNull

toInt32 のように、この関数は入力値を Int32 型の値に変換しますが、エラーが発生した場合は NULL を返します。

構文

toInt32OrNull(x)

引数

x — 数字の文字列表現。String。

サポートされている引数:

(U)Int8/16/32/128/256 の文字列表現。

サポートされていない引数（\N を返す）:

Float32/64 型の値の文字列表現（NaN や Inf を含む）。
バイナリおよび16進数値の文字列表現、e.g. SELECT toInt32OrNull('0xc0fe');。

注記

入力値が Int32 の範囲内で表現できない場合、オーバーフローまたはアンダーフローが発生します。これはエラーとは見なされません。

返される値

成功した場合は 32 ビット整数値、それ以外の場合は NULL。Int32 / NULL。

注記

この関数はゼロに向けての丸めを使用しており、数の小数点以下の桁を切り捨てます。

例

クエリ:

SELECT
    toInt32OrNull('-32'),
    toInt32OrNull('abc')
FORMAT Vertical;

結果:

Row 1:
──────
toInt32OrNull('-32'): -32
toInt32OrNull('abc'): ᴺᵁᴸᴸ

参照

toInt32。
toInt32OrZero。
toInt32OrDefault。

toInt32OrDefault

toInt32 のように、この関数は入力値を Int32 型の値に変換しますが、エラーが発生した場合はデフォルト値を返します。 default 値が渡されていない場合、エラーが発生した場合は 0 が返されます。

構文

toInt32OrDefault(expr[, default])

引数

expr — 数字または数値の文字列表現を返す式。式 / String。
default (オプション) — Int32 型へのパースが不成功の場合に返すデフォルト値。Int32。

サポートされている引数:

(U)Int8/16/32/64/128/256 の値または文字列表現。
Float32/64 型の値。

デフォルト値が返される引数:

Float32/64 型の値の文字列表現（NaN や Inf を含む）。
バイナリおよび16進数値の文字列表現、e.g. SELECT toInt32OrDefault('0xc0fe', CAST('-1', 'Int32'));。

注記

入力値が Int32 の範囲内で表現できない場合、オーバーフローまたはアンダーフローが発生します。これはエラーとは見なされません。

返される値

成功した場合は 32 ビット整数値、それ以外の場合は渡されたデフォルト値、ない場合は 0 を返します。Int32。

注記

この関数はゼロに向けての丸めを使用しており、数の小数点以下の桁を切り捨てます。
デフォルト値の型はキャスト型と同じである必要があります。

例

クエリ:

SELECT
    toInt32OrDefault('-32', CAST('-1', 'Int32')),
    toInt32OrDefault('abc', CAST('-1', 'Int32'))
FORMAT Vertical;

結果:

Row 1:
──────
toInt32OrDefault('-32', CAST('-1', 'Int32')): -32
toInt32OrDefault('abc', CAST('-1', 'Int32')): -1

参照

toInt32。
toInt32OrZero。
toInt32OrNull。

toInt64

入力値を Int64 型の値に変換します。エラーが発生した場合は例外がスローされます。

構文

toInt64(expr)

引数

expr — 数字または数値の文字列表現を返す式。式。

サポートされている引数:

(U)Int8/16/32/64/128/256 型の値または文字列表現。
Float32/64 型の値。

サポートされていない型:

Float32/64 型の値の文字列表現（NaN や Inf を含む）。
バイナリおよび16進数値の文字列表現、e.g. SELECT toInt64('0xc0fe');。

注記

入力値が Int64 の範囲内で表現できない場合、結果がオーバーフローまたはアンダーフローします。これはエラーとは見なされません。たとえば: SELECT toInt64(9223372036854775808) == -9223372036854775808;。

返される値

64 ビット整数値。Int64。

注記

この関数はゼロに向けての丸めを使用しており、数の小数点以下の桁を切り捨てます。

例

クエリ:

SELECT
    toInt64(-64),
    toInt64(-64.64),
    toInt64('-64')
FORMAT Vertical;

結果:

Row 1:
──────
toInt64(-64):    -64
toInt64(-64.64): -64
toInt64('-64'):  -64

参照

toInt64OrZero。
toInt64OrNull。
toInt64OrDefault。

toInt64OrZero

toInt64 のように、この関数は入力値を Int64 型の値に変換しますが、エラーが発生した場合は 0 を返します。

構文

toInt64OrZero(x)

引数

x — 数字の文字列表現。String。

サポートされている引数:

(U)Int8/16/32/128/256 の文字列表現。

サポートされていない引数（0 を返す）:

Float32/64 型の値の文字列表現（NaN や Inf を含む）。
バイナリおよび16進数値の文字列表現、e.g. SELECT toInt64OrZero('0xc0fe');。

注記

入力値が Int64 の範囲内で表現できない場合、オーバーフローまたはアンダーフローが発生します。これはエラーとは見なされません。

返される値

成功した場合は 64 ビット整数値、それ以外の場合は 0。Int64。

注記

この関数はゼロに向けての丸めを使用しており、数の小数点以下の桁を切り捨てます。

例

クエリ:

SELECT
    toInt64OrZero('-64'),
    toInt64OrZero('abc')
FORMAT Vertical;

結果:

Row 1:
──────
toInt64OrZero('-64'): -64
toInt64OrZero('abc'): 0

参照

toInt64。
toInt64OrNull。
toInt64OrDefault。

toInt64OrNull

toInt64 のように、この関数は入力値を Int64 型の値に変換しますが、エラーが発生した場合は NULL を返します。

構文

toInt64OrNull(x)

引数

x — 数字の文字列表現。式 / String。

サポートされている引数:

(U)Int8/16/32/128/256 の文字列表現。

サポートされていない引数（\N を返す）:

Float32/64 型の値の文字列表現（NaN や Inf を含む）。
バイナリおよび16進数値の文字列表現、e.g. SELECT toInt64OrNull('0xc0fe');。

注記

入力値が Int64 の範囲内で表現できない場合、オーバーフローまたはアンダーフローが発生します。これはエラーとは見なされません。

返される値

成功した場合は 64 ビット整数値、それ以外の場合は NULL。Int64 / NULL。

注記

この関数はゼロに向けての丸めを使用しており、数の小数点以下の桁を切り捨てます。

例

クエリ:

SELECT
    toInt64OrNull('-64'),
    toInt64OrNull('abc')
FORMAT Vertical;

結果:

Row 1:
──────
toInt64OrNull('-64'): -64
toInt64OrNull('abc'): ᴺᵁᴸᴸ

参照

toInt64。
toInt64OrZero。
toInt64OrDefault。

toInt64OrDefault

toInt64 のように、この関数は入力値を Int64 型の値に変換しますが、エラーが発生した場合はデフォルト値を返します。 default 値が渡されていない場合、エラーが発生した場合は 0 が返されます。

構文

toInt64OrDefault(expr[, default])

引数

expr — 数字または数値の文字列表現を返す式。式 / String。
default (オプション) — Int64 型へのパースが不成功の場合に返すデフォルト値。Int64。

サポートされている引数:

(U)Int8/16/32/64/128/256 の値または文字列表現。
Float32/64 型の値。

デフォルト値が返される引数:

Float32/64 型の値の文字列表現（NaN や Inf を含む）。
バイナリおよび16進数値の文字列表現、e.g. SELECT toInt64OrDefault('0xc0fe', CAST('-1', 'Int64'));。

注記

入力値が Int64 の範囲内で表現できない場合、オーバーフローまたはアンダーフローが発生します。これはエラーとは見なされません。

返される値

成功した場合は 64 ビット整数値、それ以外の場合は渡されたデフォルト値、ない場合は 0 を返します。Int64。

注記

この関数はゼロに向けての丸めを使用しており、数の小数点以下の桁を切り捨てます。
デフォルト値の型はキャスト型と同じである必要があります。

例

クエリ:

SELECT
    toInt64OrDefault('-64', CAST('-1', 'Int64')),
    toInt64OrDefault('abc', CAST('-1', 'Int64'))
FORMAT Vertical;

結果:

Row 1:
──────
toInt64OrDefault('-64', CAST('-1', 'Int64')): -64
toInt64OrDefault('abc', CAST('-1', 'Int64')): -1

参照

toInt64。
toInt64OrZero。
toInt64OrNull。

toInt128

入力値を Int128 型の値に変換します。エラーが発生した場合は例外がスローされます。

構文

toInt128(expr)

引数

expr — 数字または数値の文字列表現を返す式。式。

サポートされている引数:

(U)Int8/16/32/64/128/256 型の値または文字列表現。
Float32/64 型の値。

サポートされていない引数:

Float32/64 型の値の文字列表現（NaN や Inf を含む）。
バイナリおよび16進数値の文字列表現、e.g. SELECT toInt128('0xc0fe');。

注記

入力値が Int128 の範囲内で表現できない場合、結果がオーバーフローまたはアンダーフローします。これはエラーとは見なされません。

返される値

128 ビット整数値。Int128。

注記

この関数はゼロに向けての丸めを使用しており、数の小数点以下の桁を切り捨てます。

例

クエリ:

SELECT
    toInt128(-128),
    toInt128(-128.8),
    toInt128('-128')
FORMAT Vertical;

結果:

Row 1:
──────
toInt128(-128):   -128
toInt128(-128.8): -128
toInt128('-128'): -128

参照

toInt128OrZero。
toInt128OrNull。
toInt128OrDefault。

toInt128OrZero

toInt128 のように、この関数は入力値を Int128 型の値に変換しますが、エラーが発生した場合は 0 を返します。

構文

toInt128OrZero(expr)

引数

expr — 数字または数値の文字列表現を返す式。式 / String。

サポートされている引数:

(U)Int8/16/32/128/256 の文字列表現。

サポートされていない引数（0 を返す）:

Float32/64 型の値の文字列表現（NaN や Inf を含む）。
バイナリおよび16進数値の文字列表現、e.g. SELECT toInt128OrZero('0xc0fe');。

注記

入力値が Int128 の範囲内で表現できない場合、オーバーフローまたはアンダーフローが発生します。これはエラーとは見なされません。

返される値

成功した場合は 128 ビット整数値、それ以外の場合は 0。Int128。

注記

この関数はゼロに向けての丸めを使用しており、数の小数点以下の桁を切り捨てます。

例

クエリ:

SELECT
    toInt128OrZero('-128'),
    toInt128OrZero('abc')
FORMAT Vertical;

結果:

Row 1:
──────
toInt128OrZero('-128'): -128
toInt128OrZero('abc'):  0

参照

toInt128。
toInt128OrNull。
toInt128OrDefault。

toInt128OrNull

toInt128 のように、この関数は入力値を Int128 型の値に変換しますが、エラーが発生した場合は NULL を返します。

構文

toInt128OrNull(x)

引数

x — 数字の文字列表現。式 / String。

サポートされている引数:

(U)Int8/16/32/128/256 の文字列表現。

サポートされていない引数（\N を返す）:

Float32/64 型の値の文字列表現（NaN や Inf を含む）。
バイナリおよび16進数値の文字列表現、e.g. SELECT toInt128OrNull('0xc0fe');。

注記

入力値が Int128 の範囲内で表現できない場合、オーバーフローまたはアンダーフローが発生します。これはエラーとは見なされません。

返される値

成功した場合は 128 ビット整数値、それ以外の場合は NULL。Int128 / NULL。

注記

この関数はゼロに向けての丸めを使用しており、数の小数点以下の桁を切り捨てます。

例

クエリ:

SELECT
    toInt128OrNull('-128'),
    toInt128OrNull('abc')
FORMAT Vertical;

結果:

Row 1:
──────
toInt128OrNull('-128'): -128
toInt128OrNull('abc'):  ᴺᵁᴸᴸ

参照

toInt128。
toInt128OrZero。
toInt128OrDefault。

toInt128OrDefault

toInt128 と同様に、この関数は入力値を Int128 型の値に変換しますが、エラーが発生した場合にはデフォルト値を返します。 default 値が渡されなかった場合、エラーの際には 0 が返されます。

構文

toInt128OrDefault(expr[, default])

引数

expr — 数字または数字の文字列表現を返す式です。 Expression / String。
default (オプション) — Int128 型へのパースが失敗した場合に返すデフォルト値です。 Int128。

サポートされる引数：

(U)Int8/16/32/64/128/256 型の値。
Float32/64 型の値。
(U)Int8/16/32/128/256 型の文字列表現。

デフォルト値が返される引数：

Float32/64 値の文字列表現、NaN や Inf を含む。
バイナリおよび16進値の文字列表現、例: SELECT toInt128OrDefault('0xc0fe', CAST('-1', 'Int128'));。

注記

入力値が Int128 の範囲内で表現できない場合、結果のオーバーフローまたはアンダーフローが発生します。これはエラーとは見なされません。

返される値

成功した場合は128ビット整数値、失敗した場合は渡されたデフォルト値、または渡されていない場合は 0 を返します。 Int128。

注記

この関数はゼロに向かう丸めを使用しており、数値の小数桁を切り捨てます。
デフォルト値の型はキャストされる型と同じである必要があります。

例

クエリ：

SELECT
    toInt128OrDefault('-128', CAST('-1', 'Int128')),
    toInt128OrDefault('abc', CAST('-1', 'Int128'))
FORMAT Vertical;

結果：

Row 1:
──────
toInt128OrDefault('-128', CAST('-1', 'Int128')): -128
toInt128OrDefault('abc', CAST('-1', 'Int128')):  -1

参照

toInt128.
toInt128OrZero.
toInt128OrNull.

toInt256

入力値を Int256 型の値に変換します。エラーが発生した場合には例外をスローします。

構文

toInt256(expr)

引数

expr — 数字または数字の文字列表現を返す式です。 Expression。

サポートされる引数：

(U)Int8/16/32/64/128/256 型の値またはその文字列表現。
Float32/64 型の値。

サポートされていない引数：

Float32/64 値の文字列表現、NaN や Infを含む。
バイナリおよび16進値の文字列表現、例: SELECT toInt256('0xc0fe');。

注記

入力値が Int256 の範囲内で表現できない場合、結果がオーバーフローまたはアンダーフローします。これはエラーとは見なされません。

返される値

256ビット整数値。 Int256。

注記

この関数はゼロに向かう丸めを使用しており、数値の小数桁を切り捨てます。

例

クエリ：

SELECT
    toInt256(-256),
    toInt256(-256.256),
    toInt256('-256')
FORMAT Vertical;

結果：

Row 1:
──────
toInt256(-256):     -256
toInt256(-256.256): -256
toInt256('-256'):   -256

参照

toInt256OrZero.
toInt256OrNull.
toInt256OrDefault.

toInt256OrZero

toInt256 と同様に、この関数は入力値を Int256 型の値に変換しますが、エラーが発生した場合には 0 を返します。

構文

toInt256OrZero(x)

引数

x — 数字の文字列表現です。 String。

サポートされる引数：

(U)Int8/16/32/128/256 型の文字列表現。

サポートされていない引数（0 を返す）：

Float32/64 値の文字列表現、NaN や Inf を含む。
バイナリおよび16進値の文字列表現、例: SELECT toInt256OrZero('0xc0fe');。

注記

入力値が Int256 の範囲内で表現できない場合、結果がオーバーフローまたはアンダーフローします。これはエラーとは見なされません。

返される値

成功した場合は256ビット整数値、失敗した場合は 0 を返します。 Int256。

注記

この関数はゼロに向かう丸めを使用しており、数値の小数桁を切り捨てます。

例

クエリ：

SELECT
    toInt256OrZero('-256'),
    toInt256OrZero('abc')
FORMAT Vertical;

結果：

Row 1:
──────
toInt256OrZero('-256'): -256
toInt256OrZero('abc'):  0

参照

toInt256.
toInt256OrNull.
toInt256OrDefault.

toInt256OrNull

toInt256 と同様に、この関数は入力値を Int256 型の値に変換しますが、エラーが発生した場合には NULL を返します。

構文

toInt256OrNull(x)

引数

x — 数字の文字列表現です。 String。

サポートされる引数：

(U)Int8/16/32/128/256 型の文字列表現。

サポートされていない引数（\N を返す）：

Float32/64 値の文字列表現、NaN や Inf を含む。
バイナリおよび16進値の文字列表現、例: SELECT toInt256OrNull('0xc0fe');。

注記

入力値が Int256 の範囲内で表現できない場合、結果がオーバーフローまたはアンダーフローします。これはエラーとは見なされません。

返される値

成功した場合は256ビット整数値、失敗した場合は NULL を返します。 Int256 / NULL。

注記

この関数はゼロに向かう丸めを使用しており、数値の小数桁を切り捨てます。

例

クエリ：

SELECT
    toInt256OrNull('-256'),
    toInt256OrNull('abc')
FORMAT Vertical;

結果：

Row 1:
──────
toInt256OrNull('-256'): -256
toInt256OrNull('abc'):  ᴺᵁᴸᴸ

参照

toInt256.
toInt256OrZero.
toInt256OrDefault.

toInt256OrDefault

toInt256 と同様に、この関数は入力値を Int256 型の値に変換しますが、エラーが発生した場合にはデフォルト値を返します。 default 値が渡されなかった場合、エラーの際には 0 が返されます。

構文

toInt256OrDefault(expr[, default])

引数

expr — 数字または数字の文字列表現を返す式です。 Expression / String。
default (オプション) — Int256 型へのパースが失敗した場合に返すデフォルト値です。 Int256。

サポートされる引数：

(U)Int8/16/32/64/128/256 型の値またはその文字列表現。
Float32/64 型の値。

デフォルト値が返される引数：

Float32/64 値の文字列表現、NaN や Inf を含む。
バイナリおよび16進値の文字列表現、例: SELECT toInt256OrDefault('0xc0fe', CAST('-1', 'Int256'));。

注記

入力値が Int256 の範囲内で表現できない場合、結果がオーバーフローまたはアンダーフローします。これはエラーとは見なされません。

返される値

成功した場合は256ビット整数値、失敗した場合は渡されたデフォルト値、または渡されていない場合は 0 を返します。 Int256。

注記

この関数はゼロに向かう丸めを使用しており、数値の小数桁を切り捨てます。
デフォルト値の型はキャストされる型と同じである必要があります。

例

クエリ：

SELECT
    toInt256OrDefault('-256', CAST('-1', 'Int256')),
    toInt256OrDefault('abc', CAST('-1', 'Int256'))
FORMAT Vertical;

結果：

Row 1:
──────
toInt256OrDefault('-256', CAST('-1', 'Int256')): -256
toInt256OrDefault('abc', CAST('-1', 'Int256')):  -1

参照

toInt256.
toInt256OrZero.
toInt256OrNull.

toUInt8

入力値を UInt8 型の値に変換します。エラーが発生した場合には例外をスローします。

構文

toUInt8(expr)

引数

expr — 数字または数字の文字列表現を返す式です。 Expression。

サポートされる引数：

(U)Int8/16/32/64/128/256 型の値またはその文字列表現。
Float32/64 型の値。

サポートされていない引数：

Float32/64 値の文字列表現、NaN や Inf を含む。
バイナリおよび16進値の文字列表現、例: SELECT toUInt8('0xc0fe');。

注記

入力値が UInt8 の範囲内で表現できない場合、結果がオーバーフローまたはアンダーフローします。これはエラーとは見なされません。例えば： SELECT toUInt8(256) == 0;

返される値

8ビット符号なし整数値。 UInt8。

注記

この関数はゼロに向かう丸めを使用しており、数値の小数桁を切り捨てます。

例

クエリ：

SELECT
    toUInt8(8),
    toUInt8(8.8),
    toUInt8('8')
FORMAT Vertical;

結果：

Row 1:
──────
toUInt8(8):   8
toUInt8(8.8): 8
toUInt8('8'): 8

参照

toUInt8OrZero.
toUInt8OrNull.
toUInt8OrDefault.

toUInt8OrZero

toUInt8 と同様に、この関数は入力値を UInt8 型の値に変換しますが、エラーが発生した場合には 0 を返します。

構文

toUInt8OrZero(x)

引数

x — 数字の文字列表現です。 String。

サポートされる引数：

(U)Int8/16/32/128/256 型の文字列表現。

サポートされていない引数（0 を返す）：

Float32/64 値の文字列表現、NaN や Inf を含む。
バイナリおよび16進値の文字列表現、例: SELECT toUInt8OrZero('0xc0fe');。

注記

入力値が UInt8 の範囲内で表現できない場合、結果がオーバーフローまたはアンダーフローします。これはエラーとは見なされません。

返される値

成功した場合は8ビット符号なし整数値、失敗した場合は 0 を返します。 UInt8。

注記

この関数はゼロに向かう丸めを使用しており、数値の小数桁を切り捨てます。

例

クエリ：

SELECT
    toUInt8OrZero('-8'),
    toUInt8OrZero('abc')
FORMAT Vertical;

結果：

Row 1:
──────
toUInt8OrZero('-8'):  0
toUInt8OrZero('abc'): 0

参照

toUInt8.
toUInt8OrNull.
toUInt8OrDefault.

toUInt8OrNull

toUInt8 と同様に、この関数は入力値を UInt8 型の値に変換しますが、エラーが発生した場合には NULL を返します。

構文

toUInt8OrNull(x)

引数

x — 数字の文字列表現です。 String。

サポートされる引数：

(U)Int8/16/32/128/256 型の文字列表現。

サポートされていない引数（\N を返す）：

Float32/64 値の文字列表現、NaN や Inf を含む。
バイナリおよび16進値の文字列表現、例: SELECT toUInt8OrNull('0xc0fe');。

注記

入力値が UInt8 の範囲内で表現できない場合、結果がオーバーフローまたはアンダーフローします。これはエラーとは見なされません。

返される値

成功した場合は8ビット符号なし整数値、失敗した場合は NULL を返します。 UInt8 / NULL。

注記

この関数はゼロに向かう丸めを使用しており、数値の小数桁を切り捨てます。

例

クエリ：

SELECT
    toUInt8OrNull('8'),
    toUInt8OrNull('abc')
FORMAT Vertical;

結果：

Row 1:
──────
toUInt8OrNull('8'):   8
toUInt8OrNull('abc'): ᴺᵁᴸᴸ

参照

toUInt8.
toUInt8OrZero.
toUInt8OrDefault.

toUInt8OrDefault

toUInt8 と同様に、この関数は入力値を UInt8 型の値に変換しますが、エラー発生時にはデフォルト値を返します。 default 値が渡されなかった場合、エラーの際には 0 が返されます。

構文

toUInt8OrDefault(expr[, default])

引数

expr — 数字または数字の文字列表現を返す式です。 Expression / String。
default (オプション) — UInt8 型へのパースが失敗した場合に返すデフォルト値です。 UInt8。

サポートされる引数：

(U)Int8/16/32/64/128/256 型の値やその文字列表現。
Float32/64 型の値。

デフォルト値が返される引数：

Float32/64 値の文字列表現、NaN や Inf を含む。
バイナリおよび16進値の文字列表現、例: SELECT toUInt8OrDefault('0xc0fe', CAST('0', 'UInt8'));。

注記

入力値が UInt8 の範囲内で表現できない場合、結果がオーバーフローまたはアンダーフローします。これはエラーとは見なされません。

返される値

成功した場合は8ビット符号なし整数値、失敗した場合は渡されたデフォルト値、または渡されていない場合は 0 を返します。 UInt8。

注記

この関数はゼロに向かう丸めを使用しており、数値の小数桁を切り捨てます。
デフォルト値の型はキャストされる型と同じである必要があります。

例

クエリ：

SELECT
    toUInt8OrDefault('8', CAST('0', 'UInt8')),
    toUInt8OrDefault('abc', CAST('0', 'UInt8'))
FORMAT Vertical;

結果：

Row 1:
──────
toUInt8OrDefault('8', CAST('0', 'UInt8')):   8
toUInt8OrDefault('abc', CAST('0', 'UInt8')): 0

参照

toUInt8.
toUInt8OrZero.
toUInt8OrNull.

toUInt16

入力値を UInt16 型の値に変換します。エラーが発生した場合には例外をスローします。

構文

toUInt16(expr)

引数

expr — 数字または数字の文字列表現を返す式です。 Expression。

サポートされる引数：

(U)Int8/16/32/64/128/256 型の値やその文字列表現。
Float32/64 型の値。

サポートされていない引数：

Float32/64 値の文字列表現、NaN や Inf を含む。
バイナリおよび16進値の文字列表現、例: SELECT toUInt16('0xc0fe');。

注記

入力値が UInt16 の範囲内で表現できない場合、結果がオーバーフローまたはアンダーフローします。これはエラーとは見なされません。例えば： SELECT toUInt16(65536) == 0;

返される値

16ビット符号なし整数値。 UInt16。

注記

この関数はゼロに向かう丸めを使用しており、数値の小数桁を切り捨てます。

例

クエリ：

SELECT
    toUInt16(16),
    toUInt16(16.16),
    toUInt16('16')
FORMAT Vertical;

結果：

Row 1:
──────
toUInt16(16):    16
toUInt16(16.16): 16
toUInt16('16'):  16

参照

toUInt16OrZero.
toUInt16OrNull.
toUInt16OrDefault.

toUInt16OrZero

toUInt16 と同様に、この関数は入力値を UInt16 型の値に変換しますが、エラーが発生した場合には 0 を返します。

構文

toUInt16OrZero(x)

引数

x — 数字の文字列表現です。 String。

サポートされる引数：

(U)Int8/16/32/128/256 型の文字列表現。

サポートされていない引数（0 を返す）：

Float32/64 値の文字列表現、NaN や Inf を含む。
バイナリおよび16進値の文字列表現、例: SELECT toUInt16OrZero('0xc0fe');。

注記

入力値が UInt16 の範囲内で表現できない場合、結果がオーバーフローまたはアンダーフローします。これはエラーとは見なされません。

返される値

成功した場合は16ビット符号なし整数値、失敗した場合は 0 を返します。 UInt16。

注記

この関数はゼロに向かう丸めを使用しており、数値の小数桁を切り捨てます。

例

クエリ：

SELECT
    toUInt16OrZero('16'),
    toUInt16OrZero('abc')
FORMAT Vertical;

結果：

Row 1:
──────
toUInt16OrZero('16'):  16
toUInt16OrZero('abc'): 0

参照

toUInt16.
toUInt16OrNull.
toUInt16OrDefault.

toUInt16OrNull

toUInt16 と同様に、この関数は入力値を UInt16 型の値に変換しますが、エラーが発生した場合には NULL を返します。

構文

toUInt16OrNull(x)

引数

x — 数字の文字列表現です。 String。

サポートされる引数：

(U)Int8/16/32/128/256 型の文字列表現。

サポートされていない引数（\N を返す）：

Float32/64 値の文字列表現、NaN や Inf を含む。
バイナリおよび16進値の文字列表現、例: SELECT toUInt16OrNull('0xc0fe');。

注記

入力値が UInt16 の範囲内で表現できない場合、結果がオーバーフローまたはアンダーフローします。これはエラーとは見なされません。

返される値

成功した場合は16ビット符号なし整数値、失敗した場合は NULL を返します。 UInt16 / NULL。

注記

この関数はゼロに向かう丸めを使用しており、数値の小数桁を切り捨てます。

例

クエリ：

SELECT
    toUInt16OrNull('16'),
    toUInt16OrNull('abc')
FORMAT Vertical;

結果：

Row 1:
──────
toUInt16OrNull('16'):  16
toUInt16OrNull('abc'): ᴺᵁᴸᴸ

参照

toUInt16.
toUInt16OrZero.
toUInt16OrDefault.

toUInt16OrDefault

toUInt16 と同様に、この関数は入力値を UInt16 型の値に変換しますが、エラー発生時にはデフォルト値を返します。 default 値が渡されなかった場合、エラーの際には 0 が返されます。

構文

toUInt16OrDefault(expr[, default])

引数

expr — 数字または数字の文字列表現を返す式です。 Expression / String。
default (オプション) — UInt16 型へのパースが失敗した場合に返すデフォルト値です。 UInt16。

サポートされる引数：

(U)Int8/16/32/64/128/256 型の値やその文字列表現。
Float32/64 型の値。

デフォルト値が返される引数：

Float32/64 値の文字列表現、NaN や Inf を含む。
バイナリおよび16進値の文字列表現、例: SELECT toUInt16OrDefault('0xc0fe', CAST('0', 'UInt16'));。

注記

入力値が UInt16 の範囲内で表現できない場合、結果がオーバーフローまたはアンダーフローします。これはエラーとは見なされません。

返される値

成功した場合は16ビット符号なし整数値、失敗した場合は渡されたデフォルト値、または渡されていない場合は 0 を返します。 UInt16。

注記

この関数はゼロに向かう丸めを使用しており、数値の小数桁を切り捨てます。
デフォルト値の型はキャストされる型と同じである必要があります。

例

クエリ：

SELECT
    toUInt16OrDefault('16', CAST('0', 'UInt16')),
    toUInt16OrDefault('abc', CAST('0', 'UInt16'))
FORMAT Vertical;

結果：

Row 1:
──────
toUInt16OrDefault('16', CAST('0', 'UInt16')):  16
toUInt16OrDefault('abc', CAST('0', 'UInt16')): 0

参照

toUInt16.
toUInt16OrZero.
toUInt16OrNull.

toUInt32

入力値を UInt32 型の値に変換します。エラーが発生した場合には例外をスローします。

構文

toUInt32(expr)

引数

expr — 数字または数字の文字列表現を返す式です。 Expression。

サポートされる引数：

(U)Int8/16/32/64/128/256 型の値やその文字列表現。
Float32/64 型の値。

サポートされていない引数：

Float32/64 値の文字列表現、NaN や Inf を含む。
バイナリおよび16進値の文字列表現、例: SELECT toUInt32('0xc0fe');。

注記

入力値が UInt32 の範囲内で表現できない場合、結果がオーバーフローまたはアンダーフローします。これはエラーとは見なされません。例えば： SELECT toUInt32(4294967296) == 0;

返される値

32ビット符号なし整数値。 UInt32。

注記

この関数はゼロに向かう丸めを使用しており、数値の小数桁を切り捨てます。

例

クエリ：

SELECT
    toUInt32(32),
    toUInt32(32.32),
    toUInt32('32')
FORMAT Vertical;

結果：

Row 1:
──────
toUInt32(32):    32
toUInt32(32.32): 32
toUInt32('32'):  32

参照

toUInt32OrZero.
toUInt32OrNull.
toUInt32OrDefault.

toUInt32OrZero

toUInt32 と同様に、この関数は入力値を UInt32 型の値に変換しますが、エラーが発生した場合には 0 を返します。

構文

toUInt32OrZero(x)

引数

x — 数字の文字列表現です。 String。

サポートされる引数：

(U)Int8/16/32/128/256 型の文字列表現。

サポートされていない引数（0 を返す）：

Float32/64 値の文字列表現、NaN や Inf を含む。
バイナリおよび16進値の文字列表現、例: SELECT toUInt32OrZero('0xc0fe');。

注記

入力値が UInt32 の範囲内で表現できない場合、結果がオーバーフローまたはアンダーフローします。これはエラーとは見なされません。

返される値

成功した場合は32ビット符号なし整数値、失敗した場合は 0 を返します。 UInt32

注記

この関数はゼロに向かう丸めを使用しており、数値の小数桁を切り捨てます。

例

クエリ：

SELECT
    toUInt32OrZero('32'),
    toUInt32OrZero('abc')
FORMAT Vertical;

結果：

Row 1:
──────
toUInt32OrZero('32'):  32
toUInt32OrZero('abc'): 0

参照

toUInt32.
toUInt32OrNull.
toUInt32OrDefault.

toUInt32OrNull

toUInt32 と同様に、この関数は入力値を UInt32 型の値に変換しますが、エラーが発生した場合には NULL を返します。

構文

toUInt32OrNull(x)

引数

x — 数字の文字列表現です。 String。

サポートされる引数：

(U)Int8/16/32/128/256 型の文字列表現。

サポートされていない引数（\N を返す）：

Float32/64 値の文字列表現、NaN や Inf を含む。
バイナリおよび16進値の文字列表現、例: SELECT toUInt32OrNull('0xc0fe');。

注記

入力値が UInt32 の範囲内で表現できない場合、結果がオーバーフローまたはアンダーフローします。これはエラーとは見なされません。

返される値

成功した場合は32ビット符号なし整数値、失敗した場合は NULL を返します。 UInt32 / NULL。

注記

この関数はゼロに向かう丸めを使用しており、数値の小数桁を切り捨てます。

例

クエリ：

SELECT
    toUInt32OrNull('32'),
    toUInt32OrNull('abc')
FORMAT Vertical;

結果：

Row 1:
──────
toUInt32OrNull('32'):  32
toUInt32OrNull('abc'): ᴺᵁᴸᴸ

参照

toUInt32.
toUInt32OrZero.
toUInt32OrDefault.

toUInt32OrDefault

toUInt32 と同様に、この関数は入力値を UInt32 型の値に変換しますが、エラー発生時にはデフォルト値を返します。 default 値が渡されなかった場合、エラーの際には 0 が返されます。

構文

toUInt32OrDefault(expr[, default])

引数

expr — 数字または数字の文字列表現を返す式です。 Expression / String。
default (オプション) — UInt32 型へのパースが失敗した場合に返すデフォルト値です。 UInt32。

サポートされる引数：

(U)Int8/16/32/64/128/256 型の値やその文字列表現。
Float32/64 型の値。

デフォルト値が返される引数：

Float32/64 値の文字列表現、NaN や Inf を含む。
バイナリおよび16進値の文字列表現、例: SELECT toUInt32OrDefault('0xc0fe', CAST('0', 'UInt32'));。

注記

入力値が UInt32 の範囲内で表現できない場合、結果がオーバーフローまたはアンダーフローします。これはエラーとは見なされません。

返される値

成功した場合は32ビット符号なし整数値、失敗した場合は渡されたデフォルト値、または渡されていない場合は 0 を返します。 UInt32。

注記

この関数はゼロに向かう丸めを使用しており、数値の小数桁を切り捨てます。
デフォルト値の型はキャストされる型と同じである必要があります。

例

クエリ：

SELECT
    toUInt32OrDefault('32', CAST('0', 'UInt32')),
    toUInt32OrDefault('abc', CAST('0', 'UInt32'))
FORMAT Vertical;

結果：

Row 1:
──────
toUInt32OrDefault('32', CAST('0', 'UInt32')):  32
toUInt32OrDefault('abc', CAST('0', 'UInt32')): 0

参照

toUInt32.
toUInt32OrZero.
toUInt32OrNull.

toUInt64

入力値を UInt64 型の値に変換します。エラーが発生した場合には例外をスローします。

構文

toUInt64(expr)

引数

expr — 数字または数字の文字列表現を返す式です。 Expression。

サポートされる引数：

(U)Int8/16/32/64/128/256 型の値やその文字列表現。
Float32/64 型の値。

サポートされていない引数：

Float32/64 値の文字列表現、NaN や Inf を含む。
バイナリおよび16進値の文字列表現、例: SELECT toUInt64('0xc0fe');。

注記

入力値が UInt64 の範囲内で表現できない場合、結果がオーバーフローまたはアンダーフローします。これはエラーとは見なされません。例えば： SELECT toUInt64(18446744073709551616) == 0;

返される値

64ビット符号なし整数値。 UInt64。

注記

この関数はゼロに向かう丸めを使用しており、数値の小数桁を切り捨てます。

例

クエリ：

SELECT
    toUInt64(64),
    toUInt64(64.64),
    toUInt64('64')
FORMAT Vertical;

結果：

Row 1:
──────
toUInt64(64):    64
toUInt64(64.64): 64
toUInt64('64'):  64

参照

toUInt64OrZero.
toUInt64OrNull.
toUInt64OrDefault.

toUInt64OrZero

toUInt64 と同様に、この関数は入力値を UInt64 型の値に変換しますが、エラーが発生した場合には 0 を返します。

構文

toUInt64OrZero(x)

引数

x — 数字の文字列表現です。 String。

サポートされる引数：

(U)Int8/16/32/128/256 型の文字列表現。

サポートされていない引数（0 を返す）：

Float32/64 値の文字列表現、NaN や Inf を含む。
バイナリおよび16進値の文字列表現、例: SELECT toUInt64OrZero('0xc0fe');。

注記

入力値が UInt64 の範囲内で表現できない場合、結果がオーバーフローまたはアンダーフローします。これはエラーとは見なされません。

返される値

成功した場合は64ビット符号なし整数値、失敗した場合は 0 を返します。 UInt64。

注記

この関数はゼロに向かう丸めを使用しており、数値の小数桁を切り捨てます。

例

クエリ：

SELECT
    toUInt64OrZero('64'),
    toUInt64OrZero('abc')
FORMAT Vertical;

結果：

Row 1:
──────
toUInt64OrZero('64'):  64
toUInt64OrZero('abc'): 0

参照

toUInt64.
toUInt64OrNull.
toUInt64OrDefault.

toUInt64OrNull

toUInt64 と同様に、この関数は入力値を UInt64 型の値に変換しますが、エラーが発生した場合には NULL を返します。

構文

toUInt64OrNull(x)

引数

x — 数字の文字列表現です。 Expression / String。

サポートされる引数：

(U)Int8/16/32/128/256 型の文字列表現。

サポートされていない引数（\N を返す）：

Float32/64 値の文字列表現、NaN や Inf を含む。
バイナリおよび16進値の文字列表現、例: SELECT toUInt64OrNull('0xc0fe');。

注記

入力値が UInt64 の範囲内で表現できない場合、結果がオーバーフローまたはアンダーフローします。これはエラーとは見なされません。

返される値

成功した場合は64ビット符号なし整数値、失敗した場合は NULL を返します。 UInt64 / NULL。

注記

この関数はゼロに向かう丸めを使用しており、数値の小数桁を切り捨てます。

例

クエリ：

SELECT
    toUInt64OrNull('64'),
    toUInt64OrNull('abc')
FORMAT Vertical;

結果：

Row 1:
──────
toUInt64OrNull('64'):  64
toUInt64OrNull('abc'): ᴺᵁᴸᴸ

参照

toUInt64.
toUInt64OrZero.
toUInt64OrDefault.

toUInt64OrDefault

toUInt64と同様に、この関数は入力値を型UInt64の値に変換しますが、エラーが発生した場合はデフォルト値を返します。 default値が渡されない場合は、エラー時に0が返されます。

構文

toUInt64OrDefault(expr[, default])

引数

expr — 数字を返す式または数字の文字列表現。Expression / String。
defauult (オプション) — 型UInt64への解析が失敗した場合に返されるデフォルト値。UInt64。

サポートされている引数:

(U)Int8/16/32/64/128/256型の値または文字列表現。
Float32/64型の値。

デフォルト値が返される引数:

NaNやInfを含むFloat32/64値の文字列表現。
バイナリおよび16進数の値の文字列表現。例: SELECT toUInt64OrDefault('0xc0fe', CAST('0', 'UInt64'));。

注記

入力値がUInt64の範囲内に表現できない場合、結果のオーバーフローまたはアンダーフローが発生します。これはエラーとは見なされません。

返される値

成功した場合は64ビットの符号なし整数値、そうでない場合は渡されたデフォルト値、または渡されていない場合は0を返します。UInt64。

注記

関数はゼロに向かう丸めを使用しており、数値の小数桁を切り捨てます。
デフォルト値の型はキャスト型と同じでなければなりません。

例

クエリ:

SELECT
    toUInt64OrDefault('64', CAST('0', 'UInt64')),
    toUInt64OrDefault('abc', CAST('0', 'UInt64'))
FORMAT Vertical;

結果:

Row 1:
──────
toUInt64OrDefault('64', CAST('0', 'UInt64')):  64
toUInt64OrDefault('abc', CAST('0', 'UInt64')): 0

参照

toUInt64。
toUInt64OrZero。
toUInt64OrNull。

toUInt128

入力値を型UInt128の値に変換します。エラーが発生した場合は例外をスローします。

構文

toUInt128(expr)

引数

expr — 数字を返す式または数字の文字列表現。Expression。

サポートされている引数:

(U)Int8/16/32/64/128/256型の値または文字列表現。
Float32/64型の値。

サポートされていない引数:

NaNやInfを含むFloat32/64値の文字列表現。
バイナリおよび16進数の値の文字列表現。例: SELECT toUInt128('0xc0fe');。

注記

入力値がUInt128の範囲内に表現できない場合、結果はオーバーフローまたはアンダーフローが発生します。これはエラーとは見なされません。

返される値

128ビットの符号なし整数値。UInt128。

注記

関数はゼロに向かう丸めを使用しており、数値の小数桁を切り捨てます。

例

クエリ:

SELECT
    toUInt128(128),
    toUInt128(128.8),
    toUInt128('128')
FORMAT Vertical;

結果:

Row 1:
──────
toUInt128(128):   128
toUInt128(128.8): 128
toUInt128('128'): 128

参照

toUInt128OrZero。
toUInt128OrNull。
toUInt128OrDefault。

toUInt128OrZero

toUInt128と同様に、この関数は入力値を型UInt128の値に変換しますが、エラーが発生した場合は0を返します。

構文

toUInt128OrZero(expr)

引数

expr — 数字を返す式または数字の文字列表現。Expression / String。

サポートされている引数:

(U)Int8/16/32/128/256の文字列表現。

サポートされていない引数（0を返します）:

NaNやInfを含むFloat32/64値の文字列表現。
バイナリおよび16進数の値の文字列表現。例: SELECT toUInt128OrZero('0xc0fe');。

注記

入力値がUInt128の範囲内に表現できない場合、結果のオーバーフローまたはアンダーフローが発生します。これはエラーとは見なされません。

返される値

成功した場合は128ビットの符号なし整数値、そうでない場合は0。UInt128。

注記

関数はゼロに向かう丸めを使用しており、数値の小数桁を切り捨てます。

例

クエリ:

SELECT
    toUInt128OrZero('128'),
    toUInt128OrZero('abc')
FORMAT Vertical;

結果:

Row 1:
──────
toUInt128OrZero('128'): 128
toUInt128OrZero('abc'): 0

参照

toUInt128。
toUInt128OrNull。
toUInt128OrDefault。

toUInt128OrNull

toUInt128と同様に、この関数は入力値を型UInt128の値に変換しますが、エラーが発生した場合はNULLを返します。

構文

toUInt128OrNull(x)

引数

x — 数字の文字列表現。Expression / String。

サポートされている引数:

(U)Int8/16/32/128/256の文字列表現。

サポートされていない引数（\Nを返します）

NaNやInfを含むFloat32/64値の文字列表現。
バイナリおよび16進数の値の文字列表現。例: SELECT toUInt128OrNull('0xc0fe');。

注記

入力値がUInt128の範囲内に表現できない場合、結果のオーバーフローまたはアンダーフローが発生します。これはエラーとは見なされません。

返される値

成功した場合は128ビットの符号なし整数値、そうでない場合はNULL。UInt128 / NULL。

注記

関数はゼロに向かう丸めを使用しており、数値の小数桁を切り捨てます。

例

クエリ:

SELECT
    toUInt128OrNull('128'),
    toUInt128OrNull('abc')
FORMAT Vertical;

結果:

Row 1:
──────
toUInt128OrNull('128'): 128
toUInt128OrNull('abc'): ᴺᵁᴸᴸ

参照

toUInt128。
toUInt128OrZero。
toUInt128OrDefault。

toUInt128OrDefault

toUInt128と同様に、この関数は入力値を型UInt128の値に変換しますが、エラーが発生した場合はデフォルト値を返します。 default値が渡されない場合は、エラー時に0が返されます。

構文

toUInt128OrDefault(expr[, default])

引数

expr — 数字を返す式または数字の文字列表現。Expression / String。
default (オプション) — 型UInt128への解析が失敗した場合に返されるデフォルト値。UInt128。

サポートされている引数:

(U)Int8/16/32/64/128/256。
Float32/64。
(U)Int8/16/32/128/256の文字列表現。

デフォルト値が返される引数:

NaNやInfを含むFloat32/64値の文字列表現。
バイナリおよび16進数の値の文字列表現。例: SELECT toUInt128OrDefault('0xc0fe', CAST('0', 'UInt128'));

注記

入力値がUInt128の範囲内に表現できない場合、結果のオーバーフローまたはアンダーフローが発生します。これはエラーとは見なされません。

返される値

成功した場合は128ビットの符号なし整数値、そうでない場合は渡されたデフォルト値、渡されていない場合は0を返します。UInt128。

注記

関数はゼロに向かう丸めを使用しており、数値の小数桁を切り捨てます。
デフォルト値の型はキャスト型と同じでなければなりません。

例

クエリ:

SELECT
    toUInt128OrDefault('128', CAST('0', 'UInt128')),
    toUInt128OrDefault('abc', CAST('0', 'UInt128'))
FORMAT Vertical;

結果:

Row 1:
──────
toUInt128OrDefault('128', CAST('0', 'UInt128')): 128
toUInt128OrDefault('abc', CAST('0', 'UInt128')): 0

参照

toUInt128。
toUInt128OrZero。
toUInt128OrNull。

toUInt256

入力値を型UInt256の値に変換します。エラーが発生した場合は例外をスローします。

構文

toUInt256(expr)

引数

expr — 数字を返す式または数字の文字列表現。Expression。

サポートされている引数:

(U)Int8/16/32/64/128/256型の値または文字列表現。
Float32/64型の値。

サポートされていない引数:

NaNやInfを含むFloat32/64値の文字列表現。
バイナリおよび16進数の値の文字列表現。例: SELECT toUInt256('0xc0fe');。

注記

入力値がUInt256の範囲内に表現できない場合、結果のオーバーフローまたはアンダーフローが発生します。これはエラーとは見なされません。

返される値

256ビットの符号なし整数値。Int256。

注記

関数はゼロに向かう丸めを使用しており、数値の小数桁を切り捨てます。

例

クエリ:

SELECT
    toUInt256(256),
    toUInt256(256.256),
    toUInt256('256')
FORMAT Vertical;

結果:

Row 1:
──────
toUInt256(256):     256
toUInt256(256.256): 256
toUInt256('256'):   256

参照

toUInt256OrZero。
toUInt256OrNull。
toUInt256OrDefault。

toUInt256OrZero

toUInt256と同様に、この関数は入力値を型UInt256の値に変換しますが、エラーが発生した場合は0を返します。

構文

toUInt256OrZero(x)

引数

x — 数字の文字列表現。String。

サポートされている引数:

(U)Int8/16/32/128/256の文字列表現。

サポートされていない引数（0を返す）:

NaNやInfを含むFloat32/64値の文字列表現。
バイナリおよび16進数の値の文字列表現。例: SELECT toUInt256OrZero('0xc0fe');。

注記

入力値がUInt256の範囲内に表現できない場合、結果のオーバーフローまたはアンダーフローが発生します。これはエラーとは見なされません。

返される値

成功した場合は256ビットの符号なし整数値、そうでない場合は0。UInt256。

注記

関数はゼロに向かう丸めを使用しており、数値の小数桁を切り捨てます。

例

クエリ:

SELECT
    toUInt256OrZero('256'),
    toUInt256OrZero('abc')
FORMAT Vertical;

結果:

Row 1:
──────
toUInt256OrZero('256'): 256
toUInt256OrZero('abc'): 0

参照

toUInt256。
toUInt256OrNull。
toUInt256OrDefault。

toUInt256OrNull

toUInt256と同様に、この関数は入力値を型UInt256の値に変換しますが、エラーが発生した場合はNULLを返します。

構文

toUInt256OrNull(x)

引数

x — 数字の文字列表現。String。

サポートされている引数:

(U)Int8/16/32/128/256の文字列表現。

サポートされていない引数（\Nを返します）

NaNやInfを含むFloat32/64値の文字列表現。
バイナリおよび16進数の値の文字列表現。例: SELECT toUInt256OrNull('0xc0fe');。

注記

入力値がUInt256の範囲内に表現できない場合、結果のオーバーフローまたはアンダーフローが発生します。これはエラーとは見なされません。

返される値

成功した場合は256ビットの符号なし整数値、そうでない場合はNULL。UInt256 / NULL。

注記

関数はゼロに向かう丸めを使用しており、数値の小数桁を切り捨てます。

例

クエリ:

SELECT
    toUInt256OrNull('256'),
    toUInt256OrNull('abc')
FORMAT Vertical;

結果:

Row 1:
──────
toUInt256OrNull('256'): 256
toUInt256OrNull('abc'): ᴺᵁᴸᴸ

参照

toUInt256。
toUInt256OrZero。
toUInt256OrDefault。

toUInt256OrDefault

toUInt256と同様に、この関数は入力値を型UInt256の値に変換しますが、エラーが発生した場合はデフォルト値を返します。 default値が渡されない場合は、エラー時に0が返されます。

構文

toUInt256OrDefault(expr[, default])

引数

expr — 数字を返す式または数字の文字列表現。Expression / String。
default (オプション) — 型UInt256への解析が失敗した場合に返されるデフォルト値。UInt256。

サポートされている引数:

(U)Int8/16/32/64/128/256。
Float32/64。
(U)Int8/16/32/128/256の文字列表現。

デフォルト値が返される引数:

NaNやInfを含むFloat32/64値の文字列表現。
バイナリおよび16進数の値の文字列表現。例: SELECT toUInt256OrDefault('0xc0fe', CAST('0', 'UInt256'));

注記

入力値がUInt256の範囲内に表現できない場合、結果のオーバーフローまたはアンダーフローが発生します。これはエラーとは見なされません。

返される値

成功した場合は256ビットの符号なし整数値、そうでない場合は渡されたデフォルト値、渡されていない場合は0を返します。UInt256。

注記

関数はゼロに向かう丸めを使用しており、数値の小数桁を切り捨てます。
デフォルト値の型はキャスト型と同じでなければなりません。

例

クエリ:

SELECT
    toUInt256OrDefault('-256', CAST('0', 'UInt256')),
    toUInt256OrDefault('abc', CAST('0', 'UInt256'))
FORMAT Vertical;

結果:

Row 1:
──────
toUInt256OrDefault('-256', CAST('0', 'UInt256')): 0
toUInt256OrDefault('abc', CAST('0', 'UInt256')):  0

参照

toUInt256。
toUInt256OrZero。
toUInt256OrNull。

toFloat32

入力値を型Float32の値に変換します。エラーが発生した場合は例外をスローします。

構文

toFloat32(expr)

引数

expr — 数字を返す式または数字の文字列表現。Expression。

サポートされている引数:

(U)Int8/16/32/64/128/256型の値。
(U)Int8/16/32/128/256の文字列表現。
Float32/64型の値、NaNおよびInfを含む。
Float32/64の文字列表現、NaNおよびInfを含む（大文字と小文字を区別しない）。

サポートされていない引数:

バイナリおよび16進数の値の文字列表現。例: SELECT toFloat32('0xc0fe');。

返される値

32ビットの浮動小数点値。Float32。

例

クエリ:

SELECT
    toFloat32(42.7),
    toFloat32('42.7'),
    toFloat32('NaN')
FORMAT Vertical;

結果:

Row 1:
──────
toFloat32(42.7):   42.7
toFloat32('42.7'): 42.7
toFloat32('NaN'):  nan

参照

toFloat32OrZero。
toFloat32OrNull。
toFloat32OrDefault。

toFloat32OrZero

toFloat32と同様に、この関数は入力値を型Float32の値に変換しますが、エラーが発生した場合は0を返します。

構文

toFloat32OrZero(x)

引数

x — 数字の文字列表現。String。

サポートされている引数:

(U)Int8/16/32/128/256、Float32/64の文字列表現。

サポートされていない引数（0を返します）:

バイナリおよび16進数の値の文字列表現。例: SELECT toFloat32OrZero('0xc0fe');。

返される値

成功した場合は32ビットのFloat値、そうでない場合は0。Float32。

例

クエリ:

SELECT
    toFloat32OrZero('42.7'),
    toFloat32OrZero('abc')
FORMAT Vertical;

結果:

Row 1:
──────
toFloat32OrZero('42.7'): 42.7
toFloat32OrZero('abc'):  0

参照

toFloat32。
toFloat32OrNull。
toFloat32OrDefault。

toFloat32OrNull

toFloat32と同様に、この関数は入力値を型Float32の値に変換しますが、エラーが発生した場合はNULLを返します。

構文

toFloat32OrNull(x)

引数

x — 数字の文字列表現。String。

サポートされている引数:

(U)Int8/16/32/128/256、Float32/64の文字列表現。

サポートされていない引数（\Nを返します）:

バイナリおよび16進数の値の文字列表現。例: SELECT toFloat32OrNull('0xc0fe');。

返される値

成功した場合は32ビットのFloat値、そうでない場合は\N。Float32。

例

クエリ:

SELECT
    toFloat32OrNull('42.7'),
    toFloat32OrNull('abc')
FORMAT Vertical;

結果:

Row 1:
──────
toFloat32OrNull('42.7'): 42.7
toFloat32OrNull('abc'):  ᴺᵁᴸᴸ

参照

toFloat32。
toFloat32OrZero。
toFloat32OrDefault。

toFloat32OrDefault

toFloat32と同様に、この関数は入力値を型Float32の値に変換しますが、エラーが発生した場合はデフォルト値を返します。 default値が渡されない場合は、エラー時に0が返されます。

構文

toFloat32OrDefault(expr[, default])

引数

expr — 数字を返す式または数字の文字列表現。Expression / String。
default (オプション) — 型Float32への解析が失敗した場合に返されるデフォルト値。Float32。

サポートされている引数:

(U)Int8/16/32/64/128/256型の値。
(U)Int8/16/32/128/256の文字列表現。
Float32/64型の値、NaNおよびInfを含む。
Float32/64の文字列表現、NaNおよびInfを含む（大文字と小文字を区別しない）。

デフォルト値が返される引数:

バイナリおよび16進数の値の文字列表現。例: SELECT toFloat32OrDefault('0xc0fe', CAST('0', 'Float32'));。

返される値

成功した場合は32ビットのFloat値、そうでない場合は渡されたデフォルト値、渡されていない場合は0を返します。Float32。

例

クエリ:

SELECT
    toFloat32OrDefault('8', CAST('0', 'Float32')),
    toFloat32OrDefault('abc', CAST('0', 'Float32'))
FORMAT Vertical;

結果:

Row 1:
──────
toFloat32OrDefault('8', CAST('0', 'Float32')):   8
toFloat32OrDefault('abc', CAST('0', 'Float32')): 0

参照

toFloat32。
toFloat32OrZero。
toFloat32OrNull。

toFloat64

入力値を型Float64の値に変換します。エラーが発生した場合は例外をスローします。

構文

toFloat64(expr)

引数

expr — 数字を返す式または数字の文字列表現。Expression。

サポートされている引数:

(U)Int8/16/32/64/128/256型の値。
(U)Int8/16/32/128/256の文字列表現。
Float32/64型の値、NaNおよびInfを含む。
Float32/64の文字列表現、NaNおよびInfを含む（大文字と小文字を区別しない）。

サポートされていない引数:

バイナリおよび16進数の値の文字列表現。例: SELECT toFloat64('0xc0fe');。

返される値

64ビットの浮動小数点値。Float64。

例

クエリ:

SELECT
    toFloat64(42.7),
    toFloat64('42.7'),
    toFloat64('NaN')
FORMAT Vertical;

結果:

Row 1:
──────
toFloat64(42.7):   42.7
toFloat64('42.7'): 42.7
toFloat64('NaN'):  nan

参照

toFloat64OrZero。
toFloat64OrNull。
toFloat64OrDefault。

toFloat64OrZero

toFloat64と同様に、この関数は入力値を型Float64の値に変換しますが、エラーが発生した場合は0を返します。

構文

toFloat64OrZero(x)

引数

x — 数字の文字列表現。String。

サポートされている引数:

(U)Int8/16/32/128/256、Float32/64の文字列表現。

サポートされていない引数（0を返します）:

バイナリおよび16進数の値の文字列表現。例: SELECT toFloat64OrZero('0xc0fe');。

返される値

成功した場合は64ビットのFloat値、そうでない場合は0。Float64。

例

クエリ:

SELECT
    toFloat64OrZero('42.7'),
    toFloat64OrZero('abc')
FORMAT Vertical;

結果:

Row 1:
──────
toFloat64OrZero('42.7'): 42.7
toFloat64OrZero('abc'):  0

参照

toFloat64。
toFloat64OrNull。
toFloat64OrDefault。

toFloat64OrNull

toFloat64と同様に、この関数は入力値を型Float64の値に変換しますが、エラーが発生した場合はNULLを返します。

構文

toFloat64OrNull(x)

引数

x — 数字の文字列表現。String。

サポートされている引数:

(U)Int8/16/32/128/256、Float32/64の文字列表現。

サポートされていない引数（\Nを返します）:

バイナリおよび16進数の値の文字列表現。例: SELECT toFloat64OrNull('0xc0fe');。

返される値

成功した場合は64ビットのFloat値、そうでない場合は\N。Float64。

例

クエリ:

SELECT
    toFloat64OrNull('42.7'),
    toFloat64OrNull('abc')
FORMAT Vertical;

結果:

Row 1:
──────
toFloat64OrNull('42.7'): 42.7
toFloat64OrNull('abc'):  ᴺᵁᴸᴸ

参照

toFloat64。
toFloat64OrZero。
toFloat64OrDefault。

toFloat64OrDefault

toFloat64と同様に、この関数は入力値を型Float64の値に変換しますが、エラーが発生した場合はデフォルト値を返します。 default値が渡されない場合は、エラー時に0が返されます。

構文

toFloat64OrDefault(expr[, default])

引数

expr — 数字を返す式または数字の文字列表現。Expression / String。
default (オプション) — 型Float64への解析が失敗した場合に返されるデフォルト値。Float64。

サポートされている引数:

(U)Int8/16/32/64/128/256型の値。
(U)Int8/16/32/128/256の文字列表現。
Float32/64型の値、NaNおよびInfを含む。
Float32/64の文字列表現、NaNおよびInfを含む（大文字と小文字を区別しない）。

デフォルト値が返される引数:

バイナリおよび16進数の値の文字列表現。例: SELECT toFloat64OrDefault('0xc0fe', CAST('0', 'Float64'));。

返される値

成功した場合は64ビットのFloat値、そうでない場合は渡されたデフォルト値、渡されていない場合は0を返します。Float64。

例

クエリ:

SELECT
    toFloat64OrDefault('8', CAST('0', 'Float64')),
    toFloat64OrDefault('abc', CAST('0', 'Float64'))
FORMAT Vertical;

結果:

Row 1:
──────
toFloat64OrDefault('8', CAST('0', 'Float64')):   8
toFloat64OrDefault('abc', CAST('0', 'Float64')): 0

参照

toFloat64。
toFloat64OrZero。
toFloat64OrNull。

toBFloat16

入力値を型BFloat16の値に変換します。エラーが発生した場合は例外をスローします。

構文

toBFloat16(expr)

引数

expr — 数字を返す式または数字の文字列表現。Expression。

サポートされている引数:

(U)Int8/16/32/64/128/256型の値。
(U)Int8/16/32/128/256の文字列表現。
Float32/64型の値、NaNおよびInfを含む。
Float32/64の文字列表現、NaNおよびInfを含む（大文字と小文字を区別しない）。

返される値

16ビットのブレインフロート値。BFloat16。

例

SELECT toBFloat16(toFloat32(42.7))

42.5

SELECT toBFloat16(toFloat32('42.7'));

42.5

SELECT toBFloat16('42.7');

42.5

参照

toBFloat16OrZero。
toBFloat16OrNull。

toBFloat16OrZero

文字列入力値を型BFloat16の値に変換します。文字列が浮動小数点値を表さない場合、関数はゼロを返します。

構文

toBFloat16OrZero(x)

引数

x — 数字の文字列表現。String。

サポートされている引数:

数値の文字列表現。

サポートされていない引数（0を返します）:

バイナリおよび16進数の値の文字列表現。
数値。

返される値

16ビットのブレインフロート値、そうでない場合は0。BFloat16。

注記

この関数は、文字列表現から変換する際の精度の損失を許可します。

例

SELECT toBFloat16OrZero('0x5E'); -- unsupported arguments

0

SELECT toBFloat16OrZero('12.3'); -- typical use

12.25

SELECT toBFloat16OrZero('12.3456789');

12.3125 -- silent loss of precision

参照

toBFloat16。
toBFloat16OrNull。

toBFloat16OrNull

文字列入力値を型BFloat16の値に変換しますが、文字列が浮動小数点値を表さない場合、関数はNULLを返します。

構文

toBFloat16OrNull(x)

引数

x — 数字の文字列表現。String。

サポートされている引数:

数値の文字列表現。

サポートされていない引数（NULLを返します）:

バイナリおよび16進数の値の文字列表現。
数値。

返される値

16ビットのブレインフロート値、そうでない場合はNULL (\N)。BFloat16。

注記

この関数は、文字列表現から変換する際の精度の損失を許可します。

例

SELECT toBFloat16OrNull('0x5E'); -- unsupported arguments

\N

SELECT toBFloat16OrNull('12.3'); -- typical use

12.25

SELECT toBFloat16OrNull('12.3456789');

12.3125 -- silent loss of precision

参照

toBFloat16。
toBFloat16OrZero。

toDate

引数をDateデータ型に変換します。

引数がDateTimeまたはDateTime64の場合、切り捨てられ、DateTimeの日時部分が残ります：

SELECT
    now() AS x,
    toDate(x)

┌───────────────────x─┬─toDate(now())─┐
│ 2022-12-30 13:44:17 │    2022-12-30 │
└─────────────────────┴───────────────┘

引数がStringの場合、DateまたはDateTimeとして解析されます。DateTimeとして解析された場合、日付部分が使用されます：

SELECT
    toDate('2022-12-30') AS x,
    toTypeName(x)

┌──────────x─┬─toTypeName(toDate('2022-12-30'))─┐
│ 2022-12-30 │ Date                             │
└────────────┴──────────────────────────────────┘

1 row in set. Elapsed: 0.001 sec.

SELECT
    toDate('2022-12-30 01:02:03') AS x,
    toTypeName(x)

┌──────────x─┬─toTypeName(toDate('2022-12-30 01:02:03'))─┐
│ 2022-12-30 │ Date                                      │
└────────────┴───────────────────────────────────────────┘

引数が数値で、UNIXタイムスタンプのように見える（65535より大きい）場合、DateTimeとして解釈され、次に現在のタイムゾーンでDateに切り捨てられます。タイムゾーンの引数は、関数の2番目の引数として指定できます。Dateへの切り捨てはタイムゾーンによって異なります：

SELECT
    now() AS current_time,
    toUnixTimestamp(current_time) AS ts,
    toDateTime(ts) AS time_Amsterdam,
    toDateTime(ts, 'Pacific/Apia') AS time_Samoa,
    toDate(time_Amsterdam) AS date_Amsterdam,
    toDate(time_Samoa) AS date_Samoa,
    toDate(ts) AS date_Amsterdam_2,
    toDate(ts, 'Pacific/Apia') AS date_Samoa_2

Row 1:
──────
current_time:     2022-12-30 13:51:54
ts:               1672404714
time_Amsterdam:   2022-12-30 13:51:54
time_Samoa:       2022-12-31 01:51:54
date_Amsterdam:   2022-12-30
date_Samoa:       2022-12-31
date_Amsterdam_2: 2022-12-30
date_Samoa_2:     2022-12-31

上記の例は、同じUNIXタイムスタンプが異なるタイムゾーンで異なる日付として解釈される様子を示しています。

引数が数値で、65536より小さい場合、1970-01-01（最初のUNIX日）からの日数として解釈され、Dateに変換されます。これはDateデータ型の内部数値表現に対応します。例：

SELECT toDate(12345)

┌─toDate(12345)─┐
│    2003-10-20 │
└───────────────┘

この変換はタイムゾーンには依存しません。

引数がDate型に収まらない場合は、実装依存の動作となり、最大サポート日付まで飽和するか、オーバーフローが発生します：

SELECT toDate(10000000000.)

┌─toDate(10000000000.)─┐
│           2106-02-07 │
└──────────────────────┘

関数toDateは別の形式でも記述できます：

SELECT
    now() AS time,
    toDate(time),
    DATE(time),
    CAST(time, 'Date')

┌────────────────time─┬─toDate(now())─┬─DATE(now())─┬─CAST(now(), 'Date')─┐
│ 2022-12-30 13:54:58 │    2022-12-30 │  2022-12-30 │          2022-12-30 │
└─────────────────────┴───────────────┴─────────────┴─────────────────────┘

toDateOrZero

Dateに渡された無効な引数を受け取った場合、toDateと同じですが、Dateの下限が返されます。サポートされる引数はStringのみに限られます。

例

クエリ:

SELECT toDateOrZero('2022-12-30'), toDateOrZero('');

結果:

┌─toDateOrZero('2022-12-30')─┬─toDateOrZero('')─┐
│                 2022-12-30 │       1970-01-01 │
└────────────────────────────┴──────────────────┘

toDateOrNull

無効な引数を受け取った場合、toDateと同じですが、NULLが返されます。サポートされる引数はStringのみに限られます。

例

クエリ:

SELECT toDateOrNull('2022-12-30'), toDateOrNull('');

結果:

┌─toDateOrNull('2022-12-30')─┬─toDateOrNull('')─┐
│                 2022-12-30 │             ᴺᵁᴸᴸ │
└────────────────────────────┴──────────────────┘

toDateOrDefault

Dateに渡された無効な引数を受け取った場合、toDateと同様ですが、失敗した場合はデフォルト値（指定されている場合は第2引数、そうでない場合はDateの下限）が返されます。

構文

toDateOrDefault(expr [, default_value])

例

クエリ:

SELECT toDateOrDefault('2022-12-30'), toDateOrDefault('', '2023-01-01'::Date);

結果:

┌─toDateOrDefault('2022-12-30')─┬─toDateOrDefault('', CAST('2023-01-01', 'Date'))─┐
│                    2022-12-30 │                                      2023-01-01 │
└───────────────────────────────┴─────────────────────────────────────────────────┘

toDateTime

入力値をDateTimeに変換します。

構文

toDateTime(expr[, time_zone ])

引数

expr — 値。String、Int、DateまたはDateTime。
time_zone — タイムゾーン。String。

注記

exprが数値の場合、それはUnixエポックの開始からの秒数として解釈されます（Unixタイムスタンプとして）。 exprがStringの場合、Unixタイムスタンプとして、または日付 / 時間付きの日付の文字列表現として解釈される場合があります。したがって、短い数値の文字列表現（最大4桁）の解析はあいまいさから無効化されます。例えば、文字列'1999'は年（DateまたはDateTimeの不完全な文字列表現）またはUnixタイムスタンプの両方であり得ます。長い数値の文字列は許可されています。

返される値

日付時刻。DateTime

例

クエリ:

SELECT toDateTime('2022-12-30 13:44:17'), toDateTime(1685457500, 'UTC');

結果:

┌─toDateTime('2022-12-30 13:44:17')─┬─toDateTime(1685457500, 'UTC')─┐
│               2022-12-30 13:44:17 │           2023-05-30 14:38:20 │
└───────────────────────────────────┴───────────────────────────────┘

toDateTimeOrZero

無効な引数を受け取った場合、toDateTimeと同じですが、DateTimeの下限が返されます。サポートされる引数はStringのみに限られます。

例

クエリ:

SELECT toDateTimeOrZero('2022-12-30 13:44:17'), toDateTimeOrZero('');

結果:

┌─toDateTimeOrZero('2022-12-30 13:44:17')─┬─toDateTimeOrZero('')─┐
│                     2022-12-30 13:44:17 │  1970-01-01 00:00:00 │
└─────────────────────────────────────────┴──────────────────────┘

toDateTimeOrNull

無効な引数を受け取った場合、toDateTimeと同じですが、NULLが返されます。サポートされる引数はStringのみに限られます。

例

クエリ:

SELECT toDateTimeOrNull('2022-12-30 13:44:17'), toDateTimeOrNull('');

結果:

┌─toDateTimeOrNull('2022-12-30 13:44:17')─┬─toDateTimeOrNull('')─┐
│                     2022-12-30 13:44:17 │                 ᴺᵁᴸᴸ │
└─────────────────────────────────────────┴──────────────────────┘

toDateTimeOrDefault

DateTimeに渡された無効な引数を受け取った場合、toDateTimeと同様ですが、失敗した場合はデフォルト値（指定されている場合は第3引数、そうでない場合はDateTimeの下限）が返されます。

構文

toDateTimeOrDefault(expr [, time_zone [, default_value]])

例

クエリ:

SELECT toDateTimeOrDefault('2022-12-30 13:44:17'), toDateTimeOrDefault('', 'UTC', '2023-01-01'::DateTime('UTC'));

結果:

┌─toDateTimeOrDefault('2022-12-30 13:44:17')─┬─toDateTimeOrDefault('', 'UTC', CAST('2023-01-01', 'DateTime(\'UTC\')'))─┐
│                        2022-12-30 13:44:17 │                                                     2023-01-01 00:00:00 │
└────────────────────────────────────────────┴─────────────────────────────────────────────────────────────────────────┘

toDate32

引数をDate32データ型に変換します。値が範囲外の場合、toDate32はDate32によってサポートされている境界値を返します。引数がDate型の場合は、その境界も考慮されます。

構文

toDate32(expr)

引数

expr — 値。String、UInt32またはDate。

返される値

カレンダー日付。型Date32。

例

値が範囲内の場合:

SELECT toDate32('1955-01-01') AS value, toTypeName(value);

┌──────value─┬─toTypeName(toDate32('1925-01-01'))─┐
│ 1955-01-01 │ Date32                             │
└────────────┴────────────────────────────────────┘

値が範囲外の場合:

SELECT toDate32('1899-01-01') AS value, toTypeName(value);

┌──────value─┬─toTypeName(toDate32('1899-01-01'))─┐
│ 1900-01-01 │ Date32                             │
└────────────┴────────────────────────────────────┘

Date引数の場合:

SELECT toDate32(toDate('1899-01-01')) AS value, toTypeName(value);

┌──────value─┬─toTypeName(toDate32(toDate('1899-01-01')))─┐
│ 1970-01-01 │ Date32                                     │
└────────────┴────────────────────────────────────────────┘

toDate32OrZero

Date32に渡された無効な引数を受け取った場合、toDate32と同様ですが、Date32の最小値が返されます。

例

クエリ:

SELECT toDate32OrZero('1899-01-01'), toDate32OrZero('');

結果:

┌─toDate32OrZero('1899-01-01')─┬─toDate32OrZero('')─┐
│                   1900-01-01 │         1900-01-01 │
└──────────────────────────────┴────────────────────┘

toDate32OrNull

無効な引数を受け取った場合、toDate32と同様ですが、NULLが返されます。

例

クエリ:

SELECT toDate32OrNull('1955-01-01'), toDate32OrNull('');

結果:

┌─toDate32OrNull('1955-01-01')─┬─toDate32OrNull('')─┐
│                   1955-01-01 │               ᴺᵁᴸᴸ │
└──────────────────────────────┴────────────────────┘

toDate32OrDefault

引数を Date32 データ型に変換します。値が範囲外の場合、toDate32OrDefault は Date32 でサポートされている下限値を返します。引数が Date 型である場合、その境界が考慮されます。無効な引数が受け取られた場合、デフォルト値を返します。

例

クエリ:

SELECT
    toDate32OrDefault('1930-01-01', toDate32('2020-01-01')),
    toDate32OrDefault('xx1930-01-01', toDate32('2020-01-01'));

結果:

┌─toDate32OrDefault('1930-01-01', toDate32('2020-01-01'))─┬─toDate32OrDefault('xx1930-01-01', toDate32('2020-01-01'))─┐
│                                              1930-01-01 │                                                2020-01-01 │
└─────────────────────────────────────────────────────────┴───────────────────────────────────────────────────────────┘

toDateTime64

入力値を DateTime64 型の値に変換します。

構文

toDateTime64(expr, scale, [timezone])

引数

expr — 値。 String、UInt32、Float または DateTime。
scale - タイムサイズ (精度): 10^-precision 秒。有効な範囲: [ 0 : 9 ]。
timezone (オプション) - 指定された datetime64 オブジェクトのタイムゾーン。

返される値

カレンダーの日付と時間、サブ秒精度付き。 DateTime64。

例

値が範囲内:

SELECT toDateTime64('1955-01-01 00:00:00.000', 3) AS value, toTypeName(value);

┌───────────────────value─┬─toTypeName(toDateTime64('1955-01-01 00:00:00.000', 3))─┐
│ 1955-01-01 00:00:00.000 │ DateTime64(3)                                          │
└─────────────────────────┴────────────────────────────────────────────────────────┘

精度付きの小数として:

SELECT toDateTime64(1546300800.000, 3) AS value, toTypeName(value);

┌───────────────────value─┬─toTypeName(toDateTime64(1546300800., 3))─┐
│ 2019-01-01 00:00:00.000 │ DateTime64(3)                            │
└─────────────────────────┴──────────────────────────────────────────┘

小数点なしの値は、Unix タイムスタンプ（秒）として扱われます:

SELECT toDateTime64(1546300800000, 3) AS value, toTypeName(value);

┌───────────────────value─┬─toTypeName(toDateTime64(1546300800000, 3))─┐
│ 2282-12-31 00:00:00.000 │ DateTime64(3)                              │
└─────────────────────────┴────────────────────────────────────────────┘

timezone の使用:

SELECT toDateTime64('2019-01-01 00:00:00', 3, 'Asia/Istanbul') AS value, toTypeName(value);

┌───────────────────value─┬─toTypeName(toDateTime64('2019-01-01 00:00:00', 3, 'Asia/Istanbul'))─┐
│ 2019-01-01 00:00:00.000 │ DateTime64(3, 'Asia/Istanbul')                                      │
└─────────────────────────┴─────────────────────────────────────────────────────────────────────┘

toDateTime64OrZero

toDateTime64 と同様に、この関数は入力値を DateTime64 型の値に変換しますが、無効な引数が受け取られた場合は DateTime64 の最小値を返します。

構文

toDateTime64OrZero(expr, scale, [timezone])

引数

expr — 値。 String、UInt32、Float または DateTime。
scale - タイムサイズ (精度): 10^-precision 秒。有効な範囲: [ 0 : 9 ]。
timezone (オプション) - 指定された DateTime64 オブジェクトのタイムゾーン。

返される値

カレンダーの日付と時間、サブ秒精度付き。無効な場合は DateTime64 の最小値: 1970-01-01 01:00:00.000 。 DateTime64。

例

クエリ:

SELECT toDateTime64OrZero('2008-10-12 00:00:00 00:30:30', 3) AS invalid_arg

結果:

┌─────────────invalid_arg─┐
│ 1970-01-01 01:00:00.000 │
└─────────────────────────┘

参照

toDateTime64。
toDateTime64OrNull。
toDateTime64OrDefault。

toDateTime64OrNull

toDateTime64 と同様に、この関数は入力値を DateTime64 型の値に変換しますが、無効な引数が受け取られた場合は NULL を返します。

構文

toDateTime64OrNull(expr, scale, [timezone])

引数

expr — 値。 String、UInt32、Float または DateTime。
scale - タイムサイズ (精度): 10^-precision 秒。有効な範囲: [ 0 : 9 ]。
timezone (オプション) - 指定された DateTime64 オブジェクトのタイムゾーン。

返される値

カレンダーの日付と時間、サブ秒精度付き。無効な場合は NULL。 DateTime64/NULL。

例

クエリ:

SELECT
    toDateTime64OrNull('1976-10-18 00:00:00.30', 3) AS valid_arg,
    toDateTime64OrNull('1976-10-18 00:00:00 30', 3) AS invalid_arg

結果:

┌───────────────valid_arg─┬─invalid_arg─┐
│ 1976-10-18 00:00:00.300 │        ᴺᵁᴸᴸ │
└─────────────────────────┴─────────────┘

参照

toDateTime64。
toDateTime64OrZero。
toDateTime64OrDefault。

toDateTime64OrDefault

toDateTime64 と同様に、この関数は入力値を DateTime64 型の値に変換しますが、無効な引数が受け取られた場合は DateTime64 のデフォルト値または指定されたデフォルト値を返します。

構文

toDateTime64OrNull(expr, scale, [timezone, default])

引数

expr — 値。 String、UInt32、Float または DateTime。
scale - タイムサイズ (精度): 10^-precision 秒。有効な範囲: [ 0 : 9 ]。
timezone (オプション) - 指定された DateTime64 オブジェクトのタイムゾーン。
default (オプション) - 無効な引数が受け取られた場合に返すデフォルト値。 DateTime64。

返される値

カレンダーの日付と時間、サブ秒精度付き。無効な場合は DateTime64 の最小値または指定された default 値。 DateTime64。

例

クエリ:

SELECT
    toDateTime64OrDefault('1976-10-18 00:00:00 30', 3) AS invalid_arg,
    toDateTime64OrDefault('1976-10-18 00:00:00 30', 3, 'UTC', toDateTime64('2001-01-01 00:00:00.00',3)) AS invalid_arg_with_default

結果:

┌─────────────invalid_arg─┬─invalid_arg_with_default─┐
│ 1970-01-01 01:00:00.000 │  2000-12-31 23:00:00.000 │
└─────────────────────────┴──────────────────────────┘

参照

toDateTime64。
toDateTime64OrZero。
toDateTime64OrNull。

toDecimal32

入力値を Decimal(9, S) 型の値に変換します。エラーが発生した場合は例外をスローします。

構文

toDecimal32(expr, S)

引数

expr — 数字を返す表現または数字の文字列表現。 Expression。
S — 数字の小数部分が持つことのできる桁数を指定するスケールパラメータ（0から9の間）。 UInt8。

サポートされている引数:

(U)Int8/16/32/64/128/256 型の値または文字列。
Float32/64 型の値または文字列。

サポートされていない引数:

Float32/64 値 NaN および Inf の文字列表現（大文字小文字を区別しない）。
バイナリおよび16進数値の文字列表現（例: SELECT toDecimal32('0xc0fe', 1);）。

注記

expr の値が Decimal32 の境界を超えるとオーバーフローが発生する可能性があります: ( -1 * 10^(9 - S), 1 * 10^(9 - S) )。小数部分で過剰な桁は廃棄されます（丸められません）。整数部分の過剰な桁は例外を引き起こします。

注意

変換は、余分な桁をドロップし、Float32/Float64 入力を扱っているときに予想外の方法で動作する可能性があります。なぜなら、演算は浮動小数点命令を使用して行われるからです。例えば: toDecimal32(1.15, 2) は 1.14 と等しいです。なぜなら 1.15 * 100 の浮動小数点の結果は 114.99 だからです。文字列入力を使用すると、演算は基になる整数型を使用します: toDecimal32('1.15', 2) = 1.15

返される値

Decimal(9, S) 型の値。 Decimal32(S)。

例

クエリ:

SELECT
    toDecimal32(2, 1) AS a, toTypeName(a) AS type_a,
    toDecimal32(4.2, 2) AS b, toTypeName(b) AS type_b,
    toDecimal32('4.2', 3) AS c, toTypeName(c) AS type_c
FORMAT Vertical;

結果:

Row 1:
──────
a:      2
type_a: Decimal(9, 1)
b:      4.2
type_b: Decimal(9, 2)
c:      4.2
type_c: Decimal(9, 3)

参照

toDecimal32OrZero。
toDecimal32OrNull。
toDecimal32OrDefault。

toDecimal32OrZero

toDecimal32 と同様に、この関数は入力値を Decimal(9, S) 型の値に変換しますが、エラーの場合は 0 を返します。

構文

toDecimal32OrZero(expr, S)

引数

expr — 数字の文字列表現。 String。
S — 数字の小数部分が持つことのできる桁数を指定するスケールパラメータ（0から9の間）。 UInt8。

サポートされている引数:

(U)Int8/16/32/64/128/256 型の文字列表現。
Float32/64 型の文字列表現。

サポートされていない引数:

Float32/64 値 NaN および Inf の文字列表現。
バイナリおよび16進数値の文字列表現（例: SELECT toDecimal32OrZero('0xc0fe', 1);）。

注記

expr の値が Decimal32 の境界を超えるとオーバーフローが発生する可能性があります: ( -1 * 10^(9 - S), 1 * 10^(9 - S) )。小数部分で過剰な桁は廃棄されます（丸められません）。整数部分の過剰な桁はエラーを引き起こします。

返される値

成功した場合は Decimal(9, S) 型の値。失敗した場合は 0 （S 桁の小数付き）。 Decimal32(S)。

例

クエリ:

SELECT
    toDecimal32OrZero(toString(-1.111), 5) AS a,
    toTypeName(a),
    toDecimal32OrZero(toString('Inf'), 5) AS b,
    toTypeName(b)
FORMAT Vertical;

結果:

Row 1:
──────
a:             -1.111
toTypeName(a): Decimal(9, 5)
b:             0
toTypeName(b): Decimal(9, 5)

参照

toDecimal32。
toDecimal32OrNull。
toDecimal32OrDefault。

toDecimal32OrNull

toDecimal32 と同様に、この関数は入力値を Nullable(Decimal(9, S)) 型の値に変換しますが、エラーの場合は 0 を返します。

構文

toDecimal32OrNull(expr, S)

引数

expr — 数字の文字列表現。 String。
S — 数字の小数部分が持つことのできる桁数を指定するスケールパラメータ（0から9の間）。 UInt8。

サポートされている引数:

(U)Int8/16/32/64/128/256 型の文字列表現。
Float32/64 型の文字列表現。

サポートされていない引数:

Float32/64 値 NaN および Inf の文字列表現。
バイナリおよび16進数値の文字列表現（例: SELECT toDecimal32OrNull('0xc0fe', 1);）。

注記

返される値

成功した場合は Nullable(Decimal(9, S)) 型の値。失敗した場合は同じ型の NULL 値。 Decimal32(S)。

例

クエリ:

SELECT
    toDecimal32OrNull(toString(-1.111), 5) AS a,
    toTypeName(a),
    toDecimal32OrNull(toString('Inf'), 5) AS b,
    toTypeName(b)
FORMAT Vertical;

結果:

Row 1:
──────
a:             -1.111
toTypeName(a): Nullable(Decimal(9, 5))
b:             ᴺᵁᴸᴸ
toTypeName(b): Nullable(Decimal(9, 5))

参照

toDecimal32。
toDecimal32OrZero。
toDecimal32OrDefault。

toDecimal32OrDefault

toDecimal32 と同様に、この関数は入力値を Decimal(9, S) 型の値に変換しますが、エラーの場合はデフォルト値を返します。

構文

toDecimal32OrDefault(expr, S[, default])

引数

expr — 数字の文字列表現。 String。
S — 数字の小数部分が持つことのできる桁数を指定するスケールパラメータ（0から9の間）。 UInt8。
default (オプション) — Decimal32(S) 型への解析が失敗した場合に返すデフォルト値。 Decimal32(S)。

サポートされている引数:

(U)Int8/16/32/64/128/256 型の文字列表現。
Float32/64 型の文字列表現。

サポートされていない引数:

Float32/64 値 NaN および Inf の文字列表現。
バイナリおよび16進数値の文字列表現（例: SELECT toDecimal32OrDefault('0xc0fe', 1);）。

注記

注意

変換は、余分な桁をドロップし、Float32/Float64 入力を扱っているときに予想外の方法で動作する可能性があります。なぜなら、演算は浮動小数点命令を使用して行われるからです。例えば: toDecimal32OrDefault(1.15, 2) は 1.14 と等しいです。なぜなら 1.15 * 100 の浮動小数点の結果は 114.99 だからです。文字列入力を使用すると、演算は基になる整数型を使用します: toDecimal32OrDefault('1.15', 2) = 1.15

返される値

成功した場合は Decimal(9, S) 型の値。失敗した場合は指定されたデフォルト値または 0 を返します。 Decimal32(S)。

例

クエリ:

SELECT
    toDecimal32OrDefault(toString(0.0001), 5) AS a,
    toTypeName(a),
    toDecimal32OrDefault('Inf', 0, CAST('-1', 'Decimal32(0)')) AS b,
    toTypeName(b)
FORMAT Vertical;

結果:

Row 1:
──────
a:             0.0001
toTypeName(a): Decimal(9, 5)
b:             -1
toTypeName(b): Decimal(9, 0)

参照

toDecimal32。
toDecimal32OrZero。
toDecimal32OrNull。

toDecimal64

入力値を Decimal(18, S) 型の値に変換します。エラーが発生した場合は例外をスローします。

構文

toDecimal64(expr, S)

引数

expr — 数字を返す表現または数字の文字列表現。 Expression。
S — 数字の小数部分が持つことのできる桁数を指定するスケールパラメータ（0から18の間）。 UInt8。

サポートされている引数:

(U)Int8/16/32/64/128/256 型の値または文字列。
Float32/64 型の値または文字列。

サポートされていない引数:

Float32/64 値 NaN および Inf の文字列表現（大文字小文字を区別しない）。
バイナリおよび16進数値の文字列表現（例: SELECT toDecimal64('0xc0fe', 1);）。

注記

expr の値が Decimal64 の境界を超えるとオーバーフローが発生する可能性があります: ( -1 * 10^(18 - S), 1 * 10^(18 - S) )。小数部分で過剰な桁は廃棄されます（丸められません）。整数部分の過剰な桁は例外を引き起こします。

注意

変換は、余分な桁をドロップし、Float32/Float64 入力を扱っているときに予想外の方法で動作する可能性があります。なぜなら、演算は浮動小数点命令を使用して行われるからです。例えば: toDecimal64(1.15, 2) は 1.14 と等しいです。なぜなら 1.15 * 100 の浮動小数点の結果は 114.99 だからです。文字列入力を使用すると、演算は基になる整数型を使用します: toDecimal64('1.15', 2) = 1.15

返される値

Decimal(18, S) 型の値。 Decimal64(S)。

例

クエリ:

SELECT
    toDecimal64(2, 1) AS a, toTypeName(a) AS type_a,
    toDecimal64(4.2, 2) AS b, toTypeName(b) AS type_b,
    toDecimal64('4.2', 3) AS c, toTypeName(c) AS type_c
FORMAT Vertical;

結果:

Row 1:
──────
a:      2
type_a: Decimal(18, 1)
b:      4.2
type_b: Decimal(18, 2)
c:      4.2
type_c: Decimal(18, 3)

参照

toDecimal64OrZero。
toDecimal64OrNull。
toDecimal64OrDefault。

toDecimal64OrZero

toDecimal64 と同様に、この関数は入力値を Decimal(18, S) 型の値に変換しますが、エラーの場合は 0 を返します。

構文

toDecimal64OrZero(expr, S)

引数

expr — 数字の文字列表現。 String。
S — 数字の小数部分が持つことのできる桁数を指定するスケールパラメータ（0から18の間）。 UInt8。

サポートされている引数:

(U)Int8/16/32/64/128/256 型の文字列表現。
Float32/64 型の文字列表現。

サポートされていない引数:

Float32/64 値 NaN および Inf の文字列表現。
バイナリおよび16進数値の文字列表現（例: SELECT toDecimal64OrZero('0xc0fe', 1);）。

注記

expr の値が Decimal64 の境界を超えるとオーバーフローが発生する可能性があります: ( -1 * 10^(18 - S), 1 * 10^(18 - S) )。小数部分で過剰な桁は廃棄されます（丸められません）。整数部分の過剰な桁はエラーを引き起こします。

返される値

成功した場合は Decimal(18, S) 型の値。失敗した場合は 0 （S 桁の小数付き）。 Decimal64(S)。

例

クエリ:

SELECT
    toDecimal64OrZero(toString(0.0001), 18) AS a,
    toTypeName(a),
    toDecimal64OrZero(toString('Inf'), 18) AS b,
    toTypeName(b)
FORMAT Vertical;

結果:

Row 1:
──────
a:             0.0001
toTypeName(a): Decimal(18, 18)
b:             0
toTypeName(b): Decimal(18, 18)

参照

toDecimal64。
toDecimal64OrNull。
toDecimal64OrDefault。

toDecimal64OrNull

toDecimal64 と同様に、この関数は入力値を Nullable(Decimal(18, S)) 型の値に変換しますが、エラーの場合は 0 を返します。

構文

toDecimal64OrNull(expr, S)

引数

expr — 数字の文字列表現。 String。
S — 数字の小数部分が持つことのできる桁数を指定するスケールパラメータ（0から18の間）。 UInt8。

サポートされている引数:

(U)Int8/16/32/64/128/256 型の文字列表現。
Float32/64 型の文字列表現。

サポートされていない引数:

Float32/64 値 NaN および Inf の文字列表現。
バイナリおよび16進数値の文字列表現（例: SELECT toDecimal64OrNull('0xc0fe', 1);）。

注記

返される値

成功した場合は Nullable(Decimal(18, S)) 型の値。失敗した場合は同じ型の NULL 値。 Decimal64(S)。

例

クエリ:

SELECT
    toDecimal64OrNull(toString(0.0001), 18) AS a,
    toTypeName(a),
    toDecimal64OrNull(toString('Inf'), 18) AS b,
    toTypeName(b)
FORMAT Vertical;

結果:

Row 1:
──────
a:             0.0001
toTypeName(a): Nullable(Decimal(18, 18))
b:             ᴺᵁᴸᴸ
toTypeName(b): Nullable(Decimal(18, 18))

参照

toDecimal64。
toDecimal64OrZero。
toDecimal64OrDefault。

toDecimal64OrDefault

toDecimal64 と同様に、この関数は入力値を Decimal(18, S) 型の値に変換しますが、エラーの場合はデフォルト値を返します。

構文

toDecimal64OrDefault(expr, S[, default])

引数

expr — 数字の文字列表現。 String。
S — 数字の小数部分が持つことのできる桁数を指定するスケールパラメータ（0から18の間）。 UInt8。
default (オプション) — Decimal64(S) 型への解析が失敗した場合に返すデフォルト値。 Decimal64(S)。

サポートされている引数:

(U)Int8/16/32/64/128/256 型の文字列表現。
Float32/64 型の文字列表現。

サポートされていない引数:

Float32/64 値 NaN および Inf の文字列表現。
バイナリおよび16進数値の文字列表現（例: SELECT toDecimal64OrDefault('0xc0fe', 1);）。

注記

注意

変換は、余分な桁をドロップし、Float32/Float64 入力を扱っているときに予想外の方法で動作する可能性があります。なぜなら、演算は浮動小数点命令を使用して行われるからです。例えば: toDecimal64OrDefault(1.15, 2) は 1.14 と等しいです。なぜなら 1.15 * 100 の浮動小数点の結果は 114.99 だからです。文字列入力を使用すると、演算は基になる整数型を使用します: toDecimal64OrDefault('1.15', 2) = 1.15

返される値

成功した場合は Decimal(18, S) 型の値。失敗した場合は指定されたデフォルト値または 0 を返します。 Decimal64(S)。

例

クエリ:

SELECT
    toDecimal64OrDefault(toString(0.0001), 18) AS a,
    toTypeName(a),
    toDecimal64OrDefault('Inf', 0, CAST('-1', 'Decimal64(0)')) AS b,
    toTypeName(b)
FORMAT Vertical;

結果:

Row 1:
──────
a:             0.0001
toTypeName(a): Decimal(18, 18)
b:             -1
toTypeName(b): Decimal(18, 0)

参照

toDecimal64。
toDecimal64OrZero。
toDecimal64OrNull。

toDecimal128

入力値を Decimal(38, S) 型の値に変換します。エラーが発生した場合は例外をスローします。

構文

toDecimal128(expr, S)

引数

expr — 数字を返す表現または数字の文字列表現。 Expression。
S — 数字の小数部分が持つことのできる桁数を指定するスケールパラメータ（0から38の間）。 UInt8。

サポートされている引数:

(U)Int8/16/32/64/128/256 型の値または文字列。
Float32/64 型の値または文字列。

サポートされていない引数:

Float32/64 値 NaN および Inf の文字列表現（大文字小文字を区別しない）。
バイナリおよび16進数値の文字列表現（例: SELECT toDecimal128('0xc0fe', 1);）。

注記

expr の値が Decimal128 の境界を超えるとオーバーフローが発生する可能性があります: ( -1 * 10^(38 - S), 1 * 10^(38 - S) )。小数部分で過剰な桁は廃棄されます（丸められません）。整数部分の過剰な桁は例外を引き起こします。

注意

変換は、余分な桁をドロップし、Float32/Float64 入力を扱っているときに予想外の方法で動作する可能性があります。なぜなら、演算は浮動小数点命令を使用して行われるからです。例えば: toDecimal128(1.15, 2) は 1.14 と等しいです。なぜなら 1.15 * 100 の浮動小数点の結果は 114.99 だからです。文字列入力を使用すると、演算は基になる整数型を使用します: toDecimal128('1.15', 2) = 1.15

返される値

Decimal(38, S) 型の値。 Decimal128(S)。

例

クエリ:

SELECT
    toDecimal128(99, 1) AS a, toTypeName(a) AS type_a,
    toDecimal128(99.67, 2) AS b, toTypeName(b) AS type_b,
    toDecimal128('99.67', 3) AS c, toTypeName(c) AS type_c
FORMAT Vertical;

結果:

Row 1:
──────
a:      99
type_a: Decimal(38, 1)
b:      99.67
type_b: Decimal(38, 2)
c:      99.67
type_c: Decimal(38, 3)

参照

toDecimal128OrZero。
toDecimal128OrNull。
toDecimal128OrDefault。

toDecimal128OrZero

toDecimal128 と同様に、この関数は入力値を Decimal(38, S) 型の値に変換しますが、エラーの場合は 0 を返します。

構文

toDecimal128OrZero(expr, S)

引数

expr — 数字の文字列表現。 String。
S — 数字の小数部分が持つことのできる桁数を指定するスケールパラメータ（0から38の間）。 UInt8。

サポートされている引数:

(U)Int8/16/32/64/128/256 型の文字列表現。
Float32/64 型の文字列表現。

サポートされていない引数:

Float32/64 値 NaN および Inf の文字列表現。
バイナリおよび16進数値の文字列表現（例: SELECT toDecimal128OrZero('0xc0fe', 1);）。

注記

expr の値が Decimal128 の境界を超えるとオーバーフローが発生する可能性があります: ( -1 * 10^(38 - S), 1 * 10^(38 - S) )。小数部分で過剰な桁は廃棄されます（丸められません）。整数部分の過剰な桁はエラーを引き起こします。

返される値

成功した場合は Decimal(38, S) 型の値。失敗した場合は 0 （S 桁の小数付き）。 Decimal128(S)。

例

クエリ:

SELECT
    toDecimal128OrZero(toString(0.0001), 38) AS a,
    toTypeName(a),
    toDecimal128OrZero(toString('Inf'), 38) AS b,
    toTypeName(b)
FORMAT Vertical;

結果:

Row 1:
──────
a:             0.0001
toTypeName(a): Decimal(38, 38)
b:             0
toTypeName(b): Decimal(38, 38)

参照

toDecimal128。
toDecimal128OrNull。
toDecimal128OrDefault。

toDecimal128OrNull

toDecimal128 と同様に、この関数は入力値を Nullable(Decimal(38, S)) 型の値に変換しますが、エラーの場合は 0 を返します。

構文

toDecimal128OrNull(expr, S)

引数

expr — 数字の文字列表現。 String。
S — 数字の小数部分が持つことのできる桁数を指定するスケールパラメータ（0から38の間）。 UInt8。

サポートされている引数:

(U)Int8/16/32/64/128/256 型の文字列表現。
Float32/64 型の文字列表現。

サポートされていない引数:

Float32/64 値 NaN および Inf の文字列表現。
バイナリおよび16進数値の文字列表現（例: SELECT toDecimal128OrNull('0xc0fe', 1);）。

注記

返される値

成功した場合は Nullable(Decimal(38, S)) 型の値。失敗した場合は同じ型の NULL 値。 Decimal128(S)。

例

クエリ:

SELECT
    toDecimal128OrNull(toString(1/42), 38) AS a,
    toTypeName(a),
    toDecimal128OrNull(toString('Inf'), 38) AS b,
    toTypeName(b)
FORMAT Vertical;

結果:

Row 1:
──────
a:             0.023809523809523808
toTypeName(a): Nullable(Decimal(38, 38))
b:             ᴺᵁᴸᴸ
toTypeName(b): Nullable(Decimal(38, 38))

参照

toDecimal128。
toDecimal128OrZero。
toDecimal128OrDefault。

toDecimal128OrDefault

toDecimal128 と同様に、この関数は入力値を Decimal(38, S) 型の値に変換しますが、エラーの場合はデフォルト値を返します。

構文

toDecimal128OrDefault(expr, S[, default])

引数

expr — 数字の文字列表現。 String。
S — 数字の小数部分が持つことのできる桁数を指定するスケールパラメータ（0から38の間）。 UInt8。
default (オプション) — Decimal128(S) 型への解析が失敗した場合に返すデフォルト値。 Decimal128(S)。

サポートされている引数:

(U)Int8/16/32/64/128/256 型の文字列表現。
Float32/64 型の文字列表現。

サポートされていない引数:

Float32/64 値 NaN および Inf の文字列表現。
バイナリおよび16進数値の文字列表現（例: SELECT toDecimal128OrDefault('0xc0fe', 1);）。

注記

注意

変換は、余分な桁をドロップし、Float32/Float64 入力を扱っているときに予想外の方法で動作する可能性があります。なぜなら、演算は浮動小数点命令を使用して行われるからです。例えば: toDecimal128OrDefault(1.15, 2) は 1.14 と等しいです。なぜなら 1.15 * 100 の浮動小数点の結果は 114.99 だからです。文字列入力を使用すると、演算は基になる整数型を使用します: toDecimal128OrDefault('1.15', 2) = 1.15

返される値

成功した場合は Decimal(38, S) 型の値。失敗した場合は指定されたデフォルト値または 0 を返します。 Decimal128(S)。

例

クエリ:

SELECT
    toDecimal128OrDefault(toString(1/42), 18) AS a,
    toTypeName(a),
    toDecimal128OrDefault('Inf', 0, CAST('-1', 'Decimal128(0)')) AS b,
    toTypeName(b)
FORMAT Vertical;

結果:

Row 1:
──────
a:             0.023809523809523808
toTypeName(a): Decimal(38, 18)
b:             -1
toTypeName(b): Decimal(38, 0)

参照

toDecimal128。
toDecimal128OrZero。
toDecimal128OrNull。

toDecimal256

入力値を Decimal(76, S) 型の値に変換します。エラーが発生した場合は例外をスローします。

構文

toDecimal256(expr, S)

引数

expr — 数字を返す表現または数字の文字列表現。 Expression。
S — 数字の小数部分が持つことのできる桁数を指定するスケールパラメータ（0から76の間）。 UInt8。

サポートされている引数:

(U)Int8/16/32/64/128/256 型の値または文字列。
Float32/64 型の値または文字列。

サポートされていない引数:

Float32/64 値 NaN および Inf の文字列表現（大文字小文字を区別しない）。
バイナリおよび16進数値の文字列表現（例: SELECT toDecimal256('0xc0fe', 1);）。

注記

expr の値が Decimal256 の境界を超えるとオーバーフローが発生する可能性があります: ( -1 * 10^(76 - S), 1 * 10^(76 - S) )。小数部分で過剰な桁は廃棄されます（丸められません）。整数部分の過剰な桁は例外を引き起こします。

注意

変換は、余分な桁をドロップし、Float32/Float64 入力を扱っているときに予想外の方法で動作する可能性があります。なぜなら、演算は浮動小数点命令を使用して行われるからです。例えば: toDecimal256(1.15, 2) は 1.14 と等しいです。なぜなら 1.15 * 100 の浮動小数点の結果は 114.99 だからです。文字列入力を使用すると、演算は基になる整数型を使用します: toDecimal256('1.15', 2) = 1.15

返される値

Decimal(76, S) 型の値。 Decimal256(S)。

例

クエリ:

SELECT
    toDecimal256(99, 1) AS a, toTypeName(a) AS type_a,
    toDecimal256(99.67, 2) AS b, toTypeName(b) AS type_b,
    toDecimal256('99.67', 3) AS c, toTypeName(c) AS type_c
FORMAT Vertical;

結果:

Row 1:
──────
a:      99
type_a: Decimal(76, 1)
b:      99.67
type_b: Decimal(76, 2)
c:      99.67
type_c: Decimal(76, 3)

参照

toDecimal256OrZero。
toDecimal256OrNull。
toDecimal256OrDefault。

toDecimal256OrZero

toDecimal256 と同様に、この関数は入力値を Decimal(76, S) 型の値に変換しますが、エラーの場合は 0 を返します。

構文

toDecimal256OrZero(expr, S)

引数

expr — 数字の文字列表現。 String。
S — 数字の小数部分が持つことのできる桁数を指定するスケールパラメータ（0から76の間）。 UInt8。

サポートされている引数:

(U)Int8/16/32/64/128/256 型の文字列表現。
Float32/64 型の文字列表現。

サポートされていない引数:

Float32/64 値 NaN および Inf の文字列表現。
バイナリおよび16進数値の文字列表現（例: SELECT toDecimal256OrZero('0xc0fe', 1);）。

注記

expr の値が Decimal256 の境界を超えるとオーバーフローが発生する可能性があります: ( -1 * 10^(76 - S), 1 * 10^(76 - S) )。小数部分で過剰な桁は廃棄されます（丸められません）。整数部分の過剰な桁はエラーを引き起こします。

返される値

成功した場合は Decimal(76, S) 型の値。失敗した場合は 0 （S 桁の小数付き）。 Decimal256(S)。

例

クエリ:

SELECT
    toDecimal256OrZero(toString(0.0001), 76) AS a,
    toTypeName(a),
    toDecimal256OrZero(toString('Inf'), 76) AS b,
    toTypeName(b)
FORMAT Vertical;

結果:

Row 1:
──────
a:             0.0001
toTypeName(a): Decimal(76, 76)
b:             0
toTypeName(b): Decimal(76, 76)

参照

toDecimal256。
toDecimal256OrNull。
toDecimal256OrDefault。

toDecimal256OrNull

toDecimal256 と同様に、この関数は入力値を Nullable(Decimal(76, S)) 型の値に変換しますが、エラーの場合は 0 を返します。

構文

toDecimal256OrNull(expr, S)

引数

expr — 数字の文字列表現。 String。
S — 数字の小数部分が持つことのできる桁数を指定するスケールパラメータ（0から76の間）。 UInt8。

サポートされている引数:

(U)Int8/16/32/64/128/256 型の文字列表現。
Float32/64 型の文字列表現。

サポートされていない引数:

Float32/64 値 NaN および Inf の文字列表現。
バイナリおよび16進数値の文字列表現（例: SELECT toDecimal256OrNull('0xc0fe', 1);）。

注記

返される値

成功した場合は Nullable(Decimal(76, S)) 型の値。失敗した場合は同じ型の NULL 値。 Decimal256(S)。

例

クエリ:

SELECT
    toDecimal256OrNull(toString(1/42), 76) AS a,
    toTypeName(a),
    toDecimal256OrNull(toString('Inf'), 76) AS b,
    toTypeName(b)
FORMAT Vertical;

結果:

Row 1:
──────
a:             0.023809523809523808
toTypeName(a): Nullable(Decimal(76, 76))
b:             ᴺᵁᴸᴸ
toTypeName(b): Nullable(Decimal(76, 76))

参照

toDecimal256。
toDecimal256OrZero。
toDecimal256OrDefault。

toDecimal256OrDefault

toDecimal256と同様に、この関数は入力値をDecimal(76, S)型の値に変換しますが、エラーが発生した場合にはデフォルト値を返します。

構文

toDecimal256OrDefault(expr, S[, default])

引数

expr — 数字の文字列表現。 String。
S — 小数部の桁数を指定する0から76の間のスケールパラメータ。 UInt8。
default（任意） — Decimal256(S)型への解析が失敗した場合に返されるデフォルト値。 Decimal256(S)。

サポートされている引数：

(U)Int8/16/32/64/128/256型の文字列表現。
Float32/64型の文字列表現。

サポートされていない引数：

Float32/64のNaNおよびInfの文字列表現。
バイナリおよび16進数の値の文字列表現、例: SELECT toDecimal256OrDefault('0xc0fe', 1);。

注記

exprの値がDecimal256の範囲を超えるとオーバーフローが発生する可能性があります：( -1 * 10^(76 - S), 1 * 10^(76 - S) )。小数部における過剰な桁は破棄されます（四捨五入されません）。整数部での過剰な桁はエラーを引き起こします。

注意

変換は余分な桁を落とし、Float32/Float64の入力を扱う際に期待通りに動作しない可能性があります。操作は浮動小数点命令を使用して行われるためです。例えば：toDecimal256OrDefault(1.15, 2)は1.14に等しいです。これは、浮動小数点での1.15 * 100が114.99だからです。 String型の入力を使用することで、操作が基盤の整数型を使うようにできます：toDecimal256OrDefault('1.15', 2) = 1.15

返される値

成功した場合はDecimal(76, S)型の値を返し、そうでない場合は渡されたデフォルト値を返すか、渡されなければ0を返します。 Decimal256(S)。

例

クエリ：

SELECT
    toDecimal256OrDefault(toString(1/42), 76) AS a,
    toTypeName(a),
    toDecimal256OrDefault('Inf', 0, CAST('-1', 'Decimal256(0)')) AS b,
    toTypeName(b)
FORMAT Vertical;

結果：

Row 1:
──────
a:             0.023809523809523808
toTypeName(a): Decimal(76, 76)
b:             -1
toTypeName(b): Decimal(76, 0)

関連項目

toDecimal256。
toDecimal256OrZero。
toDecimal256OrNull。

toString

値を文字列表現に変換します。 DateTime引数の場合、関数はタイムゾーンの名前を含む2番目のString引数を取ることができます。

構文

toString(value[, timezone])

引数

value: 文字列に変換する値。 Any。
timezone: 任意。 DateTime変換のためのタイムゾーン名。 String。

返される値

入力値の文字列表現を返します。 String。

例

使用例

SELECT
    now() AS ts,
    time_zone,
    toString(ts, time_zone) AS str_tz_datetime
FROM system.time_zones
WHERE time_zone LIKE 'Europe%'
LIMIT 10;

┌──────────────────ts─┬─time_zone─────────┬─str_tz_datetime─────┐
│ 2023-09-08 19:14:59 │ Europe/Amsterdam  │ 2023-09-08 21:14:59 │
│ 2023-09-08 19:14:59 │ Europe/Andorra    │ 2023-09-08 21:14:59 │
│ 2023-09-08 19:14:59 │ Europe/Astrakhan  │ 2023-09-08 23:14:59 │
│ 2023-09-08 19:14:59 │ Europe/Athens     │ 2023-09-08 22:14:59 │
│ 2023-09-08 19:14:59 │ Europe/Belfast    │ 2023-09-08 20:14:59 │
└─────────────────────┴───────────────────┴─────────────────────┘

toFixedString

String型の引数をFixedString(N)型に変換します（固定長Nの文字列）。文字列がNよりも少ないバイト数の場合、右側にNULLバイトでパディングされます。文字列がNよりも多いバイト数の場合、例外がスローされます。

構文

toFixedString(s, N)

引数

s — 固定文字列に変換する文字列。 String。
N — 長さN。 UInt8

返される値

sのN長さの固定文字列。 FixedString。

例

クエリ：

SELECT toFixedString('foo', 8) AS s;

結果：

┌─s─────────────┐
│ foo\0\0\0\0\0 │
└───────────────┘

toStringCutToZero

StringまたはFixedString引数を受け入れます。最初に見つかったゼロバイトで内容が切り詰められたStringを返します。

構文

toStringCutToZero(s)

例

クエリ：

SELECT toFixedString('foo', 8) AS s, toStringCutToZero(s) AS s_cut;

結果：

┌─s─────────────┬─s_cut─┐
│ foo\0\0\0\0\0 │ foo   │
└───────────────┴───────┘

クエリ：

SELECT toFixedString('foo\0bar', 8) AS s, toStringCutToZero(s) AS s_cut;

結果：

┌─s──────────┬─s_cut─┐
│ foo\0bar\0 │ foo   │
└────────────┴───────┘

toDecimalString

数値を文字列に変換し、小数点以下の桁数をユーザーが指定します。

構文

toDecimalString(number, scale)

引数

number — 文字列として表現される値、Int, UInt、Float、Decimal、
scale — 小数桁の数、UInt8。
- DecimalおよびInt, UInt型の最大スケールは77です（これはDecimalにおける有効桁数の最大値です）。
- Floatの最大スケールは60です。

返される値

指定された小数桁数（スケール）で表された文字列としての入力値。要求されたスケールが元の数のスケールよりも小さい場合、数は通常の算術に従って四捨五入されます。

例

クエリ：

SELECT toDecimalString(CAST('64.32', 'Float64'), 5);

結果：

┌toDecimalString(CAST('64.32', 'Float64'), 5)─┐
│ 64.32000                                    │
└─────────────────────────────────────────────┘

reinterpretAsUInt8

入力値をUInt8型の値として扱うことでバイトの再解釈を行います。CASTとは異なり、関数は元の値を保持しようとはしません。ターゲット型が入力型を表現できない場合、出力は無意味です。

構文

reinterpretAsUInt8(x)

引数

x: UInt8としてバイトの再解釈を行う値。 (U)Int*、Float、Date、DateTime、UUID、StringまたはFixedString。

返される値

UInt8として再解釈された値x。 UInt8。

例

クエリ：

SELECT
    toInt8(257) AS x,
    toTypeName(x),
    reinterpretAsUInt8(x) AS res,
    toTypeName(res);

結果：

┌─x─┬─toTypeName(x)─┬─res─┬─toTypeName(res)─┐
│ 1 │ Int8          │   1 │ UInt8           │
└───┴───────────────┴─────┴─────────────────┘

reinterpretAsUInt16

入力値をUInt16型の値として扱うことでバイトの再解釈を行います。CASTとは異なり、関数は元の値を保持しようとはしません。ターゲット型が入力型を表現できない場合、出力は無意味です。

構文

reinterpretAsUInt16(x)

引数

x: UInt16としてバイトの再解釈を行う値。(U)Int*、Float、Date、DateTime、UUID、StringまたはFixedString。

返される値

UInt16として再解釈された値x。 UInt16。

例

クエリ：

SELECT
    toUInt8(257) AS x,
    toTypeName(x),
    reinterpretAsUInt16(x) AS res,
    toTypeName(res);

結果：

┌─x─┬─toTypeName(x)─┬─res─┬─toTypeName(res)─┐
│ 1 │ UInt8         │   1 │ UInt16          │
└───┴───────────────┴─────┴─────────────────┘

reinterpretAsUInt32

入力値をUInt32型の値として扱うことでバイトの再解釈を行います。CASTとは異なり、関数は元の値を保持しようとはしません。ターゲット型が入力型を表現できない場合、出力は無意味です。

構文

reinterpretAsUInt32(x)

引数

x: UInt32としてバイトの再解釈を行う値。 (U)Int*、Float、Date、DateTime、UUID、StringまたはFixedString。

返される値

UInt32として再解釈された値x。 UInt32。

例

クエリ：

SELECT
    toUInt16(257) AS x,
    toTypeName(x),
    reinterpretAsUInt32(x) AS res,
    toTypeName(res)

結果：

┌───x─┬─toTypeName(x)─┬─res─┬─toTypeName(res)─┐
│ 257 │ UInt16        │ 257 │ UInt32          │
└─────┴───────────────┴─────┴─────────────────┘

reinterpretAsUInt64

入力値をUInt64型の値として扱うことでバイトの再解釈を行います。CASTとは異なり、関数は元の値を保持しようとはしません。ターゲット型が入力型を表現できない場合、出力は無意味です。

構文

reinterpretAsUInt64(x)

引数

x: UInt64としてバイトの再解釈を行う値。 (U)Int*、Float、Date、DateTime、UUID、StringまたはFixedString。

返される値

UInt64として再解釈された値x。 UInt64。

例

クエリ：

SELECT
    toUInt32(257) AS x,
    toTypeName(x),
    reinterpretAsUInt64(x) AS res,
    toTypeName(res)

結果：

┌───x─┬─toTypeName(x)─┬─res─┬─toTypeName(res)─┐
│ 257 │ UInt32        │ 257 │ UInt64          │
└─────┴───────────────┴─────┴─────────────────┘

reinterpretAsUInt128

入力値をUInt128型の値として扱うことでバイトの再解釈を行います。CASTとは異なり、関数は元の値を保持しようとはしません。ターゲット型が入力型を表現できない場合、出力は無意味です。

構文

reinterpretAsUInt128(x)

引数

x: UInt128としてバイトの再解釈を行う値。(U)Int*、Float、Date、DateTime、UUID、StringまたはFixedString。

返される値

UInt128として再解釈された値x。 UInt128。

例

クエリ：

SELECT
    toUInt64(257) AS x,
    toTypeName(x),
    reinterpretAsUInt128(x) AS res,
    toTypeName(res)

結果：

┌───x─┬─toTypeName(x)─┬─res─┬─toTypeName(res)─┐
│ 257 │ UInt64        │ 257 │ UInt128         │
└─────┴───────────────┴─────┴─────────────────┘

reinterpretAsUInt256

入力値をUInt256型の値として扱うことでバイトの再解釈を行います。CASTとは異なり、関数は元の値を保持しようとはしません。ターゲット型が入力型を表現できない場合、出力は無意味です。

構文

reinterpretAsUInt256(x)

引数

x: UInt256としてバイトの再解釈を行う値。(U)Int*、Float、Date、DateTime、UUID、StringまたはFixedString。

返される値

UInt256として再解釈された値x。 UInt256。

例

クエリ：

SELECT
    toUInt128(257) AS x,
    toTypeName(x),
    reinterpretAsUInt256(x) AS res,
    toTypeName(res)

結果：

┌───x─┬─toTypeName(x)─┬─res─┬─toTypeName(res)─┐
│ 257 │ UInt128       │ 257 │ UInt256         │
└─────┴───────────────┴─────┴─────────────────┘

reinterpretAsInt8

入力値をInt8型の値として扱うことでバイトの再解釈を行います。CASTとは異なり、関数は元の値を保持しようとはしません。ターゲット型が入力型を表現できない場合、出力は無意味です。

構文

reinterpretAsInt8(x)

引数

x: Int8としてバイトの再解釈を行う値。(U)Int*、Float、Date、DateTime、UUID、StringまたはFixedString。

返される値

Int8として再解釈された値x。 Int8。

例

クエリ：

SELECT
    toUInt8(257) AS x,
    toTypeName(x),
    reinterpretAsInt8(x) AS res,
    toTypeName(res);

結果：

┌─x─┬─toTypeName(x)─┬─res─┬─toTypeName(res)─┐
│ 1 │ UInt8         │   1 │ Int8            │
└───┴───────────────┴─────┴─────────────────┘

reinterpretAsInt16

入力値をInt16型の値として扱うことでバイトの再解釈を行います。CASTとは異なり、関数は元の値を保持しようとはしません。ターゲット型が入力型を表現できない場合、出力は無意味です。

構文

reinterpretAsInt16(x)

引数

x: Int16としてバイトの再解釈を行う値。(U)Int*、Float、Date、DateTime、UUID、StringまたはFixedString。

返される値

Int16として再解釈された値x。 Int16。

例

クエリ：

SELECT
    toInt8(257) AS x,
    toTypeName(x),
    reinterpretAsInt16(x) AS res,
    toTypeName(res);

結果：

┌─x─┬─toTypeName(x)─┬─res─┬─toTypeName(res)─┐
│ 1 │ Int8          │   1 │ Int16           │
└───┴───────────────┴─────┴─────────────────┘

reinterpretAsInt32

入力値をInt32型の値として扱うことでバイトの再解釈を行います。CASTとは異なり、関数は元の値を保持しようとはしません。ターゲット型が入力型を表現できない場合、出力は無意味です。

構文

reinterpretAsInt32(x)

引数

x: Int32としてバイトの再解釈を行う値。(U)Int*、Float、Date、DateTime、UUID、StringまたはFixedString。

返される値

Int32として再解釈された値x。 Int32。

例

クエリ：

SELECT
    toInt16(257) AS x,
    toTypeName(x),
    reinterpretAsInt32(x) AS res,
    toTypeName(res);

結果：

┌───x─┬─toTypeName(x)─┬─res─┬─toTypeName(res)─┐
│ 257 │ Int16         │ 257 │ Int32           │
└─────┴───────────────┴─────┴─────────────────┘

reinterpretAsInt64

入力値をInt64型の値として扱うことでバイトの再解釈を行います。CASTとは異なり、関数は元の値を保持しようとはしません。ターゲット型が入力型を表現できない場合、出力は無意味です。

構文

reinterpretAsInt64(x)

引数

x: Int64としてバイトの再解釈を行う値。(U)Int*、Float、Date、DateTime、UUID、StringまたはFixedString。

返される値

Int64として再解釈された値x。 Int64。

例

クエリ：

SELECT
    toInt32(257) AS x,
    toTypeName(x),
    reinterpretAsInt64(x) AS res,
    toTypeName(res);

結果：

┌───x─┬─toTypeName(x)─┬─res─┬─toTypeName(res)─┐
│ 257 │ Int32         │ 257 │ Int64           │
└─────┴───────────────┴─────┴─────────────────┘

reinterpretAsInt128

入力値をInt128型の値として扱うことでバイトの再解釈を行います。CASTとは異なり、関数は元の値を保持しようとはしません。ターゲット型が入力型を表現できない場合、出力は無意味です。

構文

reinterpretAsInt128(x)

引数

x: Int128としてバイトの再解釈を行う値。(U)Int*、Float、Date、DateTime、UUID、StringまたはFixedString。

返される値

Int128として再解釈された値x。 Int128。

例

クエリ：

SELECT
    toInt64(257) AS x,
    toTypeName(x),
    reinterpretAsInt128(x) AS res,
    toTypeName(res);

結果：

┌───x─┬─toTypeName(x)─┬─res─┬─toTypeName(res)─┐
│ 257 │ Int64         │ 257 │ Int128          │
└─────┴───────────────┴─────┴─────────────────┘

reinterpretAsInt256

入力値をInt256型の値として扱うことでバイトの再解釈を行います。CASTとは異なり、関数は元の値を保持しようとはしません。ターゲット型が入力型を表現できない場合、出力は無意味です。

構文

reinterpretAsInt256(x)

引数

x: Int256としてバイトの再解釈を行う値。(U)Int*、Float、Date、DateTime、UUID、StringまたはFixedString。

返される値

Int256として再解釈された値x。 Int256。

例

クエリ：

SELECT
    toInt128(257) AS x,
    toTypeName(x),
    reinterpretAsInt256(x) AS res,
    toTypeName(res);

結果：

┌───x─┬─toTypeName(x)─┬─res─┬─toTypeName(res)─┐
│ 257 │ Int128        │ 257 │ Int256          │
└─────┴───────────────┴─────┴─────────────────┘

reinterpretAsFloat32

入力値をFloat32型の値として扱うことでバイトの再解釈を行います。CASTとは異なり、関数は元の値を保持しようとはしません。ターゲット型が入力型を表現できない場合、出力は無意味です。

構文

reinterpretAsFloat32(x)

引数

x: Float32として再解釈を行う値。(U)Int*、Float、Date、DateTime、UUID、StringまたはFixedString。

返される値

Float32として再解釈された値x。 Float32。

例

クエリ：

SELECT reinterpretAsUInt32(toFloat32(0.2)) AS x, reinterpretAsFloat32(x);

結果：

┌──────────x─┬─reinterpretAsFloat32(x)─┐
│ 1045220557 │                     0.2 │
└────────────┴─────────────────────────┘

reinterpretAsFloat64

入力値をFloat64型の値として扱うことでバイトの再解釈を行います。CASTとは異なり、関数は元の値を保持しようとはしません。ターゲット型が入力型を表現できない場合、出力は無意味です。

構文

reinterpretAsFloat64(x)

引数

x: Float64として再解釈を行う値。(U)Int*、Float、Date、DateTime、UUID、StringまたはFixedString。

返される値

Float64として再解釈された値x。 Float64。

例

クエリ：

SELECT reinterpretAsUInt64(toFloat64(0.2)) AS x, reinterpretAsFloat64(x);

結果：

┌───────────────────x─┬─reinterpretAsFloat64(x)─┐
│ 4596373779694328218 │                     0.2 │
└─────────────────────┴─────────────────────────┘

reinterpretAsDate

文字列、固定文字列、または数値を受け取り、ホストオーダー（リトルエンディアン）での数としてバイトを解釈します。Unixエポックの開始からの日数として解釈された数から日付を返します。

構文

reinterpretAsDate(x)

引数

x: Unixエポックの開始からの日数。(U)Int*、Float、Date、DateTime、UUID、StringまたはFixedString。

返される値

日付。 Date。

実装の詳細

注記

提供された文字列が十分に長くない場合、関数は文字列が必要な数のNULLバイトでパディングされているかのように動作します。文字列が必要以上に長い場合、余分なバイトは無視されます。

例

クエリ：

SELECT reinterpretAsDate(65), reinterpretAsDate('A');

結果：

┌─reinterpretAsDate(65)─┬─reinterpretAsDate('A')─┐
│            1970-03-07 │             1970-03-07 │
└───────────────────────┴────────────────────────┘

reinterpretAsDateTime

これらの関数は文字列を受け取り、文字列の先頭に置かれたバイトをホストオーダー（リトルエンディアン）の数として解釈します。Unixエポックの開始からの秒数として解釈された時間を持つ日付を返します。

構文

reinterpretAsDateTime(x)

引数

x: Unixエポックの開始からの秒数。(U)Int*、Float、Date、DateTime、UUID、StringまたはFixedString。

返される値

日付と時間。 DateTime。

実装の詳細

注記

例

クエリ：

SELECT reinterpretAsDateTime(65), reinterpretAsDateTime('A');

結果：

┌─reinterpretAsDateTime(65)─┬─reinterpretAsDateTime('A')─┐
│       1970-01-01 01:01:05 │        1970-01-01 01:01:05 │
└───────────────────────────┴────────────────────────────┘

reinterpretAsString

この関数は数値、日付、または日付と時間を受け取り、ホストオーダー（リトルエンディアン）の対応する値を表すバイトを含む文字列を返します。末尾からNULLバイトが削除されます。例えば、UInt32型の値255は1バイトの長さの文字列です。

構文

reinterpretAsString(x)

引数

x: 文字列に再解釈する値。(U)Int*、Float、Date、DateTime。

返される値

xを表すバイトを含む文字列。 String。

例

クエリ：

SELECT
    reinterpretAsString(toDateTime('1970-01-01 01:01:05')),
    reinterpretAsString(toDate('1970-03-07'));

結果：

┌─reinterpretAsString(toDateTime('1970-01-01 01:01:05'))─┬─reinterpretAsString(toDate('1970-03-07'))─┐
│ A                                                      │ A                                         │
└────────────────────────────────────────────────────────┴───────────────────────────────────────────┘

reinterpretAsFixedString

この関数は数値、日付、または日付と時間を受け取り、ホストオーダー（リトルエンディアン）の対応する値を表すバイトを含むFixedStringを返します。末尾からNULLバイトが削除されます。例えば、UInt32型の値255は1バイトの長さのFixedStringです。

構文

reinterpretAsFixedString(x)

引数

x: 文字列に再解釈する値。(U)Int*、Float、Date、DateTime。

返される値

xを表すバイトを含む固定文字列。 FixedString。

例

クエリ：

SELECT
    reinterpretAsFixedString(toDateTime('1970-01-01 01:01:05')),
    reinterpretAsFixedString(toDate('1970-03-07'));

結果：

┌─reinterpretAsFixedString(toDateTime('1970-01-01 01:01:05'))─┬─reinterpretAsFixedString(toDate('1970-03-07'))─┐
│ A                                                           │ A                                              │
└─────────────────────────────────────────────────────────────┴────────────────────────────────────────────────┘

reinterpretAsUUID

注記

ここにリストされたUUID関数に加えて、専用のUUID関数ドキュメントがあります。

16バイトの文字列を受け取り、各8バイトの半分をリトルエンディアンのバイト順で解釈してUUIDを返します。文字列が十分に長くない場合、関数は文字列が必要な数のNULLバイトでパディングされているかのように動作します。文字列が16バイトよりも長い場合、末尾の余分なバイトは無視されます。

構文

reinterpretAsUUID(fixed_string)

引数

fixed_string — ビッグエンディアンのバイト文字列。 FixedString。

返される値

UUID型の値。 UUID。

例

文字列からUUIDへ。

クエリ：

SELECT reinterpretAsUUID(reverse(unhex('000102030405060708090a0b0c0d0e0f')));

結果：

┌─reinterpretAsUUID(reverse(unhex('000102030405060708090a0b0c0d0e0f')))─┐
│                                  08090a0b-0c0d-0e0f-0001-020304050607 │
└───────────────────────────────────────────────────────────────────────┘

文字列からUUID、またその逆。

クエリ：

WITH
    generateUUIDv4() AS uuid,
    identity(lower(hex(reverse(reinterpretAsString(uuid))))) AS str,
    reinterpretAsUUID(reverse(unhex(str))) AS uuid2
SELECT uuid = uuid2;

結果：

┌─equals(uuid, uuid2)─┐
│                   1 │
└─────────────────────┘

reinterpret

同じソースのメモリ内バイト列をxの値として使用し、ターゲット型に再解釈します。

構文

reinterpret(x, type)

引数

x — 任意の型。
type — ターゲット型。配列である場合、配列要素の型は固定長型でなければなりません。

返される値

ターゲット型の値。

例

クエリ：

SELECT reinterpret(toInt8(-1), 'UInt8') AS int_to_uint,
    reinterpret(toInt8(1), 'Float32') AS int_to_float,
    reinterpret('1', 'UInt32') AS string_to_int;

結果：

┌─int_to_uint─┬─int_to_float─┬─string_to_int─┐
│         255 │        1e-45 │            49 │
└─────────────┴──────────────┴───────────────┘

クエリ：

SELECT reinterpret(x'3108b4403108d4403108b4403108d440', 'Array(Float32)') AS string_to_array_of_Float32;

結果：

┌─string_to_array_of_Float32─┐
│ [5.626,6.626,5.626,6.626]  │
└────────────────────────────┘

CAST

入力値を指定されたデータ型に変換します。reinterpret関数とは異なり、CASTは新しいデータ型を使用して同じ値を表示しようとします。変換が不可能な場合は、例外が発生します。いくつかの構文のバリエーションがサポートされています。

構文

CAST(x, T)
CAST(x AS t)
x::t

引数

x — 変換する値。任意の型であることができます。
T — ターゲットデータ型の名前。 String。
t — ターゲットデータ型。

返される値

変換された値。

注記

入力値がターゲット型の範囲に収まらない場合、結果がオーバーフローします。例えば、CAST(-1, 'UInt8')は255を返します。

例

クエリ：

SELECT
    CAST(toInt8(-1), 'UInt8') AS cast_int_to_uint,
    CAST(1.5 AS Decimal(3,2)) AS cast_float_to_decimal,
    '1'::Int32 AS cast_string_to_int;

結果：

┌─cast_int_to_uint─┬─cast_float_to_decimal─┬─cast_string_to_int─┐
│              255 │                  1.50 │                  1 │
└──────────────────┴───────────────────────┴────────────────────┘

クエリ：

SELECT
    '2016-06-15 23:00:00' AS timestamp,
    CAST(timestamp AS DateTime) AS datetime,
    CAST(timestamp AS Date) AS date,
    CAST(timestamp, 'String') AS string,
    CAST(timestamp, 'FixedString(22)') AS fixed_string;

結果：

┌─timestamp───────────┬────────────datetime─┬───────date─┬─string──────────────┬─fixed_string──────────────┐
│ 2016-06-15 23:00:00 │ 2016-06-15 23:00:00 │ 2016-06-15 │ 2016-06-15 23:00:00 │ 2016-06-15 23:00:00\0\0\0 │
└─────────────────────┴─────────────────────┴────────────┴─────────────────────┴───────────────────────────┘

FixedString (N)への変換はStringまたはFixedString型の引数に対してのみ機能します。

Nullableへの型変換とその逆がサポートされています。

例

クエリ：

SELECT toTypeName(x) FROM t_null;

結果：

┌─toTypeName(x)─┐
│ Int8          │
│ Int8          │
└───────────────┘

クエリ：

SELECT toTypeName(CAST(x, 'Nullable(UInt16)')) FROM t_null;

結果：

┌─toTypeName(CAST(x, 'Nullable(UInt16)'))─┐
│ Nullable(UInt16)                        │
│ Nullable(UInt16)                        │
└─────────────────────────────────────────┘

関連項目

cast_keep_nullable設定

accurateCast(x, T)

xをTデータ型に変換します。

castとの違いは、accurateCastは、型値xが型Tの範囲に収まらない場合、数値型のオーバーフローを許可しないことです。例えば、accurateCast(-1, 'UInt8')は例外をスローします。

例

クエリ：

SELECT cast(-1, 'UInt8') AS uint8;

結果：

┌─uint8─┐
│   255 │
└───────┘

クエリ：

SELECT accurateCast(-1, 'UInt8') AS uint8;

結果：

Code: 70. DB::Exception: Received from localhost:9000. DB::Exception: Value in column Int8 cannot be safely converted into type UInt8: While processing accurateCast(-1, 'UInt8') AS uint8.

accurateCastOrNull(x, T)

入力値xを指定されたデータ型Tに変換します。常にNullable型を返し、キャスト値がターゲット型では表示できない場合はNULLを返します。

構文

accurateCastOrNull(x, T)

引数

x — 入力値。
T — 返されるデータ型の名前。

返される値

指定されたデータ型Tに変換された値。

例

クエリ：

SELECT toTypeName(accurateCastOrNull(5, 'UInt8'));

結果：

┌─toTypeName(accurateCastOrNull(5, 'UInt8'))─┐
│ Nullable(UInt8)                            │
└────────────────────────────────────────────┘

クエリ：

SELECT
    accurateCastOrNull(-1, 'UInt8') AS uint8,
    accurateCastOrNull(128, 'Int8') AS int8,
    accurateCastOrNull('Test', 'FixedString(2)') AS fixed_string;

結果：

┌─uint8─┬─int8─┬─fixed_string─┐
│  ᴺᵁᴸᴸ │ ᴺᵁᴸᴸ │ ᴺᵁᴸᴸ         │
└───────┴──────┴──────────────┘

accurateCastOrDefault(x, T[, default_value])

入力値xを指定されたデータ型Tに変換します。キャスト値がターゲット型で表示できない場合は、デフォルト型値または指定されたdefault_valueを返します。

構文

accurateCastOrDefault(x, T)

引数

x — 入力値。
T — 返されるデータ型の名前。
default_value — 返されるデータ型のデフォルト値。

返される値

指定されたデータ型Tに変換された値。

例

クエリ：

SELECT toTypeName(accurateCastOrDefault(5, 'UInt8'));

結果：

┌─toTypeName(accurateCastOrDefault(5, 'UInt8'))─┐
│ UInt8                                         │
└───────────────────────────────────────────────┘

クエリ：

SELECT
    accurateCastOrDefault(-1, 'UInt8') AS uint8,
    accurateCastOrDefault(-1, 'UInt8', 5) AS uint8_default,
    accurateCastOrDefault(128, 'Int8') AS int8,
    accurateCastOrDefault(128, 'Int8', 5) AS int8_default,
    accurateCastOrDefault('Test', 'FixedString(2)') AS fixed_string,
    accurateCastOrDefault('Test', 'FixedString(2)', 'Te') AS fixed_string_default;

結果：

┌─uint8─┬─uint8_default─┬─int8─┬─int8_default─┬─fixed_string─┬─fixed_string_default─┐
│     0 │             5 │    0 │            5 │              │ Te                   │
└───────┴───────────────┴──────┴──────────────┴──────────────┴──────────────────────┘

toInterval

数値と間隔単位（例：'second'や'day'）からIntervalデータ型の値を作成します。

構文

toInterval(value, unit)

引数

value — インターバルの長さ。整数またはそれに対応する文字列表現、浮動小数点数。(U)Int*/Float*/String。
unit — 作成するインターバルの種類。 String Literal。可能な値:
- nanosecond
- microsecond
- millisecond
- second
- minute
- hour
- day
- week
- month
- quarter
- year
unit引数は大文字小文字を区別しません。

返される値

結果のインターバル。 Interval

例

SELECT toDateTime('2025-01-01 00:00:00') + toInterval(1, 'hour')

┌─toDateTime('2025-01-01 00:00:00') + toInterval(1, 'hour') ─┐
│                                        2025-01-01 01:00:00 │
└────────────────────────────────────────────────────────────┘

toIntervalYear

データ型IntervalYearのn年のインターバルを返します。

構文

toIntervalYear(n)

引数

n — 年数。整数またはそれに対応する文字列表現、浮動小数点数。(U)Int*/Float*/String。

返される値

n年のインターバル。 IntervalYear。

例

クエリ：

WITH
    toDate('2024-06-15') AS date,
    toIntervalYear(1) AS interval_to_year
SELECT date + interval_to_year AS result

結果：

┌─────result─┐
│ 2025-06-15 │
└────────────┘

toIntervalQuarter

データ型IntervalQuarterのn四半期のインターバルを返します。

構文

toIntervalQuarter(n)

引数

n — 四半期の数。整数またはそれに対応する文字列表現、浮動小数点数。(U)Int*/Float*/String。

返される値

n四半期のインターバル。 IntervalQuarter。

例

クエリ：

WITH
    toDate('2024-06-15') AS date,
    toIntervalQuarter(1) AS interval_to_quarter
SELECT date + interval_to_quarter AS result

結果：

┌─────result─┐
│ 2024-09-15 │
└────────────┘

toIntervalMonth

データ型IntervalMonthのn月のインターバルを返します。

構文

toIntervalMonth(n)

引数

n — 月の数。整数またはそれに対応する文字列表現、浮動小数点数。(U)Int*/Float*/String。

返される値

n月のインターバル。 IntervalMonth。

例

クエリ：

WITH
    toDate('2024-06-15') AS date,
    toIntervalMonth(1) AS interval_to_month
SELECT date + interval_to_month AS result

結果：

┌─────result─┐
│ 2024-07-15 │
└────────────┘

toIntervalWeek

データ型IntervalWeekのn週間のインターバルを返します。

構文

toIntervalWeek(n)

引数

n — 週間の数。整数またはそれに対応する文字列表現、浮動小数点数。(U)Int*/Float*/String。

返される値

n週間のインターバル。 IntervalWeek。

例

クエリ：

WITH
    toDate('2024-06-15') AS date,
    toIntervalWeek(1) AS interval_to_week
SELECT date + interval_to_week AS result

結果：

┌─────result─┐
│ 2024-06-22 │
└────────────┘

toIntervalDay

データ型IntervalDayのn日のインターバルを返します。

構文

toIntervalDay(n)

引数

n — 日数。整数またはそれに対応する文字列表現、浮動小数点数。(U)Int*/Float*/String。

返される値

n日のインターバル。 IntervalDay。

例

クエリ：

WITH
    toDate('2024-06-15') AS date,
    toIntervalDay(5) AS interval_to_days
SELECT date + interval_to_days AS result

結果：

┌─────result─┐
│ 2024-06-20 │
└────────────┘

toIntervalHour

データ型IntervalHourのn時間のインターバルを返します。

構文

toIntervalHour(n)

引数

n — 時間数。整数またはそれに対応する文字列表現、浮動小数点数。(U)Int*/Float*/String。

返される値

n時間のインターバル。 IntervalHour。

例

クエリ：

WITH
    toDate('2024-06-15') AS date,
    toIntervalHour(12) AS interval_to_hours
SELECT date + interval_to_hours AS result

結果：

┌──────────────result─┐
│ 2024-06-15 12:00:00 │
└─────────────────────┘

toIntervalMinute

データ型IntervalMinuteのn分のインターバルを返します。

構文

toIntervalMinute(n)

引数

n — 分数。整数またはそれに対応する文字列表現、浮動小数点数。(U)Int*/Float*/String。

返される値

n分のインターバル。 IntervalMinute。

例

クエリ：

WITH
    toDate('2024-06-15') AS date,
    toIntervalMinute(12) AS interval_to_minutes
SELECT date + interval_to_minutes AS result

結果：

┌──────────────result─┐
│ 2024-06-15 00:12:00 │
└─────────────────────┘

toIntervalSecond

データ型IntervalSecondのn秒のインターバルを返します。

構文

toIntervalSecond(n)

引数

n — 秒数。整数またはそれに対応する文字列表現、浮動小数点数。(U)Int*/Float*/String。

返される値

n秒のインターバル。 IntervalSecond。

例

クエリ：

WITH
    toDate('2024-06-15') AS date,
    toIntervalSecond(30) AS interval_to_seconds
SELECT date + interval_to_seconds AS result

結果：

┌──────────────result─┐
│ 2024-06-15 00:00:30 │
└─────────────────────┘

toIntervalMillisecond

データ型IntervalMillisecondsのnミリ秒のインターバルを返します。

構文

toIntervalMillisecond(n)

引数

n — ミリ秒数。整数またはそれに対応する文字列表現、浮動小数点数。(U)Int*/Float*/String。

返される値

nミリ秒のインターバル。 IntervalMilliseconds。

例

クエリ：

WITH
    toDateTime('2024-06-15') AS date,
    toIntervalMillisecond(30) AS interval_to_milliseconds
SELECT date + interval_to_milliseconds AS result

結果：

┌──────────────────result─┐
│ 2024-06-15 00:00:00.030 │
└─────────────────────────┘

toIntervalMicrosecond

n マイクロ秒の間隔をデータ型 IntervalMicrosecond で返します。

構文

toIntervalMicrosecond(n)

引数

n — マイクロ秒の数。整数またはその文字列表現、および浮動小数点数。 (U)Int*/Float*/String。

返される値

n マイクロ秒の間隔。 IntervalMicrosecond。

例

クエリ:

WITH
    toDateTime('2024-06-15') AS date,
    toIntervalMicrosecond(30) AS interval_to_microseconds
SELECT date + interval_to_microseconds AS result

結果:

┌─────────────────────result─┐
│ 2024-06-15 00:00:00.000030 │
└────────────────────────────┘

toIntervalNanosecond

n ナノ秒の間隔をデータ型 IntervalNanosecond で返します。

構文

toIntervalNanosecond(n)

引数

n — ナノ秒の数。整数またはその文字列表現、および浮動小数点数。 (U)Int*/Float*/String。

返される値

n ナノ秒の間隔。 IntervalNanosecond。

例

クエリ:

WITH
    toDateTime('2024-06-15') AS date,
    toIntervalNanosecond(30) AS interval_to_nanoseconds
SELECT date + interval_to_nanoseconds AS result

結果:

┌────────────────────────result─┐
│ 2024-06-15 00:00:00.000000030 │
└───────────────────────────────┘

parseDateTime

String を DateTime に、MySQL のフォーマット文字列に従って変換します。

この関数は、関数 formatDateTime の逆操作です。

構文

parseDateTime(str[, format[, timezone]])

引数

str — 解析する文字列
format — フォーマット文字列。オプション。指定しない場合は %Y-%m-%d %H:%i:%s。
timezone — Timezone。オプション。

返される値

入力文字列から MySQL スタイルのフォーマット文字列に従って解析された DateTime 値を返します。

サポートされているフォーマット指定子

formatDateTime にリストされたすべてのフォーマット指定子。ただし、次のものは除きます:

%Q: 四半期 (1-4)

例

SELECT parseDateTime('2021-01-04+23:00:00', '%Y-%m-%d+%H:%i:%s')

┌─parseDateTime('2021-01-04+23:00:00', '%Y-%m-%d+%H:%i:%s')─┐
│                                       2021-01-04 23:00:00 │
└───────────────────────────────────────────────────────────┘

別名: TO_TIMESTAMP.

parseDateTimeOrZero

parseDateTime と同様ですが、処理できない日付フォーマットに遭遇したときにゼロの日付を返します。

parseDateTimeOrNull

parseDateTime と同様ですが、処理できない日付フォーマットに遭遇したときに NULL を返します。

別名: str_to_date.

parseDateTimeInJodaSyntax

parseDateTime に似ていますが、フォーマット文字列が MySQL 構文の代わりに Joda です。

この関数は、関数 formatDateTimeInJodaSyntax の逆操作です。

構文

parseDateTimeInJodaSyntax(str[, format[, timezone]])

引数

str — 解析する文字列
format — フォーマット文字列。オプション。指定しない場合は yyyy-MM-dd HH:mm:ss。
timezone — Timezone。オプション。

返される値

入力文字列から Joda スタイルのフォーマット文字列に従って解析された DateTime 値を返します。

サポートされているフォーマット指定子

formatDateTimeInJodaSyntax にリストされたすべてのフォーマット指定子がサポートされていますが、次のものは除きます:

S: 秒の小数部
z: タイムゾーン
Z: タイムゾーンオフセット/ID

例

SELECT parseDateTimeInJodaSyntax('2023-02-24 14:53:31', 'yyyy-MM-dd HH:mm:ss', 'Europe/Minsk')

┌─parseDateTimeInJodaSyntax('2023-02-24 14:53:31', 'yyyy-MM-dd HH:mm:ss', 'Europe/Minsk')─┐
│                                                                     2023-02-24 14:53:31 │
└─────────────────────────────────────────────────────────────────────────────────────────┘

parseDateTimeInJodaSyntaxOrZero

parseDateTimeInJodaSyntax と同様ですが、処理できない日付フォーマットに遭遇したときにゼロの日付を返します。

parseDateTimeInJodaSyntaxOrNull

parseDateTimeInJodaSyntax と同様ですが、処理できない日付フォーマットに遭遇したときに NULL を返します。

parseDateTime64

String を DateTime64 に、MySQL のフォーマット文字列に従って変換します。

構文

parseDateTime64(str[, format[, timezone]])

引数

str — 解析する文字列。
format — フォーマット文字列。オプション。指定しない場合は %Y-%m-%d %H:%i:%s.%f。
timezone — Timezone。オプション。

返される値

入力文字列から MySQL スタイルのフォーマット文字列に従って解析された DateTime64 値を返します。返される値の精度は 6 です。

parseDateTime64OrZero

parseDateTime64 と同様ですが、処理できない日付フォーマットに遭遇したときにゼロの日付を返します。

parseDateTime64OrNull

parseDateTime64 と同様ですが、処理できない日付フォーマットに遭遇したときに NULL を返します。

parseDateTime64InJodaSyntax

String を DateTime64 に、Joda フォーマット文字列に従って変換します。

構文

parseDateTime64InJodaSyntax(str[, format[, timezone]])

引数

str — 解析する文字列。
format — フォーマット文字列。オプション。指定しない場合は yyyy-MM-dd HH:mm:ss。
timezone — Timezone。オプション。

返される値

入力文字列から Joda スタイルのフォーマット文字列に従って解析された DateTime64 値を返します。返される値の精度はフォーマット文字列の S プレースホルダの数に等しい（ただし最大 6 まで）。

parseDateTime64InJodaSyntaxOrZero

parseDateTime64InJodaSyntax と同様ですが、処理できない日付フォーマットに遭遇したときにゼロの日付を返します。

parseDateTime64InJodaSyntaxOrNull

parseDateTime64InJodaSyntax と同様ですが、処理できない日付フォーマットに遭遇したときに NULL を返します。

parseDateTimeBestEffort

parseDateTime32BestEffort

String 表現の日時を DateTime データ型に変換します。

この関数は、ISO 8601、RFC 1123 - 5.2.14 RFC-822 日付と時刻の仕様、ClickHouse とその他のいくつかの日付と時刻のフォーマットを解析します。

構文

parseDateTimeBestEffort(time_string [, time_zone])

引数

time_string — 変換する日付と時刻を含む文字列。 String。
time_zone — タイムゾーン。この関数は、タイムゾーンに従って time_string を解析します。 String。

サポートされている非標準フォーマット

9..10 桁の unix タイムスタンプを含む文字列。
日付と時刻のコンポーネントを持つ文字列: YYYYMMDDhhmmss、DD/MM/YYYY hh:mm:ss、DD-MM-YY hh:mm、YYYY-MM-DD hh:mm:ss、など。
日付を含む文字列で、時刻のコンポーネントは含まれていない: YYYY、YYYYMM、YYYY*MM、DD/MM/YYYY、DD-MM-YY など。
日と時刻を含む文字列: DD、DD hh、DD hh:mm。この場合 MM は 01 に置き換えられます。
日付と時刻を含む文字列、およびタイムゾーンオフセット情報: YYYY-MM-DD hh:mm:ss ±h:mm、など。例えば、2020-12-12 17:36:00 -5:00。
syslog タイムスタンプ: Mmm dd hh:mm:ss。例えば、Jun 9 14:20:32。

セパレーターを含むすべてのフォーマットでは、この関数は月の名前をその完全な名前または最初の3文字で解析します。例: 24/DEC/18、24-Dec-18、01-September-2018。指定されていない場合は、年は現在の年として扱われます。もし結果の DateTime が将来の日付（現在の時点の1秒後でも）である場合、現在の年は前の年に置き換えられます。

返される値

time_string を DateTime データ型に変換します。

例

クエリ:

SELECT parseDateTimeBestEffort('23/10/2020 12:12:57')
AS parseDateTimeBestEffort;

結果:

┌─parseDateTimeBestEffort─┐
│     2020-10-23 12:12:57 │
└─────────────────────────┘

クエリ:

SELECT parseDateTimeBestEffort('Sat, 18 Aug 2018 07:22:16 GMT', 'Asia/Istanbul')
AS parseDateTimeBestEffort;

結果:

┌─parseDateTimeBestEffort─┐
│     2018-08-18 10:22:16 │
└─────────────────────────┘

クエリ:

SELECT parseDateTimeBestEffort('1284101485')
AS parseDateTimeBestEffort;

結果:

┌─parseDateTimeBestEffort─┐
│     2015-07-07 12:04:41 │
└─────────────────────────┘

クエリ:

SELECT parseDateTimeBestEffort('2018-10-23 10:12:12')
AS parseDateTimeBestEffort;

結果:

┌─parseDateTimeBestEffort─┐
│     2018-10-23 10:12:12 │
└─────────────────────────┘

クエリ:

SELECT toYear(now()) AS year, parseDateTimeBestEffort('10 20:19');

結果:

┌─year─┬─parseDateTimeBestEffort('10 20:19')─┐
│ 2023 │                 2023-01-10 20:19:00 │
└──────┴─────────────────────────────────────┘

クエリ:

WITH
    now() AS ts_now,
    formatDateTime(ts_around, '%b %e %T') AS syslog_arg
SELECT
    ts_now,
    syslog_arg,
    parseDateTimeBestEffort(syslog_arg)
FROM (SELECT arrayJoin([ts_now - 30, ts_now + 30]) AS ts_around);

結果:

┌──────────────ts_now─┬─syslog_arg──────┬─parseDateTimeBestEffort(syslog_arg)─┐
│ 2023-06-30 23:59:30 │ Jun 30 23:59:00 │                 2023-06-30 23:59:00 │
│ 2023-06-30 23:59:30 │ Jul  1 00:00:00 │                 2022-07-01 00:00:00 │
└─────────────────────┴─────────────────┴─────────────────────────────────────┘

参照

parseDateTimeBestEffortUS

この関数は、ISO 日付フォーマット（例: YYYY-MM-DD hh:mm:ss）および他の日付フォーマットで、月と日付のコンポーネントを明確に抽出できる場合、parseDateTimeBestEffort と同様に動作します。例: YYYYMMDDhhmmss、YYYY-MM、DD hh、または YYYY-MM-DD hh:mm:ss ±h:mm。月と日付のコンポーネントを明確に抽出できない場合、例: MM/DD/YYYY、MM-DD-YYYY、または MM-DD-YY、この関数は DD/MM/YYYY、DD-MM-YYYY、または DD-MM-YY の代わりに米国の日付形式を優先します。例外として、月が 12 より大きく、かつ 31 以下の場合、この関数は parseDateTimeBestEffort の動作に戻り、例: 15/08/2020 は 2020-08-15 として解析されます。

parseDateTimeBestEffortOrNull

parseDateTime32BestEffortOrNull

parseDateTimeBestEffort と同様ですが、処理できない日付フォーマットに遭遇したときに NULL を返します。

parseDateTimeBestEffortOrZero

parseDateTime32BestEffortOrZero

parseDateTimeBestEffort と同様ですが、処理できない日付フォーマットに遭遇したときにゼロの日付またはゼロの日時を返します。

parseDateTimeBestEffortUSOrNull

parseDateTimeBestEffortUS 関数と同様ですが、処理できない日付フォーマットに遭遇したときに NULL を返します。

parseDateTimeBestEffortUSOrZero

parseDateTimeBestEffortUS 関数と同様ですが、処理できない日付フォーマットに遭遇したときにゼロの日付（1970-01-01）またはゼロの日時（1970-01-01 00:00:00）を返します。

parseDateTime64BestEffort

parseDateTimeBestEffort 関数と同様ですが、ミリ秒とマイクロ秒も解析し、DateTime データ型を返します。

構文

parseDateTime64BestEffort(time_string [, precision [, time_zone]])

引数

time_string — 変換する日付または時刻を含む文字列。 String。
precision — 必須の精度。3 — ミリ秒用、6 — マイクロ秒用。デフォルトは 3。オプション。 UInt8。
time_zone — Timezone。この関数は、タイムゾーンに従って time_string を解析します。オプション。 String。

返される値

time_string を DateTime データ型に変換します。

例

クエリ:

SELECT parseDateTime64BestEffort('2021-01-01') AS a, toTypeName(a) AS t
UNION ALL
SELECT parseDateTime64BestEffort('2021-01-01 01:01:00.12346') AS a, toTypeName(a) AS t
UNION ALL
SELECT parseDateTime64BestEffort('2021-01-01 01:01:00.12346',6) AS a, toTypeName(a) AS t
UNION ALL
SELECT parseDateTime64BestEffort('2021-01-01 01:01:00.12346',3,'Asia/Istanbul') AS a, toTypeName(a) AS t
FORMAT PrettyCompactMonoBlock;

結果:

┌──────────────────────────a─┬─t──────────────────────────────┐
│ 2021-01-01 01:01:00.123000 │ DateTime64(3)                  │
│ 2021-01-01 00:00:00.000000 │ DateTime64(3)                  │
│ 2021-01-01 01:01:00.123460 │ DateTime64(6)                  │
│ 2020-12-31 22:01:00.123000 │ DateTime64(3, 'Asia/Istanbul') │
└────────────────────────────┴────────────────────────────────┘

parseDateTime64BestEffortUS

parseDateTime64BestEffort と同様ですが、曖昧な場合は米国の日付形式（MM/DD/YYYY など）を優先します。

parseDateTime64BestEffortOrNull

parseDateTime64BestEffort と同様ですが、処理できない日付フォーマットに遭遇したときに NULL を返します。

parseDateTime64BestEffortOrZero

parseDateTime64BestEffort と同様ですが、処理できない日付フォーマットに遭遇したときにゼロの日付またはゼロの日時を返します。

parseDateTime64BestEffortUSOrNull

parseDateTime64BestEffort と同様ですが、曖昧な場合は米国の日付形式（MM/DD/YYYY など）を優先し、処理できない日付フォーマットに遭遇したときに NULL を返します。

parseDateTime64BestEffortUSOrZero

parseDateTime64BestEffort と同様ですが、曖昧な場合は米国の日付形式（MM/DD/YYYY など）を優先し、処理できない日付フォーマットに遭遇したときにゼロの日付またはゼロの日時を返します。

toLowCardinality

入力パラメータを同じデータ型の LowCardinality バージョンに変換します。

LowCardinality データ型からデータを変換するには、CAST 関数を使用します。例えば、CAST(x as String)。

構文

toLowCardinality(expr)

引数

expr — Expression の結果で、サポートされているデータ型のいずれか。 supported data types。

返される値

expr の結果。 LowCardinality の expr の型。

例

クエリ:

SELECT toLowCardinality('1');

結果:

┌─toLowCardinality('1')─┐
│ 1                     │
└───────────────────────┘

toUnixTimestamp

String、Date、または DateTime を Unix タイムスタンプ（1970-01-01 00:00:00 UTC からの秒数）として UInt32 型に変換します。

構文

toUnixTimestamp(date, [timezone])

引数

date: 変換する値。 Date または Date32 または DateTime または DateTime64 または String。
timezone: オプション。変換に使用するタイムゾーン。指定しない場合はサーバーのタイムゾーンが使用されます。 String

返される値

Unix タイムスタンプを返します。 UInt32

例

使用例

SELECT
'2017-11-05 08:07:47' AS dt_str,
toUnixTimestamp(dt_str) AS from_str,
toUnixTimestamp(dt_str, 'Asia/Tokyo') AS from_str_tokyo,
toUnixTimestamp(toDateTime(dt_str)) AS from_datetime,
toUnixTimestamp(toDateTime64(dt_str, 0)) AS from_datetime64,
toUnixTimestamp(toDate(dt_str)) AS from_date,
toUnixTimestamp(toDate32(dt_str)) AS from_date32
FORMAT Vertical;

Row 1:
──────
dt_str:          2017-11-05 08:07:47
from_str:        1509869267
from_str_tokyo:  1509836867
from_datetime:   1509869267
from_datetime64: 1509869267
from_date:       1509840000
from_date32:     1509840000

toUnixTimestamp64Second

DateTime64 を固定秒精度の Int64 値に変換します。入力値は、その精度に応じて適切にスケーリングされます。

注記

出力値は UTC のタイムスタンプであり、DateTime64 のタイムゾーンではありません。

構文

toUnixTimestamp64Second(value)

引数

value — 精度のある DateTime64 値。 DateTime64。

返される値

value を Int64 データ型に変換します。 Int64。

例

クエリ:

WITH toDateTime64('2009-02-13 23:31:31.011', 3, 'UTC') AS dt64
SELECT toUnixTimestamp64Second(dt64);

結果:

┌─toUnixTimestamp64Second(dt64)─┐
│                    1234567891 │
└───────────────────────────────┘

toUnixTimestamp64Milli

DateTime64 を固定ミリ秒精度の Int64 値に変換します。入力値は、その精度に応じて適切にスケーリングされます。

注記

出力値は UTC のタイムスタンプであり、DateTime64 のタイムゾーンではありません。

構文

toUnixTimestamp64Milli(value)

引数

value — 精度のある DateTime64 値。 DateTime64。

返される値

value を Int64 データ型に変換します。 Int64。

例

クエリ:

WITH toDateTime64('2009-02-13 23:31:31.011', 3, 'UTC') AS dt64
SELECT toUnixTimestamp64Milli(dt64);

結果:

┌─toUnixTimestamp64Milli(dt64)─┐
│                1234567891011 │
└──────────────────────────────┘

toUnixTimestamp64Micro

DateTime64 を固定マイクロ秒精度の Int64 値に変換します。入力値は、その精度に応じて適切にスケーリングされます。

注記

出力値は UTC のタイムスタンプであり、DateTime64 のタイムゾーンではありません。

構文

toUnixTimestamp64Micro(value)

引数

value — 精度のある DateTime64 値。 DateTime64。

返される値

value を Int64 データ型に変換します。 Int64。

例

クエリ:

WITH toDateTime64('1970-01-15 06:56:07.891011', 6, 'UTC') AS dt64
SELECT toUnixTimestamp64Micro(dt64);

結果:

┌─toUnixTimestamp64Micro(dt64)─┐
│                1234567891011 │
└──────────────────────────────┘

toUnixTimestamp64Nano

DateTime64 を固定ナノ秒精度の Int64 値に変換します。入力値は、その精度に応じて適切にスケーリングされます。

注記

出力値は UTC のタイムスタンプであり、DateTime64 のタイムゾーンではありません。

構文

toUnixTimestamp64Nano(value)

引数

value — 精度のある DateTime64 値。 DateTime64。

返される値

value を Int64 データ型に変換します。 Int64。

例

クエリ:

WITH toDateTime64('1970-01-01 00:20:34.567891011', 9, 'UTC') AS dt64
SELECT toUnixTimestamp64Nano(dt64);

結果:

┌─toUnixTimestamp64Nano(dt64)─┐
│               1234567891011 │
└─────────────────────────────┘

fromUnixTimestamp64Second

Int64 を固定秒精度の DateTime64 値に変換します。入力値は、その精度に応じて適切にスケーリングされます。

注記

入力値は UTC タイムスタンプとして処理され、指定された（または暗黙の）タイムゾーンのタイムスタンプではありません。

構文

fromUnixTimestamp64Second(value[, timezone])

引数

value — 精度のある値。 Int64。
timezone — （オプション）結果のタイムゾーン名。 String。

返される値

value を精度 0 の DateTime64 に変換します。 DateTime64。

例

クエリ:

WITH CAST(1733935988, 'Int64') AS i64
SELECT
    fromUnixTimestamp64Second(i64, 'UTC') AS x,
    toTypeName(x);

結果:

┌───────────────────x─┬─toTypeName(x)────────┐
│ 2024-12-11 16:53:08 │ DateTime64(0, 'UTC') │
└─────────────────────┴──────────────────────┘

fromUnixTimestamp64Milli

Int64 を固定ミリ秒精度の DateTime64 値に変換します。入力値は、その精度に応じて適切にスケーリングされます。

注記

入力値は UTC タイムスタンプとして処理され、指定された（または暗黙の）タイムゾーンのタイムスタンプではありません。

構文

fromUnixTimestamp64Milli(value[, timezone])

引数

value — 精度のある値。 Int64。
timezone — （オプション）結果のタイムゾーン名。 String。

返される値

value を精度 3 の DateTime64 に変換します。 DateTime64。

例

クエリ:

WITH CAST(1733935988123, 'Int64') AS i64
SELECT
    fromUnixTimestamp64Milli(i64, 'UTC') AS x,
    toTypeName(x);

結果:

┌───────────────────────x─┬─toTypeName(x)────────┐
│ 2024-12-11 16:53:08.123 │ DateTime64(3, 'UTC') │
└─────────────────────────┴──────────────────────┘

fromUnixTimestamp64Micro

Int64 を固定マイクロ秒精度の DateTime64 値に変換します。入力値は、その精度に応じて適切にスケーリングされます。

注記

入力値は UTC タイムスタンプとして処理され、指定された（または暗黙の）タイムゾーンのタイムスタンプではありません。

構文

fromUnixTimestamp64Micro(value[, timezone])

引数

value — 精度のある値。 Int64。
timezone — （オプション）結果のタイムゾーン名。 String。

返される値

value を精度 6 の DateTime64 に変換します。 DateTime64。

例

クエリ:

WITH CAST(1733935988123456, 'Int64') AS i64
SELECT
    fromUnixTimestamp64Micro(i64, 'UTC') AS x,
    toTypeName(x);

結果:

┌──────────────────────────x─┬─toTypeName(x)────────┐
│ 2024-12-11 16:53:08.123456 │ DateTime64(6, 'UTC') │
└────────────────────────────┴──────────────────────┘

fromUnixTimestamp64Nano

Int64 を固定ナノ秒精度の DateTime64 値に変換します。入力値は、その精度に応じて適切にスケーリングされます。

注記

入力値は UTC タイムスタンプとして処理され、指定された（または暗黙の）タイムゾーンのタイムスタンプではありません。

構文

fromUnixTimestamp64Nano(value[, timezone])

引数

value — 精度のある値。 Int64。
timezone — （オプション）結果のタイムゾーン名。 String。

返される値

value を精度 9 の DateTime64 に変換します。 DateTime64。

例

クエリ:

WITH CAST(1733935988123456789, 'Int64') AS i64
SELECT
    fromUnixTimestamp64Nano(i64, 'UTC') AS x,
    toTypeName(x);

結果:

┌─────────────────────────────x─┬─toTypeName(x)────────┐
│ 2024-12-11 16:53:08.123456789 │ DateTime64(9, 'UTC') │
└───────────────────────────────┴──────────────────────┘

formatRow

任意の式を指定されたフォーマットを通じて文字列に変換します。

構文

formatRow(format, x, y, ...)

引数

format — テキストフォーマット。例えば、CSV、TSV。
x,y, ... — 式。

返される値

フォーマットされた文字列。（テキストフォーマットでは通常改行文字で終了します）。

例

クエリ:

SELECT formatRow('CSV', number, 'good')
FROM numbers(3);

結果:

┌─formatRow('CSV', number, 'good')─┐
│ 0,"good"
                         │
│ 1,"good"
                         │
│ 2,"good"
                         │
└──────────────────────────────────┘

注: フォーマットに接尾辞/接頭辞が含まれている場合、それは各行に書き込まれます。

例

クエリ:

SELECT formatRow('CustomSeparated', number, 'good')
FROM numbers(3)
SETTINGS format_custom_result_before_delimiter='<prefix>\n', format_custom_result_after_delimiter='<suffix>'

結果:

┌─formatRow('CustomSeparated', number, 'good')─┐
│ <prefix>
0    good
<suffix>                   │
│ <prefix>
1    good
<suffix>                   │
│ <prefix>
2    good
<suffix>                   │
└──────────────────────────────────────────────┘

注: この関数では、行ベースのフォーマットのみがサポートされています。

formatRowNoNewline

任意の式を指定されたフォーマットを通じて文字列に変換します。これは、最後の \n があれば削除する点で formatRow と異なります。

構文

formatRowNoNewline(format, x, y, ...)

引数

format — テキストフォーマット。例えば、CSV、TSV。
x,y, ... — 式。

返される値

フォーマットされた文字列。

例

クエリ:

SELECT formatRowNoNewline('CSV', number, 'good')
FROM numbers(3);

結果:

┌─formatRowNoNewline('CSV', number, 'good')─┐
│ 0,"good"                                  │
│ 1,"good"                                  │
│ 2,"good"                                  │
└───────────────────────────────────────────┘

データ変換に関する一般的な問題​

toString 関数に関する注意事項​

toDate / toDateTime 関数に関する注意事項​

toBool​

toInt8​

toInt8OrZero​

toInt8OrNull​

toInt8OrDefault​

toInt16​

toInt16OrZero​

toInt16OrNull​

toInt16OrDefault​

toInt32​

toInt32OrZero​

toInt32OrNull​

toInt32OrDefault​

toInt64​

toInt64OrZero​

toInt64OrNull​

toInt64OrDefault​

toInt128​

toInt128OrZero​

toInt128OrNull​

toInt128OrDefault​

toInt256​

toInt256OrZero​

toInt256OrNull​

toInt256OrDefault​

toUInt8​

toUInt8OrZero​

toUInt8OrNull​

toUInt8OrDefault​

toUInt16​

toUInt16OrZero​

toUInt16OrNull​

toUInt16OrDefault​

toUInt32​

toUInt32OrZero​

toUInt32OrNull​

toUInt32OrDefault​

toUInt64​

toUInt64OrZero​

toUInt64OrNull​

toUInt64OrDefault​

toUInt128​

toUInt128OrZero​

toUInt128OrNull​

toUInt128OrDefault​

toUInt256​

toUInt256OrZero​

toUInt256OrNull​

toUInt256OrDefault​

toFloat32​

toFloat32OrZero​

toFloat32OrNull​

toFloat32OrDefault​

toFloat64​

toFloat64OrZero​

toFloat64OrNull​

toFloat64OrDefault​

toBFloat16​

toBFloat16OrZero​

toBFloat16OrNull​

toDate​

toDateOrZero​

toDateOrNull​

toDateOrDefault​

toDateTime​

toDateTimeOrZero​

toDateTimeOrNull​

toDateTimeOrDefault​

toDate32​

toDate32OrZero​

toDate32OrNull​

toDate32OrDefault​

toDateTime64​

toDateTime64OrZero​

toDateTime64OrNull​

toDateTime64OrDefault​

toDecimal32​

データ変換に関する一般的な問題

`toString` 関数に関する注意事項

`toDate` / `toDateTime` 関数に関する注意事項

toBool

toInt8

toInt8OrZero

toInt8OrNull

toInt8OrDefault

toInt16

toInt16OrZero

toInt16OrNull

toInt16OrDefault

toInt32

toInt32OrZero

toInt32OrNull

toInt32OrDefault

toInt64

toInt64OrZero

toInt64OrNull

toInt64OrDefault

toInt128

toInt128OrZero

toInt128OrNull

toInt128OrDefault

toInt256

toInt256OrZero

toInt256OrNull

toInt256OrDefault

toUInt8

toUInt8OrZero

toUInt8OrNull

toUInt8OrDefault

toUInt16

toUInt16OrZero

toUInt16OrNull

toUInt16OrDefault

toUInt32

toUInt32OrZero

toUInt32OrNull

toUInt32OrDefault

toUInt64

toUInt64OrZero

toUInt64OrNull

toUInt64OrDefault

toUInt128

toUInt128OrZero

toUInt128OrNull

toUInt128OrDefault

toUInt256

toUInt256OrZero

toUInt256OrNull

toUInt256OrDefault

toFloat32

toFloat32OrZero

toFloat32OrNull

toFloat32OrDefault

toFloat64

toFloat64OrZero

toFloat64OrNull

toFloat64OrDefault

toBFloat16

toBFloat16OrZero

toBFloat16OrNull

toDate

toDateOrZero

toDateOrNull

toDateOrDefault

toDateTime

toDateTimeOrZero

toDateTimeOrNull

toDateTimeOrDefault

toDate32

toDate32OrZero

toDate32OrNull

toDate32OrDefault

toDateTime64

toDateTime64OrZero

toDateTime64OrNull

toDateTime64OrDefault

toDecimal32