型変換関数

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

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) │
└──────────────────┴─────────────────────┴──────────────────┘

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進数の値の文字列表現、例：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型の値に変換しますが、エラーが発生した場合はデフォルト値を返します。デフォルト値が指定されていない場合はエラーが発生した際に0が返されます。

構文

toInt8OrDefault(expr[, default])

引数

expr — 数字または数字の文字列表現を返す式。式 / String。
default（オプション）— Int8型への変換が失敗した場合に返されるデフォルト値。 Int8。

サポートされる引数:

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

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

Float32/64型の値の文字列表現、NaNおよびInfを含む。
バイナリおよび16進数の値の文字列表現、例：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進数の値の文字列表現、例：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進数の値の文字列表現、例：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進数の値の文字列表現、例：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型の値に変換しますが、エラーが発生した場合はデフォルト値を返します。デフォルト値が指定されていない場合はエラーが発生した際に0が返されます。

構文

toInt16OrDefault(expr[, default])

引数

expr — 数字または数字の文字列表現を返す式。式 / String。
default（オプション）— Int16型への変換が失敗した場合に返されるデフォルト値。 Int16。

サポートされる引数:

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

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

Float32/64型の値の文字列表現、NaNおよびInfを含む。
バイナリおよび16進数の値の文字列表現、例：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進数の値の文字列表現、例：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進数の値の文字列表現、例：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進数の値の文字列表現、例：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型の値に変換しますが、エラーが発生した場合はデフォルト値を返します。デフォルト値が指定されていない場合はエラーが発生した際に0が返されます。

構文

toInt32OrDefault(expr[, default])

引数

expr — 数字または数字の文字列表現を返す式。式 / String。
default（オプション）— Int32型への変換が失敗した場合に返されるデフォルト値。 Int32。

サポートされる引数:

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

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

Float32/64型の値の文字列表現、NaNおよびInfを含む。
バイナリおよび16進数の値の文字列表現、例：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進数の値の文字列表現、例：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進数の値の文字列表現、例：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進数の値の文字列表現、例：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型の値に変換しますが、エラーが発生した場合はデフォルト値を返します。デフォルト値が指定されていない場合はエラーが発生した際に0が返されます。

構文

toInt64OrDefault(expr[, default])

引数

expr — 数字または数字の文字列表現を返す式。式 / String。
default（オプション）— Int64型への変換が失敗した場合に返されるデフォルト値。 Int64。

サポートされる引数:

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

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

Float32/64型の値の文字列表現、NaNおよびInfを含む。
バイナリおよび16進数の値の文字列表現、例：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進数の値の文字列表現、例：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 \{#toint128orzero}

[`toInt128`](#toint128) と同様に、この関数は入力値を [Int128](../data-types/int-uint.md) 型に変換しますが、エラーが発生した場合は `0` を返します。

**構文**

```sql
toInt128OrZero(expr)

引数

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

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

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

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

Float32/64 値の文字列表現、NaN および Inf を含む。
バイナリおよび16進数の文字列表現、例: 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 — 数字の文字列表現。式 / 文字列。

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

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

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

Float32/64 値の文字列表現、NaN および Inf を含む。
バイナリおよび16進数の文字列表現、例: 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 型に変換しますが、エラーが発生した場合はデフォルト値を返します。デフォルト値が指定されていない場合、エラーが発生した場合は 0 が返されます。

構文

toInt128OrDefault(expr[, default])

引数

expr — 数字または数字の文字列表現を返す式。式 / 文字列。
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 — 数字または数字の文字列表現を返す式。式。

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

(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 — 数字の文字列表現。文字列。

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

(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 — 数字の文字列表現。文字列。

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

(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 型に変換しますが、エラーが発生した場合はデフォルト値を返します。デフォルト値が指定されていない場合、エラーが発生した場合は 0 が返されます。

構文

toInt256OrDefault(expr[, default])

引数

expr — 数字または数字の文字列表現を返す式。式 / 文字列。
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 — 数字または数字の文字列表現を返す式。式。

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

(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 — 数字の文字列表現。文字列。

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

(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 — 数字の文字列表現。文字列。

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

(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 型に変換しますが、エラーが発生した場合はデフォルト値を返します。デフォルト値が指定されていない場合、エラーが発生した場合は 0 が返されます。

構文

toUInt8OrDefault(expr[, default])

引数

expr — 数字または数字の文字列表現を返す式。式 / 文字列。
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 — 数字または数字の文字列表現を返す式。式。

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

(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 — 数字の文字列表現。文字列。

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

(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 — 数字の文字列表現。文字列。

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

(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 型に変換しますが、エラーが発生した場合はデフォルト値を返します。デフォルト値が指定されていない場合、エラーが発生した場合は 0 が返されます。

構文

toUInt16OrDefault(expr[, default])

引数

expr — 数字または数字の文字列表現を返す式。式 / 文字列。
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 — 数字または数字の文字列表現を返す式。式。

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

(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 — 数字の文字列表現。文字列。

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

(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 — 数字の文字列表現。文字列。

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

(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 \{#touint32ordefault}

[`toUInt32`](#touint32)と同様に、この関数は入力値を[UInt32](../data-types/int-uint.md)型の値に変換しますが、エラーが発生した場合はデフォルト値を返します。
デフォルト値が指定されていない場合は、エラーが発生した場合に`0`が返されます。

**構文**

```sql
toUInt32OrDefault(expr[, default])

引数

expr — 数値または数値の文字列表現を返す式。式 / 文字列。
default（オプション）— UInt32型へのパースに失敗した場合に返されるデフォルト値。 UInt32。

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

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

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

NaNやInfを含むFloat32/64の文字列表現。
SELECT toUInt32OrDefault('0xc0fe', CAST('0', 'UInt32'));のような2進数および16進数の文字列表現。

注記

入力値が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 — 数値または数値の文字列表現を返す式。式。

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

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

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

NaNやInfを含むFloat32/64の文字列表現。
SELECT toUInt64('0xc0fe');のような2進数および16進数の文字列表現。

注記

入力値が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 — 数値を表す文字列。文字列。

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

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

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

NaNやInfを含むFloat32/64の文字列表現。
SELECT toUInt64OrZero('0xc0fe');のような2進数および16進数の文字列表現。

注記

入力値が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 — 数値を表す文字列。式 / 文字列。

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

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

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

NaNやInfを含むFloat32/64の文字列表現。
SELECT toUInt64OrNull('0xc0fe');のような2進数および16進数の文字列表現。

注記

入力値が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型の値に変換しますが、エラーが発生した場合はデフォルト値を返します。デフォルト値が指定されていない場合は、エラーが発生した場合に0が返されます。

構文

toUInt64OrDefault(expr[, default])

引数

expr — 数値または数値の文字列表現を返す式。式 / 文字列。
default（オプション）— UInt64型へのパースに失敗した場合に返されるデフォルト値。 UInt64。

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

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

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

NaNやInfを含むFloat32/64の文字列表現。
SELECT toUInt64OrDefault('0xc0fe', CAST('0', 'UInt64'));のような2進数および16進数の文字列表現。

注記

入力値が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 — 数値または数値の文字列表現を返す式。式。

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

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

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

NaNやInfを含むFloat32/64の文字列表現。
SELECT toUInt128('0xc0fe');のような2進数および16進数の文字列表現。

注記

入力値が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 — 数値または数値の文字列表現を返す式。式 / 文字列。

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

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

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

NaNやInfを含むFloat32/64の文字列表現。
SELECT toUInt128OrZero('0xc0fe');のような2進数および16進数の文字列表現。

注記

入力値が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 — 数値を表す文字列。式 / 文字列。

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

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

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

NaNやInfを含むFloat32/64の文字列表現。
SELECT toUInt128OrNull('0xc0fe');のような2進数および16進数の文字列表現。

注記

入力値が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型の値に変換しますが、エラーが発生した場合はデフォルト値を返します。デフォルト値が指定されていない場合は、エラーが発生した場合に0が返されます。

構文

toUInt128OrDefault(expr[, default])

引数

expr — 数値または数値の文字列表現を返す式。式 / 文字列。
default（オプション）— UInt128型へのパースに失敗した場合に返されるデフォルト値。 UInt128。

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

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

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

NaNやInfを含むFloat32/64の文字列表現。
SELECT toUInt128OrDefault('0xc0fe', CAST('0', 'UInt128'));のような2進数および16進数の文字列表現。

注記

入力値が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 — 数値または数値の文字列表現を返す式。式。

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

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

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

NaNやInfを含むFloat32/64の文字列表現。
SELECT toUInt256('0xc0fe');のような2進数および16進数の文字列表現。

注記

入力値が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 — 数値を表す文字列。文字列。

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

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

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

NaNやInfを含むFloat32/64の文字列表現。
SELECT toUInt256OrZero('0xc0fe');のような2進数および16進数の文字列表現。

注記

入力値が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 — 数値を表す文字列。文字列。

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

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

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

NaNやInfを含むFloat32/64の文字列表現。
SELECT toUInt256OrNull('0xc0fe');のような2進数および16進数の文字列表現。

注記

入力値が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型の値に変換しますが、エラーが発生した場合はデフォルト値を返します。デフォルト値が指定されていない場合は、エラーが発生した場合に0が返されます。

構文

toUInt256OrDefault(expr[, default])

引数

expr — 数値または数値の文字列表現を返す式。式 / 文字列。
default（オプション）— UInt256型へのパースに失敗した場合に返されるデフォルト値。 UInt256。

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

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

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

NaNやInfを含むFloat32/64の文字列表現。
SELECT toUInt256OrDefault('0xc0fe', CAST('0', 'UInt256'));のような2進数および16進数の文字列表現。

注記

入力値が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 — 数値または数値の文字列表現を返す式。式。

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

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

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

SELECT toFloat32('0xc0fe');のような2進数および16進数の文字列表現。

返される値

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 — 数値を表す文字列。文字列。

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

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

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

SELECT toFloat32OrZero('0xc0fe');のような2進数および16進数の文字列表現。

返される値

成功した場合は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 — 数値を表す文字列。文字列。

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

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

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

SELECT toFloat32OrNull('0xc0fe');のような2進数および16進数の文字列表現。

返される値

成功した場合は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型の値に変換しますが、エラーが発生した場合はデフォルト値を返します。デフォルト値が指定されていない場合は、エラーが発生した場合に0が返されます。

構文

toFloat32OrDefault(expr[, default])

引数

expr — 数値または数値の文字列表現を返す式。式 / 文字列。
default（オプション）— Float32型へのパースに失敗した場合に返されるデフォルト値。 Float32。

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

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

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

2進数および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 — 数値または数値の文字列表現を返す式。式。

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

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

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

SELECT toFloat64('0xc0fe');のような2進数および16進数の文字列表現。

返される値

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 — 数値を表す文字列。文字列。

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

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

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

SELECT toFloat64OrZero('0xc0fe');のような2進数および16進数の文字列表現。

返される値

成功した場合は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 — 数値を表す文字列。文字列。

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

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

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

SELECT toFloat64OrNull('0xc0fe');のような2進数および16進数の文字列表現。

返される値

成功した場合は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

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

構文

toBFloat16OrZero(x)

引数

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

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

数値の文字列表現。

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

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

返される値

16ビットのブレインフロート値、そうでなければ 0。 BFloat16。

注記

この関数は文字列表現からの変換中に精度の損失を黙って許可します。

例

SELECT toBFloat16OrZero('0x5E'); -- サポートされていない引数

0

SELECT toBFloat16OrZero('12.3'); -- 一般的な使用法

12.25

SELECT toBFloat16OrZero('12.3456789');

12.3125 -- 精度の損失

関連項目

toBFloat16。
toBFloat16OrNull。

toBFloat16OrNull

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

構文

toBFloat16OrNull(x)

引数

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

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

数値の文字列表現。

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

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

返される値

16ビットのブレインフロート値、そうでなければ NULL (\N)。 BFloat16。

注記

この関数は文字列表現からの変換中に精度の損失を黙って許可します。

例

SELECT toBFloat16OrNull('0x5E'); -- サポートされていない引数

\N

SELECT toBFloat16OrNull('12.3'); -- 一般的な使用法

12.25

SELECT toBFloat16OrNull('12.3456789');

12.3125 -- 精度の損失

関連項目

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 に切り捨てられます。タイムゾーン引数は、関数の第二引数として指定できます。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 型の範囲に当てはまらない場合、実装依存の動作を生成し、最大サポート日付に saturation するかオーバーフローで終了する可能性があります：

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

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

toDate と同様ですが、失敗した場合は、第二引数（指定されている場合）または 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' は年（未完成の文字列表現の日付 / 日付時刻）または 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

toDateTime と同様ですが、失敗した場合は、第三引数（指定されている場合）または 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

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^-精度秒。有効範囲：[ 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^-精度秒。有効範囲：[ 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^-精度秒。有効範囲：[ 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^-精度秒。有効範囲：[ 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) 型の値に変換します。スケール 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);。

注記

オーバーフローが発生すると、expr の値が Decimal32 の範囲を超えると ( -1 * 10^(9 - S), 1 * 10^(9 - S) )。小数部の余分な桁は破棄され（丸められません）、整数部が過剰な桁になるとエラーが発生します。

返される値

成功した場合は型は 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 \{#todecimal32ordefault}

[`toDecimal32`](#todecimal32) と同様に、この関数は入力値を [Decimal(9, S)](../data-types/decimal.md) 型の値に変換しますが、エラーが発生した場合はデフォルト値を返します。

**構文**

```sql
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);.

注記

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

注意

変換処理において、余分な桁がドロップされ、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

入力値をスケール S を持つ 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 を返します。 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

入力値をスケール S を持つ 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 を返します。 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

入力値をスケール S を持つ 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 を返します。 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);.

注記

注意

変換処理において、余分な桁がドロップされ、Float32/Float64入力を扱う際には予期しない動作をする可能性があります。操作は浮動小数点命令を使用して行われます。例えば: toDecimal256OrDefault(1.15, 2) は 1.14 に等しいです。なぜなら、1.15 * 100 が浮動小数点では114.99になるからです。文字列入力を使用することで、操作は基になる整数型を使用できます: 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

数字、文字列（固定文字列ではない）、日付、および日時の間で変換する関数。これらの関数はすべて1つの引数を受け取ります。

文字列への変換または文字列からの変換を行う際、値はTabSeparated形式（およびほぼすべての他のテキスト形式）に対して同じルールを使用してフォーマットまたは解析されます。文字列を解析できない場合、例外がスローされ、リクエストがキャンセルされます。

日付を数値に変換する場合、またはその逆において、日付はUnixエポックの開始からの日数を表します。日時を数値に変換する場合、またはその逆において、日時はUnixエポックの開始からの秒数を表します。

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++における異なる数値型間の代入と同じルールを使用します。

さらに、DateTime引数のtoString関数は、タイムゾーン名を含む2番目の文字列引数を受け取ることができます。例: Asia/Yekaterinburg この場合、時間は指定されたタイムゾーンに従ってフォーマットされます。

例

クエリ:

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関数も参照してください。

toFixedString

文字列型の引数をFixedString(N)型（固定長Nの文字列）に変換します。文字列のバイト数がN未満の場合、右側にヌルバイトでパディングされます。文字列のバイト数がNを超える場合、例外がスローされます。

構文

toFixedString(s, N)

引数

s — 固定文字列に変換する文字列です。文字列。
N — 長さN。UInt8

返される値

sのN長固定文字列です。FixedString。

例

クエリ:

SELECT toFixedString('foo', 8) AS s;

結果:

┌─s─────────────┐
│ foo\0\0\0\0\0 │
└───────────────┘

toStringCutToZero

文字列またはFixedString引数を受け取ります。最初に見つかったヌルバイトで切り捨てられた文字列を返します。

構文

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、文字列かFixedString。

返される値

再解釈された値xをUInt8として。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、文字列かFixedString。

返される値

再解釈された値xをUInt16として。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、文字列かFixedString。

返される値

再解釈された値xをUInt32として。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、文字列かFixedString。

返される値

再解釈された値xをUInt64として。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、文字列かFixedString。

返される値

再解釈された値xをUInt128として。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、文字列かFixedString。

返される値

再解釈された値xをUInt256として。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、文字列かFixedString。

返される値

再解釈された値xをInt8として。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、文字列かFixedString。

返される値

再解釈された値xをInt16として。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、文字列かFixedString。

返される値

再解釈された値xをInt32として。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、文字列かFixedString。

返される値

再解釈された値xをInt64として。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、文字列かFixedString。

返される値

再解釈された値xをInt128として。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、文字列かFixedString。

返される値

再解釈された値xをInt256として。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、文字列かFixedString。

返される値

再解釈された値xをFloat32として。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、文字列かFixedString。

返される値

再解釈された値xをFloat64として。Float64。

例

クエリ:

SELECT reinterpretAsUInt64(toFloat64(0.2)) as x, reinterpretAsFloat64(x);

結果:

┌───────────────────x─┬─reinterpretAsFloat64(x)─┐
│ 4596373779694328218 │                     0.2 │
└─────────────────────┴─────────────────────────┘

reinterpretAsDate

文字列、固定文字列、または数値を受け取り、ホストオーダー（リトルエンディアン）で数値としてバイトを解釈します。Unix Epochの始まり以来の日数として解釈された数値から日付を返します。

構文

reinterpretAsDate(x)

引数

x: Unix Epochの始まり以来の日数。 (U)Int*、Float、Date、DateTime、UUID、文字列かFixedString。

返される値

日付。Date。

実装に関する詳細

注記

提供された文字列が十分な長さでない場合、関数は、必要な数のヌルバイトでパディングされた文字列として動作します。文字列が必要よりも長い場合、余分なバイトは無視されます。

例

クエリ:

SELECT reinterpretAsDate(65), reinterpretAsDate('A');

結果:

┌─reinterpretAsDate(65)─┬─reinterpretAsDate('A')─┐
│            1970-03-07 │             1970-03-07 │
└───────────────────────┴────────────────────────┘

reinterpretAsDateTime

これらの関数は文字列を受け取り、文字列の先頭に配置されたバイトをホストオーダー（リトルエンディアン）で数値として解釈します。Unix Epochの始まり以来の秒数として解釈された数値から日付と時刻を返します。

構文

reinterpretAsDateTime(x)

引数

x: Unix Epochの始まり以来の秒数。 (U)Int*、Float、Date、DateTime、UUID、文字列かFixedString。

返される値

日付と時刻。DateTime。

実装に関する詳細

注記

例

クエリ:

SELECT reinterpretAsDateTime(65), reinterpretAsDateTime('A');

結果:

┌─reinterpretAsDateTime(65)─┬─reinterpretAsDateTime('A')─┐
│       1970-01-01 01:01:05 │        1970-01-01 01:01:05 │
└───────────────────────────┴────────────────────────────┘

reinterpretAsString

この関数は数値、日付、または時刻付きの日付を受け取り、ホストオーダー（リトルエンディアン）で対応する値を表すバイトを含む文字列を返します。ヌルバイトは末尾から削除されます。たとえば、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を返します。ヌルバイトは末尾から削除されます。たとえば、UInt32型の値255は、1バイトの長さのFixedStringになります。

構文

reinterpretAsFixedString(x)

引数

x: 文字列に再解釈する値。(U)Int*、Float、Date、DateTime。

返される値

xを表すバイトを含むFixedString。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を返します。文字列が十分な長さでない場合、関数は、必要な数のヌルバイトで末尾までパディングされた文字列として動作します。文字列が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 │
└─────────────┴──────────────┴───────────────┘

CAST

入力値を指定されたデータ型に変換します。reinterpret関数とは異なり、CASTは新しいデータ型を使用して同じ値を表すことを試みます。変換できない場合、例外が発生します。いくつかの構文バリアントがサポートされています。

構文

CAST(x, T)
CAST(x AS t)
x::t

引数

x — 変換する値。任意の型であることができます。
T — ターゲットデータ型の名前。文字列。
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)への変換は、文字列型または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

データ型 IntervalMillisecond の 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

データ型 IntervalMicrosecond の n マイクロ秒のインターバルを返します。

構文

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

データ型 IntervalNanosecond の n ナノ秒のインターバルを返します。

構文

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

MySQL フォーマット文字列に従って、String を DateTime に変換します。

この関数は、関数 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 値を返します。

サポートされているフォーマット指定子

すべてのフォーマット指定子は formatDateTimeInJoda にリストされていますが、次のものは除外されます:

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

MySQL フォーマット文字列に従って、String を DateTime64 に変換します。

構文

parseDateTime64(str[, format[, timezone]])

引数

str — パース対象の文字列。
format — フォーマット文字列。省略時は %Y-%m-%d %H:%i:%s.%f です。
timezone — Timezone。省略可能。

返される値

入力文字列から MySQLスタイルのフォーマット文字列に従ってパースした DateTime64 値を返します。返される値の精度は 6 です。

parseDateTime64OrZero

parseDateTime64 と同様ですが、処理できない日付フォーマットに遭遇した場合はゼロの日付を返します。

parseDateTime64OrNull

parseDateTime64 と同様ですが、処理できない日付フォーマットに遭遇した場合は NULL を返します。

parseDateTime64InJodaSyntax

Jodaフォーマット文字列に従って String を DateTime64 に変換します。

構文

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。年が指定されていない場合、それは現在の年と等しいとみなされます。結果の日付時刻が未来のものである（現在の瞬間の後、たった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 — 一つの supported data types の結果となる Expression。

返される値

expr の結果。LowCardinality の expr の型。

例

クエリ:

SELECT toLowCardinality('1');

結果:

┌─toLowCardinality('1')─┐
│ 1                     │
└───────────────────────┘

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。

返される値

精度0のDateTime64に変換されたvalue。 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値に変換し、オプションのタイムゾーンを指定できます。入力値は、その精度に応じて適切にスケーリングされます。

注記

構文

fromUnixTimestamp64Milli(value[, timezone])

引数

value — 任意の精度を持つ値。 Int64。
timezone — （オプション）結果のタイムゾーン名。 String。

返される値

精度3のDateTime64に変換されたvalue。 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値に変換し、オプションのタイムゾーンを指定できます。入力値は、その精度に応じて適切にスケーリングされます。

注記

構文

fromUnixTimestamp64Micro(value[, timezone])

引数

value — 任意の精度を持つ値。 Int64。
timezone — （オプション）結果のタイムゾーン名。 String。

返される値

精度6のDateTime64に変換されたvalue。 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値に変換し、オプションのタイムゾーンを指定できます。入力値は、その精度に応じて適切にスケーリングされます。

注記

構文

fromUnixTimestamp64Nano(value[, timezone])

引数

value — 任意の精度を持つ値。 Int64。
timezone — （オプション）結果のタイムゾーン名。 String。

返される値

精度9のDateTime64に変換されたvalue。 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

任意の式を指定された形式の文字列に変換します。formatRowとの違いは、この関数が最後の\nをトリミングする点です。

構文

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"                                  │
└───────────────────────────────────────────┘

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

toBool​

toInt8​

toInt8OrZero​

toInt8OrNull​

toInt8OrDefault​

toInt16​

toInt16OrZero​

toInt16OrNull​

toInt16OrDefault​

toInt32​

toInt32OrZero​

toInt32OrNull​

toInt32OrDefault​

toInt64​

toInt64OrZero​

toInt64OrNull​

toInt64OrDefault​

toInt128​

toInt128OrNull​

toInt128OrDefault​

toInt256​

toInt256OrZero​

toInt256OrNull​

toInt256OrDefault​

toUInt8​

toUInt8OrZero​

toUInt8OrNull​

toUInt8OrDefault​

toUInt16​

toUInt16OrZero​

toUInt16OrNull​

toUInt16OrDefault​

toUInt32​

toUInt32OrZero​

toUInt32OrNull​

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​

toDecimal32OrZero​

toDecimal32OrNull​

toDecimal64​

toDecimal64OrZero​

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

toBool

toInt8

toInt8OrZero

toInt8OrNull

toInt8OrDefault

toInt16

toInt16OrZero

toInt16OrNull

toInt16OrDefault

toInt32

toInt32OrZero

toInt32OrNull

toInt32OrDefault

toInt64

toInt64OrZero

toInt64OrNull

toInt64OrDefault

toInt128

toInt128OrNull

toInt128OrDefault

toInt256

toInt256OrZero

toInt256OrNull

toInt256OrDefault

toUInt8

toUInt8OrZero

toUInt8OrNull

toUInt8OrDefault

toUInt16

toUInt16OrZero

toUInt16OrNull

toUInt16OrDefault

toUInt32

toUInt32OrZero

toUInt32OrNull

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

toDecimal32OrZero

toDecimal32OrNull

toDecimal64

toDecimal64OrZero