型変換関数
データ変換に関する一般的な問題
ClickHouseは一般的に、C++プログラムと同じ動作を使用します。
to<type>
関数とcastは、いくつかのケースで異なる動作をします。例えば、LowCardinalityの場合、castはLowCardinality特性を削除し、to<type>
関数は削除しません。同様にNullableでも、この動作はSQL標準と互換性がなく、cast_keep_nullable設定を使用して変更することができます。
データ型の値が小さいデータ型(例えばInt64
からInt32
へ)に変換される場合や、互換性のないデータ型(例えばString
からInt
へ)の間で変換される場合は、潜在的なデータ損失に注意してください。結果が期待通りであるかどうかを慎重に確認してください。
例:
toBool
入力値をBool
型の値に変換します。エラーが発生した場合は例外をスローします。
構文
引数
expr
— 数字または文字列を返す式。 式。
サポートされる引数:
- (U)Int8/16/32/64/128/256型の値。
- Float32/64型の値。
- 文字列
true
またはfalse
(大文字小文字は区別されません)。
返される値
- 引数の評価に基づいて
true
またはfalse
を返します。 Bool。
例
クエリ:
結果:
toInt8
入力値をInt8
型の値に変換します。エラーが発生した場合は例外をスローします。
構文
引数
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。
関数はゼロに向かって丸めるを使用しており、数の小数部分を切り捨てます。
例
クエリ:
結果:
関連事項
toInt8OrZero
toInt8
と同様に、この関数は入力値を Int8型の値に変換しますが、エラーが発生した場合は0
を返します。
構文
引数
x
— 数字の文字列表現。 String。
サポートされる引数:
- (U)Int8/16/32/128/256型の値の文字列表現。
サポートされていない引数(0
を返します):
- 通常のFloat32/64型の値の文字列表現、
NaN
およびInf
を含む。 - バイナリおよび16進数の値の文字列表現、例:
SELECT toInt8OrZero('0xc0fe');
。
入力値が Int8の範囲内に表現できない場合、結果のオーバーフローまたはアンダーフローが発生します。 これはエラーと見なされません。
返される値
- 成功した場合は8ビット整数値を返し、そうでない場合は
0
を返します。 Int8。
関数はゼロに向かって丸めるを使用しており、数の小数部分を切り捨てます。
例
クエリ:
結果:
関連事項
toInt8OrNull
toInt8
と同様に、この関数は入力値を Int8型の値に変換しますが、エラーが発生した場合はNULL
を返します。
構文
引数
x
— 数字の文字列表現。 String。
サポートされる引数:
- (U)Int8/16/32/128/256型の値の文字列表現。
サポートされていない引数(\N
を返します)
- Float32/64型の値の文字列表現、
NaN
およびInf
を含む。 - バイナリおよび16進数の値の文字列表現、例:
SELECT toInt8OrNull('0xc0fe');
。
入力値が Int8の範囲内に表現できない場合、結果のオーバーフローまたはアンダーフローが発生します。 これはエラーと見なされません。
返される値
関数はゼロに向かって丸めるを使用しており、数の小数部分を切り捨てます。
例
クエリ:
結果:
関連事項
toInt8OrDefault
toInt8
と同様に、この関数は入力値を Int8型の値に変換しますが、エラーが発生した場合はデフォルト値を返します。
デフォルト値が指定されていない場合はエラーが発生した際に0
が返されます。
構文
引数
サポートされる引数:
- (U)Int8/16/32/64/128/256型の値または文字列表現。
- Float32/64型の値。
デフォルト値が返される引数:
- Float32/64型の値の文字列表現、
NaN
およびInf
を含む。 - バイナリおよび16進数の値の文字列表現、例:
SELECT toInt8OrDefault('0xc0fe', CAST('-1', 'Int8'));
。
入力値が Int8の範囲内に表現できない場合、結果のオーバーフローまたはアンダーフローが発生します。 これはエラーと見なされません。
返される値
- 成功した場合は8ビット整数値を返し、そうでない場合は渡されたデフォルト値を返すか、デフォルト値が提供されていない場合は
0
を返します。 Int8。
- 関数はゼロに向かって丸めるを使用しており、数の小数部分を切り捨てます。
- デフォルト値の型はキャストする型と同じであるべきです。
例
クエリ:
結果:
関連事項
toInt16
入力値をInt16
型の値に変換します。エラーが発生した場合は例外をスローします。
構文
引数
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。
関数はゼロに向かって丸めるを使用しており、数の小数部分を切り捨てます。
例
クエリ:
結果:
関連事項
toInt16OrZero
toInt16
と同様に、この関数は入力値を Int16型の値に変換しますが、エラーが発生した場合は0
を返します。
構文
引数
x
— 数字の文字列表現。 String。
サポートされる引数:
- (U)Int8/16/32/128/256型の値の文字列表現。
サポートされていない引数(0
を返します):
- Float32/64型の値の文字列表現、
NaN
およびInf
を含む。 - バイナリおよび16進数の値の文字列表現、例:
SELECT toInt16OrZero('0xc0fe');
。
入力値が Int16の範囲内に表現できない場合、オーバーフローまたはアンダーフローが発生します。 これはエラーと見なされません。
返される値
- 成功した場合は16ビット整数値を返し、そうでない場合は
0
を返します。 Int16。
関数はゼロに向かって丸めるを使用しており、数の小数部分を切り捨てます。
例
クエリ:
結果:
関連事項
toInt16OrNull
toInt16
と同様に、この関数は入力値を Int16型の値に変換しますが、エラーが発生した場合はNULL
を返します。
構文
引数
x
— 数字の文字列表現。 String。
サポートされる引数:
- (U)Int8/16/32/128/256型の値の文字列表現。
サポートされていない引数(\N
を返します)
- Float32/64型の値の文字列表現、
NaN
およびInf
を含む。 - バイナリおよび16進数の値の文字列表現、例:
SELECT toInt16OrNull('0xc0fe');
。
入力値が Int16の範囲内に表現できない場合、オーバーフローまたはアンダーフローが発生します。 これはエラーと見なされません。
返される値
関数はゼロに向かって丸めるを使用しており、数の小数部分を切り捨てます。
例
クエリ:
結果:
関連事項
toInt16OrDefault
toInt16
と同様に、この関数は入力値を Int16型の値に変換しますが、エラーが発生した場合はデフォルト値を返します。
デフォルト値が指定されていない場合はエラーが発生した際に0
が返されます。
構文
引数
サポートされる引数:
- (U)Int8/16/32/64/128/256型の値または文字列表現。
- Float32/64型の値。
デフォルト値が返される引数:
- Float32/64型の値の文字列表現、
NaN
およびInf
を含む。 - バイナリおよび16進数の値の文字列表現、例:
SELECT toInt16OrDefault('0xc0fe', CAST('-1', 'Int16'));
。
入力値が Int16の範囲内に表現できない場合、オーバーフローまたはアンダーフローが発生します。 これはエラーと見なされません。
返される値
- 成功した場合は16ビット整数値を返し、そうでない場合は渡されたデフォルト値を返すか、デフォルト値が提供されていない場合は
0
を返します。 Int16。
- 関数はゼロに向かって丸めるを使用しており、数の小数部分を切り捨てます。
- デフォルト値の型はキャストする型と同じであるべきです。
例
クエリ:
結果:
関連事項
toInt32
入力値をInt32
型の値に変換します。エラーが発生した場合は例外をスローします。
構文
引数
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。
関数はゼロに向かって丸めるを使用しており、数の小数部分を切り捨てます。
例
クエリ:
結果:
関連事項
toInt32OrZero
toInt32
と同様に、この関数は入力値を Int32型の値に変換しますが、エラーが発生した場合は0
を返します。
構文
引数
x
— 数字の文字列表現。 String。
サポートされる引数:
- (U)Int8/16/32/128/256型の値の文字列表現。
サポートされていない引数(0
を返します):
- Float32/64型の値の文字列表現、
NaN
およびInf
を含む。 - バイナリおよび16進数の値の文字列表現、例:
SELECT toInt32OrZero('0xc0fe');
。
入力値が Int32の範囲内に表現できない場合、結果のオーバーフローまたはアンダーフローが発生します。 これはエラーと見なされません。
返される値
- 成功した場合は32ビット整数値を返し、そうでない場合は
0
を返します。 Int32
関数はゼロに向かって丸めるを使用しており、数の小数部分を切り捨てます。
例
クエリ:
結果:
関連事項
toInt32OrNull
toInt32
と同様に、この関数は入力値を Int32型の値に変換しますが、エラーが発生した場合はNULL
を返します。
構文
引数
x
— 数字の文字列表現。 String。
サポートされる引数:
- (U)Int8/16/32/128/256型の値の文字列表現。
サポートされていない引数(\N
を返します)
- Float32/64型の値の文字列表現、
NaN
およびInf
を含む。 - バイナリおよび16進数の値の文字列表現、例:
SELECT toInt32OrNull('0xc0fe');
。
入力値が Int32の範囲内に表現できない場合、結果のオーバーフローまたはアンダーフローが発生します。 これはエラーと見なされません。
返される値
関数はゼロに向かって丸めるを使用しており、数の小数部分を切り捨てます。
例
クエリ:
結果:
関連事項
toInt32OrDefault
toInt32
と同様に、この関数は入力値を Int32型の値に変換しますが、エラーが発生した場合はデフォルト値を返します。
デフォルト値が指定されていない場合はエラーが発生した際に0
が返されます。
構文
引数
サポートされる引数:
- (U)Int8/16/32/64/128/256型の値または文字列表現。
- Float32/64型の値。
デフォルト値が返される引数:
- Float32/64型の値の文字列表現、
NaN
およびInf
を含む。 - バイナリおよび16進数の値の文字列表現、例:
SELECT toInt32OrDefault('0xc0fe', CAST('-1', 'Int32'));
。
入力値が Int32の範囲内に表現できない場合、オーバーフローまたはアンダーフローが発生します。 これはエラーと見なされません。
返される値
- 成功した場合は32ビット整数値を返し、そうでない場合は渡されたデフォルト値を返すか、デフォルト値が提供されていない場合は
0
を返します。 Int32。
- 関数はゼロに向かって丸めるを使用しており、数の小数部分を切り捨てます。
- デフォルト値の型はキャストする型と同じであるべきです。
例
クエリ:
結果:
関連事項
toInt64
入力値をInt64
型の値に変換します。エラーが発生した場合は例外をスローします。
構文
引数
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。
関数はゼロに向かって丸めるを使用しており、数の小数部分を切り捨てます。
例
クエリ:
結果:
関連事項
toInt64OrZero
toInt64
と同様に、この関数は入力値を Int64型の値に変換しますが、エラーが発生した場合は0
を返します。
構文
引数
x
— 数字の文字列表現。 String。
サポートされる引数:
- (U)Int8/16/32/128/256型の値の文字列表現。
サポートされていない引数(0
を返します):
- Float32/64型の値の文字列表現、
NaN
およびInf
を含む。 - バイナリおよび16進数の値の文字列表現、例:
SELECT toInt64OrZero('0xc0fe');
。
入力値が Int64の範囲内に表現できない場合、結果のオーバーフローまたはアンダーフローが発生します。 これはエラーと見なされません。
返される値
- 成功した場合は64ビット整数値を返し、そうでない場合は
0
を返します。 Int64。
関数はゼロに向かって丸めるを使用しており、数の小数部分を切り捨てます。
例
クエリ:
結果:
関連事項
toInt64OrNull
toInt64
と同様に、この関数は入力値を Int64型の値に変換しますが、エラーが発生した場合はNULL
を返します。
構文
引数
サポートされる引数:
- (U)Int8/16/32/128/256型の値の文字列表現。
サポートされていない引数(\N
を返します)
- Float32/64型の値の文字列表現、
NaN
およびInf
を含む。 - バイナリおよび16進数の値の文字列表現、例:
SELECT toInt64OrNull('0xc0fe');
。
入力値が Int64の範囲内に表現できない場合、オーバーフローまたはアンダーフローが発生します。 これはエラーと見なされません。
返される値
関数はゼロに向かって丸めるを使用しており、数の小数部分を切り捨てます。
例
クエリ:
結果:
関連事項
toInt64OrDefault
toInt64
と同様に、この関数は入力値を Int64型の値に変換しますが、エラーが発生した場合はデフォルト値を返します。
デフォルト値が指定されていない場合はエラーが発生した際に0
が返されます。
構文
引数
サポートされる引数:
- (U)Int8/16/32/64/128/256型の値または文字列表現。
- Float32/64型の値。
デフォルト値が返される引数:
- Float32/64型の値の文字列表現、
NaN
およびInf
を含む。 - バイナリおよび16進数の値の文字列表現、例:
SELECT toInt64OrDefault('0xc0fe', CAST('-1', 'Int64'));
。
入力値が Int64の範囲内に表現できない場合、オーバーフローまたはアンダーフローが発生します。 これはエラーと見なされません。
返される値
- 成功した場合は64ビット整数値を返し、そうでない場合は渡されたデフォルト値を返すか、デフォルト値が提供されていない場合は
0
を返します。 Int64。
- 関数はゼロに向かって丸めるを使用しており、数の小数部分を切り捨てます。
- デフォルト値の型はキャストする型と同じであるべきです。
例
クエリ:
結果:
関連事項
toInt128
入力値をInt128
型の値に変換します。エラーが発生した場合は例外をスローします。
構文
引数
expr
— 数字または数字の文字列表現を返す式。 式。
サポートされる引数:
- (U)Int8/16/32/64/128/256型の値または文字列表現。
- Float32/64型の値。
サポートされていない引数:
- Float32/64型の値の文字列表現、
NaN
およびInf
を含む。 - バイナリおよび16進数の値の文字列表現、例:
SELECT toInt128('0xc0fe');
。
入力値が Int128の範囲内に表現できない場合、オーバーフローまたはアンダーフローが発生します。 これはエラーと見なされません。
返される値
- 128ビット整数値。 Int128。
関数はゼロに向かって丸めるを使用しており、数の小数部分を切り捨てます。
例
クエリ:
結果:
関連事項
引数
サポートされている引数:
- (U)Int8/16/32/128/256 の文字列表現。
サポートされていない引数(0
を返す):
- Float32/64 値の文字列表現、
NaN
およびInf
を含む。 - バイナリおよび16進数の文字列表現、例:
SELECT toInt128OrZero('0xc0fe');
。
入力値が Int128 の範囲内で表現できない場合、結果のオーバーフローまたはアンダーフローが発生します。 これはエラーとは見なされません。
返される値
- 成功した場合は 128 ビット整数値、それ以外の場合は
0
を返します。 Int128。
この関数は ゼロに向かって丸める を使用し、数字の小数点以下の桁を切り捨てます。
例
クエリ:
結果:
関連項目
toInt128OrNull
toInt128
と同様に、この関数は入力値を Int128 型に変換しますが、エラーが発生した場合は NULL
を返します。
構文
引数
サポートされている引数:
- (U)Int8/16/32/128/256 の文字列表現。
サポートされていない引数(\N
を返す):
- Float32/64 値の文字列表現、
NaN
およびInf
を含む。 - バイナリおよび16進数の文字列表現、例:
SELECT toInt128OrNull('0xc0fe');
。
入力値が Int128 の範囲内で表現できない場合、結果のオーバーフローまたはアンダーフローが発生します。 これはエラーとは見なされません。
返される値
この関数は ゼロに向かって丸める を使用し、数字の小数点以下の桁を切り捨てます。
例
クエリ:
結果:
関連項目
toInt128OrDefault
toInt128
と同様に、この関数は入力値を Int128 型に変換しますが、エラーが発生した場合はデフォルト値を返します。
デフォルト値が指定されていない場合、エラーが発生した場合は 0
が返されます。
構文
引数
サポートされている引数:
- (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。
- この関数は ゼロに向かって丸める を使用し、数字の小数点以下の桁を切り捨てます。
- デフォルト値の型はキャスト型と同じである必要があります。
例
クエリ:
結果:
関連項目
toInt256
入力値を Int256
型に変換します。エラーが発生した場合は例外をスローします。
構文
引数
expr
— 数字または数字の文字列表現を返す式。 式。
サポートされている引数:
- (U)Int8/16/32/64/128/256 の値または文字列表現。
- Float32/64 の値。
サポートされていない引数:
- Float32/64 値の文字列表現、
NaN
およびInf
を含む。 - バイナリおよび16進数の文字列表現、例:
SELECT toInt256('0xc0fe');
。
入力値が Int256 の範囲内で表現できない場合、結果のオーバーフローまたはアンダーフローが発生します。 これはエラーとは見なされません。
返される値
- 256 ビット整数値。 Int256。
この関数は ゼロに向かって丸める を使用し、数字の小数点以下の桁を切り捨てます。
例
クエリ:
結果:
関連項目
toInt256OrZero
toInt256
と同様に、この関数は入力値を Int256 型に変換しますが、エラーが発生した場合は 0
を返します。
構文
引数
x
— 数字の文字列表現。 文字列。
サポートされている引数:
- (U)Int8/16/32/128/256 の文字列表現。
サポートされていない引数(0
を返す):
- Float32/64 値の文字列表現,
NaN
およびInf
を含む。 - バイナリおよび16進数の文字列表現、例:
SELECT toInt256OrZero('0xc0fe');
。
入力値が Int256 の範囲内で表現できない場合、結果のオーバーフローまたはアンダーフローが発生します。 これはエラーとは見なされません。
返される値
- 成功した場合は 256 ビット整数値、それ以外の場合は
0
を返します。 Int256。
この関数は ゼロに向かって丸める を使用し、数字の小数点以下の桁を切り捨てます。
例
クエリ:
結果:
関連項目
toInt256OrNull
toInt256
と同様に、この関数は入力値を Int256 型に変換しますが、エラーが発生した場合は NULL
を返します。
構文
引数
x
— 数字の文字列表現。 文字列。
サポートされている引数:
- (U)Int8/16/32/128/256 の文字列表現。
サポートされていない引数(\N
を返す):
- Float32/64 値の文字列表現,
NaN
およびInf
を含む。 - バイナリおよび16進数の文字列表現、例:
SELECT toInt256OrNull('0xc0fe');
。
入力値が Int256 の範囲内で表現できない場合、結果のオーバーフローまたはアンダーフローが発生します。 これはエラーとは見なされません。
返される値
この関数は ゼロに向かって丸める を使用し、数字の小数点以下の桁を切り捨てます。
例
クエリ:
結果:
関連項目
toInt256OrDefault
toInt256
と同様に、この関数は入力値を Int256 型に変換しますが、エラーが発生した場合はデフォルト値を返します。
デフォルト値が指定されていない場合、エラーが発生した場合は 0
が返されます。
構文
引数
サポートされている引数:
- (U)Int8/16/32/64/128/256 の値または文字列表現。
- Float32/64 の値。
デフォルト値が返される引数:
- Float32/64 値の文字列表現、
NaN
およびInf
を含む。 - バイナリおよび16進数の文字列表現、例:
SELECT toInt256OrDefault('0xc0fe', CAST('-1', 'Int256'));
。
入力値が Int256 の範囲内で表現できない場合、結果のオーバーフローまたはアンダーフローが発生します。 これはエラーとは見なされません。
返される値
- 成功した場合は 256 ビット整数値、それ以外の場合はデフォルト値が指定された場合はそれを返し、指定されていない場合は
0
を返します。 Int256。
- この関数は ゼロに向かって丸める を使用し、数字の小数点以下の桁を切り捨てます。
- デフォルト値の型はキャスト型と同じである必要があります。
例
クエリ:
結果:
関連項目
toUInt8
入力値を UInt8
型に変換します。エラーが発生した場合は例外をスローします。
構文
引数
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。
この関数は ゼロに向かって丸める を使用し、数字の小数点以下の桁を切り捨てます。
例
クエリ:
結果:
関連項目
toUInt8OrZero
toUInt8
と同様に、この関数は入力値を UInt8 型に変換しますが、エラーが発生した場合は 0
を返します。
構文
引数
x
— 数字の文字列表現。 文字列。
サポートされている引数:
- (U)Int8/16/32/128/256 の文字列表現。
サポートされていない引数(0
を返す):
- 通常の Float32/64 値の文字列表現、
NaN
およびInf
を含む。 - バイナリおよび16進数の文字列表現、例:
SELECT toUInt8OrZero('0xc0fe');
。
入力値が UInt8 の範囲内で表現できない場合、結果のオーバーフローまたはアンダーフローが発生します。 これはエラーとは見なされません。
返される値
- 成功した場合は 8 ビット符号なし整数値、それ以外の場合は
0
を返します。 UInt8。
この関数は ゼロに向かって丸める を使用し、数字の小数点以下の桁を切り捨てます。
例
クエリ:
結果:
関連項目
toUInt8OrNull
toUInt8
と同様に、この関数は入力値を UInt8 型に変換しますが、エラーが発生した場合は NULL
を返します。
構文
引数
x
— 数字の文字列表現。 文字列。
サポートされている引数:
- (U)Int8/16/32/128/256 の文字列表現。
サポートされていない引数(\N
を返す):
- Float32/64 値の文字列表現、
NaN
およびInf
を含む。 - バイナリおよび16進数の文字列表現、例:
SELECT toUInt8OrNull('0xc0fe');
。
入力値が UInt8 の範囲内で表現できない場合、結果のオーバーフローまたはアンダーフローが発生します。 これはエラーとは見なされません。
返される値
この関数は ゼロに向かって丸める を使用し、数字の小数点以下の桁を切り捨てます。
例
クエリ:
結果:
関連項目
toUInt8OrDefault
toUInt8
と同様に、この関数は入力値を UInt8 型に変換しますが、エラーが発生した場合はデフォルト値を返します。
デフォルト値が指定されていない場合、エラーが発生した場合は 0
が返されます。
構文
引数
サポートされている引数:
- (U)Int8/16/32/64/128/256 の値または文字列表現。
- Float32/64 の値。
デフォルト値が返される引数:
- Float32/64 値の文字列表現、
NaN
およびInf
を含む。 - バイナリおよび16進数の文字列表現、例:
SELECT toUInt8OrDefault('0xc0fe', CAST('0', 'UInt8'));
。
入力値が UInt8 の範囲内で表現できない場合、結果のオーバーフローまたはアンダーフローが発生します。 これはエラーとは見なされません。
返される値
- 成功した場合は 8 ビット符号なし整数値、それ以外の場合はデフォルト値が指定された場合はそれを返し、指定されていない場合は
0
を返します。 UInt8。
- この関数は ゼロに向かって丸める を使用し、数字の小数点以下の桁を切り捨てます。
- デフォルト値の型はキャスト型と同じである必要があります。
例
クエリ:
結果:
関連項目
toUInt16
入力値を UInt16
型に変換します。エラーが発生した場合は例外をスローします。
構文
引数
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。
この関数は ゼロに向かって丸める を使用し、数字の小数点以下の桁を切り捨てます。
例
クエリ:
結果:
関連項目
toUInt16OrZero
toUInt16
と同様に、この関数は入力値を UInt16 型に変換しますが、エラーが発生した場合は 0
を返します。
構文
引数
x
— 数字の文字列表現。 文字列。
サポートされている引数:
- (U)Int8/16/32/128/256 の文字列表現。
サポートされていない引数(0
を返す):
- Float32/64 値の文字列表現、
NaN
およびInf
を含む。 - バイナリおよび16進数の文字列表現、例:
SELECT toUInt16OrZero('0xc0fe');
。
入力値が UInt16 の範囲内で表現できない場合、結果のオーバーフローまたはアンダーフローが発生します。 これはエラーとは見なされません。
返される値
- 成功した場合は 16 ビット符号なし整数値、それ以外の場合は
0
を返します。 UInt16。
この関数は ゼロに向かって丸める を使用し、数字の小数点以下の桁を切り捨てます。
例
クエリ:
結果:
関連項目
toUInt16OrNull
toUInt16
と同様に、この関数は入力値を UInt16 型に変換しますが、エラーが発生した場合は NULL
を返します。
構文
引数
x
— 数字の文字列表現。 文字列。
サポートされている引数:
- (U)Int8/16/32/128/256 の文字列表現。
サポートされていない引数(\N
を返す):
- Float32/64 値の文字列表現、
NaN
およびInf
を含む。 - バイナリおよび16進数の文字列表現、例:
SELECT toUInt16OrNull('0xc0fe');
。
入力値が UInt16 の範囲内で表現できない場合、結果のオーバーフローまたはアンダーフローが発生します。 これはエラーとは見なされません。
返される値
この関数は ゼロに向かって丸める を使用し、数字の小数点以下の桁を切り捨てます。
例
クエリ:
結果:
関連項目
toUInt16OrDefault
toUInt16
と同様に、この関数は入力値を UInt16 型に変換しますが、エラーが発生した場合はデフォルト値を返します。
デフォルト値が指定されていない場合、エラーが発生した場合は 0
が返されます。
構文
引数
サポートされている引数:
- (U)Int8/16/32/64/128/256 の値または文字列表現。
- Float32/64 の値。
デフォルト値が返される引数:
- Float32/64 値の文字列表現、
NaN
およびInf
を含む。 - バイナリおよび16進数の文字列表現、例:
SELECT toUInt16OrDefault('0xc0fe', CAST('0', 'UInt16'));
。
入力値が UInt16 の範囲内で表現できない場合、結果のオーバーフローまたはアンダーフローが発生します。 これはエラーとは見なされません。
返される値
- 成功した場合は 16 ビット符号なし整数値、それ以外の場合はデフォルト値が指定された場合はそれを返し、指定されていない場合は
0
を返します。 UInt16。
- この関数は ゼロに向かって丸める を使用し、数字の小数点以下の桁を切り捨てます。
- デフォルト値の型はキャスト型と同じである必要があります。
例
クエリ:
結果:
関連項目
toUInt32
入力値を UInt32
型に変換します。エラーが発生した場合は例外をスローします。
構文
引数
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。
この関数は ゼロに向かって丸める を使用し、数字の小数点以下の桁を切り捨てます。
例
クエリ:
結果:
関連項目
toUInt32OrZero
toUInt32
と同様に、この関数は入力値を UInt32 型に変換しますが、エラーが発生した場合は 0
を返します。
構文
引数
x
— 数字の文字列表現。 文字列。
サポートされている引数:
- (U)Int8/16/32/128/256 の文字列表現。
サポートされていない引数(0
を返す):
- Float32/64 値の文字列表現、
NaN
およびInf
を含む。 - バイナリおよび16進数の文字列表現、例:
SELECT toUInt32OrZero('0xc0fe');
。
入力値が UInt32 の範囲内で表現できない場合、結果のオーバーフローまたはアンダーフローが発生します。 これはエラーとは見なされません。
返される値
- 成功した場合は 32 ビット符号なし整数値、それ以外の場合は
0
を返します。 UInt32
この関数は ゼロに向かって丸める , 意味する数字の小数点以下の桁を切り捨てます。
例
クエリ:
結果:
関連項目
toUInt32OrNull
toUInt32
と同様に、この関数は入力値を UInt32 型に変換しますが、エラーが発生した場合は NULL
を返します。
構文
引数
x
— 数字の文字列表現。 文字列。
サポートされている引数:
- (U)Int8/16/32/128/256 の文字列表現。
サポートされていない引数(\N
を返す):
- Float32/64 値の文字列表現、
NaN
およびInf
を含む。 - バイナリおよび16進数の文字列表現、例:
SELECT toUInt32OrNull('0xc0fe');
。
入力値が 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。
- 関数はゼロに向かって切り捨てを使用しており、これにより数値の小数点以下が切り捨てられます。
- デフォルト値の型はキャストされた型と同じである必要があります。
例
クエリ:
結果:
関連項目
toUInt64
入力値をUInt64
型の値に変換します。エラーが発生した場合は例外をスローします。
構文
引数
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。
関数はゼロに向かって切り捨てを使用しており、これにより数値の小数点以下が切り捨てられます。
例
クエリ:
結果:
関連項目
toUInt64OrZero
toUInt64
と同様に、この関数は入力値をUInt64型の値に変換しますが、エラーが発生した場合は0
を返します。
構文
引数
x
— 数値を表す文字列。 文字列。
サポートされている引数:
- (U)Int8/16/32/128/256の文字列表現。
サポートされていない引数(0
を返す):
NaN
やInf
を含むFloat32/64の文字列表現。SELECT toUInt64OrZero('0xc0fe');
のような2進数および16進数の文字列表現。
入力値がUInt64の範囲内に表現できない場合、結果のオーバーフローまたはアンダーフローが発生します。 これはエラーとは見なされません。
返される値
- 成功した場合は64ビットの符号なし整数値、それ以外の場合は
0
。 UInt64。
関数はゼロに向かって切り捨てを使用しており、これにより数値の小数点以下が切り捨てられます。
例
クエリ:
結果:
関連項目
toUInt64OrNull
toUInt64
と同様に、この関数は入力値をUInt64型の値に変換しますが、エラーが発生した場合はNULL
を返します。
構文
引数
サポートされている引数:
- (U)Int8/16/32/128/256の文字列表現。
サポートされていない引数(\N
を返す):
NaN
やInf
を含むFloat32/64の文字列表現。SELECT toUInt64OrNull('0xc0fe');
のような2進数および16進数の文字列表現。
入力値がUInt64の範囲内に表現できない場合、結果のオーバーフローまたはアンダーフローが発生します。 これはエラーとは見なされません。
返される値
関数はゼロに向かって切り捨てを使用しており、これにより数値の小数点以下が切り捨てられます。
例
クエリ:
結果:
関連項目
toUInt64OrDefault
toUInt64
と同様に、この関数は入力値をUInt64型の値に変換しますが、エラーが発生した場合はデフォルト値を返します。
デフォルト値が指定されていない場合は、エラーが発生した場合に0
が返されます。
構文
引数
サポートされている引数:
- (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。
- 関数はゼロに向かって切り捨てを使用しており、これにより数値の小数点以下が切り捨てられます。
- デフォルト値の型はキャストされた型と同じである必要があります。
例
クエリ:
結果:
関連項目
toUInt128
入力値をUInt128
型の値に変換します。エラーが発生した場合は例外をスローします。
構文
引数
expr
— 数値または数値の文字列表現を返す式。 式。
サポートされている引数:
- (U)Int8/16/32/64/128/256型の値または文字列表現。
- Float32/64型の値。
サポートされていない引数:
NaN
やInf
を含むFloat32/64の文字列表現。SELECT toUInt128('0xc0fe');
のような2進数および16進数の文字列表現。
入力値がUInt128の範囲内に表現できない場合、結果のオーバーフローまたはアンダーフローが発生します。 これはエラーとは見なされません。
返される値
- 128ビットの符号なし整数値。 UInt128。
関数はゼロに向かって切り捨てを使用しており、これにより数値の小数点以下が切り捨てられます。
例
クエリ:
結果:
関連項目
toUInt128OrZero
toUInt128
と同様に、この関数は入力値をUInt128型の値に変換しますが、エラーが発生した場合は0
を返します。
構文
引数
サポートされている引数:
- (U)Int8/16/32/128/256の文字列表現。
サポートされていない引数(0
を返す):
NaN
やInf
を含むFloat32/64の文字列表現。SELECT toUInt128OrZero('0xc0fe');
のような2進数および16進数の文字列表現。
入力値がUInt128の範囲内に表現できない場合、結果のオーバーフローまたはアンダーフローが発生します。 これはエラーとは見なされません。
返される値
- 成功した場合は128ビットの符号なし整数値、それ以外の場合は
0
。 UInt128。
関数はゼロに向かって切り捨てを使用しており、これにより数値の小数点以下が切り捨てられます。
例
クエリ:
結果:
関連項目
toUInt128OrNull
toUInt128
と同様に、この関数は入力値をUInt128型の値に変換しますが、エラーが発生した場合はNULL
を返します。
構文
引数
サポートされている引数:
- (U)Int8/16/32/128/256の文字列表現。
サポートされていない引数(\N
を返す):
NaN
やInf
を含むFloat32/64の文字列表現。SELECT toUInt128OrNull('0xc0fe');
のような2進数および16進数の文字列表現。
入力値がUInt128の範囲内に表現できない場合、結果のオーバーフローまたはアンダーフローが発生します。 これはエラーとは見なされません。
返される値
関数はゼロに向かって切り捨てを使用しており、これにより数値の小数点以下が切り捨てられます。
例
クエリ:
結果:
関連項目
toUInt128OrDefault
toUInt128
と同様に、この関数は入力値をUInt128型の値に変換しますが、エラーが発生した場合はデフォルト値を返します。
デフォルト値が指定されていない場合は、エラーが発生した場合に0
が返されます。
構文
引数
サポートされている引数:
- (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。
- 関数はゼロに向かって切り捨てを使用しており、これにより数値の小数点以下が切り捨てられます。
- デフォルト値の型はキャストされた型と同じである必要があります。
例
クエリ:
結果:
関連項目
toUInt256
入力値をUInt256
型の値に変換します。エラーが発生した場合は例外をスローします。
構文
引数
expr
— 数値または数値の文字列表現を返す式。 式。
サポートされている引数:
- (U)Int8/16/32/64/128/256型の値または文字列表現。
- Float32/64型の値。
サポートされていない引数:
NaN
やInf
を含むFloat32/64の文字列表現。SELECT toUInt256('0xc0fe');
のような2進数および16進数の文字列表現。
入力値がUInt256の範囲内に表現できない場合、結果のオーバーフローまたはアンダーフローが発生します。 これはエラーとは見なされません。
返される値
- 256ビットの符号なし整数値。 Int256。
関数はゼロに向かって切り捨てを使用しており、これにより数値の小数点以下が切り捨てられます。
例
クエリ:
結果:
関連項目
toUInt256OrZero
toUInt256
と同様に、この関数は入力値をUInt256型の値に変換しますが、エラーが発生した場合は0
を返します。
構文
引数
x
— 数値を表す文字列。 文字列。
サポートされている引数:
- (U)Int8/16/32/128/256の文字列表現。
サポートされていない引数(0
を返す):
NaN
やInf
を含むFloat32/64の文字列表現。SELECT toUInt256OrZero('0xc0fe');
のような2進数および16進数の文字列表現。
入力値がUInt256の範囲内に表現できない場合、結果のオーバーフローまたはアンダーフローが発生します。 これはエラーとは見なされません。
返される値
- 成功した場合は256ビットの符号なし整数値、それ以外の場合は
0
。 UInt256。
関数はゼロに向かって切り捨てを使用しており、これにより数値の小数点以下が切り捨てられます。
例
クエリ:
結果:
関連項目
toUInt256OrNull
toUInt256
と同様に、この関数は入力値をUInt256型の値に変換しますが、エラーが発生した場合はNULL
を返します。
構文
引数
x
— 数値を表す文字列。 文字列。
サポートされている引数:
- (U)Int8/16/32/128/256の文字列表現。
サポートされていない引数(\N
を返す):
NaN
やInf
を含むFloat32/64の文字列表現。SELECT toUInt256OrNull('0xc0fe');
のような2進数および16進数の文字列表現。
入力値がUInt256の範囲内に表現できない場合、結果のオーバーフローまたはアンダーフローが発生します。 これはエラーとは見なされません。
返される値
関数はゼロに向かって切り捨てを使用しており、これにより数値の小数点以下が切り捨てられます。
例
クエリ:
結果:
関連項目
toUInt256OrDefault
toUInt256
と同様に、この関数は入力値をUInt256型の値に変換しますが、エラーが発生した場合はデフォルト値を返します。
デフォルト値が指定されていない場合は、エラーが発生した場合に0
が返されます。
構文
引数
サポートされている引数:
- (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。
- 関数はゼロに向かって切り捨てを使用しており、これにより数値の小数点以下が切り捨てられます。
- デフォルト値の型はキャストされた型と同じである必要があります。
例
クエリ:
結果:
関連項目
toFloat32
入力値をFloat32
型の値に変換します。エラーが発生した場合は例外をスローします。
構文
引数
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。
例
クエリ:
結果:
関連項目
toFloat32OrZero
toFloat32
と同様に、この関数は入力値をFloat32型の値に変換しますが、エラーが発生した場合は0
を返します。
構文
引数
x
— 数値を表す文字列。 文字列。
サポートされている引数:
- (U)Int8/16/32/128/256、Float32/64の文字列表現。
サポートされていない引数(0
を返す):
SELECT toFloat32OrZero('0xc0fe');
のような2進数および16進数の文字列表現。
返される値
- 成功した場合は32ビットのFloat値、それ以外の場合は
0
。 Float32。
例
クエリ:
結果:
関連項目
toFloat32OrNull
toFloat32
と同様に、この関数は入力値をFloat32型の値に変換しますが、エラーが発生した場合はNULL
を返します。
構文
引数
x
— 数値を表す文字列。 文字列。
サポートされている引数:
- (U)Int8/16/32/128/256、Float32/64の文字列表現。
サポートされていない引数(\N
を返す):
SELECT toFloat32OrNull('0xc0fe');
のような2進数および16進数の文字列表現。
返される値
- 成功した場合は32ビットのFloat値、それ以外の場合は
\N
。 Float32。
例
クエリ:
結果:
関連項目
toFloat32OrDefault
toFloat32
と同様に、この関数は入力値をFloat32型の値に変換しますが、エラーが発生した場合はデフォルト値を返します。
デフォルト値が指定されていない場合は、エラーが発生した場合に0
が返されます。
構文
引数
サポートされている引数:
- (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。
例
クエリ:
結果:
関連項目
toFloat64
入力値をFloat64
型の値に変換します。エラーが発生した場合は例外をスローします。
構文
引数
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。
例
クエリ:
結果:
関連項目
toFloat64OrZero
toFloat64
と同様に、この関数は入力値をFloat64型の値に変換しますが、エラーが発生した場合は0
を返します。
構文
引数
x
— 数値を表す文字列。 文字列。
サポートされている引数:
- (U)Int8/16/32/128/256、Float32/64の文字列表現。
サポートされていない引数(0
を返す):
SELECT toFloat64OrZero('0xc0fe');
のような2進数および16進数の文字列表現。
返される値
- 成功した場合は64ビットのFloat値、それ以外の場合は
0
。 Float64。
例
クエリ:
結果:
関連項目
toFloat64OrNull
toFloat64
と同様に、この関数は入力値をFloat64型の値に変換しますが、エラーが発生した場合はNULL
を返します。
構文
引数
x
— 数値を表す文字列。 文字列。
サポートされている引数:
- (U)Int8/16/32/128/256、Float32/64の文字列表現。
サポートされていない引数(\N
を返す):
SELECT toFloat64OrNull('0xc0fe');
のような2進数および16進数の文字列表現。
返される値
- 成功した場合は64ビットのFloat値、それ以外の場合は
\N
。 Float64。
例
クエリ:
結果:
関連項目
toFloat64OrDefault
toFloat64
と同様に、この関数は入力値を Float64 型の値に変換しますが、エラーが発生した場合にはデフォルト値を返します。
default
値が渡されなかった場合は、エラー時に 0
が返されます。
構文
引数
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。
例
クエリ:
結果:
関連項目
toBFloat16
入力値を BFloat16
型の値に変換します。
エラーが発生した場合には例外がスローされます。
構文
引数
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。
例
関連項目
toBFloat16OrZero
String 入力値を BFloat16
型の値に変換します。
文字列が浮動小数点値を表していない場合、関数はゼロを返します。
構文
引数
x
— 数値の文字列表現。 String。
サポートされている引数:
- 数値の文字列表現。
サポートされていない引数(0
を返します):
- バイナリおよび16進数値の文字列表現。
- 数値の値。
返される値
- 16ビットのブレインフロート値、そうでなければ
0
。 BFloat16。
この関数は文字列表現からの変換中に精度の損失を黙って許可します。
例
関連項目
toBFloat16OrNull
String 入力値を BFloat16
型の値に変換しますが、文字列が浮動小数点値を表していない場合、関数は NULL
を返します。
構文
引数
x
— 数値の文字列表現。 String。
サポートされている引数:
- 数値の文字列表現。
サポートされていない引数(NULL
を返します):
- バイナリおよび16進数値の文字列表現。
- 数値の値。
返される値
- 16ビットのブレインフロート値、そうでなければ
NULL
(\N
)。 BFloat16。
この関数は文字列表現からの変換中に精度の損失を黙って許可します。
例
関連項目
toDate
引数を Date データ型に変換します。
引数が DateTime または DateTime64 の場合、それは切り捨てられ、DateTime の日付コンポーネントが残ります:
引数が String の場合、Date または DateTime として解析されます。 それが DateTime として解析された場合、日付コンポーネントが使用されます:
引数が数値であり、UNIX タイムスタンプのように見える場合(65535 より大きい)、それは DateTime として解釈され、その後、現在のタイムゾーンで Date に切り捨てられます。 タイムゾーン引数は、関数の第二引数として指定できます。Date への切り捨てはタイムゾーンに依存します:
上記の例は、同じ UNIX タイムスタンプが異なるタイムゾーンで異なる日付として解釈される方法を示しています。
引数が数値であり、65536 より小さい場合、それは1970-01-01 からの日数(最初の UNIX 日)として解釈され、Date に変換されます。これは Date
データ型の内部的な数値表現に該当します。例:
この変換はタイムゾーンに依存しません。
引数が Date 型の範囲に当てはまらない場合、実装依存の動作を生成し、最大サポート日付に saturation するかオーバーフローで終了する可能性があります:
関数 toDate
は、別の形式でも書くことができます:
toDateOrZero
toDate と同様ですが、無効な引数が与えられた場合には Date の下限を返します。 サポートされているのは String 引数のみです。
例
クエリ:
結果:
toDateOrNull
toDate と同様ですが、無効な引数が与えられた場合には NULL
を返します。 サポートされているのは String 引数のみです。
例
クエリ:
結果:
toDateOrDefault
toDate と同様ですが、失敗した場合は、第二引数(指定されている場合)または Date の下限値を返します。
構文
例
クエリ:
結果:
toDateTime
入力値を DateTime に変換します。
構文
引数
expr
が数値の場合、それはUnix エポックの始まりからの秒数(Unix タイムスタンプ)として解釈されます。
expr
が String の場合、Unix タイムスタンプまたは日付 / 時間の文字列表現として解釈される場合があります。
したがって、短い数字の文字列表現(最大4桁)はあいまい性のために明示的に無効となっており、例えば文字列 '1999'
は年(未完成の文字列表現の日付 / 日付時刻)または Unix タイムスタンプの両方を意味する可能性があります。 より長い数値の文字列は許可されています。
返される値
- 日付と時間。 DateTime
例
クエリ:
結果:
toDateTimeOrZero
toDateTime と同様ですが、無効な引数が与えられた場合には DateTime の下限を返します。 サポートされているのは String 引数のみです。
例
クエリ:
結果:
toDateTimeOrNull
toDateTime と同様ですが、無効な引数が与えられた場合には NULL
を返します。 サポートされているのは String 引数のみです。
例
クエリ:
結果:
toDateTimeOrDefault
toDateTime と同様ですが、失敗した場合は、第三引数(指定されている場合)または DateTime の下限値を返します。
構文
例
クエリ:
結果:
toDate32
引数を Date32 データ型に変換します。 値が範囲外の場合、toDate32
は Date32 がサポートする境界値を返します。 引数が Date 型の場合、その境界が考慮されます。
構文
引数
返される値
- カレンダーの日付。 型は Date32。
例
- 値が範囲内にある場合:
- 値が範囲外の場合:
- Date 引数で:
toDate32OrZero
toDate32 と同様ですが、無効な引数が与えられた場合には Date32 の最小値を返します。
例
クエリ:
結果:
toDate32OrNull
toDate32 と同様ですが、無効な引数が与えられた場合には NULL
を返します。
例
クエリ:
結果:
toDate32OrDefault
引数を Date32 データ型に変換します。 値が範囲外の場合、toDate32OrDefault
は Date32 がサポートする下限値を返します。 引数が Date 型の場合、その境界が考慮されます。 無効な引数が与えられた場合はデフォルト値を返します。
例
クエリ:
結果:
toDateTime64
入力値を DateTime64 型の値に変換します。
構文
引数
expr
— 値。 String、UInt32、Float、または DateTime。scale
- チックサイズ(精度):10-精度 秒。 有効範囲:[ 0 : 9 ]。timezone
(オプション) - 指定した datetime64 オブジェクトのタイムゾーン。
返される値
- カレンダーの日付と一日の時間。 サブ秒精度あり。 DateTime64。
例
- 値が範囲内にある場合:
- 精度を持つ小数の場合:
小数点なしでは、値は Unix タイムスタンプとして秒単位で扱われます。
timezone
あり:
toDateTime64OrZero
toDateTime64 と同様に、この関数は入力値を DateTime64 型の値に変換しますが、無効な引数が与えられた場合には DateTime64 の最小値を返します。
構文
引数
expr
— 値。 String、UInt32、Float、または DateTime。scale
- チックサイズ(精度):10-精度 秒。 有効範囲:[ 0 : 9 ]。timezone
(オプション) - 指定した DateTime64 オブジェクトのタイムゾーン。
返される値
- カレンダーの日付と一日の時間。 サブ秒精度あり、無効な場合は
DateTime64
の最小値:1970-01-01 01:00:00.000
。 DateTime64。
例
クエリ:
結果:
関連項目
toDateTime64OrNull
toDateTime64 と同様に、この関数は入力値を DateTime64 型の値に変換しますが、無効な引数が与えられた場合には NULL
を返します。
構文
引数
expr
— 値。 String、UInt32、Float、または DateTime。scale
- チックサイズ(精度):10-精度 秒。 有効範囲:[ 0 : 9 ]。timezone
(オプション) - 指定した DateTime64 オブジェクトのタイムゾーン。
返される値
- カレンダーの日付と一日の時間。 サブ秒精度あり、無効な場合は
NULL
。 DateTime64/NULL。
例
クエリ:
結果:
関連項目
toDateTime64OrDefault
toDateTime64 と同様に、この関数は入力値を DateTime64 型の値に変換しますが、無効な引数が与えられた場合には DateTime64 のデフォルト値または提供されたデフォルト値を返します。
構文
引数
expr
— 値。 String、UInt32、Float、または DateTime。scale
- チックサイズ(精度):10-精度 秒。 有効範囲:[ 0 : 9 ]。timezone
(オプション) - 指定した DateTime64 オブジェクトのタイムゾーン。default
(オプション) - 無効な引数が与えられた場合に返されるデフォルト値。 DateTime64。
返される値
- カレンダーの日付と一日の時間。 サブ秒精度あり、無効な場合は
DateTime64
の最小値または提供されたdefault
値。 DateTime64。
例
クエリ:
結果:
関連項目
toDecimal32
入力値を Decimal(9, S)
型の値に変換します。 スケール 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)。
例
クエリ:
結果:
関連項目
toDecimal32OrZero
toDecimal32
と同様に、この関数は入力値を Decimal(9, S) 型の値に変換しますが、エラーが発生した場合には 0
を返します。
構文
引数
サポートされている引数:
- (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)。
例
クエリ:
結果:
関連項目
toDecimal32OrNull
toDecimal32
と同様に、この関数は入力値を Nullable(Decimal(9, S)) 型の値に変換しますが、エラーが発生した場合には 0
を返します。
構文
引数
サポートされている引数:
- (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)。
例
クエリ:
結果:
関連項目
引数
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).
例
クエリ:
結果:
関連項目
toDecimal64
入力値をスケール S
を持つ Decimal(18, 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).
例
クエリ:
結果:
関連項目
toDecimal64OrZero
toDecimal64
と同様に、この関数は入力値を Decimal(18, S) 型の値に変換しますが、エラーが発生した場合は 0
を返します。
構文
引数
サポートされている引数:
- (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).
例
クエリ:
結果:
関連項目
toDecimal64OrNull
toDecimal64
と同様に、この関数は入力値を Nullable(Decimal(18, S)) 型の値に変換しますが、エラーが発生した場合は 0
を返します。
構文
引数
サポートされている引数:
- (U)Int8/16/32/64/128/256型の文字列表現。
- Float32/64型の文字列表現。
サポートされていない引数:
- Float32/64値
NaN
とInf
の文字列表現。 - バイナリおよび16進数値の文字列表現、例:
SELECT toDecimal64OrNull('0xc0fe', 1);
.
expr
の値が Decimal64
の範囲を超えるとオーバーフローが発生する可能性があります: ( -1 * 10^(18 - S), 1 * 10^(18 - S) )
.
小数部分の過剰な桁は切り捨てられます(丸められません)。
整数部分の過剰な桁はエラーを引き起こします。
返される値
- 成功した場合は
Nullable(Decimal(18, S))
型の値を返し、そうでない場合は同じ型のNULL
値を返します。 Decimal64(S).
例
クエリ:
結果:
関連項目
toDecimal64OrDefault
toDecimal64
と同様に、この関数は入力値を Decimal(18, S) 型の値に変換しますが、エラーが発生した場合はデフォルト値を返します。
構文
引数
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);
.
expr
の値が Decimal64
の範囲を超えるとオーバーフローが発生する可能性があります: ( -1 * 10^(18 - S), 1 * 10^(18 - S) )
.
小数部分の過剰な桁は切り捨てられます(丸められません)。
整数部分の過剰な桁はエラーを引き起こします。
変換処理において、余分な桁がドロップされ、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).
例
クエリ:
結果:
関連項目
toDecimal128
入力値をスケール S
を持つ Decimal(38, 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).
例
クエリ:
結果:
関連項目
toDecimal128OrZero
toDecimal128
と同様に、この関数は入力値を Decimal(38, S) 型の値に変換しますが、エラーが発生した場合は 0
を返します。
構文
引数
サポートされている引数:
- (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).
例
クエリ:
結果:
関連項目
toDecimal128OrNull
toDecimal128
と同様に、この関数は入力値を Nullable(Decimal(38, S)) 型の値に変換しますが、エラーが発生した場合は 0
を返します。
構文
引数
サポートされている引数:
- (U)Int8/16/32/64/128/256型の文字列表現。
- Float32/64型の文字列表現。
サポートされていない引数:
- Float32/64値
NaN
とInf
の文字列表現。 - バイナリおよび16進数値の文字列表現、例:
SELECT toDecimal128OrNull('0xc0fe', 1);
.
expr
の値が Decimal128
の範囲を超えるとオーバーフローが発生する可能性があります: ( -1 * 10^(38 - S), 1 * 10^(38 - S) )
.
小数部分の過剰な桁は切り捨てられます(丸められません)。
整数部分の過剰な桁はエラーを引き起こします。
返される値
- 成功した場合は
Nullable(Decimal(38, S))
型の値を返し、そうでない場合は同じ型のNULL
値を返します。 Decimal128(S).
例
クエリ:
結果:
関連項目
toDecimal128OrDefault
toDecimal128
と同様に、この関数は入力値を Decimal(38, S) 型の値に変換しますが、エラーが発生した場合はデフォルト値を返します。
構文
引数
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);
.
expr
の値が Decimal128
の範囲を超えるとオーバーフローが発生する可能性があります: ( -1 * 10^(38 - S), 1 * 10^(38 - S) )
.
小数部分の過剰な桁は切り捨てられます(丸められません)。
整数部分の過剰な桁はエラーを引き起こします。
変換処理において、余分な桁がドロップされ、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).
例
クエリ:
結果:
関連項目
toDecimal256
入力値をスケール S
を持つ Decimal(76, 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).
例
クエリ:
結果:
関連項目
toDecimal256OrZero
toDecimal256
と同様に、この関数は入力値を Decimal(76, S) 型の値に変換しますが、エラーが発生した場合は 0
を返します。
構文
引数
サポートされている引数:
- (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).
例
クエリ:
結果:
関連項目
toDecimal256OrNull
toDecimal256
と同様に、この関数は入力値を Nullable(Decimal(76, S)) 型の値に変換しますが、エラーが発生した場合は 0
を返します。
構文
引数
サポートされている引数:
- (U)Int8/16/32/64/128/256型の文字列表現。
- Float32/64型の文字列表現。
サポートされていない引数:
- Float32/64値
NaN
とInf
の文字列表現。 - バイナリおよび16進数値の文字列表現、例:
SELECT toDecimal256OrNull('0xc0fe', 1);
.
expr
の値が Decimal256
の範囲を超えるとオーバーフローが発生する可能性があります: ( -1 * 10^(76 - S), 1 * 10^(76 - S) )
.
小数部分の過剰な桁は切り捨てられます(丸められません)。
整数部分の過剰な桁はエラーを引き起こします。
返される値
- 成功した場合は
Nullable(Decimal(76, S))
型の値を返し、そうでない場合は同じ型のNULL
値を返します。 Decimal256(S).
例
クエリ:
結果:
関連項目
toDecimal256OrDefault
toDecimal256
と同様に、この関数は入力値を Decimal(76, S) 型の値に変換しますが、エラーが発生した場合はデフォルト値を返します。
構文
引数
expr
— 数字の文字列表現。 String.S
— 数字の小数部に持つことができる桁数を指定する0から76までのスケールパラメータ。 UInt8.default
(オプション) —Decimal256(S)
型へのパースが失敗した場合に返されるデフォルト値。 Decimal256(S).
サポートされている引数:
- (U)Int8/16/32/64/128/256型の文字列表現。
- Float32/64型の文字列表現。
サポートされていない引数:
- Float32/64値
NaN
とInf
の文字列表現。 - バイナリおよび16進数値の文字列表現、例:
SELECT toDecimal256OrDefault('0xc0fe', 1);
.
expr
の値が Decimal256
の範囲を超えるとオーバーフローが発生する可能性があります: ( -1 * 10^(76 - S), 1 * 10^(76 - S) )
.
小数部分の過剰な桁は切り捨てられます(丸められません)。
整数部分の過剰な桁はエラーを引き起こします。
変換処理において、余分な桁がドロップされ、Float32/Float64入力を扱う際には予期しない動作をする可能性があります。操作は浮動小数点命令を使用して行われます。
例えば: toDecimal256OrDefault(1.15, 2)
は 1.14
に等しいです。なぜなら、1.15 * 100 が浮動小数点では114.99になるからです。
文字列入力を使用することで、操作は基になる整数型を使用できます: toDecimal256OrDefault('1.15', 2) = 1.15
返される値
- 成功した場合は
Decimal(76, S)
型の値を返し、そうでない場合は渡されたデフォルト値を返すか、渡されなかった場合は0
を返します。 Decimal256(S).
例
クエリ:
結果:
関連項目
toString
数字、文字列(固定文字列ではない)、日付、および日時の間で変換する関数。 これらの関数はすべて1つの引数を受け取ります。
文字列への変換または文字列からの変換を行う際、値はTabSeparated形式(およびほぼすべての他のテキスト形式)に対して同じルールを使用してフォーマットまたは解析されます。文字列を解析できない場合、例外がスローされ、リクエストがキャンセルされます。
日付を数値に変換する場合、またはその逆において、日付はUnixエポックの開始からの日数を表します。 日時を数値に変換する場合、またはその逆において、日時はUnixエポックの開始からの秒数を表します。
toDate/toDateTime関数の日付および日時形式は以下のように定義されます:
例外として、UInt32、Int32、UInt64、またはInt64の数値型から日付に変換する場合、かつ、数値が65536以上である場合、その数値はUnixタイムスタンプとして解釈され(日数としてではなく)、日付に丸められます。これにより、toDate(unix_timestamp)
を書き込む一般的な発生をサポートします。さもなければエラーが発生し、より面倒なtoDate(toDateTime(unix_timestamp))
を書く必要があります。
日付と日時の間の変換は、自然な方法で行われます:nullの時間を追加するか、時間を削除します。
数値型間の変換は、C++における異なる数値型間の代入と同じルールを使用します。
さらに、DateTime引数のtoString関数は、タイムゾーン名を含む2番目の文字列引数を受け取ることができます。例: Asia/Yekaterinburg
この場合、時間は指定されたタイムゾーンに従ってフォーマットされます。
例
クエリ:
結果:
また、toUnixTimestamp
関数も参照してください。
toFixedString
文字列型の引数をFixedString(N)型(固定長Nの文字列)に変換します。文字列のバイト数がN未満の場合、右側にヌルバイトでパディングされます。文字列のバイト数がNを超える場合、例外がスローされます。
構文
引数
返される値
s
のN長固定文字列です。FixedString。
例
クエリ:
結果:
toStringCutToZero
文字列またはFixedString引数を受け取ります。最初に見つかったヌルバイトで切り捨てられた文字列を返します。
構文
例
クエリ:
結果:
クエリ:
結果:
toDecimalString
数値を文字列に変換し、出力の小数点以下の桁数をユーザーが指定します。
構文
引数
返される値
- 指定された小数点以下の桁数(スケール)を持つ文字列として表現された入力値。要求されたスケールが元の数値のスケールよりも小さい場合、数値は一般的な算術に従って丸められます。
例
クエリ:
結果:
reinterpretAsUInt8
入力値をUInt8型の値として扱うことによってバイト再解釈を行います。CAST
とは異なり、元の値を保持しようとはしていません。ターゲット型が入力型を表現できない場合、出力は意味を持ちません。
構文
引数
返される値
- 再解釈された値
x
をUInt8として。UInt8。
例
クエリ:
結果:
reinterpretAsUInt16
入力値をUInt16型の値として扱うことによってバイト再解釈を行います。CAST
とは異なり、元の値を保持しようとはしていません。ターゲット型が入力型を表現できない場合、出力は意味を持ちません。
構文
引数
返される値
- 再解釈された値
x
をUInt16として。UInt16。
例
クエリ:
結果:
reinterpretAsUInt32
入力値をUInt32型の値として扱うことによってバイト再解釈を行います。CAST
とは異なり、元の値を保持しようとはしていません。ターゲット型が入力型を表現できない場合、出力は意味を持ちません。
構文
引数
返される値
- 再解釈された値
x
をUInt32として。UInt32。
例
クエリ:
結果:
reinterpretAsUInt64
入力値をUInt64型の値として扱うことによってバイト再解釈を行います。CAST
とは異なり、元の値を保持しようとはしていません。ターゲット型が入力型を表現できない場合、出力は意味を持ちません。
構文
引数
返される値
- 再解釈された値
x
をUInt64として。UInt64。
例
クエリ:
結果:
reinterpretAsUInt128
入力値をUInt128型の値として扱うことによってバイト再解釈を行います。CAST
とは異なり、元の値を保持しようとはしていません。ターゲット型が入力型を表現できない場合、出力は意味を持ちません。
構文
引数
返される値
- 再解釈された値
x
をUInt128として。UInt128。
例
クエリ:
結果:
reinterpretAsUInt256
入力値をUInt256型の値として扱うことによってバイト再解釈を行います。CAST
とは異なり、元の値を保持しようとはしていません。ターゲット型が入力型を表現できない場合、出力は意味を持ちません。
構文
引数
返される値
- 再解釈された値
x
をUInt256として。UInt256。
例
クエリ:
結果:
reinterpretAsInt8
入力値をInt8型の値として扱うことによってバイト再解釈を行います。CAST
とは異なり、元の値を保持しようとはしていません。ターゲット型が入力型を表現できない場合、出力は意味を持ちません。
構文
引数
返される値
- 再解釈された値
x
をInt8として。Int8。
例
クエリ:
結果:
reinterpretAsInt16
入力値をInt16型の値として扱うことによってバイト再解釈を行います。CAST
とは異なり、元の値を保持しようとはしていません。ターゲット型が入力型を表現できない場合、出力は意味を持ちません。
構文
引数
返される値
- 再解釈された値
x
をInt16として。Int16。
例
クエリ:
結果:
reinterpretAsInt32
入力値をInt32型の値として扱うことによってバイト再解釈を行います。CAST
とは異なり、元の値を保持しようとはしていません。ターゲット型が入力型を表現できない場合、出力は意味を持ちません。
構文
引数
返される値
- 再解釈された値
x
をInt32として。Int32。
例
クエリ:
結果:
reinterpretAsInt64
入力値をInt64型の値として扱うことによってバイト再解釈を行います。CAST
とは異なり、元の値を保持しようとはしていません。ターゲット型が入力型を表現できない場合、出力は意味を持ちません。
構文
引数
返される値
- 再解釈された値
x
をInt64として。Int64。
例
クエリ:
結果:
reinterpretAsInt128
入力値をInt128型の値として扱うことによってバイト再解釈を行います。CAST
とは異なり、元の値を保持しようとはしていません。ターゲット型が入力型を表現できない場合、出力は意味を持ちません。
構文
引数
返される値
- 再解釈された値
x
をInt128として。Int128。
例
クエリ:
結果:
reinterpretAsInt256
入力値をInt256型の値として扱うことによってバイト再解釈を行います。CAST
とは異なり、元の値を保持しようとはしていません。ターゲット型が入力型を表現できない場合、出力は意味を持ちません。
構文
引数
返される値
- 再解釈された値
x
をInt256として。Int256。
例
クエリ:
結果:
reinterpretAsFloat32
入力値をFloat32型の値として扱うことによってバイト再解釈を行います。CAST
とは異なり、元の値を保持しようとはしていません。ターゲット型が入力型を表現できない場合、出力は意味を持ちません。
構文
引数
返される値
- 再解釈された値
x
をFloat32として。Float32。
例
クエリ:
結果:
reinterpretAsFloat64
入力値をFloat64型の値として扱うことによってバイト再解釈を行います。CAST
とは異なり、元の値を保持しようとはしていません。ターゲット型が入力型を表現できない場合、出力は意味を持ちません。
構文
引数
返される値
- 再解釈された値
x
をFloat64として。Float64。
例
クエリ:
結果:
reinterpretAsDate
文字列、固定文字列、または数値を受け取り、ホストオーダー(リトルエンディアン)で数値としてバイトを解釈します。Unix Epochの始まり以来の日数として解釈された数値から日付を返します。
構文
引数
返される値
- 日付。Date。
実装に関する詳細
提供された文字列が十分な長さでない場合、関数は、必要な数のヌルバイトでパディングされた文字列として動作します。文字列が必要よりも長い場合、余分なバイトは無視されます。
例
クエリ:
結果:
reinterpretAsDateTime
これらの関数は文字列を受け取り、文字列の先頭に配置されたバイトをホストオーダー(リトルエンディアン)で数値として解釈します。Unix Epochの始まり以来の秒数として解釈された数値から日付と時刻を返します。
構文
引数
返される値
- 日付と時刻。DateTime。
実装に関する詳細
提供された文字列が十分な長さでない場合、関数は、必要な数のヌルバイトでパディングされた文字列として動作します。文字列が必要よりも長い場合、余分なバイトは無視されます。
例
クエリ:
結果:
reinterpretAsString
この関数は数値、日付、または時刻付きの日付を受け取り、ホストオーダー(リトルエンディアン)で対応する値を表すバイトを含む文字列を返します。ヌルバイトは末尾から削除されます。たとえば、UInt32型の値255は、1バイトの長さの文字列になります。
構文
引数
返される値
x
を表すバイトを含む文字列。String。
例
クエリ:
結果:
reinterpretAsFixedString
この関数は数値、日付、または時刻付きの日付を受け取り、ホストオーダー(リトルエンディアン)で対応する値を表すバイトを含むFixedStringを返します。ヌルバイトは末尾から削除されます。たとえば、UInt32型の値255は、1バイトの長さのFixedStringになります。
構文
引数
返される値
x
を表すバイトを含むFixedString。FixedString。
例
クエリ:
結果:
reinterpretAsUUID
ここにリストされているUUID関数に加えて、専用のUUID関数ドキュメントもあります。
16バイトの文字列を受け取り、各8バイトの半分をリトルエンディアンバイト順で解釈してUUIDを返します。文字列が十分な長さでない場合、関数は、必要な数のヌルバイトで末尾までパディングされた文字列として動作します。文字列が16バイトを超える場合、末尾の余分なバイトは無視されます。
構文
引数
fixed_string
— ビッグエンディアンバイト文字列。FixedString。
返される値
- UUID型の値。UUID。
例
文字列からUUIDへの変換。
クエリ:
結果:
文字列とUUIDの往復変換。
クエリ:
結果:
reinterpret
メモリ内の同じバイトシーケンスをx
値に使用し、これをターゲット型に再解釈します。
構文
引数
x
— 任意の型。type
— ターゲット型。文字列。
返される値
- ターゲット型の値。
例
クエリ:
結果:
CAST
入力値を指定されたデータ型に変換します。reinterpret関数とは異なり、CAST
は新しいデータ型を使用して同じ値を表すことを試みます。変換できない場合、例外が発生します。
いくつかの構文バリアントがサポートされています。
構文
引数
x
— 変換する値。任意の型であることができます。T
— ターゲットデータ型の名前。文字列。t
— ターゲットデータ型。
返される値
- 変換された値。
入力値がターゲット型の範囲に収まらない場合、結果はオーバーフローします。例えば、CAST(-1, 'UInt8')
は255
を返します。
例
クエリ:
結果:
クエリ:
結果:
FixedString (N)への変換は、文字列型またはFixedString型の引数に対してのみ機能します。
Nullable型への型変換とその逆もサポートされています。
例
クエリ:
結果:
クエリ:
結果:
参照
accurateCast(x, T)
x
をT
データ型に変換します。
castとの違いは、accurateCast
は型値x
が型T
の範囲に収まらない場合、数値型のオーバーフローを許可しない点です。例えば、accurateCast(-1, 'UInt8')
は例外をスローします。
例
クエリ:
結果:
クエリ:
結果:
accurateCastOrNull(x, T)
入力値x
を指定されたデータ型T
に変換します。常にNullable型を返し、キャストした値がターゲット型で表現できない場合はNULLを返します。
構文
引数
x
— 入力値。T
— 返されるデータ型の名前。
返される値
- 指定されたデータ型
T
に変換された値。
例
クエリ:
結果:
クエリ:
結果:
accurateCastOrDefault(x, T[, default_value])
入力値 x
を指定されたデータ型 T
に変換します。キャストされた値がターゲット型で表現可能でない場合は、デフォルトの型値または指定した default_value
を返します。
構文
引数
x
— 入力値。T
— 返されるデータ型の名称。default_value
— 返されるデータ型のデフォルト値。
返される値
- 指定されたデータ型
T
に変換された値。
例
クエリ:
結果:
クエリ:
結果:
toInterval
数値と間隔単位(例: 'second' や 'day')から Interval データ型の値を作成します。
構文
引数
-
value
— インターバルの長さ。整数またはその文字列表現、および浮動小数点数。(U)Int*/Float*/String。 -
unit
— 作成するインターバルの型。String Literal。 可能な値:nanosecond
microsecond
millisecond
second
minute
hour
day
week
month
quarter
year
unit
引数は大文字と小文字を区別しません。
返される値
- 結果のインターバル。Interval
例
toIntervalYear
データ型 IntervalYear の n
年のインターバルを返します。
構文
引数
返される値
n
年のインターバル。IntervalYear。
例
クエリ:
結果:
toIntervalQuarter
データ型 IntervalQuarter の n
四半期のインターバルを返します。
構文
引数
返される値
n
四半期のインターバル。IntervalQuarter。
例
クエリ:
結果:
toIntervalMonth
データ型 IntervalMonth の n
月のインターバルを返します。
構文
引数
返される値
n
月のインターバル。IntervalMonth。
例
クエリ:
結果:
toIntervalWeek
データ型 IntervalWeek の n
週間のインターバルを返します。
構文
引数
返される値
n
週間のインターバル。IntervalWeek。
例
クエリ:
結果:
toIntervalDay
データ型 IntervalDay の n
日のインターバルを返します。
構文
引数
返される値
n
日のインターバル。IntervalDay。
例
クエリ:
結果:
toIntervalHour
データ型 IntervalHour の n
時間のインターバルを返します。
構文
引数
返される値
n
時間のインターバル。IntervalHour。
例
クエリ:
結果:
toIntervalMinute
データ型 IntervalMinute の n
分のインターバルを返します。
構文
引数
返される値
n
分のインターバル。IntervalMinute。
例
クエリ:
結果:
toIntervalSecond
データ型 IntervalSecond の n
秒のインターバルを返します。
構文
引数
返される値
n
秒のインターバル。IntervalSecond。
例
クエリ:
結果:
toIntervalMillisecond
データ型 IntervalMillisecond の n
ミリ秒のインターバルを返します。
構文
引数
返される値
n
ミリ秒のインターバル。IntervalMilliseconds。
例
クエリ:
結果:
toIntervalMicrosecond
データ型 IntervalMicrosecond の n
マイクロ秒のインターバルを返します。
構文
引数
返される値
n
マイクロ秒のインターバル。IntervalMicrosecond。
例
クエリ:
結果:
toIntervalNanosecond
データ型 IntervalNanosecond の n
ナノ秒のインターバルを返します。
構文
引数
返される値
n
ナノ秒のインターバル。IntervalNanosecond。
例
クエリ:
結果:
parseDateTime
MySQL フォーマット文字列 に従って、String を DateTime に変換します。
この関数は、関数 formatDateTime の逆操作です。
構文
引数
str
— パース対象の文字列format
— フォーマット文字列。省略時は%Y-%m-%d %H:%i:%s
です。timezone
— Timezone。省略可能。
返される値
入力文字列から MySQLスタイルのフォーマット文字列に従ってパースした DateTime 値を返します。
サポートされているフォーマット指定子
formatDateTime にリストされているすべてのフォーマット指定子。ただし:
- %Q: 四半期 (1-4)
例
エイリアス: TO_TIMESTAMP
.
parseDateTimeOrZero
parseDateTime と同様ですが、処理できない日付フォーマットに遭遇した場合はゼロの日付を返します。
parseDateTimeOrNull
parseDateTime と同様ですが、処理できない日付フォーマットに遭遇した場合は NULL
を返します。
エイリアス: str_to_date
.
parseDateTimeInJodaSyntax
parseDateTime と似ていますが、フォーマット文字列が MySQL 構文の代わりに Joda にあります。
この関数は、関数 formatDateTimeInJodaSyntax の逆操作です。
構文
引数
str
— パース対象の文字列format
— フォーマット文字列。省略時はyyyy-MM-dd HH:mm:ss
です。timezone
— Timezone。省略可能。
返される値
入力文字列から Jodaスタイルのフォーマット文字列に従ってパースした DateTime 値を返します。
サポートされているフォーマット指定子
すべてのフォーマット指定子は formatDateTimeInJoda にリストされていますが、次のものは除外されます:
- S: 小数秒
- z: タイムゾーン
- Z: タイムゾーンオフセット/ID
例
parseDateTimeInJodaSyntaxOrZero
parseDateTimeInJodaSyntax と同様ですが、処理できない日付フォーマットに遭遇した場合はゼロの日付を返します。
parseDateTimeInJodaSyntaxOrNull
parseDateTimeInJodaSyntax と同様ですが、処理できない日付フォーマットに遭遇した場合は NULL
を返します。
parseDateTime64
MySQL フォーマット文字列 に従って、String を DateTime64 に変換します。
構文
引数
str
— パース対象の文字列。format
— フォーマット文字列。省略時は%Y-%m-%d %H:%i:%s.%f
です。timezone
— Timezone。省略可能。
返される値
入力文字列から MySQLスタイルのフォーマット文字列に従ってパースした DateTime64 値を返します。 返される値の精度は 6 です。
parseDateTime64OrZero
parseDateTime64 と同様ですが、処理できない日付フォーマットに遭遇した場合はゼロの日付を返します。
parseDateTime64OrNull
parseDateTime64 と同様ですが、処理できない日付フォーマットに遭遇した場合は NULL
を返します。
parseDateTime64InJodaSyntax
Jodaフォーマット文字列 に従って String を DateTime64 に変換します。
構文
引数
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 のおよびその他のいくつかの日時形式をパースします。
構文
引数
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 データ型に変換します。
例
クエリ:
結果:
クエリ:
結果:
クエリ:
結果:
クエリ:
結果:
クエリ:
結果:
クエリ:
結果:
関連項目
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 データ型を返します。
構文
引数
time_string
— 変換される日付または日付と時刻を含む文字列。String。precision
— 必須の精度。3
— ミリ秒用、6
— マイクロ秒用。デフォルトは3
です。省略可能。UInt8。time_zone
— Timezone。この関数はtime_string
をタイムゾーンに従ってパースします。省略可能。String。
返される値
time_string
を DateTime データ型に変換します。
例
クエリ:
結果:
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)
。
構文
引数
expr
— 一つの supported data types の結果となる Expression。
返される値
expr
の結果。LowCardinality のexpr
の型。
例
クエリ:
結果:
toUnixTimestamp64Second
DateTime64
を固定秒精度の Int64
値に変換します。入力値は、その精度に応じて適切にスケールアップまたはダウンされます。
出力値は UTC のタイムスタンプであり、DateTime64
のタイムゾーンではありません。
構文
引数
value
— 任意の精度の DateTime64 値。DateTime64。
返される値
value
をInt64
データ型に変換します。Int64。
例
クエリ:
結果:
toUnixTimestamp64Milli
DateTime64
を固定ミリ秒精度の Int64
値に変換します。入力値は、その精度に応じて適切にスケールアップまたはダウンされます。
出力値は UTC のタイムスタンプであり、DateTime64
のタイムゾーンではありません。
構文
引数
value
— 任意の精度の DateTime64 値。DateTime64。
返される値
value
をInt64
データ型に変換します。Int64。
例
クエリ:
結果:
toUnixTimestamp64Micro
DateTime64
を固定マイクロ秒精度の Int64
値に変換します。入力値は、その精度に応じて適切にスケールアップまたはダウンされます。
出力値は UTC のタイムスタンプであり、DateTime64
のタイムゾーンではありません。
構文
引数
value
— 任意の精度の DateTime64 値。DateTime64。
返される値
value
をInt64
データ型に変換します。Int64。
例
クエリ:
結果:
toUnixTimestamp64Nano
DateTime64
を固定ナノ秒精度のInt64
値に変換します。入力値は、その精度に応じて適切にスケーリングされます。
出力値はUTCのタイムスタンプであり、DateTime64
のタイムゾーンではありません。
構文
引数
value
— 任意の精度を持つDateTime64値。 DateTime64。
返される値
value
がInt64
データ型に変換されます。 Int64。
例
クエリ:
結果:
fromUnixTimestamp64Second
Int64
を固定秒精度のDateTime64
値に変換し、オプションのタイムゾーンを指定できます。入力値は、その精度に応じて適切にスケーリングされます。
入力値はUTCタイムスタンプとして扱われることに注意してください。指定された(または暗黙の)タイムゾーンでのタイムスタンプではありません。
構文
引数
返される値
- 精度
0
のDateTime64に変換されたvalue
。 DateTime64。
例
クエリ:
結果:
fromUnixTimestamp64Milli
Int64
を固定ミリ秒精度のDateTime64
値に変換し、オプションのタイムゾーンを指定できます。入力値は、その精度に応じて適切にスケーリングされます。
入力値はUTCタイムスタンプとして扱われることに注意してください。指定された(または暗黙の)タイムゾーンでのタイムスタンプではありません。
構文
引数
返される値
- 精度
3
のDateTime64に変換されたvalue
。 DateTime64。
例
クエリ:
結果:
fromUnixTimestamp64Micro
Int64
を固定マイクロ秒精度のDateTime64
値に変換し、オプションのタイムゾーンを指定できます。入力値は、その精度に応じて適切にスケーリングされます。
入力値はUTCタイムスタンプとして扱われることに注意してください。指定された(または暗黙の)タイムゾーンでのタイムスタンプではありません。
構文
引数
返される値
- 精度
6
のDateTime64に変換されたvalue
。 DateTime64。
例
クエリ:
結果:
fromUnixTimestamp64Nano
Int64
を固定ナノ秒精度のDateTime64
値に変換し、オプションのタイムゾーンを指定できます。入力値は、その精度に応じて適切にスケーリングされます。
入力値はUTCタイムスタンプとして扱われることに注意してください。指定された(または暗黙の)タイムゾーンでのタイムスタンプではありません。
構文
引数
返される値
- 精度
9
のDateTime64に変換されたvalue
。 DateTime64。
例
クエリ:
結果:
formatRow
任意の式を指定された形式の文字列に変換します。
構文
引数
返される値
- フォーマットされた文字列。(テキスト形式の場合、通常は改行文字で終了します)。
例
クエリ:
結果:
注: フォーマットに接頭辞/接尾辞が含まれている場合、各行に書き込まれます。
例
クエリ:
結果:
注: この関数では行ベースのフォーマットのみがサポートされています。
formatRowNoNewline
任意の式を指定された形式の文字列に変換します。formatRowとの違いは、この関数が最後の\n
をトリミングする点です。
構文
引数
返される値
- フォーマットされた文字列。
例
クエリ:
結果: