Функции преобразования типов

Распространённые проблемы при преобразовании данных

ClickHouse в целом использует те же правила, что и программы на C++. Функции to<type> и cast в некоторых случаях ведут себя по-разному, например для LowCardinality: cast удаляет признак LowCardinality, а функции to<type> — нет. То же самое и с Nullable: такое поведение несовместимо со стандартом SQL, и его можно изменить с помощью настройки cast_keep_nullable.

Учитывайте возможную потерю данных, если значения одного типа преобразуются в тип меньшего размера (например, из Int64 в Int32) или между несовместимыми типами данных (например, из String в Int). Обязательно внимательно проверяйте, соответствует ли результат ожидаемому.

Пример:

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

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

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

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

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

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

Примечания к функциям `toString`

Семейство функций toString позволяет преобразовывать числа, строки (но не строки фиксированной длины), даты и значения даты и времени. Все эти функции принимают один аргумент.

При преобразовании в строку или из строки значение форматируется или разбирается по тем же правилам, что и для формата TabSeparated (и почти всех остальных текстовых форматов). Если строку не удаётся разобрать, генерируется исключение, и запрос отменяется.
При преобразовании дат в числа или наоборот дата соответствует количеству дней с начала эпохи Unix.
При преобразовании значений даты и времени в числа или наоборот дата и время соответствуют количеству секунд с начала эпохи Unix.
Функция toString для аргумента DateTime может принимать второй аргумент типа String, содержащий имя часового пояса, например: Europe/Amsterdam. В этом случае время форматируется в соответствии с указанным часовым поясом.

Примечания к функциям `toDate`/`toDateTime`

Форматы даты и даты со временем для функций 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)). Преобразование между датой и значением типа дата и время выполняется естественным образом: добавлением нулевого времени или отбрасыванием времени. При преобразовании между числовыми типами используются те же правила, что и при присваивании между различными числовыми типами в C++. Пример

Query

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

Response

┌──────────────────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.

CAST

Добавленный в: v1.1.0 Преобразует значение в указанный тип данных. В отличие от функции reinterpret, CAST пытается получить то же значение в целевом типе. Если это невозможно, возникает исключение. Синтаксис

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

Аргументы

x — Значение любого типа. Any
T — Целевой тип данных. String

Возвращаемое значение Возвращает значение, преобразованное в целевой тип данных. Any Примеры Базовое использование

Query

SELECT CAST(42, 'String')

Response

┌─CAST(42, 'String')─┐
│ 42                 │
└────────────────────┘

Использование ключевого слова AS

Query

SELECT CAST('2025-01-01' AS Date)

Response

┌─CAST('2025-01-01', 'Date')─┐
│                 2025-01-01 │
└────────────────────────────┘

Использование синтаксиса ::

Query

SELECT '123'::UInt32

Response

┌─CAST('123', 'UInt32')─┐
│                   123 │
└───────────────────────┘

DATE

Добавленный в: v21.2.0 Преобразует аргумент в тип данных Date. Это псевдоним toDate для совместимости с MySQL. Работает так же, как toDate. Синтаксис

DATE(expr)

Аргументы

expr — Значение, которое необходимо преобразовать. String или UInt32 или Date или DateTime

Возвращаемое значение Возвращает значение типа Date. Date Примеры Базовое использование

Query

SELECT DATE('2023-01-01')

Response

2023-01-01

accurateCast

Добавленный в: v1.1.0 Преобразует значение в указанный тип данных. В отличие от CAST, accurateCast выполняет более строгую проверку типов и генерирует исключение, если преобразование приводит к потере точности данных или если такое преобразование невозможно. Эта функция безопаснее обычного CAST, поскольку предотвращает потерю точности и недопустимые преобразования. Синтаксис

accurateCast(x, T)

Аргументы

x — Значение для преобразования. Any
T — Имя целевого типа данных. String

Возвращаемое значение Возвращает преобразованное значение целевого типа данных. Any Примеры Успешное преобразование

Query

SELECT accurateCast(42, 'UInt16')

Response

┌─accurateCast(42, 'UInt16')─┐
│                        42 │
└───────────────────────────┘

String в число

Query

SELECT accurateCast('123.45', 'Float64')

Response

┌─accurateCast('123.45', 'Float64')─┐
│                            123.45 │
└───────────────────────────────────┘

accurateCastOrDefault

Добавленный в: v21.1.0 Преобразует значение в указанный тип данных. Как accurateCast, но, если преобразование нельзя выполнить без потери точности, возвращает значение по умолчанию вместо того, чтобы генерировать исключение. Если значение по умолчанию передаётся вторым аргументом, оно должно иметь целевой тип. Если значение по умолчанию не указано, используется значение по умолчанию для целевого типа. Синтаксис

accurateCastOrDefault(x, T[, default_value])

Аргументы

x — Значение для преобразования. Any
T — Имя целевого типа данных. const String
default_value — Необязательный параметр. Значение по умолчанию, которое возвращается, если преобразование не удалось. Any

Возвращаемое значение Возвращает преобразованное значение целевого типа данных или значение по умолчанию, если преобразование невозможно. Any Примеры Успешное преобразование

Query

SELECT accurateCastOrDefault(42, 'String')

Response

┌─accurateCastOrDefault(42, 'String')─┐
│ 42                                  │
└─────────────────────────────────────┘

Неудачное преобразование с явно заданным значением по умолчанию

Query

SELECT accurateCastOrDefault('abc', 'UInt32', 999::UInt32)

Response

┌─accurateCastOrDefault('abc', 'UInt32', 999)─┐
│                                         999 │
└─────────────────────────────────────────────┘

Сбой преобразования с неявным значением по умолчанию

Query

SELECT accurateCastOrDefault('abc', 'UInt32')

Response

┌─accurateCastOrDefault('abc', 'UInt32')─┐
│                                      0 │
└────────────────────────────────────────┘

accurateCastOrNull

Добавленный в: v1.1.0 Преобразует значение в указанный тип данных. Как и accurateCast, но возвращает NULL вместо того, чтобы генерировать исключение, если преобразование нельзя выполнить без потери точности. Эта функция сочетает безопасность accurateCast с удобной обработкой ошибок. Синтаксис

accurateCastOrNull(x, T)

Аргументы

x — Значение, которое нужно преобразовать. Any
T — Имя целевого типа данных. String

Возвращаемое значение Возвращает преобразованное значение целевого типа данных или NULL, если преобразование невозможно. Any Примеры Успешное преобразование

Query

SELECT accurateCastOrNull(42, 'String')

Response

┌─accurateCastOrNull(42, 'String')─┐
│ 42                               │
└──────────────────────────────────┘

При ошибке преобразования возвращается NULL

Query

SELECT accurateCastOrNull('abc', 'UInt32')

Response

┌─accurateCastOrNull('abc', 'UInt32')─┐
│                                ᴺᵁᴸᴸ │
└─────────────────────────────────────┘

formatRow

Добавленный в: v20.7.0 Преобразует произвольные выражения в строку в указанном формате.

Если формат содержит суффикс/префикс, они будут записываться в каждой строке. В этой функции поддерживаются только построчные форматы.

Синтаксис

formatRow(format, x, y, ...)

Аргументы

format — Текстовый формат. Например, CSV, TSV. String
x, y, ... — Выражения. Any

Возвращаемое значение Отформатированная строка. (для текстовых форматов она обычно заканчивается символом новой строки). String Примеры Базовое использование

Query

SELECT formatRow('CSV', number, 'good')
FROM numbers(3)

Response

┌─formatRow('CSV', number, 'good')─┐
│ 0,"good"
                         │
│ 1,"good"
                         │
│ 2,"good"
                         │
└──────────────────────────────────┘

В пользовательском формате

Query

SELECT formatRow('CustomSeparated', number, 'good')
FROM numbers(3)
SETTINGS format_custom_result_before_delimiter='<prefix>\n', format_custom_result_after_delimiter='<suffix>'

Response

┌─formatRow('CustomSeparated', number, 'good')─┐
│ <prefix>
0    good
<suffix>                   │
│ <prefix>
1    good
<suffix>                   │
│ <prefix>
2    good
<suffix>                   │
└──────────────────────────────────────────────┘

formatRowNoNewline

Добавленный в: v20.7.0 То же, что и formatRow, но без символа новой строки в конце каждой строки. Преобразует произвольные выражения в строку в указанном формате, но удаляет из результата все конечные символы новой строки. Синтаксис

formatRowNoNewline(format, x, y, ...)

Аргументы

format — Текстовый формат, например CSV или TSV. String
x, y, ... — Выражения. Any

Возвращаемое значение Возвращает отформатированную строку без символов новой строки. String Примеры Базовое использование

Query

SELECT formatRowNoNewline('CSV', number, 'good')
FROM numbers(3)

Response

┌─formatRowNoNewline('CSV', number, 'good')─┐
│ 0,"good"                                  │
│ 1,"good"                                  │
│ 2,"good"                                  │
└───────────────────────────────────────────┘

fromUnixTimestamp64Micro

Добавленный в: v20.5.0 Преобразует Unix-временную метку в микросекундах в значение DateTime64 с точностью до микросекунд. Входное значение интерпретируется как Unix-временная метка с микросекундной точностью (число микросекунд с 1970-01-01 00:00:00 UTC). Синтаксис

fromUnixTimestamp64Micro(value[, timezone])

Аргументы

value — Unix-временная метка в микросекундах. Int64
timezone — Необязательно. Часовой пояс возвращаемого значения. String

Возвращаемое значение Возвращает значение DateTime64 с точностью до микросекунд. DateTime64(6) Примеры Пример использования

Query

SELECT fromUnixTimestamp64Micro(1640995200123456)

Response

┌─fromUnixTimestamp64Micro(1640995200123456)─┐
│                 2022-01-01 00:00:00.123456 │
└────────────────────────────────────────────┘

fromUnixTimestamp64Milli

Добавленный в: v20.5.0 Преобразует Unix-временную метку в миллисекундах в значение DateTime64 с миллисекундной точностью. Входное значение интерпретируется как Unix-временная метка с миллисекундной точностью (количество миллисекунд, прошедших с 1970-01-01 00:00:00 UTC). Синтаксис

fromUnixTimestamp64Milli(value[, timezone])

Аргументы

value — Unix-временная метка в миллисекундах. Int64
timezone — Необязательный параметр. Часовой пояс возвращаемого значения. String

Возвращаемое значение Значение DateTime64 с точностью до миллисекунд. DateTime64(3) Примеры Пример использования

Query

SELECT fromUnixTimestamp64Milli(1640995200123)

Response

┌─fromUnixTimestamp64Milli(1640995200123)─┐
│                 2022-01-01 00:00:00.123 │
└─────────────────────────────────────────┘

fromUnixTimestamp64Nano

Добавленный в: v20.5.0 Преобразует Unix-временную метку в наносекундах в значение DateTime64 с точностью до наносекунд. Входное значение интерпретируется как Unix-временная метка с точностью до наносекунд (количество наносекунд, прошедших с 1970-01-01 00:00:00 UTC).

Обратите внимание: входное значение интерпретируется как временная метка в UTC, а не в часовом поясе входного значения.

Синтаксис

fromUnixTimestamp64Nano(value[, timezone])

Аргументы

value — Unix-временная метка в наносекундах. Int64
timezone — Необязательно. Часовой пояс возвращаемого значения. String

Возвращаемое значение Возвращает значение DateTime64 с точностью до наносекунд. DateTime64(9) Примеры Пример использования

Query

SELECT fromUnixTimestamp64Nano(1640995200123456789)

Response

┌─fromUnixTimestamp64Nano(1640995200123456789)─┐
│                2022-01-01 00:00:00.123456789 │
└──────────────────────────────────────────────┘

fromUnixTimestamp64Second

Добавленный в: v24.12.0 Преобразует Unix-временную метку в секундах в значение DateTime64 с точностью до секунд. Входное значение интерпретируется как Unix-временная метка с точностью до секунд (количество секунд с 1970-01-01 00:00:00 UTC). Синтаксис

fromUnixTimestamp64Second(value[, timezone])

Аргументы

value — Unix-временная метка в секундах. Int64
timezone — Необязательный. Часовой пояс для возвращаемого значения. String

Возвращаемое значение Возвращает значение DateTime64 с точностью до секунды. DateTime64(0) Примеры Пример использования

Query

SELECT fromUnixTimestamp64Second(1640995200)

Response

┌─fromUnixTimestamp64Second(1640995200)─┐
│                   2022-01-01 00:00:00 │
└───────────────────────────────────────┘

parseDateTime

Добавленный в: v23.3.0 Разбирает строку с датой и временем в соответствии со строкой формата даты MySQL. Эта функция обратна formatDateTime. Она разбирает аргумент типа String, используя строку формата String. Возвращает значение типа DateTime. Синтаксис

parseDateTime(time_string, format[, timezone])

Псевдонимы: TO_UNIXTIME Аргументы

time_string — Строка, которую нужно разобрать в DateTime. String
format — Строка формата, определяющая, как разбирать time_string. String
timezone — Необязательно. Часовой пояс. String

Возвращаемое значение Возвращает значение DateTime, разобранное из входной строки в соответствии со строкой формата в стиле MySQL. DateTime Примеры Пример использования

Query

SELECT parseDateTime('2025-01-04+23:00:00', '%Y-%m-%d+%H:%i:%s')

Response

┌─parseDateTime('2025-01-04+23:00:00', '%Y-%m-%d+%H:%i:%s')─┐
│                                       2025-01-04 23:00:00 │
└───────────────────────────────────────────────────────────┘

parseDateTime32BestEffort

Добавленный в: v20.9.0 Преобразует строковое представление даты и времени в тип данных DateTime. Функция разбирает даты и время в форматах ISO 8601, RFC 1123 - 5.2.14 RFC-822 Date and Time Specification, ClickHouse и некоторых других форматах. Синтаксис

parseDateTime32BestEffort(time_string[, time_zone])

Аргументы

time_string — Строка String, содержащая дату и время для преобразования. String
time_zone — Необязательный. Часовой пояс, в соответствии с которым разбирается time_string. String

Возвращаемое значение Возвращает time_string в формате DateTime. DateTime Примеры Пример использования

Query

SELECT parseDateTime32BestEffort('23/10/2025 12:12:57')
AS parseDateTime32BestEffort

Response

┌─parseDateTime32BestEffort─┐
│       2025-10-23 12:12:57 │
└───────────────────────────┘

С часовым поясом

Query

SELECT parseDateTime32BestEffort('Sat, 18 Aug 2025 07:22:16 GMT', 'Asia/Istanbul')
AS parseDateTime32BestEffort

Response

┌─parseDateTime32BestEffort─┐
│       2025-08-18 10:22:16 │
└───────────────────────────┘

Unix-временная метка

Query

SELECT parseDateTime32BestEffort('1284101485')
AS parseDateTime32BestEffort

Response

┌─parseDateTime32BestEffort─┐
│       2015-07-07 12:04:41 │
└───────────────────────────┘

parseDateTime32BestEffortOrNull

Добавленный в: v20.9.0 То же, что и parseDateTime32BestEffort, но при обнаружении формата даты, который невозможно обработать, функция возвращает NULL. Синтаксис

parseDateTime32BestEffortOrNull(time_string[, time_zone])

Аргументы

time_string — Строка String, содержащая дату и время для преобразования. String
time_zone — Необязательно. Часовой пояс, в соответствии с которым разбирается time_string. String

Возвращаемое значение Возвращает объект DateTime, разобранный из строки, или NULL, если разобрать строку не удалось. DateTime Примеры Пример использования

Query

SELECT
    parseDateTime32BestEffortOrNull('23/10/2025 12:12:57') AS valid,
    parseDateTime32BestEffortOrNull('invalid date') AS invalid

Response

┌─valid───────────────┬─invalid─┐
│ 2025-10-23 12:12:57 │    ᴺᵁᴸᴸ │
└─────────────────────┴─────────┘

parseDateTime32BestEffortOrZero

Добавленный в: v20.9.0 То же, что и parseDateTime32BestEffort, но при встрече с неподдерживаемым форматом даты функция возвращает нулевую дату или нулевое значение дата-время. Синтаксис

parseDateTime32BestEffortOrZero(time_string[, time_zone])

Аргументы

time_string — Строка с датой и временем для преобразования. String
time_zone — Необязательно. Часовой пояс, в соответствии с которым разбирается time_string. String

Возвращаемое значение Возвращает объект DateTime, полученный при разборе строки, или нулевую дату (1970-01-01 00:00:00), если разбор не удался. DateTime Примеры Пример использования

Query

SELECT
    parseDateTime32BestEffortOrZero('23/10/2025 12:12:57') AS valid,
    parseDateTime32BestEffortOrZero('invalid date') AS invalid

Response

┌─valid───────────────┬─invalid─────────────┐
│ 2025-10-23 12:12:57 │ 1970-01-01 00:00:00 │
└─────────────────────┴─────────────────────┘

parseDateTime64

Добавленный в: v24.11.0 Разбирает строку даты и времени с точностью до долей секунды в соответствии со строкой формата даты MySQL. Эта функция является обратной к formatDateTime для DateTime64. Она разбирает аргумент типа String с помощью строки формата String. Возвращает тип DateTime64, который может представлять даты с 1900 по 2299 год с точностью до долей секунды. Синтаксис

parseDateTime64(time_string, format[, timezone])

Аргументы

time_string — Строка, которую нужно разобрать как DateTime64. String
format — Строка формата, задающая способ разбора time_string. String
timezone — Необязательно. Часовой пояс. String

Возвращаемое значение Возвращает значение DateTime64, разобранное из входной строки в соответствии со строкой формата в стиле MySQL. DateTime64 Примеры Пример использования

Query

SELECT parseDateTime64('2025-01-04 23:00:00.123', '%Y-%m-%d %H:%i:%s.%f')

Response

┌─parseDateTime64('2025-01-04 23:00:00.123', '%Y-%m-%d %H:%i:%s.%f')─┐
│                                       2025-01-04 23:00:00.123       │
└─────────────────────────────────────────────────────────────────────┘

parseDateTime64BestEffort

Добавленный в: v20.1.0 То же, что и функция parseDateTimeBestEffort, но также разбирает миллисекунды и микросекунды и возвращает тип данных DateTime64. Синтаксис

parseDateTime64BestEffort(time_string[, precision[, time_zone]])

Аргументы

time_string — Строка, содержащая дату или дату и время для преобразования. String
precision — Необязательно. Требуемая точность. 3 для миллисекунд, 6 для микросекунд. По умолчанию: 3. UInt8
time_zone — Необязательно. Часовой пояс. Функция разбирает time_string с учетом часового пояса. String

Возвращаемое значение Возвращает time_string, преобразованную в тип данных DateTime64. DateTime64 Примеры Пример использования

Query

SELECT parseDateTime64BestEffort('2025-01-01') AS a, toTypeName(a) AS t
UNION ALL
SELECT parseDateTime64BestEffort('2025-01-01 01:01:00.12346') AS a, toTypeName(a) AS t
UNION ALL
SELECT parseDateTime64BestEffort('2025-01-01 01:01:00.12346',6) AS a, toTypeName(a) AS t
UNION ALL
SELECT parseDateTime64BestEffort('2025-01-01 01:01:00.12346',3,'Asia/Istanbul') AS a, toTypeName(a) AS t
FORMAT PrettyCompactMonoBlock

Response

┌──────────────────────────a─┬─t──────────────────────────────┐
│ 2025-01-01 01:01:00.123000 │ DateTime64(3)                  │
│ 2025-01-01 00:00:00.000000 │ DateTime64(3)                  │
│ 2025-01-01 01:01:00.123460 │ DateTime64(6)                  │
│ 2025-12-31 22:01:00.123000 │ DateTime64(3, 'Asia/Istanbul') │
└────────────────────────────┴────────────────────────────────┘

parseDateTime64BestEffortOrNull

Добавленный в: v20.1.0 То же, что и parseDateTime64BestEffort, но возвращает NULL, если встречает формат даты, который невозможно обработать. Синтаксис

parseDateTime64BestEffortOrNull(time_string[, precision[, time_zone]])

Аргументы

time_string — Строка, содержащая дату или дату и время для преобразования. String
precision — Необязательно. Требуемая точность. 3 для миллисекунд, 6 для микросекунд. По умолчанию: 3. UInt8
time_zone — Необязательно. Часовой пояс. Функция разбирает time_string в соответствии с часовым поясом. String

Возвращаемое значение Возвращает time_string, преобразованную в DateTime64, или NULL, если входное значение не удаётся разобрать. DateTime64 или NULL Примеры Пример использования

Query

SELECT parseDateTime64BestEffortOrNull('2025-01-01 01:01:00.123') AS valid,
       parseDateTime64BestEffortOrNull('invalid') AS invalid

Response

┌─valid───────────────────┬─invalid─┐
│ 2025-01-01 01:01:00.123 │    ᴺᵁᴸᴸ │
└─────────────────────────┴─────────┘

parseDateTime64BestEffortOrZero

Добавленный в: v20.1.0 То же, что и parseDateTime64BestEffort, за исключением того, что функция возвращает нулевую дату или нулевое значение дата-время, если встречает формат даты, который не может быть обработан. Синтаксис

parseDateTime64BestEffortOrZero(time_string[, precision[, time_zone]])

Аргументы

time_string — Строка, содержащая дату или дату и время для преобразования. String
precision — Необязательно. Требуемая точность. 3 для миллисекунд, 6 для микросекунд. По умолчанию: 3. UInt8
time_zone — Необязательно. Часовой пояс. Функция разбирает time_string с учетом этого часового пояса. String

Возвращаемое значение Возвращает значение time_string, преобразованное в DateTime64, или нулевую дату/дату и время (1970-01-01 00:00:00.000), если входное значение не удается разобрать. DateTime64 Примеры Пример использования

Query

SELECT parseDateTime64BestEffortOrZero('2025-01-01 01:01:00.123') AS valid,
       parseDateTime64BestEffortOrZero('invalid') AS invalid

Response

┌─valid───────────────────┬─invalid─────────────────┐
│ 2025-01-01 01:01:00.123 │ 1970-01-01 00:00:00.000 │
└─────────────────────────┴─────────────────────────┘

parseDateTime64BestEffortUS

Добавленный в: v22.8.0 То же, что и parseDateTime64BestEffort, но в неоднозначных случаях эта функция отдает предпочтение американскому формату даты (MM/DD/YYYY и т. д.). Синтаксис

parseDateTime64BestEffortUS(time_string [, precision [, time_zone]])

Аргументы

time_string — Строка String, содержащая дату или дату и время для преобразования. String
precision — Необязательно. Требуемая точность. 3 для миллисекунд, 6 для микросекунд. По умолчанию: 3. UInt8
time_zone — Необязательно. Часовой пояс. Функция разбирает time_string в соответствии с указанным часовым поясом. String

Возвращаемое значение Возвращает time_string, преобразованную в DateTime64, с предпочтением американского формата даты в неоднозначных случаях. DateTime64 Примеры Пример использования

Query

SELECT parseDateTime64BestEffortUS('02/10/2025 12:30:45.123') AS us_format,
       parseDateTime64BestEffortUS('15/08/2025 10:15:30.456') AS fallback_to_standard

Response

┌─us_format───────────────┬─fallback_to_standard────┐
│ 2025-02-10 12:30:45.123 │ 2025-08-15 10:15:30.456 │
└─────────────────────────┴─────────────────────────┘

parseDateTime64BestEffortUSOrNull

Добавленный в: v22.8.0 То же, что и parseDateTime64BestEffort, но в неоднозначных случаях эта функция отдаёт предпочтение американскому формату даты (MM/DD/YYYY и т. д.) и возвращает NULL, если встречает формат даты, который не может быть обработан. Синтаксис

parseDateTime64BestEffortUSOrNull(time_string[, precision[, time_zone]])

Аргументы

time_string — Строка, содержащая дату или дата и время для преобразования. String
precision — Необязательный параметр. Требуемая точность. 3 для миллисекунд, 6 для микросекунд. По умолчанию: 3. UInt8
time_zone — Необязательный параметр. Часовой пояс. Функция разбирает time_string в соответствии с этим часовым поясом. String

Возвращаемое значение Возвращает time_string, преобразованную в DateTime64 с приоритетом формата US, или NULL, если входное значение не удаётся разобрать. DateTime64 или NULL Примеры Пример использования

Query

SELECT parseDateTime64BestEffortUSOrNull('02/10/2025 12:30:45.123') AS valid_us,
       parseDateTime64BestEffortUSOrNull('invalid') AS invalid

Response

┌─valid_us────────────────┬─invalid─┐
│ 2025-02-10 12:30:45.123 │    ᴺᵁᴸᴸ │
└─────────────────────────┴─────────┘

parseDateTime64BestEffortUSOrZero

Добавленный в: v22.8.0 То же, что и parseDateTime64BestEffort, но в неоднозначных случаях эта функция предпочитает американский формат даты (MM/DD/YYYY и т. д.) и возвращает нулевую дату или нулевое значение даты-времени, если встречает формат даты, который не может быть обработан. Синтаксис

parseDateTime64BestEffortUSOrZero(time_string [, precision [, time_zone]])

Аргументы

time_string — Строка, содержащая дату или дату и время для преобразования. String
precision — Необязательно. Требуемая точность: 3 для миллисекунд, 6 для микросекунд. По умолчанию: 3. UInt8
time_zone — Необязательно. Часовой пояс. Функция разбирает time_string в соответствии с этим часовым поясом. String

Возвращаемое значение Возвращает time_string, преобразованную в DateTime64 с предпочтением американского формата, или нулевую дату/дату и время (1970-01-01 00:00:00.000), если входное значение не удаётся разобрать. DateTime64 Примеры Пример использования

Query

SELECT parseDateTime64BestEffortUSOrZero('02/10/2025 12:30:45.123') AS valid_us,
       parseDateTime64BestEffortUSOrZero('invalid') AS invalid

Response

┌─valid_us────────────────┬─invalid─────────────────┐
│ 2025-02-10 12:30:45.123 │ 1970-01-01 00:00:00.000 │
└─────────────────────────┴─────────────────────────┘

parseDateTime64InJodaSyntax

Добавленный в: v24.10.0 Разбирает строку даты и времени с точностью до долей секунды в соответствии со строкой формата даты и времени Joda. Эта функция является обратной к formatDateTimeInJodaSyntax для DateTime64. Она разбирает аргумент типа String, используя строку формата в стиле Joda. Возвращает значение типа DateTime64, которое может представлять даты с 1900 по 2299 год с точностью до долей секунды. Описание шаблонов формата см. в документации Joda Time. Синтаксис

parseDateTime64InJodaSyntax(time_string, format[, timezone])

Аргументы

time_string — Строка String, которую нужно разобрать в DateTime64. String
format — Строка формата в синтаксисе Joda, задающая способ разбора time_string. String
timezone — Необязательно. Часовой пояс. String

Возвращаемое значение Возвращает значение DateTime64, разобранное из входной строки в соответствии со строкой формата в стиле Joda. DateTime64 Примеры Пример использования

Query

SELECT parseDateTime64InJodaSyntax('2025-01-04 23:00:00.123', 'yyyy-MM-dd HH:mm:ss.SSS')

Response

┌─parseDateTime64InJodaSyntax('2025-01-04 23:00:00.123', 'yyyy-MM-dd HH:mm:ss.SSS')─┐
│                                                          2025-01-04 23:00:00.123   │
└────────────────────────────────────────────────────────────────────────────────────┘

parseDateTime64InJodaSyntaxOrNull

Добавленный в: v24.10.0 То же, что и parseDateTime64InJodaSyntax, но возвращает NULL, если указан неподдающийся разбору формат даты. Синтаксис

parseDateTime64InJodaSyntaxOrNull(time_string, format[, timezone])

Аргументы

time_string — строка, которую нужно разобрать как DateTime64. String
format — строка формата в синтаксисе Joda, задающая способ разбора time_string. String
timezone — необязательный параметр. Часовой пояс. String

Возвращаемое значение Возвращает значение DateTime64, разобранное из входной строки, или NULL, если разбор не удался. Nullable(DateTime64) Примеры Пример использования

Query

SELECT parseDateTime64InJodaSyntaxOrNull('2025-01-04 23:00:00.123', 'yyyy-MM-dd HH:mm:ss.SSS')

Response

┌─parseDateTime64InJodaSyntaxOrNull('2025-01-04 23:00:00.123', 'yyyy-MM-dd HH:mm:ss.SSS')─┐
│                                                             2025-01-04 23:00:00.123      │
└──────────────────────────────────────────────────────────────────────────────────────────┘

parseDateTime64InJodaSyntaxOrZero

Добавленный в: v24.10.0 То же, что и parseDateTime64InJodaSyntax, но при неподдающемся разбору формате даты возвращает нулевую дату. Синтаксис

parseDateTime64InJodaSyntaxOrZero(time_string, format[, timezone])

Аргументы

time_string — Строка String, которую нужно преобразовать в DateTime64. String
format — Строка формата в синтаксисе Joda, задающая способ разбора time_string. String
timezone — Необязательный параметр. Часовой пояс. String

Возвращаемое значение Возвращает значение DateTime64, разобранное из входной строки, или нулевое значение DateTime64, если разбор завершился неудачно. DateTime64 Примеры Пример использования

Query

SELECT parseDateTime64InJodaSyntaxOrZero('2025-01-04 23:00:00.123', 'yyyy-MM-dd HH:mm:ss.SSS')

Response

┌─parseDateTime64InJodaSyntaxOrZero('2025-01-04 23:00:00.123', 'yyyy-MM-dd HH:mm:ss.SSS')─┐
│                                                              2025-01-04 23:00:00.123     │
└──────────────────────────────────────────────────────────────────────────────────────────┘

parseDateTime64OrNull

Добавленный в: v24.11.0 То же, что и parseDateTime64, но возвращает NULL, если встречается неподдающийся разбору формат даты. Синтаксис

parseDateTime64OrNull(time_string, format[, timezone])

Аргументы

time_string — Строка, которую нужно разобрать как DateTime64. String
format — Строка формата, задающая способ разбора time_string. String
timezone — Необязательный параметр. Часовой пояс. String

Возвращаемое значение Возвращает DateTime64, разобранный из входной строки, или NULL, если разбор не удался. Nullable(DateTime64) Примеры Пример использования

Query

SELECT parseDateTime64OrNull('2025-01-04 23:00:00.123', '%Y-%m-%d %H:%i:%s.%f')

Response

┌─parseDateTime64OrNull('2025-01-04 23:00:00.123', '%Y-%m-%d %H:%i:%s.%f')─┐
│                                            2025-01-04 23:00:00.123        │
└───────────────────────────────────────────────────────────────────────────┘

parseDateTime64OrZero

Добавленный в: v24.11.0 То же, что и parseDateTime64, но возвращает нулевую дату, если встречает неподдающийся разбору формат даты. Синтаксис

parseDateTime64OrZero(time_string, format[, timezone])

Аргументы

time_string — Строка, которую нужно разобрать в DateTime64. String
format — Строка формата, задающая, как разобрать time_string. String
timezone — Необязательный параметр. Часовой пояс. String

Возвращаемое значение Возвращает DateTime64, разобранный из входной строки, или нулевое значение DateTime64, если разбор не удался. DateTime64 Примеры Пример использования

Query

SELECT parseDateTime64OrZero('2025-01-04 23:00:00.123', '%Y-%m-%d %H:%i:%s.%f')

Response

┌─parseDateTime64OrZero('2025-01-04 23:00:00.123', '%Y-%m-%d %H:%i:%s.%f')─┐
│                                             2025-01-04 23:00:00.123       │
└───────────────────────────────────────────────────────────────────────────┘

parseDateTimeBestEffort

Добавленный в: v1.1.0 Преобразует дату и время из строкового представления String в тип данных DateTime. Функция разбирает форматы даты и времени ISO 8601, RFC 1123 - 5.2.14 RFC-822, формат ClickHouse, а также некоторые другие. Поддерживаемые нестандартные форматы:

Строка, содержащая 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 и т. д.
Временная метка syslog: Mmm dd hh:mm:ss. Например, Jun 9 14:20:32.

Для всех форматов с разделителями функция разбирает названия месяцев, записанные полностью или в виде первых трех букв названия месяца. Если год не указан, считается, что он равен текущему году. Синтаксис

parseDateTimeBestEffort(time_string[, time_zone])

Аргументы

time_string — Строка с датой и временем для преобразования. String
time_zone — Необязательный параметр. Часовой пояс, в соответствии с которым разбирается time_string. String

Возвращаемое значение Возвращает time_string в формате DateTime. DateTime Примеры Пример использования

Query

SELECT parseDateTimeBestEffort('23/10/2025 12:12:57') AS parseDateTimeBestEffort

Response

┌─parseDateTimeBestEffort─┐
│     2025-10-23 12:12:57 │
└─────────────────────────┘

С указанием часового пояса

Query

SELECT parseDateTimeBestEffort('Sat, 18 Aug 2025 07:22:16 GMT', 'Asia/Istanbul') AS parseDateTimeBestEffort

Response

┌─parseDateTimeBestEffort─┐
│     2025-08-18 10:22:16 │
└─────────────────────────┘

Unix-временная метка

Query

SELECT parseDateTimeBestEffort('1735689600') AS parseDateTimeBestEffort

Response

┌─parseDateTimeBestEffort─┐
│     2025-01-01 00:00:00 │
└─────────────────────────┘

parseDateTimeBestEffortOrNull

Добавленный в: v1.1.0 То же, что и parseDateTimeBestEffort, за исключением того, что функция возвращает NULL, если встречает формат даты, который не может обработать. Функция разбирает ISO 8601, RFC 1123 - 5.2.14 RFC-822 Date and Time Specification, форматы даты и времени ClickHouse, а также некоторые другие форматы. Поддерживаемые нестандартные форматы:

Строка, содержащая 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 и т. д.
Syslog-временная метка: Mmm dd hh:mm:ss. Например, Jun 9 14:20:32.

Для всех форматов с разделителями функция разбирает названия месяцев, записанные полностью или по первым трем буквам. Если год не указан, считается, что он равен текущему году. Синтаксис

parseDateTimeBestEffortOrNull(time_string[, time_zone])

Аргументы

time_string — Строка, содержащая дату и время для преобразования. String
time_zone — Необязательно. Часовой пояс, в соответствии с которым разбирается time_string. String

Возвращаемое значение Возвращает time_string в виде DateTime или NULL, если входное значение не удаётся разобрать. DateTime или NULL Примеры Пример использования

Query

SELECT parseDateTimeBestEffortOrNull('23/10/2025 12:12:57') AS valid,
       parseDateTimeBestEffortOrNull('invalid') AS invalid

Response

┌─valid───────────────┬─invalid─┐
│ 2025-10-23 12:12:57 │    ᴺᵁᴸᴸ │
└─────────────────────┴─────────┘

parseDateTimeBestEffortOrZero

Добавленный в: v1.1.0 То же, что и parseDateTimeBestEffort, за исключением того, что функция возвращает нулевую дату или нулевое значение дата-времени, если встречает формат даты, который не может быть обработан. Функция разбирает ISO 8601, RFC 1123 - 5.2.14 RFC-822 Date and Time Specification, а также форматы даты и времени ClickHouse и некоторые другие форматы. Поддерживаемые нестандартные форматы:

Строка, содержащая 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 и т. д.
Временная метка syslog: Mmm dd hh:mm:ss. Например, Jun 9 14:20:32.

Для всех форматов с разделителями функция разбирает названия месяцев, указанные полностью или в виде первых трёх букв. Если год не указан, считается, что он равен текущему году. Синтаксис

parseDateTimeBestEffortOrZero(time_string[, time_zone])

Аргументы

time_string — Строка String, содержащая дату и время для преобразования. String
time_zone — Необязательно. Часовой пояс, в соответствии с которым разбирается time_string. String

Возвращаемое значение Возвращает time_string в формате DateTime или нулевую дату/дату-время (1970-01-01 или 1970-01-01 00:00:00), если входное значение не удаётся разобрать. DateTime Примеры Пример использования

Query

SELECT parseDateTimeBestEffortOrZero('23/10/2025 12:12:57') AS valid,
       parseDateTimeBestEffortOrZero('invalid') AS invalid

Response

┌─valid───────────────┬─invalid─────────────┐
│ 2025-10-23 12:12:57 │ 1970-01-01 00:00:00 │
└─────────────────────┴─────────────────────┘

parseDateTimeBestEffortUS

Добавленный в: v1.1.0 Эта функция ведёт себя как parseDateTimeBestEffort для дат в формате ISO, например YYYY-MM-DD hh:mm:ss, а также для других форматов даты, где месяц и день можно определить однозначно, например 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. Синтаксис

parseDateTimeBestEffortUS(time_string[, time_zone])

Аргументы

time_string — String с датой и временем для преобразования. String
time_zone — Необязательно. Часовой пояс, в соответствии с которым разбирается time_string. String

Возвращаемое значение Возвращает time_string в виде DateTime, отдавая предпочтение американскому формату даты в неоднозначных случаях. DateTime Примеры Пример использования

Query

SELECT parseDateTimeBestEffortUS('02/10/2025') AS us_format,
       parseDateTimeBestEffortUS('15/08/2025') AS fallback_to_standard

Response

┌─us_format───────────┬─fallback_to_standard─┐
│ 2025-02-10 00:00:00 │  2025-08-15 00:00:00 │
└─────────────────────┴──────────────────────┘

parseDateTimeBestEffortUSOrNull

Добавленный в: v1.1.0 То же, что и функция parseDateTimeBestEffortUS, за исключением того, что при обнаружении формата даты, который не удается обработать, она возвращает NULL. Для форматов дат ISO эта функция ведет себя как parseDateTimeBestEffort, но в неоднозначных случаях предпочитает американский формат даты и при ошибках разбора возвращает NULL. Синтаксис

parseDateTimeBestEffortUSOrNull(time_string[, time_zone])

Аргументы

time_string — Строка, содержащая дату и время для преобразования. String
time_zone — Необязательный. Часовой пояс, в соответствии с которым разбирается time_string. String

Возвращаемое значение Возвращает time_string как DateTime с приоритетом формата US или NULL, если входное значение не удаётся разобрать. DateTime или NULL Примеры Пример использования

Query

SELECT parseDateTimeBestEffortUSOrNull('02/10/2025') AS valid_us,
       parseDateTimeBestEffortUSOrNull('invalid') AS invalid

Response

┌─valid_us────────────┬─invalid─┐
│ 2025-02-10 00:00:00 │    ᴺᵁᴸᴸ │
└─────────────────────┴─────────┘

parseDateTimeBestEffortUSOrZero

Добавленный в: v1.1.0 То же, что и функция parseDateTimeBestEffortUS, за исключением того, что при обнаружении формата даты, который не удаётся обработать, она возвращает нулевую дату (1970-01-01) или нулевую дату и время (1970-01-01 00:00:00). Эта функция работает так же, как parseDateTimeBestEffort, для дат в формате ISO, но в неоднозначных случаях предпочитает американский формат даты и при ошибках разбора возвращает ноль. Синтаксис

parseDateTimeBestEffortUSOrZero(time_string[, time_zone])

Аргументы

time_string — Строка, содержащая дату и время для преобразования. String
time_zone — Необязательно. Часовой пояс, в соответствии с которым разбирается time_string. String

Возвращаемое значение Возвращает time_string в виде DateTime с предпочтением американского формата или нулевую дату/дату-время (1970-01-01 или 1970-01-01 00:00:00), если входное значение не удаётся разобрать. DateTime Примеры Пример использования

Query

SELECT parseDateTimeBestEffortUSOrZero('02/10/2025') AS valid_us,
       parseDateTimeBestEffortUSOrZero('invalid') AS invalid

Response

┌─valid_us────────────┬─invalid─────────────┐
│ 2025-02-10 00:00:00 │ 1970-01-01 00:00:00 │
└─────────────────────┴─────────────────────┘

parseDateTimeInJodaSyntax

Добавленный в: v23.3.0 Разбирает строку с датой и временем в соответствии со строкой формата даты Joda. Эта функция является обратной к formatDateTimeInJodaSyntax. Она разбирает аргумент типа String, используя строку формата в стиле Joda. Возвращает значение типа DateTime. Описание шаблонов формата см. в документации Joda Time. Синтаксис

parseDateTimeInJodaSyntax(time_string, format[, timezone])

Аргументы

time_string — Строка для разбора в DateTime. String
format — Строка формата в синтаксисе Joda, задающая способ разбора time_string. String
timezone — Необязательно. Часовой пояс. String

Возвращаемое значение Возвращает значение DateTime, полученное путём разбора входной строки в соответствии со строкой формата в стиле Joda. DateTime Примеры Пример использования

Query

SELECT parseDateTimeInJodaSyntax('2025-01-04 23:00:00', 'yyyy-MM-dd HH:mm:ss')

Response

┌─parseDateTimeInJodaSyntax('2025-01-04 23:00:00', 'yyyy-MM-dd HH:mm:ss')─┐
│                                                      2025-01-04 23:00:00 │
└──────────────────────────────────────────────────────────────────────────┘

parseDateTimeInJodaSyntaxOrNull

Добавленный в: v23.3.0 То же, что и parseDateTimeInJodaSyntax, но при неподдающемся разбору формате даты возвращает NULL. Синтаксис

parseDateTimeInJodaSyntaxOrNull(time_string, format[, timezone])

Аргументы

time_string — Строка, которую нужно разобрать как DateTime. String
format — Строка формата в синтаксисе Joda, задающая способ разбора time_string. String
timezone — Необязательно. Часовой пояс. String

Возвращаемое значение Возвращает DateTime, разобранный из входной строки, или NULL, если разбор завершился неудачно. Nullable(DateTime) Примеры Пример использования

Query

SELECT parseDateTimeInJodaSyntaxOrNull('2025-01-04 23:00:00', 'yyyy-MM-dd HH:mm:ss')

Response

┌─parseDateTimeInJodaSyntaxOrNull('2025-01-04 23:00:00', 'yyyy-MM-dd HH:mm:ss')─┐
│                                                         2025-01-04 23:00:00    │
└────────────────────────────────────────────────────────────────────────────────┘

parseDateTimeInJodaSyntaxOrZero

Добавленный в: v23.3.0 То же, что и parseDateTimeInJodaSyntax, но возвращает нулевую дату, если встречается неподдающийся разбору формат даты. Синтаксис

parseDateTimeInJodaSyntaxOrZero(time_string, format[, timezone])

Аргументы

time_string — строка, которую нужно разобрать как DateTime. String
format — строка формата в синтаксисе Joda, задающая, как разбирать time_string. String
timezone — Необязательно. Часовой пояс. String

Возвращаемое значение Возвращает значение DateTime, разобранное из входной строки, или нулевой DateTime, если разобрать строку не удалось. DateTime Примеры Пример использования

Query

SELECT parseDateTimeInJodaSyntaxOrZero('2025-01-04 23:00:00', 'yyyy-MM-dd HH:mm:ss')

Response

┌─parseDateTimeInJodaSyntaxOrZero('2025-01-04 23:00:00', 'yyyy-MM-dd HH:mm:ss')─┐
│                                                          2025-01-04 23:00:00   │
└────────────────────────────────────────────────────────────────────────────────┘

parseDateTimeOrNull

Добавленный в: v23.3.0 То же, что и parseDateTime, но возвращает NULL, если встречает неподдающийся разбору формат даты. Синтаксис

parseDateTimeOrNull(time_string, format[, timezone])

Псевдонимы: str_to_date Аргументы

time_string — Строка, преобразуемая в DateTime. String
format — Строка формата, задающая способ разбора time_string. String
timezone — Необязательный параметр. Часовой пояс. String

Возвращаемое значение Возвращает DateTime, разобранный из входной строки, или NULL, если разбор не удался. Nullable(DateTime) Примеры Пример использования

Query

SELECT parseDateTimeOrNull('2025-01-04+23:00:00', '%Y-%m-%d+%H:%i:%s')

Response

┌─parseDateTimeOrNull('2025-01-04+23:00:00', '%Y-%m-%d+%H:%i:%s')─┐
│                                            2025-01-04 23:00:00  │
└─────────────────────────────────────────────────────────────────┘

parseDateTimeOrZero

Добавленный в: v23.3.0 То же, что и parseDateTime, но при неподдающемся разбору формате даты возвращает нулевую дату. Синтаксис

parseDateTimeOrZero(time_string, format[, timezone])

Аргументы

time_string — Строка для разбора в DateTime. String
format — Строка формата, задающая способ разбора time_string. String
timezone — Необязательно. Часовой пояс. String

Возвращаемое значение Возвращает DateTime, разобранный из входной строки, или нулевой DateTime, если разбор не удался. DateTime Примеры Пример использования

Query

SELECT parseDateTimeOrZero('2025-01-04+23:00:00', '%Y-%m-%d+%H:%i:%s')

Response

┌─parseDateTimeOrZero('2025-01-04+23:00:00', '%Y-%m-%d+%H:%i:%s')─┐
│                                             2025-01-04 23:00:00 │
└─────────────────────────────────────────────────────────────────┘

reinterpret

Добавленный в: v1.1.0 Использует ту же последовательность байтов в памяти исходного значения для значения x и переинтерпретирует её как целевой тип. Синтаксис

reinterpret(x, type)

Аргументы

x — Любой тип. Any
type — Целевой тип. Если это массив, тип его элементов должен иметь фиксированную длину. String

Возвращаемое значение Значение целевого типа. Any Примеры Пример использования

Query

SELECT reinterpret(toInt8(-1), 'UInt8') AS int_to_uint,
    reinterpret(toInt8(1), 'Float32') AS int_to_float,
    reinterpret('1', 'UInt32') AS string_to_int

Response

┌─int_to_uint─┬─int_to_float─┬─string_to_int─┐
│         255 │        1e-45 │            49 │
└─────────────┴──────────────┴───────────────┘

Пример типа Array

Query

SELECT reinterpret(x'3108b4403108d4403108b4403108d440', 'Array(Float32)') AS string_to_array_of_Float32

Response

┌─string_to_array_of_Float32─┐
│ [5.626,6.626,5.626,6.626]  │
└────────────────────────────┘

reinterpretAsDate

Добавленный в: v1.1.0 Переинтерпретирует входное значение как значение типа Date (предполагая порядок little endian), то есть как количество дней с начала эпохи Unix — 1970-01-01 Синтаксис

reinterpretAsDate(x)

Аргументы

x — Количество дней с начала эпохи Unix. (U)Int* или Float*, или Date, или DateTime, или UUID, или String, или FixedString

Возвращаемое значение Дата. Date Примеры Пример использования

Query

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

Response

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

reinterpretAsDateTime

Добавленный в: v1.1.0 Переинтерпретирует входное значение как значение DateTime (предполагая порядок little endian), представляющее собой количество дней с начала эпохи Unix 1970-01-01 Синтаксис

reinterpretAsDateTime(x)

Аргументы

x — Число секунд с начала эпохи Unix. (U)Int* или Float* или Date или DateTime или UUID или String или FixedString

Возвращаемое значение Дата и время. DateTime Примеры Пример использования

Query

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

Response

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

reinterpretAsFixedString

Добавленный в: v1.1.0 Переинтерпретирует входное значение как строку фиксированной длины (предполагается порядок little endian). Null-байты в конце игнорируются; например, для значения UInt32 255 функция возвращает строку из одного символа. Синтаксис

reinterpretAsFixedString(x)

Аргументы

x — значение, которое нужно переинтерпретировать в строку. (U)Int* или Float* или Date или DateTime

Возвращаемое значение Строка фиксированной длины, содержащая байты, представляющие x. FixedString Примеры Пример использования

Query

SELECT
    reinterpretAsFixedString(toDateTime('1970-01-01 01:01:05')),
    reinterpretAsFixedString(toDate('1970-03-07'))

Response

┌─reinterpretAsFixedString(toDateTime('1970-01-01 01:01:05'))─┬─reinterpretAsFixedString(toDate('1970-03-07'))─┐
│ A                                                           │ A                                              │
└─────────────────────────────────────────────────────────────┴────────────────────────────────────────────────┘

reinterpretAsFloat32

Добавленный в: v1.1.0 Переинтерпретирует входное значение как значение типа Float32. В отличие от CAST, функция не пытается сохранить исходное значение — если целевой тип не может представить входной тип, результат не определен. Синтаксис

reinterpretAsFloat32(x)

Аргументы

x — Значение, переинтерпретируемое как Float32. (U)Int* или Float* или Date или DateTime или UUID или String или FixedString

Возвращаемое значение Возвращает переинтерпретированное значение x. Float32 Примеры Пример использования

Query

SELECT reinterpretAsUInt32(toFloat32(0.2)) AS x, reinterpretAsFloat32(x)

Response

┌──────────x─┬─reinterpretAsFloat32(x)─┐
│ 1045220557 │                     0.2 │
└────────────┴─────────────────────────┘

reinterpretAsFloat64

Добавленный в: v1.1.0 Переинтерпретирует входное значение как значение типа Float64. В отличие от CAST, функция не пытается сохранить исходное значение — если целевой тип не способен представить входной тип, результат не определён. Синтаксис

reinterpretAsFloat64(x)

Аргументы

x — Значение, переинтерпретируемое как Float64. (U)Int* или Float* или Date или DateTime или UUID или String или FixedString

Возвращаемое значение Возвращает переинтерпретированное значение x. Float64 Примеры Пример использования

Query

SELECT reinterpretAsUInt64(toFloat64(0.2)) AS x, reinterpretAsFloat64(x)

Response

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

reinterpretAsInt128

Добавленный в: v1.1.0 Переинтерпретирует входное значение как значение типа Int128. В отличие от CAST, функция не пытается сохранить исходное значение — если целевой тип не может представить входной тип, результат не определён. Синтаксис

reinterpretAsInt128(x)

Аргументы

x — Значение, переинтерпретируемое как Int128. (U)Int* или Float* или Date или DateTime или UUID или String или FixedString

Возвращаемое значение Возвращает значение x, переинтерпретированное как Int128 Примеры Пример использования

Query

SELECT
    toInt64(257) AS x,
    toTypeName(x),
    reinterpretAsInt128(x) AS res,
    toTypeName(res)

Response

┌───x─┬─toTypeName(x)─┬─res─┬─toTypeName(res)─┐
│ 257 │ Int64         │ 257 │ Int128          │
└─────┴───────────────┴─────┴─────────────────┘

reinterpretAsInt16

Добавленный в: v1.1.0 Переинтерпретирует входное значение как значение типа Int16. В отличие от CAST, эта функция не пытается сохранить исходное значение: если целевой тип не может представить входной тип, результат не определён. Синтаксис

reinterpretAsInt16(x)

Аргументы

x — Значение, переинтерпретируемое как Int16. (U)Int* или Float* или Date или DateTime или UUID или String или FixedString

Возвращаемое значение Возвращает переинтерпретированное значение x. Int16 Примеры Пример использования

Query

SELECT
    toInt8(257) AS x,
    toTypeName(x),
    reinterpretAsInt16(x) AS res,
    toTypeName(res)

Response

┌─x─┬─toTypeName(x)─┬─res─┬─toTypeName(res)─┐
│ 1 │ Int8          │   1 │ Int16           │
└───┴───────────────┴─────┴─────────────────┘

reinterpretAsInt256

Добавленный в: v1.1.0 Переинтерпретирует входное значение как значение типа Int256. В отличие от CAST, функция не пытается сохранить исходное значение — если целевой тип не может представить входной тип, результат не определён. Синтаксис

reinterpretAsInt256(x)

Аргументы

x — Значение для переинтерпретации в Int256. (U)Int* или Float* или Date или DateTime или UUID или String или FixedString

Возвращаемое значение Возвращает переинтерпретированное значение x. Int256 Примеры Пример использования

Query

SELECT
    toInt128(257) AS x,
    toTypeName(x),
    reinterpretAsInt256(x) AS res,
    toTypeName(res)

Response

┌───x─┬─toTypeName(x)─┬─res─┬─toTypeName(res)─┐
│ 257 │ Int128        │ 257 │ Int256          │
└─────┴───────────────┴─────┴─────────────────┘

reinterpretAsInt32

Добавленный в: v1.1.0 Переинтерпретирует входное значение как значение типа Int32. В отличие от CAST, функция не пытается сохранить исходное значение — если целевой тип не может представить входной тип, результат не определён. Синтаксис

reinterpretAsInt32(x)

Аргументы

x — Значение, которое нужно реинтерпретировать как Int32. (U)Int* или Float* или Date или DateTime или UUID или String или FixedString

Возвращаемое значение Возвращает значение x, реинтерпретированное как Int32. Примеры Пример использования

Query

SELECT
    toInt16(257) AS x,
    toTypeName(x),
    reinterpretAsInt32(x) AS res,
    toTypeName(res)

Response

┌───x─┬─toTypeName(x)─┬─res─┬─toTypeName(res)─┐
│ 257 │ Int16         │ 257 │ Int32           │
└─────┴───────────────┴─────┴─────────────────┘

reinterpretAsInt64

Добавленный в: v1.1.0 Переинтерпретирует входное значение как значение типа Int64. В отличие от CAST, функция не пытается сохранить исходное значение — если целевой тип не может представить входной тип, результат не определён. Синтаксис

reinterpretAsInt64(x)

Аргументы

x — значение, которое нужно переинтерпретировать как Int64. (U)Int* или Float* или Date или DateTime или UUID или String или FixedString

Возвращаемое значение Переинтерпретированное значение x. Int64 Примеры Пример использования

Query

SELECT
    toInt32(257) AS x,
    toTypeName(x),
    reinterpretAsInt64(x) AS res,
    toTypeName(res)

Response

┌───x─┬─toTypeName(x)─┬─res─┬─toTypeName(res)─┐
│ 257 │ Int32         │ 257 │ Int64           │
└─────┴───────────────┴─────┴─────────────────┘

reinterpretAsInt8

Добавленный в: v1.1.0 Переинтерпретирует входное значение как значение типа Int8. В отличие от CAST, функция не пытается сохранить исходное значение — если целевой тип не может представить входной тип, результат не определен. Синтаксис

reinterpretAsInt8(x)

Аргументы

x — значение для переинтерпретации как Int8. (U)Int* or Float* or Date or DateTime or UUID or String or FixedString

Возвращаемое значение Возвращает переинтерпретированное значение x. Int8 Примеры Пример использования

Query

SELECT
    toUInt8(257) AS x,
    toTypeName(x),
    reinterpretAsInt8(x) AS res,
    toTypeName(res)

Response

┌─x─┬─toTypeName(x)─┬─res─┬─toTypeName(res)─┐
│ 1 │ UInt8         │   1 │ Int8            │
└───┴───────────────┴─────┴─────────────────┘

reinterpretAsString

Добавленный в: v1.1.0 Переинтерпретирует входное значение как строку (в порядке little endian). Null-байты в конце игнорируются; например, для значения UInt32 255 функция возвращает строку из одного символа. Синтаксис

reinterpretAsString(x)

Аргументы

x — Значение, которое нужно переинтерпретировать в строку. (U)Int* или Float* или Date или DateTime

Возвращаемое значение Строка, содержащая байты, представляющие x. String Примеры Пример использования

Query

SELECT
    reinterpretAsString(toDateTime('1970-01-01 01:01:05')),
    reinterpretAsString(toDate('1970-03-07'))

Response

┌─reinterpretAsString(toDateTime('1970-01-01 01:01:05'))─┬─reinterpretAsString(toDate('1970-03-07'))─┐
│ A                                                      │ A                                         │
└────────────────────────────────────────────────────────┴───────────────────────────────────────────┘

reinterpretAsUInt128

Добавленный в: v1.1.0 Переинтерпретирует входное значение как значение типа UInt128. В отличие от CAST, функция не пытается сохранить исходное значение — если целевой тип не может представить входной тип, результат не определён. Синтаксис

reinterpretAsUInt128(x)

Аргументы

x — Значение, которое нужно переинтерпретировать как UInt128. (U)Int* или Float* или Date или DateTime или UUID или String или FixedString

Возвращаемое значение Возвращает переинтерпретированное значение x. UInt128 Примеры Пример использования

Query

SELECT
    toUInt64(257) AS x,
    toTypeName(x),
    reinterpretAsUInt128(x) AS res,
    toTypeName(res)

Response

┌───x─┬─toTypeName(x)─┬─res─┬─toTypeName(res)─┐
│ 257 │ UInt64        │ 257 │ UInt128         │
└─────┴───────────────┴─────┴─────────────────┘

reinterpretAsUInt16

Добавленный в: v1.1.0 Переинтерпретирует входное значение как значение типа UInt16. В отличие от CAST, функция не пытается сохранить исходное значение — если входной тип не может быть представлен целевым типом, результат не определён. Синтаксис

reinterpretAsUInt16(x)

Аргументы

x — Значение, которое нужно переинтерпретировать как UInt16. (U)Int* или Float* или Date или DateTime или UUID или String или FixedString

Возвращаемое значение Возвращает переинтерпретированное значение x. UInt16 Примеры Пример использования

Query

SELECT
    toUInt8(257) AS x,
    toTypeName(x),
    reinterpretAsUInt16(x) AS res,
    toTypeName(res)

Response

┌─x─┬─toTypeName(x)─┬─res─┬─toTypeName(res)─┐
│ 1 │ UInt8         │   1 │ UInt16          │
└───┴───────────────┴─────┴─────────────────┘

reinterpretAsUInt256

Добавленный в: v1.1.0 Переинтерпретирует входное значение как значение типа UInt256. В отличие от CAST, функция не пытается сохранить исходное значение — если целевой тип не может представить входной тип, результат не определён. Синтаксис

reinterpretAsUInt256(x)

Аргументы

x — значение, которое нужно переинтерпретировать как UInt256. (U)Int* или Float* или Date или DateTime или UUID или String или FixedString

Возвращаемое значение Возвращает переинтерпретированное значение x. UInt256 Примеры Пример использования

Query

SELECT
    toUInt128(257) AS x,
    toTypeName(x),
    reinterpretAsUInt256(x) AS res,
    toTypeName(res)

Response

┌───x─┬─toTypeName(x)─┬─res─┬─toTypeName(res)─┐
│ 257 │ UInt128       │ 257 │ UInt256         │
└─────┴───────────────┴─────┴─────────────────┘

reinterpretAsUInt32

Добавленный в: v1.1.0 Переинтерпретирует входное значение как значение типа UInt32. В отличие от CAST, функция не пытается сохранить исходное значение — если целевой тип не может представить входной тип, результат не определён. Синтаксис

reinterpretAsUInt32(x)

Аргументы

x — Значение, которое нужно реинтерпретировать как UInt32. (U)Int* или Float* или Date или DateTime или UUID или String или FixedString

Возвращаемое значение Возвращает значение x, реинтерпретированное как UInt32. Примеры Пример использования

Query

SELECT
    toUInt16(257) AS x,
    toTypeName(x),
    reinterpretAsUInt32(x) AS res,
    toTypeName(res)

Response

┌───x─┬─toTypeName(x)─┬─res─┬─toTypeName(res)─┐
│ 257 │ UInt16        │ 257 │ UInt32          │
└─────┴───────────────┴─────┴─────────────────┘

reinterpretAsUInt64

Добавленный в: v1.1.0 Переинтерпретирует входное значение как значение типа UInt64. В отличие от CAST, функция не пытается сохранить исходное значение — если целевой тип не может представить входной тип, результат не определён. Синтаксис

reinterpretAsUInt64(x)

Аргументы

x — Значение, которое нужно переинтерпретировать как UInt64. Int* или UInt* или Float* или Date или DateTime или UUID или String или FixedString

Возвращаемое значение Переинтерпретированное значение x. UInt64 Примеры Пример использования

Query

SELECT
    toUInt32(257) AS x,
    toTypeName(x),
    reinterpretAsUInt64(x) AS res,
    toTypeName(res)

Response

┌───x─┬─toTypeName(x)─┬─res─┬─toTypeName(res)─┐
│ 257 │ UInt32        │ 257 │ UInt64          │
└─────┴───────────────┴─────┴─────────────────┘

reinterpretAsUInt8

Добавленный в: v1.1.0 Переинтерпретирует входное значение как значение типа UInt8. В отличие от CAST, функция не пытается сохранить исходное значение — если целевой тип не может представить входной тип, результат не определён. Синтаксис

reinterpretAsUInt8(x)

Аргументы

x — Значение, которое нужно переинтерпретировать как UInt8. (U)Int* или Float* или Date или DateTime или UUID или String или FixedString

Возвращаемое значение Переинтерпретированное значение x. UInt8 Примеры Пример использования

Query

SELECT
    toInt8(-1) AS val,
    toTypeName(val),
    reinterpretAsUInt8(val) AS res,
    toTypeName(res);

Response

┌─val─┬─toTypeName(val)─┬─res─┬─toTypeName(res)─┐
│  -1 │ Int8            │ 255 │ UInt8           │
└─────┴─────────────────┴─────┴─────────────────┘

reinterpretAsUUID

Добавленный в: v1.1.0 Принимает строку длиной 16 байт и возвращает UUID, интерпретируя каждую 8-байтную половину в порядке little-endian. Если строка короче, чем нужно, функция работает так, как будто в конец строки дописано необходимое количество null-байтов. Если строка длиннее 16 байт, лишние байты в конце игнорируются. Синтаксис

reinterpretAsUUID(fixed_string)

Аргументы

fixed_string — Байтовая строка в формате big-endian. FixedString

Возвращаемое значение Значение типа UUID. UUID Примеры Преобразование строки в UUID

Query

SELECT reinterpretAsUUID(reverse(unhex('000102030405060708090a0b0c0d0e0f')))

Response

┌─reinterpretAsUUID(reverse(unhex('000102030405060708090a0b0c0d0e0f')))─┐
│                                  08090a0b-0c0d-0e0f-0001-020304050607 │
└───────────────────────────────────────────────────────────────────────┘

toBFloat16

Добавленный в: v1.1.0 Преобразует входное значение в значение типа BFloat16. В случае ошибки генерирует исключение. См. также:

toBFloat16OrZero.
toBFloat16OrNull.

Синтаксис

toBFloat16(expr)

Аргументы

expr — выражение, возвращающее число или строковое представление числа. Выражение

Возвращаемое значение Возвращает 16-битное значение формата brain floating point. BFloat16 Примеры Пример использования

Query

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

Response

toBFloat16(toFloat32(42.7)): 42.5
toBFloat16(t⋯32('42.7')):    42.5
toBFloat16('42.7'):          42.5

toBFloat16OrNull

Добавленный в: v1.1.0 Преобразует входное значение String в значение типа BFloat16. Если строка не представляет значение с плавающей запятой, функция возвращает NULL. Поддерживаемые аргументы:

Строковые представления числовых значений.

Неподдерживаемые аргументы (возвращают NULL):

Строковые представления двоичных и шестнадцатеричных значений.
Числовые значения.

Функция допускает потерю точности без уведомления при преобразовании из строкового представления.

См. также:

toBFloat16.
toBFloat16OrZero.

Синтаксис

toBFloat16OrNull(x)

Аргументы

x — Строковое представление числа. String

Возвращаемое значение Возвращает 16-битное значение в формате brain floating point, иначе — NULL. BFloat16 или NULL Примеры Пример использования

Query

SELECT toBFloat16OrNull('0x5E'), -- неподдерживаемые аргументы
       toBFloat16OrNull('12.3'), -- типичное использование
       toBFloat16OrNull('12.3456789') -- незаметная потеря точности

Response

\N
12.25
12.3125

toBFloat16OrZero

Добавленный в: v1.1.0 Преобразует входное значение String в значение типа BFloat16. Если строка не представляет собой число с плавающей точкой, функция возвращает ноль. Поддерживаемые аргументы:

Строковые представления числовых значений.

Неподдерживаемые аргументы (возвращают 0):

Строковые представления двоичных и шестнадцатеричных значений.
Числовые значения.

Функция допускает скрытую потерю точности при преобразовании из строкового представления.

См. также:

toBFloat16.
toBFloat16OrNull.

Синтаксис

toBFloat16OrZero(x)

Аргументы

x — Строковое представление числа. String

Возвращаемое значение Возвращает 16-битное значение формата brain floating point, иначе — 0. BFloat16 Примеры Пример использования

Query

SELECT toBFloat16OrZero('0x5E'), -- неподдерживаемые аргументы
       toBFloat16OrZero('12.3'), -- типичное использование
       toBFloat16OrZero('12.3456789') -- незаметная потеря точности

Response

0
12.25
12.3125

toBool

Добавленный в: v22.2.0 Преобразует входное значение в значение типа Bool. Синтаксис

toBool(expr)

Аргументы

expr — выражение, возвращающее число или строку. Для строк принимает значения ‘true’ или ‘false’ (регистронезависимо). (U)Int* или Float* или String или Expression

Возвращаемое значение Возвращает true или false в зависимости от результата вычисления аргумента. Bool Примеры Пример использования

Query

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

Response

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

toDate

Добавленный в: v1.1.0 Преобразует входное значение в тип Date. Поддерживает преобразование из типов String, FixedString, DateTime и числовых типов. Синтаксис

toDate(x)

Аргументы

x — Входное значение для преобразования. String или FixedString или DateTime или (U)Int* или Float*

Возвращаемое значение Преобразованное входное значение. Date Примеры Преобразование String в Date

Query

SELECT toDate('2025-04-15')

Response

2025-04-15

Преобразование DateTime в Date

Query

SELECT toDate(toDateTime('2025-04-15 10:30:00'))

Response

2025-04-15

Преобразование целого числа в тип Date

Query

SELECT toDate(20297)

Response

2025-07-28

toDate32

Добавленный в: v21.9.0 Преобразует аргумент в тип данных Date32. Если значение выходит за пределы диапазона, toDate32 возвращает граничные значения, поддерживаемые Date32. Если аргумент имеет тип Date, учитываются его границы. Синтаксис

toDate32(expr)

Аргументы

expr — значение для преобразования. String, UInt32 или Date

Возвращаемое значение Возвращает календарную дату. Date32 Примеры В допустимом диапазоне

Query

SELECT toDate32('2025-01-01') AS value, toTypeName(value)
FORMAT Vertical

Response

Строка 1:
──────
value:           2025-01-01
toTypeName(value): Date32

Вне допустимого диапазона

Query

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

Response

Строка 1:
──────
value:           1900-01-01
toTypeName(value): Date32

toDate32OrDefault

Добавленный в: v21.11.0 Преобразует аргумент в тип данных Date32. Если значение выходит за пределы диапазона, toDate32OrDefault возвращает значение нижней границы, поддерживаемое типом Date32. Если аргумент имеет тип Date, учитываются его границы. Возвращает значение по умолчанию, если получен некорректный аргумент. Синтаксис

toDate32OrDefault(expr[, default])

Аргументы

expr — Выражение, возвращающее число или строковое представление числа. String или (U)Int* или Float*
default — Необязательно. Значение по умолчанию, возвращаемое, если преобразование не удалось. Date32

Возвращаемое значение Значение типа Date32 в случае успешного выполнения; в противном случае возвращается значение по умолчанию, если оно передано, или 1900-01-01, если нет. Date32 Примеры Успешное преобразование

Query

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

Response

1930-01-01

Преобразование не удалось

Query

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

Response

2020-01-01

toDate32OrNull

Добавленный в: v21.9.0 Преобразует входное значение в значение типа Date32, но возвращает NULL, если передан некорректный аргумент. То же, что и toDate32, но возвращает NULL, если передан некорректный аргумент. Синтаксис

toDate32OrNull(x)

Аргументы

x — строковое представление даты. String

Возвращаемое значение Возвращает значение Date32 в случае успеха, в противном случае — NULL. Date32 или NULL Примеры Пример использования

Query

SELECT toDate32OrNull('2025-01-01'), toDate32OrNull('invalid')

Response

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

toDate32OrZero

Добавленный в: v21.9.0 Преобразует входное значение в значение типа Date32, но при получении некорректного аргумента возвращает нижнюю границу Date32. То же, что и toDate32, но при получении некорректного аргумента возвращает нижнюю границу Date32. См. также:

toDate32
toDate32OrNull
toDate32OrDefault

Синтаксис

toDate32OrZero(x)

Аргументы

x — строковое представление даты. String

Возвращаемое значение Возвращает значение Date32 в случае успеха, в противном случае — нижнюю границу Date32 (1900-01-01). Date32 Примеры Пример использования

Query

SELECT toDate32OrZero('2025-01-01'), toDate32OrZero('')

Response

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

toDateOrDefault

Добавленный в: v21.11.0 Как и toDate, но в случае ошибки возвращает значение по умолчанию: либо второй аргумент (если он указан), либо, в противном случае, нижнюю границу Date. Синтаксис

toDateOrDefault(expr[, default])

Аргументы

expr — Выражение, возвращающее число или строковое представление числа. String или (U)Int* или Float*
default — Необязательно. Значение по умолчанию, которое возвращается, если разбор завершился неуспешно. Date

Возвращаемое значение Значение типа Date в случае успешного выполнения; в противном случае возвращается значение по умолчанию, если оно передано, или 1970-01-01, если нет. Date Примеры Успешное преобразование

Query

SELECT toDateOrDefault('2022-12-30')

Response

2022-12-30

Ошибка преобразования

Query

SELECT toDateOrDefault('', CAST('2023-01-01', 'Date'))

Response

2023-01-01

toDateOrNull

Добавленный в: v1.1.0 Преобразует входное значение в значение типа Date, но возвращает NULL, если получает некорректный аргумент. То же, что и toDate, но возвращает NULL, если получает некорректный аргумент. Синтаксис

toDateOrNull(x)

Аргументы

x — Строковое представление даты. String

Возвращаемое значение Возвращает значение типа Date в случае успеха, в противном случае — NULL. Date или NULL Примеры Пример использования

Query

SELECT toDateOrNull('2025-12-30'), toDateOrNull('invalid')

Response

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

toDateOrZero

Добавленный в: v1.1.0 Преобразует входное значение в значение типа Date, но возвращает нижнюю границу Date, если передан некорректный аргумент. То же, что и toDate, но при передаче некорректного аргумента возвращает нижнюю границу Date. См. также:

toDate
toDateOrNull
toDateOrDefault

Синтаксис

toDateOrZero(x)

Аргументы

x — строковое представление даты. String

Возвращаемое значение Возвращает значение типа Date в случае успешного преобразования, в противном случае — нижнюю границу типа Date (1970-01-01). Date Примеры Пример использования

Query

SELECT toDateOrZero('2025-12-30'), toDateOrZero('')

Response

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

toDateTime

Добавленный в: v1.1.0 Преобразует входное значение в тип DateTime.

Если expr — число, оно интерпретируется как количество секунд с начала эпохи Unix (то есть как Unix-временная метка). Если expr — это String, оно может интерпретироваться как Unix-временная метка или как строковое представление даты / даты и времени. Поэтому разбор строковых представлений коротких чисел (до 4 цифр) явно отключён из-за неоднозначности: например, строка '1999' может обозначать как год (неполное строковое представление Date / DateTime), так и Unix-временную метку. Более длинные числовые строки допускаются.

Синтаксис

toDateTime(expr[, time_zone])

Аргументы

expr — Значение. String или Int или Date или DateTime
time_zone — Часовой пояс. String

Возвращаемое значение Возвращает значение типа дата-время. DateTime Примеры Пример использования

Query

SELECT toDateTime('2025-01-01 00:00:00'), toDateTime(1735689600, 'UTC')
FORMAT Vertical

Response

Row 1:
──────
toDateTime('2025-01-01 00:00:00'): 2025-01-01 00:00:00
toDateTime(1735689600, 'UTC'):     2025-01-01 00:00:00

toDateTime32

Добавленный в: v20.9.0 Преобразует входное значение в тип DateTime. Поддерживает преобразование из String, FixedString, Date, Date32, DateTime и числовых типов ((U)Int*, Float*, Decimal). DateTime32 имеет расширенный диапазон по сравнению с DateTime и поддерживает даты от 1900-01-01 до 2299-12-31. Синтаксис

toDateTime32(x[, timezone])

Аргументы

x — Входное значение, которое нужно преобразовать. String или FixedString или UInt* или Float* или Date или DateTime или DateTime64
timezone — Необязательно. Часовой пояс для возвращаемого значения DateTime. String

Возвращаемое значение Преобразованное входное значение. DateTime Примеры Значение находится в допустимом диапазоне

Query

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

Response

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

В виде десятичного числа с точностью

Query

SELECT toDateTime64(1735689600.000, 3) AS value, toTypeName(value);
-- без десятичной точки значение всё равно интерпретируется как Unix-временная метка в секундах
SELECT toDateTime64(1546300800000, 3) AS value, toTypeName(value);

Response

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

С часовым поясом

Query

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

Response

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

toDateTime64

Добавленный в: v20.1.0 Преобразует входное значение в тип DateTime64. Синтаксис

toDateTime64(expr, scale[, timezone])

Аргументы

expr — Выражение, возвращающее число или строковое представление числа. Выражение
scale — Размер тика (precision): 10^(-scale) секунд. UInt8
timezone — Необязательно. Часовой пояс для указанного объекта DateTime64. String

Возвращаемое значение Возвращает календарную дату и время суток с точностью до долей секунды. DateTime64 Примеры Значение находится в диапазоне

Query

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

Response

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

В формате десятичного числа с точностью

Query

SELECT toDateTime64(1546300800.000, 3) AS value, toTypeName(value);
-- Без десятичной точки значение по-прежнему интерпретируется как Unix-временная метка в секундах
SELECT toDateTime64(1546300800000, 3) AS value, toTypeName(value);

Response

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

С указанием часового пояса

Query

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

Response

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

toDateTime64OrDefault

Добавленный в: v21.11.0 Как и toDateTime64, эта функция преобразует входное значение в значение типа DateTime64, но при получении некорректного аргумента возвращает либо значение DateTime64 по умолчанию, либо указанное значение по умолчанию. Синтаксис

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

Аргументы

expr — Выражение, возвращающее число или строковое представление числа. String или (U)Int* или Float*
scale — Размер тика (precision): 10^-precision секунд. UInt8
timezone — Необязательно. Часовой пояс. String
default — Необязательно. Значение по умолчанию, которое возвращается, если разбор завершился неудачно. DateTime64

Возвращаемое значение Значение типа DateTime64 в случае успешного выполнения; в противном случае возвращается значение по умолчанию, если оно передано, или 1970-01-01 00:00:00.000, если нет. DateTime64 Примеры Успешное преобразование

Query

SELECT toDateTime64OrDefault('1976-10-18 00:00:00.30', 3)

Response

1976-10-18 00:00:00.300

Ошибка преобразования

Query

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

Response

2000-12-31 23:00:00.000

toDateTime64OrNull

Добавленный в: v20.1.0 Преобразует входное значение в значение типа DateTime64, но возвращает NULL, если передан некорректный аргумент. То же, что и toDateTime64, но возвращает NULL, если передан некорректный аргумент. Синтаксис

toDateTime64OrNull(x)

Аргументы

x — строковое представление даты и времени с субсекундной точностью. String

Возвращаемое значение Возвращает значение DateTime64 в случае успеха, иначе — NULL. DateTime64 или NULL Примеры Пример использования

Query

SELECT toDateTime64OrNull('2025-12-30 13:44:17.123'), toDateTime64OrNull('invalid')

Response

┌─toDateTime64OrNull('2025-12-30 13:44:17.123')─┬─toDateTime64OrNull('invalid')─┐
│                         2025-12-30 13:44:17.123 │                          ᴺᵁᴸᴸ │
└─────────────────────────────────────────────────┴───────────────────────────────┘

toDateTime64OrZero

Добавленный в: v20.1.0 Преобразует входное значение в значение типа DateTime64, но при получении некорректного аргумента возвращает нижнюю границу DateTime64. То же, что и toDateTime64, но при получении некорректного аргумента возвращает нижнюю границу DateTime64. См. также:

toDateTime64.
toDateTime64OrNull.
toDateTime64OrDefault.

Синтаксис

toDateTime64OrZero(x)

Аргументы

x — Строковое представление даты и времени с субсекундной точностью. String

Возвращаемое значение Если преобразование успешно, возвращает значение DateTime64, в противном случае — нижнюю границу типа DateTime64 (1970-01-01 00:00:00.000). DateTime64 Примеры Пример использования

Query

SELECT toDateTime64OrZero('2025-12-30 13:44:17.123'), toDateTime64OrZero('invalid')

Response

┌─toDateTime64OrZero('2025-12-30 13:44:17.123')─┬─toDateTime64OrZero('invalid')─┐
│                         2025-12-30 13:44:17.123 │             1970-01-01 00:00:00.000 │
└─────────────────────────────────────────────────┴─────────────────────────────────────┘

toDateTimeOrDefault

Добавленный в: v21.11.0 Аналогично toDateTime, но в случае ошибки возвращает значение по умолчанию: либо третий аргумент (если он указан), либо нижнюю границу DateTime. Синтаксис

toDateTimeOrDefault(expr[, timezone, default])

Аргументы

expr — Выражение, возвращающее число или строковое представление числа. String или (U)Int*, или Float*
timezone — Необязательно. Часовой пояс. String
default — Необязательно. Значение по умолчанию, которое возвращается, если разбор завершился неуспешно. DateTime

Возвращаемое значение Значение типа DateTime в случае успешного выполнения; в противном случае возвращается значение по умолчанию, если оно передано, или 1970-01-01 00:00:00, если нет. DateTime Примеры Успешное преобразование

Query

SELECT toDateTimeOrDefault('2022-12-30 13:44:17')

Response

2022-12-30 13:44:17

Ошибка преобразования

Query

SELECT toDateTimeOrDefault('', 'UTC', CAST('2023-01-01', 'DateTime(\'UTC\')'))

Response

2023-01-01 00:00:00

toDateTimeOrNull

Добавленный в: v1.1.0 Преобразует входное значение в значение типа DateTime, но возвращает NULL, если получает некорректный аргумент. То же, что и toDateTime, но возвращает NULL, если получает некорректный аргумент. Синтаксис

toDateTimeOrNull(x)

Аргументы

x — Строковое представление даты и времени. String

Возвращаемое значение Возвращает значение DateTime в случае успеха, в противном случае — NULL. DateTime или NULL Примеры Пример использования

Query

SELECT toDateTimeOrNull('2025-12-30 13:44:17'), toDateTimeOrNull('invalid')

Response

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

toDateTimeOrZero

Добавленный в: v1.1.0 Преобразует входное значение в значение типа DateTime, но при получении некорректного аргумента возвращает нижнюю границу DateTime. То же, что и toDateTime, но при получении некорректного аргумента возвращает нижнюю границу DateTime. Синтаксис

toDateTimeOrZero(x)

Аргументы

x — Строковое представление даты и времени. String

Возвращаемое значение Возвращает значение DateTime в случае успешного выполнения, в противном случае — нижнюю границу DateTime (1970-01-01 00:00:00). DateTime Примеры Пример использования

Query

SELECT toDateTimeOrZero('2025-12-30 13:44:17'), toDateTimeOrZero('invalid')

Response

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

toDecimal128

Добавленный в: v18.12.0 Преобразует входное значение в значение типа Decimal(38, S) с масштабом S. Генерирует исключение в случае ошибки. Поддерживаемые аргументы:

Значения или строковые представления типа (U)Int*.
Значения или строковые представления типа Float*.

Неподдерживаемые аргументы:

Значения Float* NaN и Inf или их строковые представления (регистронезависимо).
Строковые представления двоичных и шестнадцатеричных значений, например 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

Синтаксис

toDecimal128(expr, S)

Аргументы

expr — выражение, возвращающее число или строковое представление числа. Expression
S — параметр scale в диапазоне от 0 до 38, задающий, сколько цифр может быть в дробной части числа. UInt8

Возвращаемое значение Возвращает значение типа Decimal(38, S) Decimal128(S) Примеры Пример использования

Query

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

Response

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)

toDecimal128OrDefault

Добавленный в: v21.11.0 Подобно toDecimal128, эта функция преобразует входное значение в значение типа Decimal(38, S), но в случае ошибки возвращает значение по умолчанию. Синтаксис

toDecimal128OrDefault(expr, S[, default])

Аргументы

expr — Строковое представление числа. String
S — Параметр scale в диапазоне от 0 до 38, который указывает, сколько цифр может содержать дробная часть числа. UInt8
default — Необязательно. Значение по умолчанию, возвращаемое, если преобразование в тип Decimal128(S) завершается неуспешно. Decimal128(S)

Возвращаемое значение Значение типа Decimal(38, S) в случае успешного преобразования; в противном случае возвращается переданное значение по умолчанию или 0, если оно не задано. Decimal128(S) Примеры Успешное преобразование

Query

SELECT toDecimal128OrDefault(toString(1/42), 18)

Response

0.023809523809523808

Ошибка преобразования

Query

SELECT toDecimal128OrDefault('Inf', 0, CAST('-1', 'Decimal128(0)'))

Response

-1

toDecimal128OrNull

Добавленный в: v20.1.0 Преобразует входное значение в значение типа Decimal(38, S), но в случае ошибки возвращает NULL. Аналогично toDecimal128, но при ошибках преобразования возвращает NULL вместо того, чтобы генерировать исключение. Поддерживаемые аргументы:

Значения или строковые представления типа (U)Int*.
Значения или строковые представления типа Float*.

Неподдерживаемые аргументы (возвращают NULL):

Значения или строковые представления значений Float* NaN и Inf (регистронезависимо).
Строковые представления двоичных и шестнадцатеричных значений.
Значения, выходящие за пределы Decimal128: (-1*10^(38 - S), 1*10^(38 - S)).

См. также:

toDecimal128.
toDecimal128OrZero.
toDecimal128OrDefault.

Синтаксис

toDecimal128OrNull(expr, S)

Аргументы

expr — Выражение, возвращающее число или строковое представление числа. Expression
S — Параметр scale в диапазоне от 0 до 38, задающий, сколько цифр может содержать дробная часть числа. UInt8

Возвращаемое значение Возвращает значение типа Decimal(38, S) в случае успеха, иначе — NULL. Decimal128(S) или NULL Примеры Пример использования

Query

SELECT toDecimal128OrNull('42.7', 2), toDecimal128OrNull('invalid', 2)

Response

┌─toDecimal128OrNull('42.7', 2)─┬─toDecimal128OrNull('invalid', 2)─┐
│                         42.70 │                             ᴺᵁᴸᴸ │
└───────────────────────────────┴──────────────────────────────────┘

toDecimal128OrZero

Добавленный в: v20.1.0 Преобразует входное значение в значение типа Decimal(38, S), но в случае ошибки возвращает 0. Аналогично toDecimal128, но при ошибках преобразования возвращает 0 вместо того, чтобы генерировать исключение. Поддерживаемые аргументы:

Значения или строковые представления типа (U)Int*.
Значения или строковые представления типа Float*.

Неподдерживаемые аргументы (возвращается 0):

Значения Float* NaN и Inf или их строковые представления (регистронезависимо).
Строковые представления двоичных и шестнадцатеричных значений.

Если входное значение выходит за пределы Decimal128:(-1*10^(38 - S), 1*10^(38 - S)), функция возвращает 0.

Синтаксис

toDecimal128OrZero(expr, S)

Аргументы

expr — Выражение, возвращающее число или строковое представление числа. Expression
S — параметр scale в диапазоне от 0 до 38, который задаёт, сколько цифр может быть в дробной части числа. UInt8

Возвращаемое значение При успешном выполнении возвращает значение Decimal(38, S), в противном случае — 0. Decimal128(S) Примеры Базовое использование

Query

SELECT toDecimal128OrZero('42.7', 2), toDecimal128OrZero('invalid', 2)

Response

┌─toDecimal128OrZero('42.7', 2)─┬─toDecimal128OrZero('invalid', 2)─┐
│                         42.70 │                             0.00 │
└───────────────────────────────┴──────────────────────────────────┘

toDecimal256

Добавленный в: v20.8.0 Преобразует входное значение в значение типа Decimal(76, S) с масштабом S. В случае ошибки генерирует исключение. Поддерживаемые аргументы:

Значения или строковые представления типа (U)Int*.
Значения или строковые представления типа Float*.

Неподдерживаемые аргументы:

Значения или строковые представления значений Float* NaN и Inf (регистронезависимо).
Строковые представления двоичных и шестнадцатеричных значений, например 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. Можно использовать входное значение типа String, чтобы операции выполнялись с использованием базового целочисленного типа: toDecimal256('1.15', 2) = 1.15

Синтаксис

toDecimal256(expr, S)

Аргументы

expr — Выражение, возвращающее число или строковое представление числа. Expression
S — параметр scale от 0 до 76, задающий, сколько знаков может быть в дробной части числа. UInt8

Возвращаемое значение Возвращает значение типа Decimal(76, S). Decimal256(S) Примеры Пример использования

Query

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

Response

Строка 1:
──────
a:      99
type_a: Decimal(76, 1)
b:      99.67
type_b: Decimal(76, 2)
c:      99.67
type_c: Decimal(76, 3)

toDecimal256OrDefault

Добавленный в: v21.11.0 Как и toDecimal256, эта функция преобразует входное значение в тип Decimal(76, S), но в случае ошибки возвращает значение по умолчанию. Синтаксис

toDecimal256OrDefault(expr, S[, default])

Аргументы

expr — Строковое представление числа. String
S — Параметр scale в диапазоне от 0 до 76, задающий, сколько цифр может быть в дробной части числа. UInt8
default — Необязательно. Значение по умолчанию, которое возвращается, если разбор в тип Decimal256(S) завершается неуспешно. Decimal256(S)

Возвращаемое значение Значение типа Decimal(76, S) в случае успешного выполнения; в противном случае возвращается значение по умолчанию, если оно передано, или 0, если нет. Decimal256(S) Примеры Успешное преобразование

Query

SELECT toDecimal256OrDefault(toString(1/42), 76)

Response

0.023809523809523808

Ошибка преобразования

Query

SELECT toDecimal256OrDefault('Inf', 0, CAST('-1', 'Decimal256(0)'))

Response

-1

toDecimal256OrNull

Добавленный в: v20.8.0 Преобразует входное значение в значение типа Decimal(76, S), но в случае ошибки возвращает NULL. Аналогично toDecimal256, но при ошибках преобразования возвращает NULL вместо того, чтобы генерировать исключение. Поддерживаемые аргументы:

Значения или строковые представления типа (U)Int*.
Значения или строковые представления типа Float*.

Неподдерживаемые аргументы (возвращается NULL):

Значения Float* NaN и Inf, а также их строковые представления (регистронезависимо).
Строковые представления двоичных и шестнадцатеричных значений.
Значения, выходящие за пределы Decimal256: (-1 * 10^(76 - S), 1 * 10^(76 - S)).

См. также:

toDecimal256.
toDecimal256OrZero.
toDecimal256OrDefault.

Синтаксис

toDecimal256OrNull(expr, S)

Аргументы

expr — выражение, возвращающее число или строковое представление числа. Выражение
S — параметр scale в диапазоне от 0 до 76, задающий, сколько цифр может быть в дробной части числа. UInt8

Возвращаемое значение В случае успеха возвращает значение Decimal(76, S), в противном случае — NULL. Decimal256(S) или NULL Примеры Пример использования

Query

SELECT toDecimal256OrNull('42.7', 2), toDecimal256OrNull('invalid', 2)

Response

┌─toDecimal256OrNull('42.7', 2)─┬─toDecimal256OrNull('invalid', 2)─┐
│                         42.70 │                             ᴺᵁᴸᴸ │
└───────────────────────────────┴──────────────────────────────────┘

toDecimal256OrZero

Добавленный в: v20.8.0 Преобразует входное значение в значение типа Decimal(76, S), но в случае ошибки возвращает 0. Аналогична toDecimal256, но при ошибках преобразования возвращает 0 вместо того, чтобы генерировать исключение. Поддерживаемые аргументы:

Значения или строковые представления типа (U)Int*.
Значения или строковые представления типа Float*.

Неподдерживаемые аргументы (возвращается 0):

Значения или строковые представления значений Float* NaN и Inf (регистронезависимо).
Строковые представления двоичных и шестнадцатеричных значений.

Если входное значение выходит за пределы Decimal256: (-1*10^(76 - S), 1*10^(76 - S)), функция возвращает 0.

См. также:

toDecimal256.
toDecimal256OrNull.
toDecimal256OrDefault.

Синтаксис

toDecimal256OrZero(expr, S)

Аргументы

expr — Выражение, возвращающее число или строковое представление числа. Expression
S — Параметр scale в диапазоне от 0 до 76, задающий количество цифр в дробной части числа. UInt8

Возвращаемое значение Возвращает значение Decimal(76, S) в случае успеха, иначе 0. Decimal256(S) Примеры Пример использования

Query

SELECT toDecimal256OrZero('42.7', 2), toDecimal256OrZero('invalid', 2)

Response

┌─toDecimal256OrZero('42.7', 2)─┬─toDecimal256OrZero('invalid', 2)─┐
│                         42.70 │                             0.00 │
└───────────────────────────────┴──────────────────────────────────┘

toDecimal32

Добавленный в: v18.12.0 Преобразует входное значение в значение типа Decimal(9, S) с масштабом S. В случае ошибки генерирует исключение. Поддерживаемые аргументы:

Значения или строковые представления типа (U)Int*.
Значения или строковые представления типа Float*.

Неподдерживаемые аргументы:

Значения или строковые представления значений Float* NaN и Inf (регистронезависимо).
Строковые представления двоичных и шестнадцатеричных значений, например 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. Можно использовать входное значение типа String, чтобы операции выполнялись с использованием базового целочисленного типа: toDecimal32('1.15', 2) = 1.15

Синтаксис

toDecimal32(expr, S)

Аргументы

expr — Выражение, возвращающее число или строковое представление числа. Выражение
S — Параметр scale в диапазоне от 0 до 9, указывающий, сколько цифр может быть в дробной части числа. UInt8

Возвращаемое значение Возвращает значение типа Decimal(9, S) Decimal32(S) Примеры Пример использования

Query

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

Response

Строка 1:
──────
a:      2
type_a: Decimal(9, 1)
b:      4.2
type_b: Decimal(9, 2)
c:      4.2
type_c: Decimal(9, 3)

toDecimal32OrDefault

Добавленный в: v21.11.0 Как и toDecimal32, эта функция преобразует входное значение в значение типа Decimal(9, S), но в случае ошибки возвращает значение по умолчанию. Синтаксис

toDecimal32OrDefault(expr, S[, default])

Аргументы

expr — Строковое представление числа. String
S — Параметр масштаба от 0 до 9, задающий, сколько цифр может быть в дробной части числа. UInt8
default — Необязательно. Значение по умолчанию, которое возвращается, если не удалось выполнить разбор в тип Decimal32(S). Decimal32(S)

Возвращаемое значение Значение типа Decimal(9, S) в случае успешного выполнения; в противном случае возвращается переданное значение по умолчанию или 0, если оно не задано. Decimal32(S) Примеры Успешное преобразование

Query

SELECT toDecimal32OrDefault(toString(0.0001), 5)

Response

0.0001

Ошибка преобразования

Query

SELECT toDecimal32OrDefault('Inf', 0, CAST('-1', 'Decimal32(0)'))

Response

-1

toDecimal32OrNull

Добавленный в: v20.1.0 Преобразует входное значение в значение типа Decimal(9, S), но в случае ошибки возвращает NULL. Аналогична toDecimal32, но при ошибках преобразования возвращает NULL вместо того, чтобы генерировать исключение. Поддерживаемые аргументы:

Значения или строковые представления типа (U)Int*.
Значения или строковые представления типа Float*.

Неподдерживаемые аргументы (возвращает NULL):

Значения или строковые представления значений Float* NaN и Inf (регистронезависимо).
Строковые представления двоичных и шестнадцатеричных значений.
Значения, выходящие за границы Decimal32:(-1*10^(9 - S), 1*10^(9 - S)).

См. также:

toDecimal32.
toDecimal32OrZero.
toDecimal32OrDefault.

Синтаксис

toDecimal32OrNull(expr, S)

Аргументы

expr — Выражение, возвращающее число или строковое представление числа. Выражение
S — параметр масштаба в диапазоне от 0 до 9, задающий, сколько цифр может быть в дробной части числа. UInt8

Возвращаемое значение В случае успеха возвращается значение Decimal(9, S), в противном случае — NULL. Decimal32(S) или NULL Примеры Пример использования

Query

SELECT toDecimal32OrNull('42.7', 2), toDecimal32OrNull('invalid', 2)

Response

┌─toDecimal32OrNull('42.7', 2)─┬─toDecimal32OrNull('invalid', 2)─┐
│                        42.70 │                            ᴺᵁᴸᴸ │
└──────────────────────────────┴─────────────────────────────────┘

toDecimal32OrZero

Добавленный в: v20.1.0 Преобразует входное значение в значение типа Decimal(9, S), но в случае ошибки возвращает 0. Аналогично toDecimal32, но при ошибках преобразования возвращает 0 вместо того, чтобы генерировать исключение. Поддерживаемые аргументы:

Значения или строковые представления типа (U)Int*.
Значения или строковые представления типа Float*.

Неподдерживаемые аргументы (возвращается 0):

Значения или строковые представления значений Float* NaN и Inf (регистронезависимые).
Строковые представления двоичных и шестнадцатеричных значений.

Если входное значение выходит за пределы Decimal32: (-1*10^(9 - S), 1*10^(9 - S)), функция возвращает 0.

Синтаксис

toDecimal32OrZero(expr, S)

Аргументы

expr — Выражение, возвращающее число или его строковое представление. Выражение
S — параметр масштаба со значением от 0 до 9, задающий, сколько цифр может быть в дробной части числа. UInt8

Возвращаемое значение В случае успеха возвращает значение Decimal(9, S), в противном случае — 0. Decimal32(S) Примеры Пример использования

Query

SELECT toDecimal32OrZero('42.7', 2), toDecimal32OrZero('invalid', 2)

Response

┌─toDecimal32OrZero('42.7', 2)─┬─toDecimal32OrZero('invalid', 2)─┐
│                        42.70 │                            0.00 │
└──────────────────────────────┴─────────────────────────────────┘

toDecimal64

Добавленный в: v18.12.0 Преобразует входное значение в значение типа Decimal(18, S) с масштабом S. Генерирует исключение в случае ошибки. Поддерживаемые аргументы:

Значения или строковые представления типа (U)Int*.
Значения или строковые представления типа Float*.

Неподдерживаемые аргументы:

Значения или строковые представления значений Float* NaN и Inf (регистронезависимо).
Строковые представления бинарных и шестнадцатеричных значений, например 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. Можно использовать входное значение типа String, чтобы в операциях использовался базовый целочисленный тип: toDecimal64('1.15', 2) = 1.15

Синтаксис

toDecimal64(expr, S)

Аргументы

expr — Выражение, возвращающее число или его строковое представление. Выражение
S — параметр масштаба от 0 до 18, указывающий, сколько цифр может быть в дробной части числа. UInt8

Возвращаемое значение Возвращает десятичное значение. Decimal(18, S) Примеры Пример использования

Query

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

Response

Строка 1:
──────
a:      2.0
type_a: Decimal(18, 1)
b:      4.20
type_b: Decimal(18, 2)
c:      4.200
type_c: Decimal(18, 3)

toDecimal64OrDefault

Добавленный в: v21.11.0 Как и toDecimal64, эта функция преобразует входное значение в тип Decimal(18, S), но в случае ошибки возвращает значение по умолчанию. Синтаксис

toDecimal64OrDefault(expr, S[, default])

Аргументы

expr — Строковое представление числа. String
S — Параметр масштаба в диапазоне от 0 до 18, задающий, сколько цифр может содержать дробная часть числа. UInt8
default — Необязательно. Значение по умолчанию, которое возвращается, если преобразование в тип Decimal64(S) не удалось. Decimal64(S)

Возвращаемое значение Значение типа Decimal(18, S) в случае успешного преобразования; в противном случае возвращается значение по умолчанию, если оно было передано, или 0, если нет. Decimal64(S) Примеры Успешное преобразование

Query

SELECT toDecimal64OrDefault(toString(0.0001), 18)

Response

0.0001

Не удалось преобразовать

Query

SELECT toDecimal64OrDefault('Inf', 0, CAST('-1', 'Decimal64(0)'))

Response

-1

toDecimal64OrNull

Добавленный в: v20.1.0 Преобразует входное значение в значение типа Decimal(18, S), но в случае ошибки возвращает NULL. Аналогично toDecimal64, но при ошибках преобразования возвращает NULL вместо того, чтобы генерировать исключение. Поддерживаемые аргументы:

Значения или строковые представления типа (U)Int*.
Значения или строковые представления типа Float*.

Неподдерживаемые аргументы (возвращают NULL):

Значения Float* NaN и Inf, а также их строковые представления (регистронезависимые).
Строковые представления двоичных и шестнадцатеричных значений.
Значения, выходящие за пределы Decimal64: (-1*10^(18 - S), 1*10^(18 - S)).

См. также:

toDecimal64.
toDecimal64OrZero.
toDecimal64OrDefault.

Синтаксис

toDecimal64OrNull(expr, S)

Аргументы

expr — Выражение, возвращающее число или строковое представление числа. Выражение
S — параметр масштаба в диапазоне от 0 до 18, задающий, сколько цифр может содержать дробная часть числа. UInt8

Возвращаемое значение Возвращает значение Decimal(18, S) в случае успеха, иначе — NULL. Decimal64(S) или NULL Примеры Пример использования

Query

SELECT toDecimal64OrNull('42.7', 2), toDecimal64OrNull('invalid', 2)

Response

┌─toDecimal64OrNull('42.7', 2)─┬─toDecimal64OrNull('invalid', 2)─┐
│                        42.70 │                            ᴺᵁᴸᴸ │
└──────────────────────────────┴─────────────────────────────────┘

toDecimal64OrZero

Добавленный в: v20.1.0 Преобразует входное значение в значение типа Decimal(18, S), но в случае ошибки возвращает 0. Аналогична toDecimal64, но при ошибках преобразования возвращает 0 вместо того, чтобы генерировать исключение. Поддерживаемые аргументы:

Значения или строковые представления типа (U)Int*.
Значения или строковые представления типа Float*.

Неподдерживаемые аргументы (возвращается 0):

Значения или строковые представления значений Float* NaN и Inf (регистронезависимо).
Строковые представления двоичных и шестнадцатеричных значений.

Если входное значение выходит за пределы Decimal64:(-1*10^(18 - S), 1*10^(18 - S)), функция возвращает 0.

См. также:

toDecimal64.
toDecimal64OrNull.
toDecimal64OrDefault.

Синтаксис

toDecimal64OrZero(expr, S)

Аргументы

expr — Выражение, возвращающее число или строковое представление числа. Выражение
S — параметр масштаба в диапазоне от 0 до 18, определяющий, сколько цифр может быть в дробной части числа. UInt8

Возвращаемое значение Возвращает значение Decimal(18, S) в случае успеха, иначе 0. Decimal64(S) Примеры Пример использования

Query

SELECT toDecimal64OrZero('42.7', 2), toDecimal64OrZero('invalid', 2)

Response

┌─toDecimal64OrZero('42.7', 2)─┬─toDecimal64OrZero('invalid', 2)─┐
│                        42.70 │                            0.00 │
└──────────────────────────────┴─────────────────────────────────┘

toDecimalString

Добавленный в: v23.3.0 Преобразует числовое значение в String с указанным количеством знаков после запятой. Функция округляет входное значение до указанного числа десятичных знаков. Если у входного значения меньше знаков после запятой, чем требуется, результат дополняется нулями, чтобы получить ровно указанное количество знаков после запятой. Синтаксис

toDecimalString(number, scale)

Аргументы

number — Числовое значение, которое нужно преобразовать в строку. Может иметь любой числовой тип (Int, UInt, Float, Decimal). Int8 or Int16 or Int32 or Int64 or UInt8 or UInt16 or UInt32 or UInt64 or Float32 or Float64 or Decimal
scale — Количество цифр для отображения в дробной части. При необходимости результат будет округлён. UInt8

Возвращаемое значение Возвращает строковое представление числа с ровно указанным количеством цифр в дробной части. String Примеры Округление и форматирование числа

Query

SELECT toDecimalString(2.1456, 2)

Response

┌─toDecimalString(2.1456, 2)─┐
│ 2.15                       │
└────────────────────────────┘

Заполнить нулями

Query

SELECT toDecimalString(5, 3)

Response

┌─toDecimalString(5, 3)─┐
│ 5.000                 │
└───────────────────────┘

Разные числовые типы

Query

SELECT toDecimalString(CAST(123.456 AS Decimal(10,3)), 2) AS decimal_val,
       toDecimalString(CAST(42.7 AS Float32), 4) AS float_val

Response

┌─decimal_val─┬─float_val─┐
│ 123.46      │ 42.7000   │
└─────────────┴───────────┘

toFixedString

Добавленный в: v1.1.0 Преобразует аргумент String в тип FixedString(N) (строку фиксированной длины N). Если строка содержит меньше байтов, чем N, справа она дополняется null-байтами. Если строка содержит больше байтов, чем N, генерируется исключение. Синтаксис

toFixedString(s, N)

Аргументы

s — Строка, которую нужно преобразовать. String
N — Длина результирующей FixedString. const UInt*

Возвращаемое значение Возвращает FixedString длиной N. FixedString(N) Примеры Пример использования

Query

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

Response

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

toFloat32

Добавленный в: v1.1.0 Преобразует входное значение в значение типа Float32. Генерирует исключение в случае ошибки. Поддерживаемые аргументы:

Значения типа (U)Int*.
Строковые представления (U)Int8/16/32/128/256.
Значения типа Float*, включая NaN и Inf.
Строковые представления Float*, включая NaN и Inf (регистронезависимые).

Неподдерживаемые аргументы:

Строковые представления двоичных и шестнадцатеричных значений, например SELECT toFloat32('0xc0fe');.

См. также:

toFloat32OrZero.
toFloat32OrNull.
toFloat32OrDefault.

Синтаксис

toFloat32(expr)

Аргументы

expr — Выражение, возвращающее число или строковое представление числа. Выражение

Возвращаемое значение Возвращает 32-битное значение с плавающей точкой. Float32 Примеры Пример использования

Query

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

Response

Строка 1:
──────
toFloat32(42.7):   42.7
toFloat32('42.7'): 42.7
toFloat32('NaN'):  nan

toFloat32OrDefault

Добавленный в: v21.11.0 Как и toFloat32, эта функция преобразует входное значение в значение типа Float32, но в случае ошибки возвращает значение по умолчанию. Если значение default не указано, то в случае ошибки возвращается 0. Синтаксис

toFloat32OrDefault(expr[, default])

Аргументы

expr — Выражение, возвращающее число или строковое представление числа. String или (U)Int* или Float*
default — Необязательно. Значение по умолчанию, которое возвращается, если не удалось выполнить разбор. Float32

Возвращаемое значение В случае успеха возвращает значение типа Float32, в противном случае — значение по умолчанию, если оно передано, или 0, если нет. Float32 Примеры Успешное преобразование

Query

SELECT toFloat32OrDefault('8', CAST('0', 'Float32'))

Response

Ошибка преобразования

Query

SELECT toFloat32OrDefault('abc', CAST('0', 'Float32'))

Response

toFloat32OrNull

Добавленный в: v1.1.0 Преобразует входное значение в значение типа Float32, но в случае ошибки возвращает NULL. Аналогично toFloat32, но при ошибках преобразования возвращает NULL вместо генерации исключения. Поддерживаемые аргументы:

Значения типа (U)Int*.
Строковые представления (U)Int8/16/32/128/256.
Значения типа Float*, включая NaN и Inf.
Строковые представления Float*, включая NaN и Inf (регистронезависимо).

Неподдерживаемые аргументы (возвращают NULL):

Строковые представления двоичных и шестнадцатеричных значений, например: SELECT toFloat32OrNull('0xc0fe');.
Недопустимые строковые форматы.

См. также:

toFloat32.
toFloat32OrZero.
toFloat32OrDefault.

Синтаксис

toFloat32OrNull(x)

Аргументы

x — Строковое представление числа. String

Возвращаемое значение Возвращает значение типа Float32 в случае успеха, в противном случае — NULL. Float32 или NULL Примеры Пример использования

Query

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

Response

Строка 1:
──────
toFloat32OrNull('42.7'): 42.7
toFloat32OrNull('NaN'):  nan
toFloat32OrNull('abc'):  \N

toFloat32OrZero

Добавленный в: v1.1.0 Преобразует входное значение в тип Float32, но в случае ошибки возвращает 0. Аналогично toFloat32, но при ошибках преобразования возвращает 0 вместо генерации исключения. См. также:

toFloat32.
toFloat32OrNull.
toFloat32OrDefault.

Синтаксис

toFloat32OrZero(x)

Аргументы

x — Строковое представление числа. String

Возвращаемое значение Возвращает 32-битное значение Float32 в случае успеха, иначе — 0. Float32 Примеры Пример использования

Query

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

Response

Строка 1:
──────
toFloat32OrZero('42.7'): 42.7
toFloat32OrZero('abc'):  0

toFloat64

Добавленный в: v1.1.0 Преобразует входное значение в значение типа Float64. Генерирует исключение в случае ошибки. Поддерживаемые аргументы:

Значения типа (U)Int*.
Строковые представления значений типа (U)Int8/16/32/128/256.
Значения типа Float*, включая NaN и Inf.
Строковые представления значений типа Float*, включая NaN и Inf (регистронезависимо).

Неподдерживаемые аргументы:

Строковые представления двоичных и шестнадцатеричных значений, например SELECT toFloat64('0xc0fe');.

См. также:

toFloat64OrZero.
toFloat64OrNull.
toFloat64OrDefault.

Синтаксис

toFloat64(expr)

Аргументы

expr — Выражение, возвращающее число или строковое представление числа. Expression

Возвращаемое значение Возвращает 64-битное значение с плавающей точкой. Float64 Примеры Пример использования

Query

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

Response

Строка 1:
──────
toFloat64(42.7):   42.7
toFloat64('42.7'): 42.7
toFloat64('NaN'):  nan

toFloat64OrDefault

Добавленный в: v21.11.0 Как и toFloat64, эта функция преобразует входное значение в значение типа Float64, но в случае ошибки возвращает значение по умолчанию. Если значение default не указано, то в случае ошибки возвращается 0. Синтаксис

toFloat64OrDefault(expr[, default])

Аргументы

expr — Выражение, возвращающее число или строковое представление числа. String или (U)Int* или Float*
default — Необязательно. Значение по умолчанию, возвращаемое при неуспешном парсинге. Float64

Возвращаемое значение При успешном выполнении возвращает значение типа Float64, в противном случае — значение по умолчанию, если оно передано, или 0, если нет. Float64 Примеры Успешное преобразование

Query

SELECT toFloat64OrDefault('8', CAST('0', 'Float64'))

Response

Преобразование не удалось

Query

SELECT toFloat64OrDefault('abc', CAST('0', 'Float64'))

Response

toFloat64OrNull

Добавленный в: v1.1.0 Преобразует входное значение в значение типа Float64, но в случае ошибки возвращает NULL. Аналогично toFloat64, но при ошибках преобразования возвращает NULL вместо того, чтобы генерировать исключение. Поддерживаемые аргументы:

Значения типа (U)Int*.
Строковые представления (U)Int8/16/32/128/256.
Значения типа Float*, включая NaN и Inf.
Строковые представления значений типа Float*, включая NaN и Inf (регистронезависимо).

Неподдерживаемые аргументы (возвращается NULL):

Строковые представления двоичных и шестнадцатеричных значений, например SELECT toFloat64OrNull('0xc0fe');.
Недопустимые строковые форматы.

См. также:

toFloat64.
toFloat64OrZero.
toFloat64OrDefault.

Синтаксис

toFloat64OrNull(x)

Аргументы

x — строковое представление числа. String

Возвращаемое значение Возвращает 64-битное значение типа Float64 в случае успеха, в противном случае — NULL. Float64 или NULL Примеры Пример использования

Query

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

Response

строка 1:
──────
toFloat64OrNull('42.7'): 42.7
toFloat64OrNull('NaN'):  nan
toFloat64OrNull('abc'):  \N

toFloat64OrZero

Добавленный в: v1.1.0 Преобразует входное значение в Float64, но в случае ошибки возвращает 0. Аналогично toFloat64, но при ошибках преобразования возвращает 0 вместо того, чтобы генерировать исключение. См. также:

toFloat64.
toFloat64OrNull.
toFloat64OrDefault.

Синтаксис

toFloat64OrZero(x)

Аргументы

x — Строковое представление числа. String

Возвращаемое значение В случае успеха возвращает 64-битное значение с плавающей точкой, в противном случае — 0. Float64 Примеры Пример использования

Query

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

Response

Строка 1:
──────
toFloat64OrZero('42.7'): 42.7
toFloat64OrZero('abc'):  0

toInt128

Добавленный в: v1.1.0 Преобразует входное значение в значение типа Int128. В случае ошибки генерирует исключение. Функция использует округление к нулю, то есть отбрасывает дробную часть числа. Поддерживаемые аргументы:

Значения или строковые представления типа (U)Int*.
Значения типа Float*.

Неподдерживаемые аргументы:

Строковые представления значений Float*, включая NaN и Inf.
Строковые представления двоичных и шестнадцатеричных значений, например SELECT toInt128('0xc0fe');.

Если входное значение не укладывается в диапазон Int128, происходит переполнение или потеря значащих разрядов. Это не считается ошибкой.

См. также:

toInt128OrZero.
toInt128OrNull.
toInt128OrDefault.

Синтаксис

toInt128(expr)

Аргументы

expr — Выражение, возвращающее число или его строковое представление. Expression

Возвращаемое значение Возвращает 128-битное целое число. Int128 Примеры Пример использования

Query

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

Response

Строка 1:
──────
toInt128(-128):   -128
toInt128(-128.8): -128
toInt128('-128'): -128

toInt128OrDefault

Добавленный в: v21.11.0 Как и toInt128, эта функция преобразует входное значение в тип Int128, но в случае ошибки возвращает значение по умолчанию. Если значение default не передано, то в случае ошибки возвращается 0. Синтаксис

toInt128OrDefault(expr[, default])

Аргументы

expr — Выражение, возвращающее число или строковое представление числа. String или (U)Int*, или Float*
default — Необязательно. Значение по умолчанию, которое возвращается, если разбор не удался. Int128

Возвращаемое значение При успешном выполнении возвращает значение типа Int128, в противном случае — значение по умолчанию, если оно передано, или 0, если нет. Int128 Примеры Успешное преобразование

Query

SELECT toInt128OrDefault('-128', CAST('-1', 'Int128'))

Response

-128

Преобразование не удалось

Query

SELECT toInt128OrDefault('abc', CAST('-1', 'Int128'))

Response

-1

toInt128OrNull

Добавленный в: v20.8.0 Как и toInt128, эта функция преобразует входное значение в значение типа Int128, но в случае ошибки возвращает NULL. Поддерживаемые аргументы:

Строковые представления (U)Int*.

Неподдерживаемые аргументы (возвращают NULL):

Строковые представления значений Float*, включая NaN и Inf.
Строковые представления двоичных и шестнадцатеричных чисел, например SELECT toInt128OrNull('0xc0fe');.

Если входное значение не укладывается в диапазон Int128, происходит переполнение или выход за нижнюю границу диапазона результата. Это не считается ошибкой.

См. также:

toInt128.
toInt128OrZero.
toInt128OrDefault.

Синтаксис

toInt128OrNull(x)

Аргументы

x — Строковое представление числа. String

Возвращаемое значение Возвращает значение типа Int128, а если преобразование не удалось — NULL. Int128 или NULL Примеры Пример использования

Query

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

Response

Строка 1:
──────
toInt128OrNull('-128'): -128
toInt128OrNull('abc'):  \N

toInt128OrZero

Добавленный в: v20.8.0 Преобразует входное значение в тип Int128, но в случае ошибки возвращает 0. Работает как toInt128, но возвращает 0 вместо того, чтобы генерировать исключение. См. также:

toInt128.
toInt128OrNull.
toInt128OrDefault.

Синтаксис

toInt128OrZero(x)

Аргументы

x — Входное значение для преобразования. String или FixedString или Float* или Decimal или (U)Int* или Date или DateTime

Возвращаемое значение Возвращает преобразованное входное значение или 0, если преобразование не удалось. Int128 Примеры Пример использования

Query

SELECT toInt128OrZero('123')

Response

При ошибке преобразования возвращается ноль

Query

SELECT toInt128OrZero('abc')

Response

toInt16

Добавленный в: v1.1.0 Преобразует входное значение в значение типа Int16. Генерирует исключение в случае ошибки. Поддерживаемые аргументы:

Значения или строковые представления типа (U)Int*.
Значения типа Float*.

Неподдерживаемые аргументы:

Строковые представления значений типа Float*, включая NaN и Inf.
Строковые представления двоичных и шестнадцатеричных значений, например: SELECT toInt16('0xc0fe');.

Если входное значение не может быть представлено в пределах диапазона Int16, происходит переполнение или выход за нижнюю границу диапазона. Это не считается ошибкой. Например: SELECT toInt16(32768) == -32768;.

Функция использует округление к нулю, то есть отбрасывает дробную часть числа.

См. также:

toInt16OrZero.
toInt16OrNull.
toInt16OrDefault.

Синтаксис

toInt16(expr)

Аргументы

expr — Выражение, возвращающее число или строковое представление числа. Expression

Возвращаемое значение Возвращает 16-битное целое число. Int16 Примеры Пример использования

Query

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

Response

Строка 1:
──────
toInt16(-16):    -16
toInt16(-16.16): -16
toInt16('-16'):  -16

toInt16OrDefault

Добавленный в: v21.11.0 Как и toInt16, эта функция преобразует входное значение в тип Int16, но в случае ошибки возвращает значение по умолчанию. Если значение default не передано, то в случае ошибки возвращается 0. Синтаксис

toInt16OrDefault(expr[, default])

Аргументы

expr — Выражение, возвращающее число или строковое представление числа. String или (U)Int* или Float*
default — Необязательно. Значение по умолчанию, которое возвращается, если преобразование не удалось. Int16

Возвращаемое значение Возвращает значение типа Int16 в случае успешного преобразования; в противном случае возвращает значение по умолчанию, если оно передано, или 0, если нет. Int16 Примеры Успешное преобразование

Query

SELECT toInt16OrDefault('-16', CAST('-1', 'Int16'))

Response

-16

Ошибка преобразования

Query

SELECT toInt16OrDefault('abc', CAST('-1', 'Int16'))

Response

-1

toInt16OrNull

Добавленный в: v1.1.0 Как и toInt16, эта функция преобразует входное значение в значение типа Int16, но в случае ошибки возвращает NULL. Поддерживаемые аргументы:

Строковые представления (U)Int*.

Неподдерживаемые аргументы (возвращается NULL):

Строковые представления значений Float*, включая NaN и Inf.
Строковые представления двоичных и шестнадцатеричных значений, например SELECT toInt16OrNull('0xc0fe');.

Если входное значение не может быть представлено в диапазоне Int16, происходит переполнение или выход за нижнюю границу диапазона результата. Это не считается ошибкой.

См. также:

toInt16.
toInt16OrZero.
toInt16OrDefault.

Синтаксис

toInt16OrNull(x)

Аргументы

x — строковое представление числа. String

Возвращаемое значение Возвращает значение типа Int16, а если преобразование не удалось — NULL. Int16 или NULL Примеры Пример использования

Query

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

Response

Строка 1:
──────
toInt16OrNull('-16'): -16
toInt16OrNull('abc'): \N

toInt16OrZero

Добавленный в: v1.1.0 Подобно toInt16, эта функция преобразует входное значение в значение типа Int16, но в случае ошибки возвращает 0. Поддерживаемые аргументы:

Строковые представления значений (U)Int*.

Неподдерживаемые аргументы (возвращается 0):

Строковые представления значений Float*, включая NaN и Inf.
Строковые представления двоичных и шестнадцатеричных значений, например SELECT toInt16OrZero('0xc0fe');.

Если входное значение не может быть представлено в пределах диапазона Int16, происходит переполнение или выход за нижнюю границу диапазона. Это не считается ошибкой.

См. также:

toInt16.
toInt16OrNull.
toInt16OrDefault.

Синтаксис

toInt16OrZero(x)

Аргументы

x — Строковое представление числа. String

Возвращаемое значение Возвращает значение типа Int16; если преобразование не удаётся, возвращается 0. Int16 Примеры Пример использования

Query

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

Response

Строка 1:
──────
toInt16OrZero('16'): 16
toInt16OrZero('abc'): 0

toInt256

Добавленный в: v1.1.0 Преобразует входное значение в значение типа Int256. Генерирует исключение в случае ошибки. Функция использует округление к нулю, то есть отбрасывает дробную часть числа. Поддерживаемые аргументы:

Значения или строковые представления типа (U)Int*.
Значения типа Float*.

Неподдерживаемые аргументы:

Строковые представления значений Float*, включая NaN и Inf.
Строковые представления двоичных и шестнадцатеричных значений, например SELECT toInt256('0xc0fe');.

Если входное значение не может быть представлено в диапазоне Int256, происходит переполнение или выход за нижнюю границу диапазона. Это не считается ошибкой.

См. также:

toInt256OrZero.
toInt256OrNull.
toInt256OrDefault.

Синтаксис

toInt256(expr)

Аргументы

expr — выражение, возвращающее число или его строковое представление. Expression

Возвращаемое значение Возвращает 256-битное целое значение. Int256 Примеры Пример использования

Query

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

Response

Строка 1:
──────
toInt256(-256):     -256
toInt256(-256.256): -256
toInt256('-256'):   -256

toInt256OrDefault

Добавленный в: v21.11.0 Как и toInt256, эта функция преобразует входное значение в значение типа Int256, но в случае ошибки возвращает значение по умолчанию. Если значение default не указано, то в случае ошибки возвращается 0. Синтаксис

toInt256OrDefault(expr[, default])

Аргументы

expr — Выражение, возвращающее число или строковое представление числа. String, (U)Int* или Float*
default — Необязательно. Значение по умолчанию, которое возвращается, если парсинг не удался. Int256

Возвращаемое значение При успешном выполнении возвращает значение типа Int256, в противном случае — значение по умолчанию, если оно было передано, или 0, если нет. Int256 Примеры Успешное преобразование

Query

SELECT toInt256OrDefault('-256', CAST('-1', 'Int256'))

Response

-256

Ошибка преобразования

Query

SELECT toInt256OrDefault('abc', CAST('-1', 'Int256'))

Response

-1

toInt256OrNull

Добавленный в: v20.8.0 Подобно toInt256, эта функция преобразует входное значение в значение типа Int256, но при ошибке возвращает NULL. Поддерживаемые аргументы:

Строковые представления (U)Int*.

Неподдерживаемые аргументы (возвращается NULL):

Строковые представления значений Float*, включая NaN и Inf.
Строковые представления двоичных и шестнадцатеричных значений, например SELECT toInt256OrNull('0xc0fe');.

Если входное значение не может быть представлено в пределах Int256, происходит переполнение или выход за нижнюю границу диапазона результата. Это не считается ошибкой.

См. также:

toInt256.
toInt256OrZero.
toInt256OrDefault.

Синтаксис

toInt256OrNull(x)

Аргументы

x — строковое представление числа. String

Возвращаемое значение Возвращает значение типа Int256; если преобразование не удалось, возвращает NULL. Int256 или NULL Примеры Пример использования

Query

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

Response

Строка 1:
──────
toInt256OrNull('-256'): -256
toInt256OrNull('abc'):  \N

toInt256OrZero

Добавленный в: v20.8.0 Преобразует входное значение в тип Int256, но в случае ошибки возвращает 0. Аналогична toInt256, но возвращает 0 вместо генерации исключения. См. также:

toInt256.
toInt256OrNull.
toInt256OrDefault.

Синтаксис

toInt256OrZero(x)

Аргументы

x — Входное значение, которое нужно преобразовать. String или FixedString или Float* или Decimal или (U)Int* или Date или DateTime

Возвращаемое значение Преобразованное входное значение; если преобразование не удалось, возвращается 0. Int256 Примеры Пример использования

Query

SELECT toInt256OrZero('123')

Response

При ошибке преобразования возвращается ноль

Query

SELECT toInt256OrZero('abc')

Response

toInt32

Добавленный в: v1.1.0 Преобразует входное значение в значение типа Int32. В случае ошибки генерирует исключение. Поддерживаемые аргументы:

Значения или строковые представления типа (U)Int*.
Значения типа Float*.

Неподдерживаемые аргументы:

Строковые представления значений типа Float*, включая NaN и Inf.
Строковые представления двоичных и шестнадцатеричных значений, например SELECT toInt32('0xc0fe');.

Если входное значение не может быть представлено в диапазоне Int32, происходит переполнение или выход за нижнюю границу диапазона. Это не считается ошибкой. Например: SELECT toInt32(2147483648) == -2147483648;

Функция использует округление к нулю, то есть отбрасывает дробную часть числа.

См. также:

toInt32OrZero.
toInt32OrNull.
toInt32OrDefault.

Синтаксис

toInt32(expr)

Аргументы

expr — Выражение, возвращающее число или строковое представление числа. Expression

Возвращаемое значение Возвращает 32-битное целое число. Int32 Примеры Пример использования

Query

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

Response

Строка 1:
──────
toInt32(-32):    -32
toInt32(-32.32): -32
toInt32('-32'):  -32

toInt32OrDefault

Добавленный в: v21.11.0 Как и toInt32, эта функция преобразует входное значение в значение типа Int32, но в случае ошибки возвращает значение по умолчанию. Если значение default не передано, при ошибке возвращается 0. Синтаксис

toInt32OrDefault(expr[, default])

Аргументы

expr — Выражение, возвращающее число или его строковое представление. String или (U)Int* или Float*
default — Необязательно. Значение по умолчанию, которое возвращается, если парсинг завершился неудачно. Int32

Возвращаемое значение При успешном выполнении возвращает значение типа Int32, в противном случае — значение по умолчанию, если оно передано, или 0, если нет. Int32 Примеры Успешное преобразование

Query

SELECT toInt32OrDefault('-32', CAST('-1', 'Int32'))

Response

-32

Ошибка преобразования

Query

SELECT toInt32OrDefault('abc', CAST('-1', 'Int32'))

Response

-1

toInt32OrNull

Добавленный в: v1.1.0 Как и toInt32, эта функция преобразует входное значение в значение типа Int32, но в случае ошибки возвращает NULL. Поддерживаемые аргументы:

Строковые представления (U)Int*.

Неподдерживаемые аргументы (возвращает NULL):

Строковые представления значений Float*, включая NaN и Inf.
Строковые представления двоичных и шестнадцатеричных значений, например SELECT toInt32OrNull('0xc0fe');.

Если входное значение не может быть представлено в диапазоне Int32, происходит переполнение или выход за нижнюю границу диапазона результата. Это не считается ошибкой.

См. также:

toInt32.
toInt32OrZero.
toInt32OrDefault.

Синтаксис

toInt32OrNull(x)

Аргументы

x — Строковое представление числа. String

Возвращаемое значение Возвращает значение типа Int32, а если преобразование не удалось — NULL. Int32 или NULL Примеры Пример использования

Query

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

Response

Строка 1:
──────
toInt32OrNull('-32'): -32
toInt32OrNull('abc'): \N

toInt32OrZero

Добавленный в: v1.1.0 Как и toInt32, эта функция преобразует входное значение в значение типа Int32, но в случае ошибки возвращает 0. Поддерживаемые аргументы:

Строковые представления (U)Int*.

Неподдерживаемые аргументы (возвращают 0):

Строковые представления значений Float*, включая NaN и Inf.
Строковые представления двоичных и шестнадцатеричных значений, например SELECT toInt32OrZero('0xc0fe');.

Если входное значение не может быть представлено в пределах Int32, происходит переполнение или выход за нижнюю границу диапазона результата. Это не считается ошибкой.

См. также:

toInt32.
toInt32OrNull.
toInt32OrDefault.

Синтаксис

toInt32OrZero(x)

Аргументы

x — Строковое представление числа. String

Возвращаемое значение Возвращает значение типа Int32, а если преобразование невозможно — 0. Int32 Примеры Пример использования

Query

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

Response

Строка 1:
──────
toInt32OrZero('32'): 32
toInt32OrZero('abc'): 0

toInt64

Добавленный в: v1.1.0 Преобразует входное значение в значение типа Int64. Генерирует исключение в случае ошибки. Поддерживаемые аргументы:

Значения или строковые представления типа (U)Int*.
Значения типа Float*.

Неподдерживаемые аргументы:

Строковые представления значений Float*, включая NaN и Inf.
Строковые представления двоичных и шестнадцатеричных значений, например SELECT toInt64('0xc0fe');.

Если входное значение не может быть представлено в диапазоне Int64, происходит переполнение или выход за нижнюю границу диапазона. Это не считается ошибкой. Например: SELECT toInt64(9223372036854775808) == -9223372036854775808;

Функция использует округление к нулю, то есть отбрасывает дробную часть числа.

См. также:

toInt64OrZero.
toInt64OrNull.
toInt64OrDefault.

Синтаксис

toInt64(expr)

Аргументы

expr — Выражение, возвращающее число или строковое представление числа. Поддерживаются: значения или строковые представления значений типа (U)Int*, значения типа Float*. Не поддерживаются: строковые представления значений Float*, включая NaN и Inf, а также строковые представления двоичных и шестнадцатеричных значений. Expression

Возвращаемое значение Возвращает 64-битное целое число. Int64 Примеры Пример использования

Query

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

Response

строка 1:
──────
toInt64(-64):    -64
toInt64(-64.64): -64
toInt64('-64'):  -64

toInt64OrDefault

Добавленный в: v21.11.0 Как и toInt64, эта функция преобразует входное значение в тип Int64, но в случае ошибки возвращает значение по умолчанию. Если значение default не передано, то в случае ошибки возвращается 0. Синтаксис

toInt64OrDefault(expr[, default])

Аргументы

expr — Выражение, возвращающее число или строковое представление числа. String или (U)Int* или Float*
default — Необязательный параметр. Значение по умолчанию, которое возвращается, если не удалось выполнить парсинг. Int64

Возвращаемое значение Возвращает значение типа Int64 в случае успеха; в противном случае возвращает переданное значение по умолчанию, а если оно не указано — 0. Int64 Примеры Успешное преобразование

Query

SELECT toInt64OrDefault('-64', CAST('-1', 'Int64'))

Response

-64

Не удалось преобразовать

Query

SELECT toInt64OrDefault('abc', CAST('-1', 'Int64'))

Response

-1

toInt64OrNull

Добавленный в: v1.1.0 Как и toInt64, эта функция преобразует входное значение в значение типа Int64, но в случае ошибки возвращает NULL. Поддерживаемые аргументы:

Строковые представления значений (U)Int*.

Неподдерживаемые аргументы (возвращается NULL):

Строковые представления значений Float*, включая NaN и Inf.
Строковые представления двоичных и шестнадцатеричных значений, например SELECT toInt64OrNull('0xc0fe');.

Если входное значение не может быть представлено в диапазоне Int64, происходит переполнение или выход за нижнюю границу диапазона результата. Это не считается ошибкой.

См. также:

toInt64.
toInt64OrZero.
toInt64OrDefault.

Синтаксис

toInt64OrNull(x)

Аргументы

x — Строковое представление числа. String

Возвращаемое значение Возвращает значение типа Int64; в противном случае — NULL, если преобразование выполнить не удалось. Int64 или NULL Примеры Пример использования

Query

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

Response

Строка 1:
──────
toInt64OrNull('-64'): -64
toInt64OrNull('abc'): \N

toInt64OrZero

Добавленный в: v1.1.0 Преобразует входное значение в тип Int64, но в случае ошибки возвращает 0. Аналогично toInt64, но возвращает 0 вместо генерации исключения. См. также:

toInt64.
toInt64OrNull.
toInt64OrDefault.

Синтаксис

toInt64OrZero(x)

Аргументы

x — Входное значение для преобразования. String или FixedString или Float* или Decimal или (U)Int* или Date или DateTime

Возвращаемое значение Возвращает преобразованное входное значение; в случае ошибки преобразования возвращает 0. Int64 Примеры Пример использования

Query

SELECT toInt64OrZero('123')

Response

При неудачном преобразовании возвращается ноль

Query

SELECT toInt64OrZero('abc')

Response

toInt8

Добавленный в: v1.1.0 Преобразует входное значение в значение типа Int8. При ошибке генерирует исключение. Поддерживаемые аргументы:

Значения или строковые представления значений типа (U)Int*.
Значения типа Float*.

Неподдерживаемые аргументы:

Строковые представления значений Float*, включая NaN и Inf.
Строковые представления двоичных и шестнадцатеричных значений, например SELECT toInt8('0xc0fe');.

Если входное значение не может быть представлено в диапазоне Int8, происходит переполнение или выход за нижнюю границу диапазона результата. Это не считается ошибкой. Например: SELECT toInt8(128) == -128;.

Функция использует округление к нулю, то есть отбрасывает дробную часть числа.

См. также:

toInt8OrZero.
toInt8OrNull.
toInt8OrDefault.

Синтаксис

toInt8(expr)

Аргументы

expr — Выражение, возвращающее число или строковое представление числа. Выражение

Возвращаемое значение Возвращает 8-битное целочисленное значение. Int8 Примеры Пример использования

Query

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

Response

Строка 1:
──────
toInt8(-8):   -8
toInt8(-8.8): -8
toInt8('-8'): -8

toInt8OrDefault

Добавленный в: v21.11.0 Как и toInt8, эта функция преобразует входное значение в значение типа Int8, но в случае ошибки возвращает значение по умолчанию. Если значение default не передано, то при ошибке возвращается 0. Синтаксис

toInt8OrDefault(expr[, default])

Аргументы

expr — Выражение, возвращающее число или строковое представление числа. String или (U)Int* или Float*
default — Необязательно. Значение по умолчанию, которое возвращается, если разбор завершился неудачно. Int8

Возвращаемое значение В случае успеха возвращает значение типа Int8, в противном случае — значение по умолчанию, если оно было передано, или 0, если нет. Int8 Примеры Успешное преобразование

Query

SELECT toInt8OrDefault('-8', CAST('-1', 'Int8'))

Response

-8

Не удалось преобразовать

Query

SELECT toInt8OrDefault('abc', CAST('-1', 'Int8'))

Response

-1

toInt8OrNull

Добавленный в: v1.1.0 Как и toInt8, эта функция преобразует входное значение в значение типа Int8, но в случае ошибки возвращает NULL. Поддерживаемые аргументы:

Строковые представления (U)Int*.

Неподдерживаемые аргументы (возвращают NULL):

Строковые представления значений Float*, включая NaN и Inf.
Строковые представления двоичных и шестнадцатеричных значений, например SELECT toInt8OrNull('0xc0fe');.

Если входное значение не может быть представлено в пределах диапазона Int8, происходит переполнение или выход за нижнюю границу диапазона. Это не считается ошибкой.

См. также:

toInt8.
toInt8OrZero.
toInt8OrDefault.

Синтаксис

toInt8OrNull(x)

Аргументы

x — Строковое представление числа. String

Возвращаемое значение Возвращает значение типа Int8 или NULL, если преобразование не удалось. Int8 или NULL Примеры Пример использования

Query

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

Response

Строка 1:
──────
toInt8OrNull('-8'):  -8
toInt8OrNull('abc'): \N

toInt8OrZero

Добавленный в: v1.1.0 Как и toInt8, эта функция преобразует входное значение в значение типа Int8, но в случае ошибки возвращает 0. Поддерживаемые аргументы:

Строковые представления (U)Int*.

Неподдерживаемые аргументы (возвращают 0):

Строковые представления значений Float*, включая NaN и Inf.
Строковые представления двоичных и шестнадцатеричных значений, например SELECT toInt8OrZero('0xc0fe');.

Если входное значение не может быть представлено в пределах Int8, происходит переполнение или выход за нижнюю границу диапазона результата. Это не считается ошибкой.

См. также:

toInt8.
toInt8OrNull.
toInt8OrDefault.

Синтаксис

toInt8OrZero(x)

Аргументы

x — Строковое представление числа. String

Возвращаемое значение Возвращает значение типа Int8, а если преобразование не удалось — 0. Int8 Примеры Пример использования

Query

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

Response

Строка 1:
──────
toInt8OrZero('8'): 8
toInt8OrZero('abc'): 0

toInterval

Добавленный в: v25.4.0 Создает значение Interval из числового значения и строки с единицей измерения. Эта функция предоставляет единый способ создавать интервалы разных типов (секунды, минуты, часы, дни, недели, месяцы, кварталы, годы) с помощью одной функции, указывая единицу измерения в виде строкового аргумента. Строка единицы измерения регистронезависима. Это эквивалентно вызову функций для конкретных типов, таких как toIntervalSecond, toIntervalMinute, toIntervalDay и т. д., но позволяет динамически указывать единицу измерения в виде строкового параметра. Синтаксис

toInterval(value, unit)

Аргументы

value — Числовое значение, задающее количество единиц. Может быть любого числового типа: Int8 or Int16 or Int32 or Int64 or UInt8 or UInt16 or UInt32 or UInt64 or Float32 or Float64
unit — Единица времени. Должна быть строковой константой. Допустимые значения: ‘nanosecond’, ‘microsecond’, ‘millisecond’, ‘second’, ‘minute’, ‘hour’, ‘day’, ‘week’, ‘month’, ‘quarter’, ‘year’. String

Возвращаемое значение Возвращает значение типа Interval указанного вида. Тип результата зависит от единицы времени: IntervalNanosecond, IntervalMicrosecond, IntervalMillisecond, IntervalSecond, IntervalMinute, IntervalHour, IntervalDay, IntervalWeek, IntervalMonth, IntervalQuarter или IntervalYear. Interval Примеры Создание интервалов с разными единицами времени

Query

SELECT
    toInterval(5, 'second') AS seconds,
    toInterval(3, 'day') AS days,
    toInterval(2, 'month') AS months

Response

┌─seconds─┬─days─┬─months─┐
│ 5       │ 3    │ 2      │
└─────────┴──────┴────────┘

Используйте интервалы в операциях с датами

Query

SELECT
    now() AS current_time,
    now() + toInterval(1, 'hour') AS one_hour_later,
    now() - toInterval(7, 'day') AS week_ago

Response

┌─────────current_time─┬──one_hour_later─────┬────────────week_ago─┐
│ 2025-01-04 10:30:00  │ 2025-01-04 11:30:00 │ 2024-12-28 10:30:00 │
└──────────────────────┴─────────────────────┴─────────────────────┘

Динамическое создание интервала

Query

SELECT toDate('2025-01-01') + toInterval(number, 'day') AS dates
FROM numbers(5)

Response

┌──────dates─┐
│ 2025-01-01 │
│ 2025-01-02 │
│ 2025-01-03 │
│ 2025-01-04 │
│ 2025-01-05 │
└────────────┘

toIntervalDay

Добавленный в: v1.1.0 Возвращает интервал в n дней типа данных IntervalDay. Синтаксис

toIntervalDay(n)

Аргументы

n — Количество дней. Целые числа, их строковые представления, а также числа с плавающей точкой. (U)Int* или Float* или String

Возвращаемое значение Возвращает интервал длиной в n дней. Interval Примеры Пример использования

Query

WITH
    toDate('2025-06-15') AS date,
    toIntervalDay(5) AS interval_to_days
SELECT date + interval_to_days AS result

Response

┌─────result─┐
│ 2025-06-20 │
└────────────┘

toIntervalHour

Добавленный в: v1.1.0 Возвращает интервал в n часов с типом данных IntervalHour. Синтаксис

toIntervalHour(n)

Аргументы

n — Количество часов. Целые числа, их строковые представления, а также числа с плавающей точкой. Int* или UInt* или Float* или String

Возвращаемое значение Возвращает интервал длительностью n часов. Interval Примеры Пример использования

Query

WITH
    toDate('2025-06-15') AS date,
    toIntervalHour(12) AS interval_to_hours
SELECT date + interval_to_hours AS result

Response

┌──────────────result─┐
│ 2025-06-15 12:00:00 │
└─────────────────────┘

toIntervalMicrosecond

Добавленный в: v22.6.0 Возвращает интервал в n микросекунд типа IntervalMicrosecond. Синтаксис

toIntervalMicrosecond(n)

Аргументы

n — количество микросекунд. (U)Int* или Float* или String

Возвращаемое значение Возвращает интервал длительностью n микросекунд. Interval Примеры Пример использования

Query

WITH
    toDateTime('2025-06-15') AS date,
    toIntervalMicrosecond(30) AS interval_to_microseconds
SELECT date + interval_to_microseconds AS result

Response

┌─────────────────────result─┐
│ 2025-06-15 00:00:00.000030 │
└────────────────────────────┘

toIntervalMillisecond

Добавленный в: v22.6.0 Возвращает интервал длиной n миллисекунд типа данных IntervalMillisecond. Синтаксис

toIntervalMillisecond(n)

Аргументы

n — число миллисекунд. (U)Int* или Float* или String

Возвращаемое значение Возвращает интервал длиной в n миллисекунд. Interval Примеры Пример использования

Query

WITH
    toDateTime('2025-06-15') AS date,
    toIntervalMillisecond(30) AS interval_to_milliseconds
SELECT date + interval_to_milliseconds AS result

Response

┌──────────────────result─┐
│ 2025-06-15 00:00:00.030 │
└─────────────────────────┘

toIntervalMinute

Добавленный в: v1.1.0 Возвращает интервал длительностью n минут типа данных IntervalMinute. Синтаксис

toIntervalMinute(n)

Аргументы

n — Количество минут. Целые числа или их строковые представления, а также числа с плавающей точкой. (U)Int* или Float* или String

Возвращаемое значение Возвращает интервал в n минут. Interval Примеры Пример использования

Query

WITH
    toDate('2025-06-15') AS date,
    toIntervalMinute(12) AS interval_to_minutes
SELECT date + interval_to_minutes AS result

Response

┌──────────────result─┐
│ 2025-06-15 00:12:00 │
└─────────────────────┘

toIntervalMonth

Добавленный в: v1.1.0 Возвращает интервал в n месяцев типа IntervalMonth. Синтаксис

toIntervalMonth(n)

Аргументы

n — количество месяцев. (U)Int* или Float* или String

Возвращаемое значение Возвращает интервал в n месяцев. Interval Примеры Пример использования

Query

WITH
    toDate('2025-06-15') AS date,
    toIntervalMonth(1) AS interval_to_month
SELECT date + interval_to_month AS result

Response

┌─────result─┐
│ 2025-07-15 │
└────────────┘

toIntervalNanosecond

Добавленный в: v22.6.0 Возвращает интервал в n наносекунд типа данных IntervalNanosecond. Синтаксис

toIntervalNanosecond(n)

Аргументы

n — Количество наносекунд. (U)Int* или Float* или String

Возвращаемое значение Возвращает интервал в n наносекунд. Interval Примеры Пример использования

Query

WITH
    toDateTime('2025-06-15') AS date,
    toIntervalNanosecond(30) AS interval_to_nanoseconds
SELECT date + interval_to_nanoseconds AS result

Response

┌────────────────────────result─┐
│ 2025-06-15 00:00:00.000000030 │
└───────────────────────────────┘

toIntervalQuarter

Добавленный в: v1.1.0 Возвращает интервал в n кварталов типа данных IntervalQuarter. Синтаксис

toIntervalQuarter(n)

Аргументы

n — количество кварталов. (U)Int* или Float* или String

Возвращаемое значение Возвращает интервал в n кварталов. Interval Примеры Пример использования

Query

WITH
    toDate('2025-06-15') AS date,
    toIntervalQuarter(1) AS interval_to_quarter
SELECT date + interval_to_quarter AS result

Response

┌─────result─┐
│ 2025-09-15 │
└────────────┘

toIntervalSecond

Добавленный в: v1.1.0 Возвращает интервал длительностью n секунд типа данных IntervalSecond. Синтаксис

toIntervalSecond(n)

Аргументы

n — Количество секунд. Целые числа, их строковые представления, а также числа с плавающей точкой. (U)Int* или Float* или String

Возвращаемое значение Возвращает интервал длительностью n секунд. Interval Примеры Пример использования

Query

WITH
    toDate('2025-06-15') AS date,
    toIntervalSecond(30) AS interval_to_seconds
SELECT date + interval_to_seconds AS result

Response

┌──────────────result─┐
│ 2025-06-15 00:00:30 │
└─────────────────────┘

toIntervalWeek

Добавленный в: v1.1.0 Возвращает интервал в n недель с типом данных IntervalWeek. Синтаксис

toIntervalWeek(n)

Аргументы

n — Количество недель. (U)Int* или Float* или String

Возвращаемое значение Возвращает интервал длиной в n недель. Interval Примеры Пример использования

Query

WITH
    toDate('2025-06-15') AS date,
    toIntervalWeek(1) AS interval_to_week
SELECT date + interval_to_week AS result

Response

┌─────result─┐
│ 2025-06-22 │
└────────────┘

toIntervalYear

Добавленный в: v1.1.0 Возвращает интервал длиной в n лет типа данных IntervalYear. Синтаксис

toIntervalYear(n)

Аргументы

n — Количество лет. (U)Int* или Float* или String

Возвращаемое значение Возвращает интервал длиной в n лет. Interval Примеры Пример использования

Query

WITH
    toDate('2024-06-15') AS date,
    toIntervalYear(1) AS interval_to_year
SELECT date + interval_to_year AS result

Response

┌─────result─┐
│ 2025-06-15 │
└────────────┘

toLowCardinality

Добавленный в: v18.12.0 Преобразует входной аргумент в версию LowCardinality того же типа данных.

Чтобы преобразовать тип данных LowCardinality в обычный тип данных, используйте функцию CAST. Например: CAST(x AS String).

Синтаксис

toLowCardinality(expr)

Аргументы

expr — выражение, результат которого имеет один из поддерживаемых типов данных: String, FixedString, Date, DateTime, (U)Int* или Float*

Возвращаемое значение Возвращает входное значение, преобразованное в тип данных LowCardinality. LowCardinality Примеры Пример использования

Query

SELECT toLowCardinality('1')

Response

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

toString

Добавленный в: v1.1.0 Преобразует значения в строковое представление. Для аргументов DateTime функция может принимать второй аргумент типа String, содержащий имя часового пояса. Синтаксис

toString(value[, timezone])

Аргументы

value — Значение для преобразования в строку. Any
timezone — Необязательно. Имя часового пояса для преобразования значения DateTime. String

Возвращаемое значение Возвращает строковое представление входного значения. String Примеры Пример использования

Query

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

Response

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

toStringCutToZero

Добавленный в: v1.1.0 Принимает аргумент типа String или FixedString и возвращает String, содержащую копию исходной строки, обрезанную по первому null-байту. Null-байты (\0) считаются символами окончания строки. Эта функция полезна при обработке строк в стиле C или бинарных данных, где null-байты обозначают конец значимого содержимого. Синтаксис

toStringCutToZero(s)

Аргументы

s — обрабатываемое значение типа String или FixedString. String или FixedString

Возвращаемое значение Возвращает значение типа String, содержащее символы до первого null-байта. String Примеры Пример использования

Query

SELECT
    toStringCutToZero('hello'),
    toStringCutToZero('hello\0world')

Response

┌─toStringCutToZero('hello')─┬─toStringCutToZero('hello\\0world')─┐
│ hello                      │ hello                             │
└────────────────────────────┴───────────────────────────────────┘

toTime

Добавленный в: v1.1.0 Преобразует входное значение в тип Time. Поддерживает преобразование из String, FixedString, DateTime или числовых типов, обозначающих количество секунд с полуночи. Синтаксис

toTime(x)

Аргументы

x — Входное значение для преобразования. String or FixedString or DateTime or (U)Int* or Float*

Возвращаемое значение Преобразованное значение. Time Примеры Преобразование из String в Time

Query

SELECT toTime('14:30:25')

Response

14:30:25

Преобразование DateTime в тип Time

Query

SELECT toTime(toDateTime('2025-04-15 14:30:25'))

Response

14:30:25

Преобразование целого числа в тип Time

Query

SELECT toTime(52225)

Response

14:30:25

toTime64

Добавленный в: v25.6.0 Преобразует входное значение в тип Time64. Поддерживает преобразование из String, FixedString, DateTime64 или числовых типов, представляющих количество микросекунд, прошедших с полуночи. Обеспечивает микросекундную точность значений времени. Синтаксис

toTime64(x)

Аргументы

x — Входное значение для преобразования. String или FixedString, или DateTime64, или (U)Int*, или Float*

Возвращаемое значение Возвращает преобразованное входное значение с точностью до микросекунд. Time64(6) Примеры Преобразование String в Time64

Query

SELECT toTime64('14:30:25.123456')

Response

14:30:25.123456

Преобразование DateTime64 в Time64

Query

SELECT toTime64(toDateTime64('2025-04-15 14:30:25.123456', 6))

Response

14:30:25.123456

Преобразование целочисленного значения в Time64

Query

SELECT toTime64(52225123456)

Response

14:30:25.123456

toTime64OrNull

Добавленный в: v25.6.0 Преобразует входное значение в значение типа Time64, но в случае ошибки возвращает NULL. Аналогично toTime64, но при ошибках преобразования возвращает NULL вместо генерации исключения. См. также:

toTime64
toTime64OrZero

Синтаксис

toTime64OrNull(x)

Аргументы

x — строковое представление времени с субсекундной точностью. String

Возвращаемое значение При успешном выполнении возвращает значение Time64, в противном случае — NULL. Time64 или NULL Примеры Пример использования

Query

SELECT toTime64OrNull('12:30:45.123'), toTime64OrNull('invalid')

Response

┌─toTime64OrNull('12:30:45.123')─┬─toTime64OrNull('invalid')─┐
│                   12:30:45.123 │                      ᴺᵁᴸᴸ │
└────────────────────────────────┴───────────────────────────┘

toTime64OrZero

Добавленный в: v25.6.0 Преобразует входное значение в значение типа Time64, но в случае ошибки возвращает 00:00:00.000. Аналогично toTime64, но при ошибках преобразования возвращает 00:00:00.000 вместо генерации исключения. Синтаксис

toTime64OrZero(x)

Аргументы

x — строковое представление времени с субсекундной точностью. String

Возвращаемое значение Возвращает значение типа Time64 в случае успеха, иначе — 00:00:00.000. Time64 Примеры Пример использования

Query

SELECT toTime64OrZero('12:30:45.123'), toTime64OrZero('invalid')

Response

┌─toTime64OrZero('12:30:45.123')─┬─toTime64OrZero('invalid')─┐
│                   12:30:45.123 │             00:00:00.000 │
└────────────────────────────────┴──────────────────────────┘

toTimeOrNull

Добавленный в: v1.1.0 Преобразует входное значение в значение типа Time, но в случае ошибки возвращает NULL. Аналогично toTime, но при ошибках преобразования возвращает NULL вместо генерации исключения. См. также:

toTime
toTimeOrZero

Синтаксис

toTimeOrNull(x)

Аргументы

x — строковое представление времени. String

Возвращаемое значение Возвращает значение типа Time в случае успеха, в противном случае — NULL. Time или NULL Примеры Пример использования

Query

SELECT toTimeOrNull('12:30:45'), toTimeOrNull('invalid')

Response

┌─toTimeOrNull('12:30:45')─┬─toTimeOrNull('invalid')─┐
│                 12:30:45 │                    ᴺᵁᴸᴸ │
└──────────────────────────┴─────────────────────────┘

toTimeOrZero

Добавленный в: v1.1.0 Преобразует входное значение в значение типа Time, а в случае ошибки возвращает 00:00:00. Как и toTime, при ошибках преобразования возвращает 00:00:00 вместо того, чтобы генерировать исключение. Синтаксис

toTimeOrZero(x)

Аргументы

x — Строковое представление времени. String

Возвращаемое значение Возвращает значение типа Time в случае успеха, в противном случае — 00:00:00. Time Примеры Пример использования

Query

SELECT toTimeOrZero('12:30:45'), toTimeOrZero('invalid')

Response

┌─toTimeOrZero('12:30:45')─┬─toTimeOrZero('invalid')─┐
│                 12:30:45 │                00:00:00 │
└──────────────────────────┴─────────────────────────┘

toUInt128

Добавленный в: v1.1.0 Преобразует входное значение в значение типа UInt128. В случае ошибки генерирует исключение. Функция использует округление к нулю, то есть отбрасывает дробную часть числа. Поддерживаемые аргументы:

Значения или строковые представления типа (U)Int*.
Значения типа Float*.

Неподдерживаемые аргументы:

Строковые представления значений Float*, включая NaN и Inf.
Строковые представления двоичных и шестнадцатеричных значений, например SELECT toUInt128('0xc0fe');.

Если входное значение не может быть представлено в пределах UInt128, происходит переполнение или потеря значащих разрядов. Это не считается ошибкой.

См. также:

toUInt128OrZero.
toUInt128OrNull.
toUInt128OrDefault.

Синтаксис

toUInt128(expr)

Аргументы

expr — Выражение, возвращающее число или строковое представление числа. Выражение

Возвращаемое значение Возвращает 128-битное беззнаковое целое значение. UInt128 Примеры Пример использования

Query

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

Response

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

toUInt128OrDefault

Добавленный в: v21.11.0 Как и toUInt128, эта функция преобразует входное значение в значение типа UInt128, но в случае ошибки возвращает значение по умолчанию. Если значение default не передано, то при ошибке возвращается 0. Синтаксис

toUInt128OrDefault(expr[, default])

Аргументы

expr — Выражение, возвращающее число или строковое представление числа. String или (U)Int* или Float*
default — Необязательно. Значение по умолчанию, которое будет возвращено, если разбор не выполнен. UInt128

Возвращаемое значение Возвращает значение типа UInt128 в случае успеха, в противном случае — значение по умолчанию, если оно передано, или 0, если нет. UInt128 Примеры Успешное преобразование

Query

SELECT toUInt128OrDefault('128', CAST('0', 'UInt128'))

Response

Не удалось выполнить преобразование

Query

SELECT toUInt128OrDefault('abc', CAST('0', 'UInt128'))

Response

toUInt128OrNull

Добавленный в: v21.6.0 Как и toUInt128, эта функция преобразует входное значение в значение типа UInt128, но в случае ошибки возвращает NULL. Поддерживаемые аргументы:

Строковые представления (U)Int*.

Неподдерживаемые аргументы (возвращают NULL):

Строковые представления значений Float*, включая NaN и Inf.
Строковые представления двоичных и шестнадцатеричных значений, например SELECT toUInt128OrNull('0xc0fe');.

Если входное значение не может быть представлено в пределах диапазона UInt128, происходит переполнение или выход за нижнюю границу диапазона. Это не считается ошибкой.

См. также:

toUInt128.
toUInt128OrZero.
toUInt128OrDefault.

Синтаксис

toUInt128OrNull(x)

Аргументы

x — строковое представление числа. String

Возвращаемое значение Возвращает значение типа UInt128, а если преобразование не удалось — NULL. UInt128 или NULL Примеры Пример использования

Query

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

Response

Строка 1:
──────
toUInt128OrNull('128'): 128
toUInt128OrNull('abc'): \N

toUInt128OrZero

Добавленный в: v1.1.0 Подобно toUInt128, эта функция преобразует входное значение в значение типа UInt128, но в случае ошибки возвращает 0. Поддерживаемые аргументы:

Строковые представления (U)Int*.

Неподдерживаемые аргументы (возвращается 0):

Строковые представления значений Float*, включая NaN и Inf.
Строковые представления двоичных и шестнадцатеричных значений, например SELECT toUInt128OrZero('0xc0fe');.

Если входное значение не может быть представлено в пределах UInt128, происходит переполнение или выход за нижнюю границу диапазона результата. Это не считается ошибкой.

См. также:

toUInt128.
toUInt128OrNull.
toUInt128OrDefault.

Синтаксис

toUInt128OrZero(x)

Аргументы

x — Строковое представление числа. String

Возвращаемое значение Возвращает значение типа UInt128, а если преобразование не удалось — 0. UInt128 Примеры Пример использования

Query

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

Response

Строка 1:
──────
toUInt128OrZero('128'): 128
toUInt128OrZero('abc'): 0

toUInt16

Добавленный в: v1.1.0 Преобразует входное значение в значение типа UInt16. В случае ошибки генерирует исключение. Поддерживаемые аргументы:

Значения или строковые представления типа (U)Int*.
Значения типа Float*.

Неподдерживаемые аргументы:

Строковые представления значений Float*, включая NaN и Inf.
Строковые представления двоичных и шестнадцатеричных значений, например SELECT toUInt16('0xc0fe');.

Если входное значение не может быть представлено в границах UInt16, происходит переполнение или выход за нижнюю границу диапазона результата. Это не считается ошибкой. Например: SELECT toUInt16(65536) == 0;.

Функция использует округление к нулю, то есть отбрасывает дробную часть числа.

См. также:

toUInt16OrZero.
toUInt16OrNull.
toUInt16OrDefault.

Синтаксис

toUInt16(expr)

Аргументы

expr — Выражение, возвращающее число или строковое представление числа. Выражение

Возвращаемое значение Возвращает 16-битное беззнаковое целое число. UInt16 Примеры Пример использования

Query

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

Response

Строка 1:
──────
toUInt16(16):    16
toUInt16(16.16): 16
toUInt16('16'):  16

toUInt16OrDefault

Добавленный в: v21.11.0 Как и toUInt16, эта функция преобразует входное значение в тип UInt16, но в случае ошибки возвращает значение по умолчанию. Если значение default не передано, то в случае ошибки возвращается 0. Синтаксис

toUInt16OrDefault(expr[, default])

Аргументы

expr — Выражение, возвращающее число или строковое представление числа. String или (U)Int* или Float*
default — Необязательный параметр. Значение по умолчанию, которое возвращается, если парсинг завершился неудачно. UInt16

Возвращаемое значение Возвращает значение типа UInt16 в случае успеха; в противном случае — переданное значение по умолчанию, а если оно не передано, 0. UInt16 Примеры Успешное преобразование

Query

SELECT toUInt16OrDefault('16', CAST('0', 'UInt16'))

Response

Ошибка преобразования

Query

SELECT toUInt16OrDefault('abc', CAST('0', 'UInt16'))

Response

toUInt16OrNull

Добавленный в: v1.1.0 Подобно toUInt16, эта функция преобразует входное значение в значение типа UInt16, но в случае ошибки возвращает NULL. Поддерживаемые аргументы:

Строковые представления (U)Int8/16/32/128/256.

Неподдерживаемые аргументы (возвращают NULL):

Строковые представления значений Float*, включая NaN и Inf.
Строковые представления двоичных и шестнадцатеричных значений, например SELECT toUInt16OrNull('0xc0fe');.

Если входное значение не может быть представлено в пределах UInt16, происходит переполнение или выход за нижнюю границу диапазона результата. Это не считается ошибкой.

См. также:

toUInt16.
toUInt16OrZero.
toUInt16OrDefault.

Синтаксис

toUInt16OrNull(x)

Аргументы

x — Строковое представление числа. String

Возвращаемое значение Возвращает значение типа UInt16; если преобразование не удалось, возвращает NULL. UInt16 или NULL Примеры Пример использования

Query

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

Response

Row 1:
──────
toUInt16OrNull('16'):  16
toUInt16OrNull('abc'): \N

toUInt16OrZero

Добавленный в: v1.1.0 Как и toUInt16, эта функция преобразует входное значение в значение типа UInt16, но при ошибке возвращает 0. Поддерживаемые аргументы:

Строковые представления (U)Int8/16/32/128/256.

Неподдерживаемые аргументы (возвращается 0):

Строковые представления значений Float*, включая NaN и Inf.
Строковые представления двоичных и шестнадцатеричных значений, например SELECT toUInt16OrZero('0xc0fe');.

См. также:

toUInt16.
toUInt16OrNull.
toUInt16OrDefault.

Синтаксис

toUInt16OrZero(x)

Аргументы

x — Строковое представление числа. String

Возвращаемое значение Возвращает значение типа UInt16, либо 0, если преобразование не удалось. UInt16 Примеры Пример использования

Query

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

Response

Строка 1:
──────
toUInt16OrZero('16'):  16
toUInt16OrZero('abc'): 0

toUInt256

Добавленный в: v1.1.0 Преобразует входное значение в значение типа UInt256. Генерирует исключение в случае ошибки. Функция использует округление к нулю, то есть отбрасывает дробную часть числа. Поддерживаемые аргументы:

Значения или строковые представления типа (U)Int*.
Значения типа Float*.

Неподдерживаемые аргументы:

Строковые представления значений Float*, включая NaN и Inf.
Строковые представления двоичных и шестнадцатеричных значений, например SELECT toUInt256('0xc0fe');.

Если входное значение не может быть представлено в диапазоне UInt256, происходит переполнение или выход за нижнюю границу диапазона. Это не считается ошибкой.

См. также:

toUInt256OrZero.
toUInt256OrNull.
toUInt256OrDefault.

Синтаксис

toUInt256(expr)

Аргументы

expr — Выражение, возвращающее число или строковое представление числа. Выражение

Возвращаемое значение Возвращает 256-битное беззнаковое целое число. UInt256 Примеры Пример использования

Query

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

Response

Строка 1:
──────
toUInt256(256):     256
toUInt256(256.256): 256
toUInt256('256'):   256

toUInt256OrDefault

Добавленный в: v21.11.0 Как и toUInt256, эта функция преобразует входное значение в тип UInt256, но в случае ошибки возвращает значение по умолчанию. Если значение default не передано, то в случае ошибки возвращается 0. Синтаксис

toUInt256OrDefault(expr[, default])

Аргументы

expr — Выражение, возвращающее число или строковое представление числа. String, (U)Int* или Float*
default — Необязательно. Значение по умолчанию, которое возвращается, если не удалось выполнить разбор. UInt256

Возвращаемое значение При успешном выполнении возвращает значение типа UInt256, в противном случае — значение по умолчанию, если оно передано, или 0, если нет. UInt256 Примеры Успешное преобразование

Query

SELECT toUInt256OrDefault('-256', CAST('0', 'UInt256'))

Response

Ошибка преобразования

Query

SELECT toUInt256OrDefault('abc', CAST('0', 'UInt256'))

Response

toUInt256OrNull

Добавленный в: v20.8.0 Как и toUInt256, эта функция преобразует входное значение в значение типа UInt256, но в случае ошибки возвращает NULL. Поддерживаемые аргументы:

Строковые представления значений (U)Int*.

Неподдерживаемые аргументы (возвращают NULL):

Строковые представления значений Float*, включая NaN и Inf.
Строковые представления двоичных и шестнадцатеричных значений, например SELECT toUInt256OrNull('0xc0fe');.

Если входное значение не может быть представлено в пределах UInt256, происходит переполнение или выход за нижнюю границу диапазона. Это не считается ошибкой.

См. также:

toUInt256.
toUInt256OrZero.
toUInt256OrDefault.

Синтаксис

toUInt256OrNull(x)

Аргументы

x — строковое представление числа. String

Возвращаемое значение Возвращает значение типа UInt256, а если преобразование не удалось — NULL. UInt256 или NULL Примеры Пример использования

Query

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

Response

Строка 1:
──────
toUInt256OrNull('256'): 256
toUInt256OrNull('abc'): \N

toUInt256OrZero

Добавленный в: v20.8.0 Как и toUInt256, эта функция преобразует входное значение в значение типа UInt256, но в случае ошибки возвращает 0. Поддерживаемые аргументы:

Строковые представления (U)Int*.

Неподдерживаемые аргументы (возвращает 0):

Строковые представления значений Float*, включая NaN и Inf.
Строковые представления двоичных и шестнадцатеричных значений, например SELECT toUInt256OrZero('0xc0fe');.

Если входное значение не может быть представлено в диапазоне UInt256, происходит переполнение или выход за нижнюю границу диапазона результата. Это не считается ошибкой.

См. также:

toUInt256.
toUInt256OrNull.
toUInt256OrDefault.

Синтаксис

toUInt256OrZero(x)

Аргументы

x — Строковое представление числа. String

Возвращаемое значение Возвращает значение типа UInt256, а если преобразование не удалось — 0. UInt256 Примеры Пример использования

Query

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

Response

Строка 1:
──────
toUInt256OrZero('256'): 256
toUInt256OrZero('abc'): 0

toUInt32

Добавленный в: v1.1.0 Преобразует входное значение в значение типа UInt32. В случае ошибки генерирует исключение. Поддерживаемые аргументы:

Значения или строковые представления типа (U)Int*.
Значения типа Float*.

Неподдерживаемые аргументы:

Строковые представления значений Float*, включая NaN и Inf.
Строковые представления двоичных и шестнадцатеричных значений, например SELECT toUInt32('0xc0fe');.

Если входное значение не может быть представлено в пределах UInt32, происходит переполнение или выход за нижнюю границу диапазона. Это не считается ошибкой. Например: SELECT toUInt32(4294967296) == 0;

Функция использует округление к нулю, то есть отбрасывает дробную часть числа.

См. также:

toUInt32OrZero.
toUInt32OrNull.
toUInt32OrDefault.

Синтаксис

toUInt32(expr)

Аргументы

expr — выражение, возвращающее число или строковое представление числа. Выражение

Возвращаемое значение Возвращает 32-битное беззнаковое целое значение. UInt32 Примеры Пример использования

Query

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

Response

Строка 1:
──────
toUInt32(32):    32
toUInt32(32.32): 32
toUInt32('32'):  32

toUInt32OrDefault

Добавленный в: v21.11.0 Как и toUInt32, эта функция преобразует входное значение в значение типа UInt32, но в случае ошибки возвращает значение по умолчанию. Если значение default не указано, то в случае ошибки возвращается 0. Синтаксис

toUInt32OrDefault(expr[, default])

Аргументы

expr — Выражение, возвращающее число или строковое представление числа. String или (U)Int*, или Float*
default — Необязательно. Значение по умолчанию, которое возвращается, если parsing завершается неуспешно. UInt32

Возвращаемое значение При успешном выполнении возвращает значение типа UInt32; в противном случае возвращает значение по умолчанию, если оно было передано, или 0, если нет. UInt32 Примеры Успешное преобразование

Query

SELECT toUInt32OrDefault('32', CAST('0', 'UInt32'))

Response

Ошибка преобразования

Query

SELECT toUInt32OrDefault('abc', CAST('0', 'UInt32'))

Response

toUInt32OrNull

Добавленный в: v1.1.0 Как и toUInt32, эта функция преобразует входное значение в значение типа UInt32, но в случае ошибки возвращает NULL. Поддерживаемые аргументы:

Строковые представления (U)Int8/16/32/128/256.

Неподдерживаемые аргументы (возвращается NULL):

Строковые представления значений Float*, включая NaN и Inf.
Строковые представления двоичных и шестнадцатеричных значений, например SELECT toUInt32OrNull('0xc0fe');.

Если входное значение не может быть представлено в диапазоне UInt32, происходит переполнение или выход за нижнюю границу диапазона результата. Это не считается ошибкой.

См. также:

toUInt32.
toUInt32OrZero.
toUInt32OrDefault.

Синтаксис

toUInt32OrNull(x)

Аргументы

x — Строковое представление числа. String

Возвращаемое значение Возвращает значение типа UInt32; если преобразование не удалось, возвращается NULL. UInt32 или NULL Примеры Пример использования

Query

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

Response

Row 1:
──────
toUInt32OrNull('32'):  32
toUInt32OrNull('abc'): \N

toUInt32OrZero

Добавленный в: v1.1.0 Как и toUInt32, эта функция преобразует входное значение в значение типа UInt32, но в случае ошибки возвращает 0. Поддерживаемые аргументы:

Строковые представления (U)Int8/16/32/128/256.

Неподдерживаемые аргументы (возвращают 0):

Строковые представления значений Float*, включая NaN и Inf.
Строковые представления двоичных и шестнадцатеричных значений, например SELECT toUInt32OrZero('0xc0fe');.

См. также:

toUInt32.
toUInt32OrNull.
toUInt32OrDefault.

Синтаксис

toUInt32OrZero(x)

Аргументы

x — строковое представление числа. String

Возвращаемое значение Возвращает значение типа UInt32, а если преобразование не удалось — 0. UInt32 Примеры Пример использования

Query

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

Response

Строка 1:
──────
toUInt32OrZero('32'):  32
toUInt32OrZero('abc'): 0

toUInt64

Добавленный в: v1.1.0 Преобразует входное значение в значение типа UInt64. При ошибке генерирует исключение. Поддерживаемые аргументы:

Значения или строковые представления типа (U)Int*.
Значения типа Float*.

Неподдерживаемые типы:

Строковые представления значений Float*, включая NaN и Inf.
Строковые представления двоичных и шестнадцатеричных значений, например SELECT toUInt64('0xc0fe');.

Если входное значение не может быть представлено в пределах UInt64, происходит переполнение или выход за нижнюю границу диапазона. Это не считается ошибкой. Например: SELECT toUInt64(18446744073709551616) == 0;

Функция использует округление к нулю, то есть отбрасывает дробные цифры у чисел.

См. также:

toUInt64OrZero.
toUInt64OrNull.
toUInt64OrDefault.

Синтаксис

toUInt64(expr)

Аргументы

expr — Выражение, возвращающее число или его строковое представление. Выражение

Возвращаемое значение Возвращает 64-битное беззнаковое целое число. UInt64 Примеры Пример использования

Query

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

Response

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

toUInt64OrDefault

Добавленный в: v21.11.0 Подобно toUInt64, эта функция преобразует входное значение в значение типа UInt64, но в случае ошибки возвращает значение по умолчанию. Если значение default не передано, то в случае ошибки возвращается 0. Синтаксис

toUInt64OrDefault(expr[, default])

Аргументы

expr — Выражение, возвращающее число или строковое представление числа. String или (U)Int* или Float*
default — Необязательно. Значение по умолчанию, которое возвращается, если преобразование не удалось. UInt64

Возвращаемое значение Если преобразование выполнено успешно, возвращает значение типа UInt64; в противном случае — переданное значение по умолчанию или 0, если оно не указано. UInt64 Примеры Успешное преобразование

Query

SELECT toUInt64OrDefault('64', CAST('0', 'UInt64'))

Response

Не удалось выполнить преобразование

Query

SELECT toUInt64OrDefault('abc', CAST('0', 'UInt64'))

Response

toUInt64OrNull

Добавленный в: v1.1.0 Как и toUInt64, эта функция преобразует входное значение в значение типа UInt64, но в случае ошибки возвращает NULL. Поддерживаемые аргументы:

Строковые представления (U)Int*.

Неподдерживаемые аргументы (возвращают NULL):

Строковые представления значений Float*, включая NaN и Inf.
Строковые представления двоичных и шестнадцатеричных значений, например SELECT toUInt64OrNull('0xc0fe');.

Если входное значение не может быть представлено в пределах диапазона UInt64, происходит переполнение или выход за нижнюю границу диапазона результата. Это не считается ошибкой.

См. также:

toUInt64.
toUInt64OrZero.
toUInt64OrDefault.

Синтаксис

toUInt64OrNull(x)

Аргументы

x — строковое представление числа. String

Возвращаемое значение Возвращает значение типа UInt64, а если преобразование не удалось — NULL. UInt64 или NULL Примеры Пример использования

Query

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

Response

Строка 1:
──────
toUInt64OrNull('64'):  64
toUInt64OrNull('abc'): \N

toUInt64OrZero

Добавленный в: v1.1.0 Как и toUInt64, эта функция преобразует входное значение в значение типа UInt64, но при ошибке возвращает 0. Поддерживаемые аргументы:

Строковые представления (U)Int*.

Неподдерживаемые аргументы (возвращается 0):

Строковые представления значений Float*, включая NaN и Inf.
Строковые представления двоичных и шестнадцатеричных значений, например: SELECT toUInt64OrZero('0xc0fe');.

Если входное значение не может быть представлено в пределах UInt64, происходит переполнение или выход за нижнюю границу диапазона результата. Это не считается ошибкой.

См. также:

toUInt64.
toUInt64OrNull.
toUInt64OrDefault.

Синтаксис

toUInt64OrZero(x)

Аргументы

x — Строковое представление числа. String

Возвращаемое значение Возвращает значение типа UInt64; если преобразование не удалось — 0. UInt64 Примеры Пример использования

Query

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

Response

Строка 1:
──────
toUInt64OrZero('64'):  64
toUInt64OrZero('abc'): 0

toUInt8

Добавленный в: v1.1.0 Преобразует входное значение в значение типа UInt8. Генерирует исключение в случае ошибки. Поддерживаемые аргументы:

Значения или строковые представления типа (U)Int*.
Значения типа Float*.

Неподдерживаемые аргументы:

Строковые представления значений типа Float*, включая NaN и Inf.
Строковые представления двоичных и шестнадцатеричных значений, например SELECT toUInt8('0xc0fe');.

Если входное значение не может быть представлено в диапазоне UInt8, происходит переполнение или выход за нижнюю границу диапазона результата. Это не считается ошибкой. Например: SELECT toUInt8(256) == 0;.

Функция использует округление к нулю, то есть отбрасывает дробную часть числа.

См. также:

toUInt8OrZero.
toUInt8OrNull.
toUInt8OrDefault.

Синтаксис

toUInt8(expr)

Аргументы

expr — выражение, возвращающее число или строковое представление числа. Выражение

Возвращаемое значение Возвращает 8-битное беззнаковое целое число. UInt8 Примеры Пример использования

Query

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

Response

Строка 1:
──────
toUInt8(8):   8
toUInt8(8.8): 8
toUInt8('8'): 8

toUInt8OrDefault

Добавленный в: v21.11.0 Как и toUInt8, эта функция преобразует входное значение в значение типа UInt8, но в случае ошибки возвращает значение по умолчанию. Если значение default не передано, в случае ошибки возвращается 0. Синтаксис

toUInt8OrDefault(expr[, default])

Аргументы

expr — Выражение, возвращающее число или строковое представление числа. String или (U)Int*, или Float*
default — Необязательно. Значение по умолчанию, которое возвращается, если разбор не удался. UInt8

Возвращаемое значение Возвращает значение типа UInt8 в случае успеха; в противном случае возвращает значение по умолчанию, если оно передано, или 0, если нет. UInt8 Примеры Успешное преобразование

Query

SELECT toUInt8OrDefault('8', CAST('0', 'UInt8'))

Response

Ошибка преобразования

Query

SELECT toUInt8OrDefault('abc', CAST('0', 'UInt8'))

Response

toUInt8OrNull

Добавленный в: v1.1.0 Как и toUInt8, эта функция преобразует входное значение в значение типа UInt8, но при ошибке возвращает NULL. Поддерживаемые аргументы:

Строковые представления (U)Int8/16/32/128/256.

Неподдерживаемые аргументы (возвращается NULL):

Строковые представления обычных значений типа Float*, включая NaN и Inf.
Строковые представления двоичных и шестнадцатеричных значений, например SELECT toUInt8OrNull('0xc0fe');.

Если входное значение не может быть представлено в диапазоне UInt8, происходит переполнение или выход за нижнюю границу диапазона результата. Это не считается ошибкой.

См. также:

toUInt8.
toUInt8OrZero.
toUInt8OrDefault.

Синтаксис

toUInt8OrNull(x)

Аргументы

x — строковое представление числа. String

Возвращаемое значение Возвращает значение типа UInt8; если преобразование не удалось, возвращается NULL. UInt8 или NULL Примеры Пример использования

Query

SELECT
    toUInt8OrNull('42'),
    toUInt8OrNull('abc')
FORMAT Vertical

Response

Row 1:
──────
toUInt8OrNull('42'):  42
toUInt8OrNull('abc'): \N

toUInt8OrZero

Добавленный в: v1.1.0 Как и toUInt8, эта функция преобразует входное значение в значение типа UInt8, но в случае ошибки возвращает 0. Поддерживаемые аргументы:

Строковые представления (U)Int8/16/32/128/256.

Неподдерживаемые аргументы (возвращается 0):

Строковые представления обычных значений типа Float*, включая NaN и Inf.
Строковые представления двоичных и шестнадцатеричных значений, например SELECT toUInt8OrZero('0xc0fe');.

Если входное значение не может быть представлено в пределах UInt8, происходит переполнение или выход за нижнюю границу диапазона результата. Это не считается ошибкой.

См. также:

toUInt8.
toUInt8OrNull.
toUInt8OrDefault.

Синтаксис

toUInt8OrZero(x)

Аргументы

x — строковое представление числа. String

Возвращаемое значение Возвращает значение типа UInt8; если преобразование не удалось, возвращает 0. UInt8 Примеры Пример использования

Query

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

Response

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

toUUID

Добавленный в: v1.1.0 Преобразует значение типа String в значение типа UUID. Синтаксис

toUUID(string)

Аргументы

string — UUID в строковом формате. String или FixedString

Возвращаемое значение Возвращает UUID, полученный из строкового представления UUID. UUID Примеры Пример использования

Query

SELECT toUUID('61f0c404-5cb3-11e7-907b-a6006ad3dba0') AS uuid

Response

┌─────────────────────────────────uuid─┐
│ 61f0c404-5cb3-11e7-907b-a6006ad3dba0 │
└──────────────────────────────────────┘

toUUIDOrZero

Добавленный в: v20.12.0 Преобразует входное значение в значение типа UUID, но в случае ошибки возвращает нулевой UUID. Как toUUID, но при ошибках преобразования вместо генерации исключения возвращает нулевой UUID (00000000-0000-0000-0000-000000000000). Поддерживаемые аргументы:

Строковые представления UUID в стандартном формате (8-4-4-4-12 шестнадцатеричных цифр).
Строковые представления UUID без дефисов (32 шестнадцатеричные цифры).

Неподдерживаемые аргументы (возвращается нулевой UUID):

Недопустимые строковые форматы.
Типы, отличные от строковых.

Синтаксис

toUUIDOrZero(x)

Аргументы

x — строковое представление UUID. String

Возвращаемое значение Возвращает значение UUID в случае успеха, в противном случае — нулевой UUID (00000000-0000-0000-0000-000000000000). UUID Примеры Пример использования

Query

SELECT
    toUUIDOrZero('550e8400-e29b-41d4-a716-446655440000') AS valid_uuid,
    toUUIDOrZero('invalid-uuid') AS invalid_uuid

Response

┌─valid_uuid───────────────────────────┬─invalid_uuid─────────────────────────┐
│ 550e8400-e29b-41d4-a716-446655440000 │ 00000000-0000-0000-0000-000000000000 │
└──────────────────────────────────────┴──────────────────────────────────────┘

toUnixTimestamp64Micro

Добавленный в: v20.5.0 Преобразует DateTime64 в значение Int64 с фиксированной точностью в микросекундах. Входное значение соответствующим образом масштабируется в большую или меньшую сторону в зависимости от его точности.

Выходное значение задаётся относительно UTC, а не относительно часового пояса входного значения.

Синтаксис

toUnixTimestamp64Micro(value)

Аргументы

value — значение типа DateTime64 с любой точностью. DateTime64

Возвращаемое значение Возвращает Unix-временную метку в микросекундах. Int64 Примеры Пример использования

Query

WITH toDateTime64('2025-02-13 23:31:31.011123', 6, 'UTC') AS dt64
SELECT toUnixTimestamp64Micro(dt64);

Response

┌─toUnixTimestamp64Micro(dt64)─┐
│               1739489491011123 │
└────────────────────────────────┘

toUnixTimestamp64Milli

Добавленный в: v20.5.0 Преобразует DateTime64 в значение Int64 с фиксированной точностью в миллисекундах. Входное значение соответствующим образом масштабируется в зависимости от его точности.

Выходное значение задается относительно UTC, а не часового пояса входного значения.

Синтаксис

toUnixTimestamp64Milli(value)

Аргументы

value — значение типа DateTime64 с любой точностью. DateTime64

Возвращаемое значение Возвращает Unix-временную метку в миллисекундах. Int64 Примеры Пример использования

Query

WITH toDateTime64('2025-02-13 23:31:31.011', 3, 'UTC') AS dt64
SELECT toUnixTimestamp64Milli(dt64);

Response

┌─toUnixTimestamp64Milli(dt64)─┐
│                1739489491011 │
└──────────────────────────────┘

toUnixTimestamp64Nano

Добавленный в: v20.5.0 Преобразует DateTime64 в значение Int64 с фиксированной точностью до наносекунд. Входное значение соответствующим образом масштабируется вверх или вниз в зависимости от его точности.

Выходное значение рассчитывается относительно UTC, а не часового пояса входного значения.

Синтаксис

toUnixTimestamp64Nano(value)

Аргументы

value — значение типа DateTime64 с любой точностью. DateTime64

Возвращаемое значение Возвращает Unix-временную метку в наносекундах. Int64 Примеры Пример использования

Query

WITH toDateTime64('2025-02-13 23:31:31.011123456', 9, 'UTC') AS dt64
SELECT toUnixTimestamp64Nano(dt64);

Response

┌─toUnixTimestamp64Nano(dt64)────┐
│            1739489491011123456 │
└────────────────────────────────┘

toUnixTimestamp64Second

Добавленный в: v24.12.0 Преобразует DateTime64 в значение Int64 с фиксированной точностью до секунд. Входное значение соответствующим образом масштабируется в большую или меньшую сторону в зависимости от его точности.

Выходное значение задаётся относительно UTC, а не часового пояса входного значения.

Синтаксис

toUnixTimestamp64Second(value)

Аргументы

value — значение типа DateTime64 с любой точностью. DateTime64

Возвращаемое значение Возвращает Unix-временную метку в секундах. Int64 Примеры Пример использования

Query

WITH toDateTime64('2025-02-13 23:31:31.011', 3, 'UTC') AS dt64
SELECT toUnixTimestamp64Second(dt64);

Response

┌─toUnixTimestamp64Second(dt64)─┐
│                    1739489491 │
└───────────────────────────────┘

Последнее изменение 2 июля 2026 г.

ULIDДокументация по функциям для работы с ULID

​Распространённые проблемы при преобразовании данных

​Примечания к функциям toString

​Примечания к функциям toDate/toDateTime

​CAST

​DATE

​accurateCast

​accurateCastOrDefault

​accurateCastOrNull

​formatRow

​formatRowNoNewline

​fromUnixTimestamp64Micro

​fromUnixTimestamp64Milli

​fromUnixTimestamp64Nano

​fromUnixTimestamp64Second

​parseDateTime

​parseDateTime32BestEffort

​parseDateTime32BestEffortOrNull

​parseDateTime32BestEffortOrZero

​parseDateTime64

​parseDateTime64BestEffort

​parseDateTime64BestEffortOrNull

​parseDateTime64BestEffortOrZero

​parseDateTime64BestEffortUS

​parseDateTime64BestEffortUSOrNull

​parseDateTime64BestEffortUSOrZero

​parseDateTime64InJodaSyntax

​parseDateTime64InJodaSyntaxOrNull

​parseDateTime64InJodaSyntaxOrZero

​parseDateTime64OrNull

​parseDateTime64OrZero

​parseDateTimeBestEffort

​parseDateTimeBestEffortOrNull

​parseDateTimeBestEffortOrZero

​parseDateTimeBestEffortUS

​parseDateTimeBestEffortUSOrNull

​parseDateTimeBestEffortUSOrZero

​parseDateTimeInJodaSyntax

​parseDateTimeInJodaSyntaxOrNull

​parseDateTimeInJodaSyntaxOrZero

​parseDateTimeOrNull

​parseDateTimeOrZero

​reinterpret

​reinterpretAsDate

​reinterpretAsDateTime

​reinterpretAsFixedString

​reinterpretAsFloat32

​reinterpretAsFloat64

​reinterpretAsInt128

​reinterpretAsInt16

​reinterpretAsInt256

​reinterpretAsInt32

​reinterpretAsInt64

​reinterpretAsInt8

​reinterpretAsString

​reinterpretAsUInt128

​reinterpretAsUInt16

​reinterpretAsUInt256

​reinterpretAsUInt32

​reinterpretAsUInt64

​reinterpretAsUInt8

​reinterpretAsUUID

​toBFloat16

​toBFloat16OrNull

​toBFloat16OrZero

​toBool

​toDate

​toDate32

​toDate32OrDefault

​toDate32OrNull

​toDate32OrZero

​toDateOrDefault

​toDateOrNull

​toDateOrZero

​toDateTime

​toDateTime32

​toDateTime64

​toDateTime64OrDefault

​toDateTime64OrNull

​toDateTime64OrZero

​toDateTimeOrDefault

Распространённые проблемы при преобразовании данных

Примечания к функциям `toString`

Примечания к функциям `toDate`/`toDateTime`

CAST

DATE

accurateCast

accurateCastOrDefault

accurateCastOrNull

formatRow

formatRowNoNewline

fromUnixTimestamp64Micro

fromUnixTimestamp64Milli

fromUnixTimestamp64Nano

fromUnixTimestamp64Second

parseDateTime

parseDateTime32BestEffort

parseDateTime32BestEffortOrNull

parseDateTime32BestEffortOrZero

parseDateTime64

parseDateTime64BestEffort

parseDateTime64BestEffortOrNull

parseDateTime64BestEffortOrZero

parseDateTime64BestEffortUS

parseDateTime64BestEffortUSOrNull

parseDateTime64BestEffortUSOrZero

parseDateTime64InJodaSyntax

parseDateTime64InJodaSyntaxOrNull

parseDateTime64InJodaSyntaxOrZero

parseDateTime64OrNull

parseDateTime64OrZero

parseDateTimeBestEffort

parseDateTimeBestEffortOrNull

parseDateTimeBestEffortOrZero

parseDateTimeBestEffortUS

parseDateTimeBestEffortUSOrNull

parseDateTimeBestEffortUSOrZero

parseDateTimeInJodaSyntax

parseDateTimeInJodaSyntaxOrNull

parseDateTimeInJodaSyntaxOrZero

parseDateTimeOrNull

parseDateTimeOrZero

reinterpret

reinterpretAsDate

reinterpretAsDateTime

reinterpretAsFixedString

reinterpretAsFloat32

reinterpretAsFloat64

reinterpretAsInt128

reinterpretAsInt16

reinterpretAsInt256

reinterpretAsInt32

reinterpretAsInt64

reinterpretAsInt8

reinterpretAsString

reinterpretAsUInt128

reinterpretAsUInt16

reinterpretAsUInt256

reinterpretAsUInt32

reinterpretAsUInt64

reinterpretAsUInt8

reinterpretAsUUID

toBFloat16

toBFloat16OrNull

toBFloat16OrZero

toBool

toDate

toDate32

toDate32OrDefault

toDate32OrNull

toDate32OrZero

toDateOrDefault

toDateOrNull

toDateOrZero

toDateTime

toDateTime32

toDateTime64

toDateTime64OrDefault

toDateTime64OrNull

toDateTime64OrZero

toDateTimeOrDefault