Help wanted!
The following content of this documentation page has been machine-translated. But unlike other websites, it is not done on the fly. This translated text lives on GitHub repository alongside main ClickHouse codebase and waits for fellow native speakers to make it more human-readable. You can also use the original English version as a reference.
型変換関数
数値変換の一般的な問題
あるデータ型から別のデータ型に値を変換する場合、一般的なケースでは、データ損失につながる危険な操作であることを覚えておく必要があります。 大きいデータ型から小さいデータ型に値を近似しようとする場合、または異なるデータ型間で値を変換する場合、データ損失が発生する可能性があります。
クリックハウスは C++プログラムと同じ動作.
トイント(8/16/32/64)
入力値を Int データ型。 この関数ファミ:
toInt8(expr)
— Results in theInt8
データ型。toInt16(expr)
— Results in theInt16
データ型。toInt32(expr)
— Results in theInt32
データ型。toInt64(expr)
— Results in theInt64
データ型。
パラメータ
expr
— 式 数値または数値の十進表現を持つ文字列を返します。 数値の二進表現、八進表現、進表現はサポートされていません。 先頭のゼロは削除されます。
戻り値
の整数値 Int8
, Int16
, Int32
,または Int64
データ型。
関数の使用 ゼロへの丸め つまり、数字の小数部の数字を切り捨てます。
に対する関数の振る舞い NaNおよびInf 引数は未定義です。 覚えておいて 数値変換の問題、関数を使用する場合。
例
SELECT toInt64(nan), toInt32(32), toInt16('16'), toInt8(8.8)
┌─────────toInt64(nan)─┬─toInt32(32)─┬─toInt16('16')─┬─toInt8(8.8)─┐
│ -9223372036854775808 │ 32 │ 16 │ 8 │
└──────────────────────┴─────────────┴───────────────┴─────────────┘
toInt(8/16/32/64)OrZero
String型の引数を取り、それをIntに解析しようとします(8 | 16 | 32 | 64). 失敗した場合は0を返します。
例
select toInt64OrZero('123123'), toInt8OrZero('123qwe123')
┌─toInt64OrZero('123123')─┬─toInt8OrZero('123qwe123')─┐
│ 123123 │ 0 │
└─────────────────────────┴───────────────────────────┘
toInt(8/16/32/64)OrNull
String型の引数を取り、それをIntに解析しようとします(8 | 16 | 32 | 64). 失敗した場合はNULLを返します。
例
select toInt64OrNull('123123'), toInt8OrNull('123qwe123')
┌─toInt64OrNull('123123')─┬─toInt8OrNull('123qwe123')─┐
│ 123123 │ ᴺᵁᴸᴸ │
└─────────────────────────┴───────────────────────────┘
トゥイント(8/16/32/64)
入力値を UInt データ型。 この関数ファミ:
toUInt8(expr)
— Results in theUInt8
データ型。toUInt16(expr)
— Results in theUInt16
データ型。toUInt32(expr)
— Results in theUInt32
データ型。toUInt64(expr)
— Results in theUInt64
データ型。
パラメータ
expr
— 式 数値または数値の十進表現を持つ文字列を返します。 数値の二進表現、八進表現、進表現はサポートされていません。 先頭のゼロは削除されます。
戻り値
の整数値 UInt8
, UInt16
, UInt32
,または UInt64
データ型。
関数の使用 ゼロへの丸め つまり、数字の小数部の数字を切り捨てます。
負の関数に対する関数の振る舞いと NaNおよびInf 引数は未定義です。 負の数の文字列を渡すと、次のようになります '-32'
,ClickHouseは例外を発生させます。 覚えておいて 数値変換の問題、関数を使用する場合。
例
SELECT toUInt64(nan), toUInt32(-32), toUInt16('16'), toUInt8(8.8)
┌───────toUInt64(nan)─┬─toUInt32(-32)─┬─toUInt16('16')─┬─toUInt8(8.8)─┐
│ 9223372036854775808 │ 4294967264 │ 16 │ 8 │
└─────────────────────┴───────────────┴────────────────┴──────────────┘
トゥイント(8/16/32/64)オルゼロ
トゥイント(8/16/32/64)OrNull
トフロア(32/64)
toFloat(32/64)OrZero
toFloat(32/64)OrNull
東立(とうだて
トダテオルゼロ
toDateOrNull
toDateTime
トダティメオルゼロ
toDateTimeOrNull
トデシマル(32/64/128)
変換 value
に 小数点 精度の高いデータ型 S
. その value
数値または文字列を指定できます。 その S
(scale)パラメータは、小数点以下の桁数を指定します。
toDecimal32(value, S)
toDecimal64(value, S)
toDecimal128(value, S)
toDecimal(32/64/128)OrNull
入力文字列をaに変換します Nullable(Decimal(P,S))) データ型の値。 このファミリの機能など:
toDecimal32OrNull(expr, S)
— Results inNullable(Decimal32(S))
データ型。toDecimal64OrNull(expr, S)
— Results inNullable(Decimal64(S))
データ型。toDecimal128OrNull(expr, S)
— Results inNullable(Decimal128(S))
データ型。
これらの関数は、 toDecimal*()
あなたが得ることを好むならば、関数 NULL
入力値の解析エラーが発生した場合の例外ではなく、値。
パラメータ
expr
— 式 の値を返します。 文字列 データ型。 ClickHouseは、十進数のテキスト表現を想定しています。 例えば,'1.111'
.S
— Scale, the number of decimal places in the resulting value.
戻り値
の値 Nullable(Decimal(P,S))
データ型。 この値を含む:
- との数
S
ClickHouseが入力文字列を数値として解釈する場合は、小数点以下の桁数。 NULL
、ClickHouseが入力文字列を数値として解釈できない場合、または入力番号に以下のものが含まれている場合S
小数点以下の桁数。
例
SELECT toDecimal32OrNull(toString(-1.111), 5) AS val, toTypeName(val)
┌──────val─┬─toTypeName(toDecimal32OrNull(toString(-1.111), 5))─┐
│ -1.11100 │ Nullable(Decimal(9, 5)) │
└──────────┴────────────────────────────────────────────────────┘
SELECT toDecimal32OrNull(toString(-1.111), 2) AS val, toTypeName(val)
┌──val─┬─toTypeName(toDecimal32OrNull(toString(-1.111), 2))─┐
│ ᴺᵁᴸᴸ │ Nullable(Decimal(9, 2)) │
└──────┴────────────────────────────────────────────────────┘
toDecimal(32/64/128)OrZero
入力値を 小数(P,S) データ型。 このファミリの機能など:
toDecimal32OrZero( expr, S)
— Results inDecimal32(S)
データ型。toDecimal64OrZero( expr, S)
— Results inDecimal64(S)
データ型。toDecimal128OrZero( expr, S)
— Results inDecimal128(S)
データ型。
これらの関数は、 toDecimal*()
あなたが得ることを好むならば、関数 0
入力値の解析エラーが発生した場合の例外ではなく、値。
パラメータ
expr
— 式 の値を返します。 文字列 データ型。 ClickHouseは、十進数のテキスト表現を想定しています。 例えば,'1.111'
.S
— Scale, the number of decimal places in the resulting value.
戻り値
の値 Nullable(Decimal(P,S))
データ型。 この値を含む:
- との数
S
ClickHouseが入力文字列を数値として解釈する場合は、小数点以下の桁数。 - 0とともに
S
ClickHouseが入力文字列を数値として解釈できない場合、または入力番号に以下のものが含まれている場合は、小数点以下の桁数S
小数点以下の桁数。
例
SELECT toDecimal32OrZero(toString(-1.111), 5) AS val, toTypeName(val)
┌──────val─┬─toTypeName(toDecimal32OrZero(toString(-1.111), 5))─┐
│ -1.11100 │ Decimal(9, 5) │
└──────────┴────────────────────────────────────────────────────┘
SELECT toDecimal32OrZero(toString(-1.111), 2) AS val, toTypeName(val)
┌──val─┬─toTypeName(toDecimal32OrZero(toString(-1.111), 2))─┐
│ 0.00 │ Decimal(9, 2) │
└──────┴────────────────────────────────────────────────────┘
toString
数値、文字列(ただし、固定文字列ではありません)、日付、および時刻を持つ日付の間で変換するための関数。
これら全ての機能を受け入れを一つの引数。
文字列との間で変換する場合、値はTabSeparated形式(およびほとんどすべての他のテキスト形式)と同じ規則を使用して書式設定または解析されます。 文字列を解析できない場合は、例外がスローされ、要求がキャンセルされます。
日付を数値に変換する場合、またはその逆の場合、日付はUnixエポックの開始からの日数に対応します。
時刻付きの日付を数値に変換する場合、またはその逆の場合、時刻付きの日付はUnixエポックの開始からの秒数に対応します。
ToDate/toDateTime関数の日付および日付と時刻の形式は、次のように定義されます:
YYYY-MM-DD
YYYY-MM-DD hh:mm:ss
例外として、uint32、Int32、UInt64、またはInt64の数値型からDateに変換する場合、数値が65536以上の場合、数値はUnixタイムスタンプとして解釈され(日数ではなく)、日付 この支援のための共通の発生を書く ‘toDate(unix_timestamp)’ それ以外の場合はエラーになり、より面倒な書き込みが必要になります ‘toDate(toDateTime(unix_timestamp))’.
日付と時刻の間の変換は、null時間を追加するか、時間を削除することによって、自然な方法で実行されます。
数値型間の変換では、C++の異なる数値型間の代入と同じ規則が使用されます。
さらに、DateTime引数のtoString関数は、タイムゾーンの名前を含む第二の文字列引数を取ることができます。 例: Asia/Yekaterinburg
この場合、時刻は指定されたタイムゾーンに従って書式設定されます。
SELECT
now() AS now_local,
toString(now(), 'Asia/Yekaterinburg') AS now_yekat
┌───────────now_local─┬─now_yekat───────────┐
│ 2016-06-15 00:11:21 │ 2016-06-15 02:11:21 │
└─────────────────────┴─────────────────────┘
また、 toUnixTimestamp
機能。
toFixedString(s,N)
文字列型の引数をFixedString(N)型(固定長Nの文字列)に変換します。 Nは定数でなければなりません。
文字列のバイト数がNより少ない場合は、右側にnullバイトが埋め込まれます。 文字列のバイト数がNより多い場合は、例外がスローされます。
トストリングカットゼロ(s)
文字列またはFixedString引数を受け取ります。 見つかった最初のゼロバイトで切り捨てられた内容の文字列を返します。
例:
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 │
└────────────┴───────┘
再解釈(8/16/32/64)
再解釈(8/16/32/64)
reinterpretAsFloat(32/64)
再解釈日
データの再解釈
これらの関数は、文字列を受け入れ、文字列の先頭に置かれたバイトをホスト順(リトルエンディアン)の数値として解釈します。 文字列が十分な長さでない場合、関数は文字列がnullバイトの必要な数で埋め込まれているかのように動作します。 文字列が必要以上に長い場合、余分なバイトは無視されます。 日付はUnixエポックの開始からの日数として解釈され、時刻を持つ日付はUnixエポックの開始からの秒数として解釈されます。
再解釈
この関数は、数値または日付または日付と時刻を受け入れ、対応する値をホスト順(リトルエンディアン)で表すバイトを含む文字列を返します。 Nullバイトは末尾から削除されます。 たとえば、UInt32型の値255は、バイト長の文字列です。
reinterpretAsFixedString
この関数は、数値または日付または日付と時刻を受け取り、ホスト順(リトルエンディアン)で対応する値を表すバイトを含むFixedStringを返します。 Nullバイトは末尾から削除されます。 たとえば、UInt32型の値255は、バイト長のFixedStringです。
キャスト(x,T)
変換 ‘x’ に ‘t’ データ型。 構文CAST(x AS t)もサポートされています。
例:
SELECT
'2016-06-15 23:00:00' AS timestamp,
CAST(timestamp AS DateTime) AS datetime,
CAST(timestamp AS Date) AS date,
CAST(timestamp, 'String') AS string,
CAST(timestamp, 'FixedString(22)') AS fixed_string
┌─timestamp───────────┬────────────datetime─┬───────date─┬─string──────────────┬─fixed_string──────────────┐
│ 2016-06-15 23:00:00 │ 2016-06-15 23:00:00 │ 2016-06-15 │ 2016-06-15 23:00:00 │ 2016-06-15 23:00:00\0\0\0 │
└─────────────────────┴─────────────────────┴────────────┴─────────────────────┴───────────────────────────┘
FixedString(N)への変換は、String型またはFixedString(N)型の引数に対してのみ機能します。
タイプ変換 Null可能 そして背部は支えられる。 例:
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) │
└─────────────────────────────────────────┘
toInterval(年/四半期|月/週|日|時/分/秒)
数値型引数を 間隔 データ型。
構文
toIntervalSecond(number)
toIntervalMinute(number)
toIntervalHour(number)
toIntervalDay(number)
toIntervalWeek(number)
toIntervalMonth(number)
toIntervalQuarter(number)
toIntervalYear(number)
パラメータ
number
— Duration of interval. Positive integer number.
戻り値
- の値
Interval
データ型。
例
WITH
toDate('2019-01-01') AS date,
INTERVAL 1 WEEK AS interval_week,
toIntervalWeek(1) AS interval_to_week
SELECT
date + interval_week,
date + interval_to_week
┌─plus(date, interval_week)─┬─plus(date, interval_to_week)─┐
│ 2019-01-08 │ 2019-01-08 │
└───────────────────────────┴──────────────────────────────┘
parseDateTimeBestEffort
の日付と時刻を変換します。 文字列 への表現 DateTime データ型。
関数は解析します ISO 8601, RFC1123-5.2.14RFC-822日付と時刻の仕様、ClickHouseのといくつかの他の日付と時刻の形式。
構文
parseDateTimeBestEffort(time_string [, time_zone]);
パラメータ
time_string
— String containing a date and time to convert. 文字列.time_zone
— Time zone. The function parsestime_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
. この場合YYYY-MM
と置き換えられる。2000-01
. - 日付と時刻とタイムゾーンのオフセット情報を含む文字列:
YYYY-MM-DD hh:mm:ss ±h:mm
など。 例えば,2020-12-12 17:36:00 -5:00
.
区切り文字を持つすべての形式について、関数は月名をフルネームまたは月名の最初の三文字で表したものを解析します。 例: 24/DEC/18
, 24-Dec-18
, 01-September-2018
.
戻り値
time_string
に変換されます。DateTime
データ型。
例
クエリ:
SELECT parseDateTimeBestEffort('12/12/2020 12:12:57')
AS parseDateTimeBestEffort;
結果:
┌─parseDateTimeBestEffort─┐
│ 2020-12-12 12:12:57 │
└─────────────────────────┘
クエリ:
SELECT parseDateTimeBestEffort('Sat, 18 Aug 2018 07:22:16 GMT', 'Europe/Moscow')
AS parseDateTimeBestEffort
結果:
┌─parseDateTimeBestEffort─┐
│ 2018-08-18 10:22:16 │
└─────────────────────────┘
クエリ:
SELECT parseDateTimeBestEffort('1284101485')
AS parseDateTimeBestEffort
結果:
┌─parseDateTimeBestEffort─┐
│ 2015-07-07 12:04:41 │
└─────────────────────────┘
クエリ:
SELECT parseDateTimeBestEffort('2018-12-12 10:12:12')
AS parseDateTimeBestEffort
結果:
┌─parseDateTimeBestEffort─┐
│ 2018-12-12 10:12:12 │
└─────────────────────────┘
クエリ:
SELECT parseDateTimeBestEffort('10 20:19')
結果:
┌─parseDateTimeBestEffort('10 20:19')─┐
│ 2000-01-10 20:19:00 │
└─────────────────────────────────────┘
も参照。
- [ISO8601による発表 @xkcd](https://xkcd.com/1179/)
- RFC 1123
- 東立(とうだて
- toDateTime
parseDateTimeBestEffortOrNull
同じように parseDateTimeBestEffort ただし、処理できない日付形式が検出されるとnullが返されます。
parseDateTimeBestEffortOrZero
同じように parseDateTimeBestEffort ただし、処理できない日付形式が検出されたときにゼロの日付またはゼロの日付時刻を返します。