Type conversion functions

BOOL
DATE
DATE_PARSE
DATETIME
DATETIME_PARSE
DB_CAST
FLOAT
GEOPOINT
GEOPOLYGON
INT
STR

BOOL

Syntax:BOOL( expression )

Converts the expression expression to Boolean type according to the following rules:

Type	`FALSE`	`TRUE`
`Number`	`0`, `0.0`	All others
`String`	Empty string (`""`)	All others
`Boolean`	`FALSE`	`TRUE`
`Date \| Datetime`	-	`TRUE`

DATE

Syntax:DATE( expression [ , timezone ] )

Converts the expression expression to date format.

The date must be in the format YYYY-MM-DD.

If expression is a number, then the timezone option can be used to convert the date to the specified time zone.

DATE_PARSE

Syntax:DATE_PARSE( value )

Converts the value expression to date format. Unlike DATE, it supports multiple formats.

DATETIME

Syntax:DATETIME( expression [ , timezone ] )

Converts the expression expression to date and time format. When converting Date to DateTime, the time is set to '00:00:00'.
The date must be in the format YYYY-MM-DDThh:mm:ss or YYYY-MM-DD hh:mm:ss.

If expression is a number, then the date and time can be converted to the specified time zone when the timezone option is available.

DATETIME_PARSE

Syntax:DATETIME_PARSE( value )

Converts the value expression to date and time format. Unlike DATETIME, it supports multiple formats.

DB_CAST

Syntax:DB_CAST( expression, native_type [ , param_1 [ , param_2 ] ] )

Converts the expression expression to database's native type native_type.

The following type casts are supported:

Data source	Data type	Native data type	Parameters for native type	Comment
`ClickHouse`	`Number (decimal)`	`Float32`
`ClickHouse`	`Number (decimal)`	`Float64`
`ClickHouse`	`Number (decimal)`	`Decimal`	`Number (whole)`, `Number (whole)`
`ClickHouse`	`Number (whole)`	`Int8`
`ClickHouse`	`Number (whole)`	`Int16`
`ClickHouse`	`Number (whole)`	`Int32`
`ClickHouse`	`Number (whole)`	`Int64`
`ClickHouse`	`String`	`String`
`PostgreSQL`	`Number (decimal)`	`double precision`
`PostgreSQL`	`Number (decimal)`	`real`
`PostgreSQL`	`Number (decimal)`	`numeric`	`Number (whole)`, `Number (whole)`
`PostgreSQL`	`Number (whole)`	`smallint`
`PostgreSQL`	`Number (whole)`	`integer`
`PostgreSQL`	`Number (whole)`	`bigint`
`PostgreSQL`	`String`	`text`
`PostgreSQL`	`String`	`character`	`Number (whole)`	Alias: `char`
`PostgreSQL`	`String`	`character varying`	`Number (whole)`	Alias: `varchar`
`PostgreSQL`	`String`	`char`	`Number (whole)`	Alias for `character`
`PostgreSQL`	`String`	`varchar`	`Number (whole)`	Alias for `character varying`

FLOAT

Syntax:FLOAT( expression )

Converts the expression expression to fractional number format according to the following rules:

Type	Value
`Number`	Original value.
`Date \| Datetime`	Unix time corresponding to the date and time. If the value contains time zone data, it's used in the calculation. If the time zone is unknown, the time is set in UTC.
`String`	A number from a decimal string.
`Boolean`	`TRUE` — `1.0`, `FALSE` — `0.0`.

GEOPOINT

Syntax:GEOPOINT( value_1 [ , value_2 ] )

Generates a Geopoint type value. For the input, it accepts a string, a "geopoint" type value, or coordinates — latitude value_1 and longitude value_2. If a single string is input, it must contain a list of two numbers (latitude and longitude) in JSON syntax.

GEOPOLYGON

Syntax:GEOPOLYGON( value )

Converts the value expression to geopolygon format.

INT

Syntax:INT( expression )

Converts the expression expression to integer format according to the following rules:

Type	Value
`Number (whole)`	Original value.
`Number (decimal)`	Integer part of the number (rounded down).
`Date \| Datetime`	Unix time corresponding to the date and time. If the value contains time zone data, it's used in the calculation. If the time zone is unknown, the time is set in UTC.
`String`	A number from a decimal string.
`Boolean`	`TRUE` — `1`, `FALSE` — `0`.

STR

Syntax:STR( expression )

Converts the expression expression to string type.