Fonctions de conversion de type

ClickHouse utilise généralement le même comportement que les programmes C++.

Les fonctions to<type> et cast se comportent différemment dans certains cas, par exemple avec LowCardinality : cast supprime l'attribut LowCardinality, contrairement aux fonctions to<type>. Il en va de même pour Nullable. Ce comportement n'est pas conforme à la norme SQL, et peut être modifié à l'aide du paramètre cast_keep_nullable.

Exemple :

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

┌

La famille de fonctions toString permet de convertir des nombres, des chaînes (mais pas des chaînes fixes), des dates et des dates avec heure. Toutes ces fonctions acceptent un argument.

• Lors d'une conversion vers ou depuis une chaîne, la valeur est formatée ou analysée selon les mêmes règles que pour le format TabSeparated (ainsi que pour presque tous les autres formats texte). Si la chaîne ne peut pas être analysée, une exception est levée et la requête est annulée.
• Lors de la conversion de dates en nombres ou inversement, la date correspond au nombre de jours écoulés depuis le début de l'époque Unix.
• Lors de la conversion de dates avec heure en nombres ou inversement, la date avec heure correspond au nombre de secondes écoulées depuis le début de l'époque Unix.
• La fonction toString appliquée à un argument DateTime peut accepter un deuxième argument String contenant le nom du fuseau horaire, par exemple : Europe/Amsterdam. Dans ce cas, l'heure est formatée selon le fuseau horaire spécifié.

Les formats de date et de date avec heure des fonctions toDate/toDateTime sont définis comme suit :

YYYY-MM-DD
YYYY-MM-DD hh:mm:ss

À titre d'exception, lors de la conversion de types numériques UInt32, Int32, UInt64 ou Int64 vers Date, si le nombre est supérieur ou égal à 65536, il est interprété comme un timestamp Unix (et non comme un nombre de jours), puis arrondi à la date. Cela permet de prendre en charge le cas courant où l'on écrit toDate(unix_timestamp), ce qui, autrement, produirait une erreur et imposerait d'écrire la forme plus lourde toDate(toDateTime(unix_timestamp)).

La conversion entre une date et une date avec heure s'effectue naturellement : en ajoutant une heure nulle ou en supprimant l'heure.

La conversion entre types numériques suit les mêmes règles que les affectations entre différents types numériques en C++.

Exemple

SELECT
    now() AS ts,
    time_zone,
    toString(ts, time_zone) AS str_tz_datetime
FROM system.time_zones
WHERE time_zone LIKE 'Europe%'
LIMIT 10

┌──────────────────ts─┬─time_zone─────────┬─str_tz_datetime─────┐
│ 2023-09-08 19:14:59 │ Europe/Amsterdam  │ 2023-09-08 21:14:59 │
│ 2023-09-08 19:14:59 │ Europe/Andorra    │ 2023-09-08 21:14:59 │
│ 2023-09-08 19:14:59 │ Europe/Astrakhan  │ 2023-09-08 23:14:59 │
│ 2023-09-08 19:14:59 │ Europe/Athens     │ 2023-09-08 22:14:59 │
│ 2023-09-08 19:14:59 │ Europe/Belfast    │ 2023-09-08 20:14:59 │
│ 2023-09-08 19:14:59 │ Europe/Belgrade   │ 2023-09-08 21:14:59 │
│ 2023-09-08 19:14:59 │ Europe/Berlin     │ 2023-09-08 21:14:59 │
│ 2023-09-08 19:14:59 │ Europe/Bratislava │ 2023-09-08 21:14:59 │
│ 2023-09-08 19:14:59 │ Europe/Brussels   │ 2023-09-08 21:14:59 │
│ 2023-09-08 19:14:59 │ Europe/Bucharest  │ 2023-09-08 22:14:59 │
└─────────────────────┴───────────────────┴─────────────────────┘

Voir aussi la fonction toUnixTimestamp.

Introduit dans : v1.1.0

Convertit une valeur en un type de données donné. Contrairement à la fonction reinterpret, CAST tente de produire la même valeur dans le type cible. Si ce n'est pas possible, une exception est levée.

Syntaxe

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

Arguments

• x — Une valeur de n’importe quel type. Any
• T — Le type de données cible. String

Valeur renvoyée

Renvoie la valeur convertie dans le type de données cible. Any

Exemples

Utilisation de base

SELECT CAST(42, 'String')

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

Utilisation de la syntaxe AS

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

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

Utilisation de la syntaxe ::

SELECT '123'::UInt32

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

Introduit dans : v21.2.0

Convertit l’argument en type de données Date. Il s’agit d’un alias de compatibilité MySQL pour toDate. Son comportement est identique à celui de toDate.

Syntaxe

DATE(expr)

Arguments

• expr — Valeur à convertir. String ou UInt32 ou Date ou DateTime

Valeur renvoyée

Renvoie une valeur de type Date.

Exemples

Utilisation de base

SELECT DATE('2023-01-01')

2023-01-01

Introduit dans : v1.1.0

Convertit une valeur vers un type de données spécifié. Contrairement à CAST, accurateCast applique une vérification de type plus stricte et lève une exception si la conversion entraîne une perte de précision des données ou si elle est impossible.

Cette fonction est plus sûre que CAST, car elle empêche les pertes de précision et les conversions invalides.

Syntaxe

accurateCast(x, T)

Arguments

• x — Une valeur à convertir. Any
• T — Le nom du type de données cible. String

Valeur renvoyée

Renvoie la valeur convertie dans le type de données cible. Any

Exemples

Conversion réussie

SELECT accurateCast(42, 'UInt16')

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

Chaîne vers un nombre

SELECT accurateCast('123.45', 'Float64')

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

Introduit dans : v21.1.0

Convertit une valeur dans un type de données spécifié. Comme accurateCast, mais renvoie une valeur par défaut au lieu de lever une exception si la conversion ne peut pas être effectuée de manière précise.

Si une valeur par défaut est fournie comme deuxième argument, elle doit être du type cible. Si aucune valeur par défaut n'est fournie, la valeur par défaut du type cible est utilisée.

Syntaxe

accurateCastOrDefault(x, T[, default_value])

Arguments

• x — Une valeur à convertir. Any
• T — Le nom du type de données cible. const String
• default_value — Facultatif. Valeur par défaut à renvoyer si la conversion échoue. Any

Valeur renvoyée

Renvoie la valeur convertie dans le type de données cible, ou la valeur par défaut si la conversion n’est pas possible. Any

Exemples

Conversion réussie

SELECT accurateCastOrDefault(42, 'String')

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

Conversion échouée avec valeur par défaut explicite

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

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

Échec de conversion avec valeur par défaut implicite

SELECT accurateCastOrDefault('abc', 'UInt32')

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

Introduit dans : v1.1.0

Convertit une valeur dans un type de données spécifié. Comme accurateCast, mais renvoie NULL au lieu de lever une exception si la conversion ne peut pas être effectuée avec précision.

Cette fonction combine la sécurité de accurateCast avec une gestion souple des erreurs.

Syntaxe

accurateCastOrNull(x, T)

Arguments

• x — Une valeur à convertir. Any
• T — Le nom du type de données cible. String

Valeur renvoyée

Renvoie la valeur convertie dans le type de données cible, ou NULL si la conversion n’est pas possible. Any

Exemples

Conversion réussie

SELECT accurateCastOrNull(42, 'String')

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

En cas d’échec, la conversion renvoie NULL

SELECT accurateCastOrNull('abc', 'UInt32')

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

Introduit dans : v20.7.0

Convertit des expressions arbitraires en chaîne de caractères à l’aide du format spécifié.

Syntaxe

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

Arguments

• format — format de texte. Par exemple, CSV, TSV. String
• x, y, ... — Expressions. Any

Valeur renvoyée

Une chaîne formatée. (pour les formats texte, elle se termine généralement par un caractère de saut de ligne). String

Exemples

Utilisation de base

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

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

Avec un format personnalisé

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

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

Introduit dans : v20.7.0

Identique à formatRow, mais supprime le caractère de nouvelle ligne de chaque ligne.

Convertit des expressions arbitraires en chaîne à l’aide du format donné, mais supprime tout caractère de nouvelle ligne final du résultat.

Syntaxe

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

Arguments

• format — Format de texte. Par exemple, CSV, TSV. String
• x, y, ... — Expressions. Any

Valeur renvoyée

Renvoie une chaîne formatée dont les retours à la ligne ont été supprimés. String

Exemples

Utilisation de base

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

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

Introduit dans : v20.5.0

Convertit un timestamp Unix en microsecondes en valeur DateTime64 avec une précision à la microseconde.

La valeur d’entrée est traitée comme un timestamp Unix avec une précision à la microseconde (nombre de microsecondes écoulées depuis 1970-01-01 00:00:00 UTC).

Syntaxe

fromUnixTimestamp64Micro(value[, timezone])

Arguments

• value — Timestamp Unix en microsecondes. Int64
• timezone — Facultatif. Fuseau horaire de la valeur renvoyée. String

Valeur renvoyée

Renvoie une valeur DateTime64 avec une précision en microsecondes. DateTime64(6)

Exemples

Exemple d'utilisation

SELECT fromUnixTimestamp64Micro(1640995200123456)

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

Introduit dans : v20.5.0

Convertit un timestamp Unix en millisecondes en valeur DateTime64 avec une précision de l’ordre de la milliseconde.

La valeur d’entrée est traitée comme un timestamp Unix avec une précision à la milliseconde (nombre de millisecondes écoulées depuis 1970-01-01 00:00:00 UTC).

Syntaxe

fromUnixTimestamp64Milli(value[, timezone])

Arguments

• value — timestamp Unix en millisecondes. Int64
• timezone — Facultatif. Fuseau horaire de la valeur renvoyée. String

Valeur renvoyée

Une valeur DateTime64 avec une précision à la milliseconde. DateTime64(3)

Exemples

Exemple d'utilisation

SELECT fromUnixTimestamp64Milli(1640995200123)

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

Introduit dans : v20.5.0

Convertit un timestamp Unix en nanosecondes en une valeur DateTime64 avec une précision en nanosecondes.

La valeur d’entrée est traitée comme un timestamp Unix avec une précision en nanosecondes (nombre de nanosecondes écoulées depuis 1970-01-01 00:00:00 UTC).

Syntaxe

fromUnixTimestamp64Nano(value[, timezone])

Arguments

• value — timestamp Unix en nanosecondes. Int64
• timezone — Facultatif. Fuseau horaire de la valeur renvoyée. String

Valeur renvoyée

Renvoie une valeur DateTime64 avec une précision à la nanoseconde. DateTime64(9)

Exemples

Exemple d'utilisation

SELECT fromUnixTimestamp64Nano(1640995200123456789)

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

Introduit dans : v24.12.0

Convertit un timestamp Unix en secondes en valeur DateTime64 avec une précision à la seconde.

La valeur d’entrée est traitée comme un timestamp Unix avec une précision à la seconde (nombre de secondes écoulées depuis 1970-01-01 00:00:00 UTC).

Syntaxe

fromUnixTimestamp64Second(value[, timezone])

Arguments

• value — timestamp Unix en secondes. Int64
• timezone — Facultatif. Fuseau horaire de la valeur renvoyée. String

Valeur renvoyée

Renvoie une valeur DateTime64 avec une précision à la seconde. DateTime64(0)

Exemples

Exemple d'utilisation

SELECT fromUnixTimestamp64Second(1640995200)

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

Introduit dans : v23.3.0

Analyse une chaîne de date et d’heure selon une chaîne de format de date MySQL.

Cette fonction est l’inverse de formatDateTime. Elle analyse un argument de type String à l’aide d’une chaîne de format String. Elle renvoie un type DateTime.

Syntaxe

parseDateTime(time_string, format[, timezone])

Alias : TO_UNIXTIME

Arguments

• time_string — Chaîne à analyser en DateTime. String
• format — Chaîne de format indiquant comment analyser time_string. String
• timezone — Facultatif. Fuseau horaire. String

Valeur renvoyée

Renvoie un DateTime analysé à partir de la chaîne d’entrée selon la chaîne de format de style MySQL. DateTime

Exemples

Exemple d’utilisation

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

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

Introduite dans : v20.9.0

Convertit la représentation sous forme de chaîne d’une date et d’une heure en type de données DateTime.

La fonction analyse les formats ISO 8601, RFC 1123 - 5.2.14 RFC-822 Date and Time Specification, ceux de ClickHouse, ainsi que certains autres formats de date et d’heure.

Syntaxe

parseDateTime32BestEffort(time_string[, time_zone])

Arguments

• time_string — String contenant une date et une heure à convertir. String
• time_zone — Facultatif. Fuseau horaire selon lequel time_string est interprété. String

Valeur renvoyée

Renvoie time_string en DateTime. DateTime

Exemples

Exemple d'utilisation

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

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

Avec un fuseau horaire

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

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

timestamp Unix

SELECT parseDateTime32BestEffort('1284101485')
AS parseDateTime32BestEffort

┌─parseDateTime32BestEffort─┐
│       2010-09-10 06:51:25 │
└───────────────────────────┘

Introduit dans : v20.9.0

Identique à parseDateTime32BestEffort, sauf qu’elle renvoie NULL lorsqu’elle rencontre un format de date qu’elle ne peut pas traiter.

Syntaxe

parseDateTime32BestEffortOrNull(time_string[, time_zone])

Arguments

• time_string — String contenant une date et une heure à convertir. String
• time_zone — Facultatif. Fuseau horaire selon lequel time_string est interprété. String

Valeur renvoyée

Renvoie un objet DateTime interprété à partir de la chaîne, ou NULL si l’analyse échoue. DateTime

Exemples

Exemple d'utilisation

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

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

Introduit dans : v20.9.0

Identique à parseDateTime32BestEffort, sauf qu'elle renvoie une date zéro ou une date et heure nulles lorsqu'elle rencontre un format de date qui ne peut pas être traité.

Syntaxe

parseDateTime32BestEffortOrZero(time_string[, time_zone])

Arguments

• time_string — String contenant une date et une heure à convertir. String
• time_zone — Facultatif. Fuseau horaire selon lequel time_string est interprétée. String

Valeur renvoyée

Renvoie un objet DateTime interprété à partir de la chaîne, ou la date zéro (1970-01-01 00:00:00) si l'analyse échoue. DateTime

Exemples

Exemple d'utilisation

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

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

Introduit dans : v24.11.0

Analyse une chaîne de date et d'heure avec une précision sub-secondes selon une chaîne de format de date MySQL.

Cette fonction est l'inverse de formatDateTime pour DateTime64. Elle analyse un argument de type String à l'aide d'un format String. Elle renvoie un type DateTime64 capable de représenter des dates de 0000 à 9999 avec une précision sub-secondes (les précisions élevées couvrent une plage plus étroite, car la valeur est stockée sous la forme d'un nombre Int64 de ticks : la précision 8 atteint environ 4892 et la précision 9 couvre la plage de 1677 à 2262).

Syntaxe

parseDateTime64(time_string, format[, timezone])

Arguments

• time_string — Chaîne à analyser pour obtenir un DateTime64. String
• format — Chaîne de format indiquant comment analyser time_string. String
• timezone — Facultatif. Fuseau horaire. String

Valeur renvoyée

Renvoie un DateTime64 obtenu par analyse de la chaîne d'entrée selon une chaîne de format de style MySQL. DateTime64

Exemples

Exemple d'utilisation

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

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

Introduit dans : v20.1.0

Identique à la fonction parseDateTimeBestEffort, mais prend également en charge l’analyse des millisecondes et des microsecondes, et renvoie le type de données DateTime64.

Syntaxe

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

Arguments

• time_string — String contenant une date ou une date avec heure à convertir. String
• precision — Facultatif. Précision requise. 3 pour les millisecondes, 6 pour les microsecondes. Par défaut : 3. UInt8
• time_zone — Facultatif. Fuseau horaire. La fonction interprète time_string en fonction du fuseau horaire. String

Valeur renvoyée

Renvoie time_string converti en type de données DateTime64. DateTime64

Exemples

Exemple d'utilisation

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

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

Introduit dans : v20.1.0

Identique à parseDateTime64BestEffort, sauf qu'elle renvoie NULL lorsqu'elle rencontre un format de date impossible à traiter.

Syntaxe

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

Arguments

• time_string — String contenant une date ou une date avec heure à convertir. String
• precision — Facultatif. Précision requise. 3 pour les millisecondes, 6 pour les microsecondes. Valeur par défaut : 3. UInt8
• time_zone — Facultatif. Fuseau horaire. La fonction interprète time_string selon le fuseau horaire. String

Valeur renvoyée

Renvoie time_string converti en DateTime64, ou NULL si l’entrée ne peut pas être interprétée. DateTime64 ou NULL

Exemples

Exemple d'utilisation

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

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

Introduit dans : v20.1.0

Identique à parseDateTime64BestEffort, sauf qu’elle renvoie une date zéro ou une date-heure zéro lorsqu’elle rencontre un format de date impossible à traiter.

Syntaxe

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

Arguments

• time_string — String contenant une date ou une date avec heure à convertir. String
• precision — Facultatif. Précision requise. 3 pour les millisecondes, 6 pour les microsecondes. Par défaut : 3. UInt8
• time_zone — Facultatif. Fuseau horaire. La fonction interprète time_string selon ce fuseau horaire. String

Valeur renvoyée

Renvoie time_string converti en DateTime64, ou la date/date-heure zéro (1970-01-01 00:00:00.000) si l’entrée ne peut pas être interprétée. DateTime64

Exemples

Exemple d’utilisation

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

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

Introduit dans : v22.8.0

Identique à parseDateTime64BestEffort, sauf que cette fonction privilégie le format de date américain (MM/DD/YYYY, etc.) en cas d'ambiguïté.

Syntaxe

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

Arguments

• time_string — String contenant une date ou une date avec heure à convertir. String
• precision — Facultatif. Précision requise. 3 pour les millisecondes, 6 pour les microsecondes. Par défaut : 3. UInt8
• time_zone — Facultatif. Fuseau horaire. La fonction interprète time_string selon le fuseau horaire. String

Valeur renvoyée

Renvoie time_string converti en DateTime64 en privilégiant le format de date US dans les cas ambigus. DateTime64

Exemples

Exemple d’utilisation

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

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

Introduit dans : v22.8.0

Identique à parseDateTime64BestEffort, sauf que cette fonction privilégie le format de date américain (MM/DD/YYYY, etc.) en cas d’ambiguïté et renvoie NULL lorsqu’elle rencontre un format de date qui ne peut pas être analysé.

Syntaxe

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

Arguments

• time_string — String contenant une date ou une date avec heure à convertir. String
• precision — Facultatif. Précision requise. 3 pour les millisecondes, 6 pour les microsecondes. Valeur par défaut : 3. UInt8
• time_zone — Facultatif. Fuseau horaire. La fonction analyse time_string en fonction du fuseau horaire. String

Valeur renvoyée

Renvoie time_string converti en DateTime64 avec préférence pour le format US, ou NULL si l’entrée ne peut pas être analysée. DateTime64 ou NULL

Exemples

Exemple d'utilisation

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

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

Introduit dans : v22.8.0

Identique à parseDateTime64BestEffort, à ceci près que cette fonction privilégie le format de date américain (MM/DD/YYYY, etc.) en cas d’ambiguïté et renvoie une date zéro ou une date-heure zéro lorsqu’elle rencontre un format de date qui ne peut pas être analysé.

Syntaxe

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

Arguments

• time_string — String contenant une date ou une date avec heure à convertir. String
• precision — Facultatif. Précision requise. 3 pour les millisecondes, 6 pour les microsecondes. Par défaut : 3. UInt8
• time_zone — Facultatif. Fuseau horaire. La fonction interprète time_string selon ce fuseau horaire. String

Valeur renvoyée

Renvoie time_string converti en DateTime64 avec préférence pour le format US, ou la date zéro/la date-heure zéro (1970-01-01 00:00:00.000) si l’entrée ne peut pas être interprétée. DateTime64

Exemples

Exemple d’utilisation

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

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

Introduit dans : v24.10.0

Analyse une chaîne de date et d'heure avec une précision inférieure à la seconde, selon une chaîne de format de date Joda.

Cette fonction est l'inverse de formatDateTimeInJodaSyntax pour DateTime64. Elle analyse un argument String à l'aide d'une chaîne de format de style Joda. Elle renvoie une valeur de type DateTime64, capable de représenter des dates de 0000 à 9999 avec une précision inférieure à la seconde (les précisions élevées couvrent une plage plus étroite, car la valeur est stockée dans un nombre de ticks Int64 : la précision 8 atteint environ 4892 et la précision 9 s'étend de 1677 à 2262).

Consultez la documentation Joda Time pour les motifs de format.

Syntaxe

parseDateTime64InJodaSyntax(time_string, format[, timezone])

Arguments

• time_string — Chaîne à analyser en DateTime64. String
• format — Chaîne de format en syntaxe Joda indiquant comment interpréter time_string. String
• timezone — Facultatif. Fuseau horaire. String

Valeur renvoyée

Renvoie un DateTime64 analysé à partir de la chaîne d’entrée selon la chaîne de format de style Joda. DateTime64

Exemples

Exemple d’utilisation

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

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

Introduit dans : v24.10.0

Identique à parseDateTime64InJodaSyntax, mais renvoie NULL si le format de date ne peut pas être analysé.

Syntaxe

parseDateTime64InJodaSyntaxOrNull(time_string, format[, timezone])

Arguments

• time_string — Chaîne à analyser en DateTime64. String
• format — Chaîne de format en syntaxe Joda indiquant comment analyser time_string. String
• timezone — Facultatif. Fuseau horaire. String

Valeur renvoyée

Renvoie un DateTime64 analysé à partir de la chaîne d’entrée, ou NULL si l’analyse échoue. Nullable(DateTime64)

Exemples

Exemple d’utilisation

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

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

Introduit dans : v24.10.0

Identique à parseDateTime64InJodaSyntax, mais renvoie une date zéro lorsqu’elle rencontre un format de date impossible à analyser.

Syntaxe

parseDateTime64InJodaSyntaxOrZero(time_string, format[, timezone])

Arguments

• time_string — Chaîne à analyser en DateTime64. String
• format — Chaîne de format en syntaxe Joda, indiquant comment analyser time_string. String
• timezone — Facultatif. Fuseau horaire. String

Valeur renvoyée

Renvoie le DateTime64 analysé à partir de la chaîne d’entrée, ou un DateTime64 zéro si l’analyse échoue. DateTime64

Exemples

Exemple d’utilisation

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

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

Introduit dans : v24.11.0

Identique à parseDateTime64, mais renvoie NULL lorsqu’elle rencontre un format de date non analysable.

Syntaxe

parseDateTime64OrNull(time_string, format[, timezone])

Arguments

• time_string — Chaîne à analyser en DateTime64. String
• format — Chaîne de format indiquant comment analyser time_string. String
• timezone — Facultatif. Fuseau horaire. String

Valeur renvoyée

Renvoie la valeur DateTime64 obtenue à partir de la chaîne d’entrée, ou NULL si l’analyse échoue. Nullable(DateTime64)

Exemples

Exemple d’utilisation

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

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

Introduit dans : v24.11.0

Identique à parseDateTime64, mais renvoie une date zéro lorsqu'un format de date ne peut pas être analysé.

Syntaxe

parseDateTime64OrZero(time_string, format[, timezone])

Arguments

• time_string — Chaîne à analyser en DateTime64. String
• format — Chaîne de format indiquant comment analyser time_string. String
• timezone — Facultatif. Fuseau horaire. String

Valeur renvoyée

Renvoie la valeur DateTime64 analysée à partir de la chaîne d’entrée, ou la valeur DateTime64 zéro si l’analyse échoue. DateTime64

Exemples

Exemple d'utilisation

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

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

Introduced in: v1.1.0

Convertit une date et une heure de leur représentation String vers le type de données DateTime. La fonction analyse les formats de date et d'heure ISO 8601, RFC 1123 - 5.2.14 RFC-822, le format de date et d'heure de ClickHouse, ainsi que certains autres formats.

Formats non standard pris en charge :

• Une chaîne contenant un timestamp Unix sur 9 à 10 chiffres.
• Une chaîne contenant une composante de date et une composante d'heure : YYYYMMDDhhmmss, DD/MM/YYYY hh:mm:ss, DD-MM-YY hh:mm, YYYY-MM-DD hh:mm:ss, etc.
• Une chaîne contenant une date, mais sans composante d'heure : YYYY, YYYYMM, YYYY*MM, DD/MM/YYYY, DD-MM-YY, etc.
• Une chaîne contenant un jour et une heure : DD, DD hh, DD hh:mm. Dans ce cas, MM est remplacé par 01.
• Une chaîne incluant la date et l'heure ainsi que des informations de décalage de fuseau horaire : YYYY-MM-DD hh:mm:ss ±h:mm, etc.
• Un timestamp syslog : Mmm dd hh:mm:ss. Par exemple, Jun 9 14:20:32.

Pour tous les formats avec séparateur, la fonction analyse les noms de mois exprimés sous leur forme complète ou par les trois premières lettres du mois. Si l'année n'est pas indiquée, l'année en cours est utilisée.

Syntax

parseDateTimeBestEffort(time_string[, time_zone])

Arguments

• time_string — Chaîne contenant une date et une heure à convertir. String
• time_zone — Facultatif. Fuseau horaire utilisé pour analyser time_string. String

Valeur renvoyée

Renvoie time_string sous forme de DateTime. DateTime

Exemples

Exemple d'utilisation

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

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

Avec un fuseau horaire

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

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

timestamp Unix

SELECT parseDateTimeBestEffort('1735689600') AS parseDateTimeBestEffort

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

Introduit dans : v1.1.0

Identique à parseDateTimeBestEffort, sauf qu'elle renvoie NULL lorsqu'elle rencontre un format de date qui ne peut pas être analysé. La fonction analyse les formats ISO 8601, RFC 1123 - 5.2.14 RFC-822 Date and Time Specification, celui de ClickHouse, ainsi que certains autres formats de date et d'heure.

Formats non standard pris en charge :

• Une chaîne contenant un timestamp Unix de 9 à 10 chiffres.
• Une chaîne avec une composante de date et une composante d'heure : YYYYMMDDhhmmss, DD/MM/YYYY hh:mm:ss, DD-MM-YY hh:mm, YYYY-MM-DD hh:mm:ss, etc.
• Une chaîne avec une date, mais sans composante d'heure : YYYY, YYYYMM, YYYY*MM, DD/MM/YYYY, DD-MM-YY, etc.
• Une chaîne contenant un jour et une heure : DD, DD hh, DD hh:mm. Dans ce cas, MM est remplacé par 01.
• Une chaîne qui inclut la date et l'heure ainsi que des informations de décalage de fuseau horaire : YYYY-MM-DD hh:mm:ss ±h:mm, etc.
• Un timestamp syslog : Mmm dd hh:mm:ss. Par exemple, Jun 9 14:20:32.

Pour tous les formats avec séparateur, la fonction analyse les noms de mois écrits soit en toutes lettres, soit avec les trois premières lettres du mois. Si l'année n'est pas spécifiée, elle est considérée comme étant l'année en cours.

Syntaxe

parseDateTimeBestEffortOrNull(time_string[, time_zone])

Arguments

• time_string — chaîne contenant une date et une heure à convertir. String
• time_zone — Facultatif. Fuseau horaire selon lequel time_string est interprétée. String

Valeur renvoyée

Renvoie time_string sous forme de DateTime, ou NULL si l’entrée ne peut pas être interprétée. DateTime ou NULL

Exemples

Exemple d’utilisation

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

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

Introduit dans : v1.1.0

Identique à parseDateTimeBestEffort, à ceci près qu'elle renvoie une date zéro ou une date-heure zéro lorsqu'elle rencontre un format de date qui ne peut pas être analysé. La fonction analyse ISO 8601, RFC 1123 - 5.2.14 RFC-822 Date and Time Specification, les formats de date et d'heure de ClickHouse, ainsi que certains autres formats.

Formats non standard pris en charge :

• Une chaîne contenant un Unix timestamp de 9 à 10 chiffres.
• Une chaîne avec une composante de date et une composante d'heure : YYYYMMDDhhmmss, DD/MM/YYYY hh:mm:ss, DD-MM-YY hh:mm, YYYY-MM-DD hh:mm:ss, etc.
• Une chaîne avec une date, mais sans composante d'heure : YYYY, YYYYMM, YYYY*MM, DD/MM/YYYY, DD-MM-YY etc.
• Une chaîne avec un jour et une heure : DD, DD hh, DD hh:mm. Dans ce cas, MM est remplacé par 01.
• Une chaîne qui inclut la date et l'heure, ainsi que des informations de décalage de fuseau horaire : YYYY-MM-DD hh:mm:ss ±h:mm, etc.
• Un syslog timestamp : Mmm dd hh:mm:ss. Par exemple, Jun 9 14:20:32.

Pour tous les formats avec séparateur, la fonction analyse les noms de mois exprimés sous leur forme complète ou par les trois premières lettres du mois. Si l'année n'est pas spécifiée, elle est considérée comme étant l'année en cours.

Syntaxe

parseDateTimeBestEffortOrZero(time_string[, time_zone])

Arguments

• time_string — chaîne contenant une date et une heure à convertir. String
• time_zone — Facultatif. Fuseau horaire utilisé pour interpréter time_string. String

Valeur renvoyée

Renvoie time_string sous forme de DateTime, ou la date/date-heure zéro (1970-01-01 ou 1970-01-01 00:00:00) si l'entrée ne peut pas être interprétée. DateTime

Exemples

Exemple d'utilisation

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

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

Introduite dans : v1.1.0

Cette fonction se comporte comme parseDateTimeBestEffort pour les formats de date ISO, par ex. YYYY-MM-DD hh:mm:ss, ainsi que pour d'autres formats de date dont les composants mois et jour peuvent être extraits sans ambiguïté, par ex. YYYYMMDDhhmmss, YYYY-MM, DD hh ou YYYY-MM-DD hh:mm:ss ±h:mm. Si les composants mois et jour ne peuvent pas être extraits sans ambiguïté, par ex. MM/DD/YYYY, MM-DD-YYYY ou MM-DD-YY, elle privilégie le format de date américain plutôt que DD/MM/YYYY, DD-MM-YYYY ou DD-MM-YY. Exception à ce qui précède : si le mois est supérieur à 12 et inférieur ou égal à 31, cette fonction revient au comportement de parseDateTimeBestEffort ; par ex. 15/08/2020 est interprété comme 2020-08-15.

Syntaxe

parseDateTimeBestEffortUS(time_string[, time_zone])

Arguments

• time_string — chaîne contenant une date et une heure à convertir. String
• time_zone — Facultatif. Fuseau horaire selon lequel time_string est interprétée. String

Valeur renvoyée

Renvoie time_string sous forme de DateTime, en privilégiant le format de date américain dans les cas ambigus. DateTime

Exemples

Exemple d'utilisation

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

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

Introduite dans : v1.1.0

Identique à la fonction parseDateTimeBestEffortUS, sauf qu'elle renvoie NULL lorsqu'elle rencontre un format de date qui ne peut pas être traité.

Cette fonction se comporte comme parseDateTimeBestEffort pour les formats de date ISO, mais privilégie le format de date américain dans les cas ambigus, et renvoie NULL en cas d'erreur d'analyse.

Syntaxe

parseDateTimeBestEffortUSOrNull(time_string[, time_zone])

Arguments

• time_string — Chaîne contenant une date et une heure à convertir. String
• time_zone — Facultatif. Fuseau horaire selon lequel time_string est analysé. String

Valeur renvoyée

Renvoie time_string sous forme de DateTime en privilégiant le format américain, ou NULL si l’entrée ne peut pas être analysée. DateTime ou NULL

Exemples

Exemple d'utilisation

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

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

Introduit dans : v1.1.0

Identique à la fonction parseDateTimeBestEffortUS, sauf qu'elle renvoie la date zéro (1970-01-01) ou la date zéro avec heure (1970-01-01 00:00:00) lorsqu'elle rencontre un format de date qui ne peut pas être analysé.

Cette fonction se comporte comme parseDateTimeBestEffort pour les formats de date ISO, mais privilégie le format de date américain dans les cas ambigus, et renvoie zéro en cas d'erreur d'analyse.

Syntaxe

parseDateTimeBestEffortUSOrZero(time_string[, time_zone])

Arguments

• time_string — String contenant une date et une heure à convertir. String
• time_zone — Facultatif. Fuseau horaire selon lequel time_string est analysé. String

Valeur renvoyée

Renvoie time_string sous forme de DateTime, avec priorité au format US, ou une date/DateTime zéro (1970-01-01 ou 1970-01-01 00:00:00) si l’entrée ne peut pas être analysée. DateTime

Exemples

Exemple d’utilisation

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

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

Introduit dans : v23.3.0

Analyse une chaîne de date et d’heure selon une chaîne de format de date Joda.

Cette fonction est l’inverse de formatDateTimeInJodaSyntax. Elle analyse un argument String à l’aide d’une chaîne de format String de style Joda. Elle renvoie un type DateTime.

Consultez la documentation Joda Time pour les modèles de format.

Syntaxe

parseDateTimeInJodaSyntax(time_string, format[, timezone])

Arguments

• time_string — Chaîne à convertir en DateTime. String
• format — Chaîne de format en syntaxe Joda indiquant comment interpréter time_string. String
• timezone — Facultatif. Fuseau horaire. String

Valeur renvoyée

Renvoie un DateTime obtenu à partir de la chaîne d'entrée selon la chaîne de format au style Joda. DateTime

Exemples

Exemple d'utilisation

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

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

Introduit dans : v23.3.0

Identique à parseDateTimeInJodaSyntax, mais renvoie NULL en présence d’un format de date impossible à analyser.

Syntaxe

parseDateTimeInJodaSyntaxOrNull(time_string, format[, timezone])

Arguments

• time_string — Chaîne à analyser pour obtenir un DateTime. String
• format — Chaîne de format en syntaxe Joda indiquant comment analyser time_string. String
• timezone — Facultatif. Fuseau horaire. String

Valeur renvoyée

Renvoie la valeur DateTime obtenue à partir de la chaîne d’entrée, ou NULL si l’analyse échoue. Nullable(DateTime)

Exemples

Exemple d’utilisation

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

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

Introduit dans : v23.3.0

Identique à parseDateTimeInJodaSyntax, mais renvoie une date zéro en cas de format de date impossible à analyser.

Syntaxe

parseDateTimeInJodaSyntaxOrZero(time_string, format[, timezone])

Arguments

• time_string — Chaîne à analyser pour obtenir un DateTime. String
• format — Chaîne de format en syntaxe Joda indiquant comment analyser time_string. String
• timezone — Optionnel. Fuseau horaire. String

Valeur renvoyée

Renvoie le DateTime obtenu à partir de la chaîne d'entrée, ou le DateTime zéro si l'analyse échoue. DateTime

Exemples

Exemple d'utilisation

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

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

Introduit dans : v23.3.0

Identique à parseDateTime, mais renvoie NULL lorsqu’il rencontre un format de date impossible à analyser.

Syntaxe

parseDateTimeOrNull(time_string, format[, timezone])

Alias : str_to_date

Arguments

• time_string — chaîne à analyser pour obtenir un DateTime. String
• format — Chaîne de format indiquant comment analyser time_string. String
• timezone — Facultatif. Fuseau horaire. String

Valeur renvoyée

Renvoie le DateTime obtenu à partir de la chaîne d'entrée, ou NULL si l'analyse échoue. Nullable(DateTime)

Exemples

Exemple d'utilisation

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

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

Introduit dans : v23.3.0

Identique à parseDateTime, mais renvoie une date zéro lorsqu’un format de date ne peut pas être analysé.

Syntaxe

parseDateTimeOrZero(time_string, format[, timezone])

Arguments

• time_string — Chaîne à convertir en DateTime. String
• format — Chaîne de format indiquant comment analyser time_string. String
• timezone — Facultatif. Fuseau horaire. String

Valeur renvoyée

Renvoie le DateTime obtenu à partir de la chaîne d'entrée, ou le DateTime zéro si l'analyse échoue. DateTime

Exemples

Exemple d'utilisation

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

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

Introduit dans : v1.1.0

Utilise la même séquence d’octets source en mémoire pour la valeur x fournie et la réinterprète dans le type de destination. Lorsque le type de destination est String, un Array source n’est pris en charge que si son type d’élément est de taille fixe et contigu en mémoire (par exemple, Array(UInt8) ou Array(FixedString(2))) ; les octets de ses éléments sont copiés tels quels dans leur ordre natif en mémoire, de sorte que le résultat puisse être réinterprété dans le type Array d’origine sur n’importe quelle architecture. Les Array dont les éléments sont de longueur variable (par exemple, Array(String)) ou Nullable (par exemple, Array(Nullable(Int32))) ne sont pas pris en charge.

Syntaxe

reinterpret(x, type)

Arguments

• x — Valeur à réinterpréter. Lors d’une réinterprétation en String, un Array source doit avoir des éléments contigus de taille fixe. Any
• type — Type de destination. S'il s'agit d'un tableau, le type des éléments du tableau doit être de longueur fixe. String

Valeur renvoyée

Valeur du type de destination. Any

Exemples

Exemple d'utilisation

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

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

Exemple de type Array

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

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

Exemple de Array vers String

SELECT hex(reinterpret([toUInt8(1), toUInt8(2), toUInt8(255)]::Array(UInt8), 'String')) AS array_of_UInt8_to_string

┌─array_of_UInt8_to_string─┐
│ 0102FF                   │
└──────────────────────────┘

Introduit dans : v1.1.0

Réinterprète la valeur d’entrée comme une valeur de type Date (en supposant l’ordre little endian), correspondant au nombre de jours écoulés depuis le début de l’époque Unix, le 1970-01-01

Syntaxe

reinterpretAsDate(x)

Arguments

• x — Nombre de jours depuis le début de l’époque Unix. (U)Int* ou Float* ou Date ou DateTime ou UUID ou String ou FixedString

Valeur renvoyée

Date. Date

Exemples

Exemple d'utilisation

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

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

Introduit dans : v1.1.0

Réinterprète la valeur d’entrée comme une valeur DateTime (en supposant l’ordre little endian), c’est-à-dire comme le nombre de jours écoulés depuis le début de l’époque Unix, le 1970-01-01

Syntaxe

reinterpretAsDateTime(x)

Arguments

• x — Nombre de secondes écoulées depuis le début de l’époque Unix. (U)Int* ou Float* ou Date ou DateTime ou UUID ou String ou FixedString

Valeur renvoyée

Date et heure. DateTime

Exemples

Exemple d’utilisation

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

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

Introduit dans : v1.1.0

Réinterprète la valeur d’entrée comme une chaîne de longueur fixe (en supposant l’ordre little endian). Les octets nuls en fin de chaîne sont ignorés. Par exemple, pour la valeur UInt32 255, la fonction renvoie une chaîne contenant un seul caractère.

Syntaxe

reinterpretAsFixedString(x)

Arguments

• x — Valeur à réinterpréter en chaîne de caractères. (U)Int* ou Float* ou Date ou DateTime

Valeur renvoyée

Chaîne de longueur fixe contenant les octets représentant x. FixedString

Exemples

Exemple d'utilisation

-- The result is a sequence of bytes, so it is shown with `hex`.
SELECT
    hex(reinterpretAsFixedString(toDateTime('1970-01-01 01:01:05'))),
    hex(reinterpretAsFixedString(toDate('1970-03-07')))

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

Introduit dans : v1.1.0

Réinterprète la valeur d’entrée comme une valeur de type Float32. Contrairement à CAST, la fonction ne cherche pas à préserver la valeur d’origine : si le type cible ne peut pas représenter le type d’entrée, la valeur de sortie est indéfinie.

Syntaxe

reinterpretAsFloat32(x)

Arguments

• x — Valeur à réinterpréter comme Float32. (U)Int* ou Float* ou Date ou DateTime ou UUID ou String ou FixedString

Valeur renvoyée

Renvoie la valeur x réinterprétée. Float32

Exemples

Exemple d'utilisation

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

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

Introduit dans : v1.1.0

Réinterprète la valeur d’entrée comme une valeur de type Float64. Contrairement à CAST, la fonction ne cherche pas à préserver la valeur d’origine : si le type cible ne peut pas représenter le type d’entrée, le résultat est indéfini.

Syntaxe

reinterpretAsFloat64(x)

Arguments

• x — Valeur à réinterpréter en Float64. (U)Int* ou Float* ou Date ou DateTime ou UUID ou String ou FixedString

Valeur renvoyée

Renvoie la valeur x réinterprétée. Float64

Exemples

Exemple d'utilisation

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

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

Introduit dans : v1.1.0

Réinterprète la valeur d’entrée comme une valeur de type Int128. Contrairement à CAST, la fonction ne cherche pas à préserver la valeur d’origine : si le type cible ne peut pas représenter le type d’entrée, la sortie est indéfinie.

Syntaxe

reinterpretAsInt128(x)

Arguments

• x — Valeur à réinterpréter en Int128. (U)Int* ou Float* ou Date ou DateTime ou UUID ou String ou FixedString

Valeur renvoyée

Renvoie la valeur x réinterprétée. Int128

Exemples

Exemple d'utilisation

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

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

Introduit dans : v1.1.0

Réinterprète la valeur d’entrée comme une valeur de type Int16. Contrairement à CAST, la fonction ne cherche pas à préserver la valeur d’origine : si le type cible ne peut pas représenter le type d’entrée, la valeur de sortie est indéfinie.

Syntaxe

reinterpretAsInt16(x)

Arguments

• x — Valeur à réinterpréter en Int16. (U)Int* ou Float* ou Date ou DateTime ou UUID ou String ou FixedString

Valeur renvoyée

Renvoie la valeur x réinterprétée. Int16

Exemples

Exemple d'utilisation

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

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

Introduit dans : v1.1.0

Réinterprète la valeur d’entrée comme une valeur de type Int256. Contrairement à CAST, la fonction ne cherche pas à préserver la valeur d’origine ; si le type cible ne peut pas représenter le type d’entrée, le résultat est indéfini.

Syntaxe

reinterpretAsInt256(x)

Arguments

• x — Valeur à réinterpréter en Int256. (U)Int* ou Float* ou Date ou DateTime ou UUID ou String ou FixedString

Valeur renvoyée

Renvoie la valeur x réinterprétée. Int256

Exemples

Exemple d'utilisation

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

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

Introduit dans : v1.1.0

Réinterprète la valeur d’entrée comme une valeur de type Int32. Contrairement à CAST, la fonction ne cherche pas à préserver la valeur d’origine ; si le type cible ne peut pas représenter le type d’entrée, le résultat est indéfini.

Syntaxe

reinterpretAsInt32(x)

Arguments

• x — Valeur à réinterpréter en Int32. (U)Int* ou Float* ou Date ou DateTime ou UUID ou String ou FixedString

Valeur renvoyée

Renvoie la valeur réinterprétée x. Int32

Exemples

Exemple d'utilisation

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

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

Introduite dans : v1.1.0

Réinterprète la valeur d'entrée comme une valeur de type Int64. Contrairement à CAST, cette fonction ne cherche pas à préserver la valeur d'origine : si le type cible n'est pas capable de représenter le type d'entrée, la valeur de sortie est indéfinie.

Syntaxe

reinterpretAsInt64(x)

Arguments

• x — Valeur à réinterpréter en Int64. (U)Int* ou Float* ou Date ou DateTime ou UUID ou String ou FixedString

Valeur renvoyée

Renvoie la valeur x réinterprétée. Int64

Exemples

Exemple d'utilisation

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

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

Introduit dans : v1.1.0

Réinterprète la valeur d'entrée comme une valeur de type Int8. Contrairement à CAST, la fonction ne cherche pas à préserver la valeur d'origine : si le type cible ne peut pas représenter le type d'entrée, la sortie est indéfinie.

Syntaxe

reinterpretAsInt8(x)

Arguments

• x — Valeur à réinterpréter en Int8. (U)Int* ou Float* ou Date ou DateTime ou UUID ou String ou FixedString

Valeur renvoyée

Renvoie la valeur réinterprétée x. Int8

Exemples

Exemple d'utilisation

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

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

Introduit dans : v1.1.0

Réinterprète la valeur d’entrée comme une chaîne de caractères. Pour les valeurs scalaires, l’ordre des octets est normalisé en little endian, et les octets nuls en fin de chaîne sont ignorés. Par exemple, pour la valeur UInt32 255, la fonction renvoie une chaîne ne contenant qu’un seul caractère. Pour un Array d’éléments de taille fixe, les octets des éléments sont copiés tels quels dans leur ordre natif en mémoire, sans suppression des octets nuls de fin et sans normalisation en little endian, de sorte que le résultat peut être réinterprété dans le type Array d’origine sur n’importe quelle architecture.

Syntaxe

reinterpretAsString(x)

Arguments

• x — Valeur à réinterpréter en chaîne de caractères. (U)Int* ou Float* ou Date ou DateTime ou Array

Valeur renvoyée

Chaîne contenant les octets représentant x. String

Exemples

Exemple d'utilisation

-- The result is a sequence of bytes, so it is shown with `hex`.
SELECT
    hex(reinterpretAsString(toDateTime('1970-01-01 01:01:05'))),
    hex(reinterpretAsString(toDate('1970-03-07')))

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

Exemple de conversion de Array en String

SELECT hex(reinterpretAsString([toUInt8(1), toUInt8(2), toUInt8(255)]::Array(UInt8))) AS array_of_UInt8_to_string

┌─array_of_UInt8_to_string─┐
│ 0102FF                   │
└──────────────────────────┘

Introduit dans : v1.1.0

Réinterprète la valeur d’entrée comme une valeur de type UInt128. Contrairement à CAST, la fonction ne cherche pas à préserver la valeur d’origine : si le type cible n’est pas capable de représenter le type d’entrée, la valeur de sortie est indéfinie.

Syntaxe

reinterpretAsUInt128(x)

Arguments

• x — Valeur à réinterpréter en UInt128. (U)Int* ou Float* ou Date ou DateTime ou UUID ou String ou FixedString

Valeur renvoyée

Renvoie la valeur x réinterprétée. UInt128

Exemples

Exemple d'utilisation

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

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

Introduit dans : v1.1.0

Réinterprète la valeur d’entrée comme une valeur de type UInt16. Contrairement à CAST, la fonction ne tente pas de préserver la valeur d’origine : si le type cible ne peut pas représenter le type d’entrée, le résultat est indéfini.

Syntaxe

reinterpretAsUInt16(x)

Arguments

• x — Valeur à réinterpréter comme UInt16. (U)Int* ou Float* ou Date ou DateTime ou UUID ou String ou FixedString

Valeur renvoyée

Renvoie la valeur x réinterprétée. UInt16

Exemples

Exemple d'utilisation

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

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

Introduit dans : v1.1.0

Réinterprète la valeur d’entrée comme une valeur de type UInt256. Contrairement à CAST, la fonction ne cherche pas à préserver la valeur d’origine : si le type cible ne peut pas représenter le type d’entrée, le résultat est indéfini.

Syntaxe

reinterpretAsUInt256(x)

Arguments

• x — valeur à réinterpréter en UInt256. (U)Int* ou Float* ou Date ou DateTime ou UUID ou String ou FixedString

Valeur renvoyée

Renvoie la valeur x réinterprétée. UInt256

Exemples

Exemple d'utilisation

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

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

Introduit dans : v1.1.0

Réinterprète la valeur d'entrée comme une valeur de type UInt32. Contrairement à CAST, la fonction ne cherche pas à préserver la valeur d'origine : si le type cible ne peut pas représenter le type d'entrée, la sortie est indéfinie.

Syntaxe

reinterpretAsUInt32(x)

Arguments

• x — Valeur à réinterpréter sous forme de UInt32. (U)Int* ou Float* ou Date ou DateTime ou UUID ou String ou FixedString

Valeur renvoyée

Renvoie la valeur x réinterprétée. UInt32

Exemples

Exemple d’utilisation

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

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

Introduit dans : v1.1.0

Réinterprète la valeur d’entrée comme une valeur de type UInt64. Contrairement à CAST, la fonction ne cherche pas à préserver la valeur d’origine : si le type cible ne peut pas représenter le type d’entrée, la sortie est indéfinie.

Syntaxe

reinterpretAsUInt64(x)

Arguments

• x — Valeur à réinterpréter en UInt64. Int* ou UInt* ou Float* ou Date ou DateTime ou UUID ou String ou FixedString

Valeur renvoyée

Renvoie la valeur de x réinterprétée. UInt64

Exemples

Exemple d'utilisation

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

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

Introduite dans : v1.1.0

Réinterprète la valeur d'entrée en valeur de type UInt8. Contrairement à CAST, la fonction ne cherche pas à préserver la valeur d'origine : si le type cible ne peut pas représenter le type d'entrée, la valeur de sortie est indéfinie.

Syntaxe

reinterpretAsUInt8(x)

Arguments

• x — Valeur à réinterpréter en UInt8. (U)Int* ou Float* ou Date ou DateTime ou UUID ou String ou FixedString

Valeur renvoyée

Renvoie la valeur x réinterprétée. UInt8

Exemples

Exemple d'utilisation

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

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

Introduit dans : v1.1.0

Accepte une chaîne de 16 octets et renvoie un UUID en interprétant chaque moitié de 8 octets selon l’ordre des octets little-endian. Si la chaîne n’est pas assez longue, la fonction se comporte comme si elle était complétée à la fin par le nombre nécessaire d’octets nuls. Si la chaîne dépasse 16 octets, les octets supplémentaires à la fin sont ignorés.

Syntaxe

reinterpretAsUUID(fixed_string)

Arguments

• fixed_string — Chaîne d’octets au format big-endian. FixedString

Valeur renvoyée

Valeur de type UUID. UUID

Exemples

Chaîne en UUID

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

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

Introduit dans : v1.1.0

Convertit une valeur d’entrée en une valeur de type BFloat16. Lève une exception en cas d’erreur.

Voir aussi :

• toBFloat16OrZero.
• toBFloat16OrNull.

Syntaxe

toBFloat16(expr)

Arguments

• expr — Expression qui renvoie un nombre ou sa représentation sous forme de chaîne. Expression

Valeur renvoyée

Renvoie une valeur brain-float de 16 bits. BFloat16

Exemples

Exemple d’utilisation

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

Row 1:
──────
toBFloat16(toFloat32(42.7)):   42.5
toBFloat16(toFloat32('42.7')): 42.5
toBFloat16('42.7'):            42.5

Introduite dans : v1.1.0

Convertit une valeur d’entrée de type String en une valeur de type BFloat16. Si la chaîne ne représente pas une valeur à virgule flottante, la fonction renvoie NULL.

Arguments pris en charge :

• Représentations sous forme de chaîne de valeurs numériques.

Arguments non pris en charge (renvoient NULL) :

• Représentations sous forme de chaîne de valeurs binaires et hexadécimales.
• Valeurs numériques.

Voir aussi :

• toBFloat16.
• toBFloat16OrZero.

Syntaxe

toBFloat16OrNull(x)

Arguments

• x — Représentation sous forme de chaîne d’un nombre. String

Valeur renvoyée

Renvoie une valeur brain-float de 16 bits, sinon NULL. BFloat16 ou NULL

Exemples

Exemple d’utilisation

SELECT toBFloat16OrNull('0x5E'), -- unsupported arguments
       toBFloat16OrNull('12.3'), -- typical use
       toBFloat16OrNull('12.3456789') -- silent loss of precision

\N	12.25	12.3125

Introduit dans : v1.1.0

Convertit une valeur d’entrée de type String en une valeur de type BFloat16. Si la chaîne ne représente pas une valeur à virgule flottante, la fonction renvoie zéro.

Arguments pris en charge :

• Représentations sous forme de chaîne de valeurs numériques.

Arguments non pris en charge (renvoient 0) :

• Représentations sous forme de chaîne de valeurs binaires et hexadécimales.
• Valeurs numériques.

Voir aussi :

• toBFloat16.
• toBFloat16OrNull.

Syntaxe

toBFloat16OrZero(x)

Arguments

• x — Représentation sous forme de chaîne d'un nombre. String

Valeur renvoyée

Renvoie une valeur brain-float sur 16 bits, sinon 0. BFloat16

Exemples

Exemple d'utilisation

SELECT toBFloat16OrZero('0x5E'), -- unsupported arguments
       toBFloat16OrZero('12.3'), -- typical use
       toBFloat16OrZero('12.3456789') -- silent loss of precision

0	12.25	12.3125

Introduit dans : v22.2.0

Convertit une valeur d’entrée en valeur de type Bool.

Syntaxe

toBool(expr)

Arguments

• expr — Expression renvoyant un nombre ou une chaîne de caractères. Pour les chaînes de caractères, accepte 'true' ou 'false' (insensible à la casse). (U)Int* ou Float* ou String ou Expression

Valeur renvoyée

Renvoie true ou false en fonction de l'évaluation de l'argument. Bool

Exemples

Exemple d'utilisation

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

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

Introduit dans : v1.1.0

Convertit une valeur d’entrée au type Date. Prend en charge la conversion à partir de String, FixedString, DateTime ou de types numériques.

Syntaxe

toDate(x)

Arguments

• x — Valeur d’entrée à convertir. String ou FixedString ou DateTime ou (U)Int* ou Float*

Valeur renvoyée

Renvoie la valeur d’entrée convertie. Date

Exemples

Conversion de String en Date

SELECT toDate('2025-04-15')

2025-04-15

Conversion de DateTime en Date

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

2025-04-15

Conversion d’un entier en Date

SELECT toDate(20297)

2025-07-28

Introduit dans : v21.9.0

Convertit l’argument en type de données Date32. Si la valeur est hors de la plage [0000-01-01, 9999-12-31], toDate32 renvoie les valeurs limites prises en charge par Date32. Si l’argument est de type Date, ses limites sont prises en compte.

Syntaxe

toDate32(expr)

Arguments

• expr — La valeur à convertir. String ou UInt32 ou Date

Valeur renvoyée

Renvoie une date calendaire. Date32

Exemples

Dans la plage

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

Row 1:
──────
value:             2025-01-01
toTypeName(value): Date32

Avant 1900

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

Row 1:
──────
value:             1899-01-01
toTypeName(value): Date32

Introduite dans : v21.11.0

Convertit l’argument en type de données Date32. Si l’argument ne peut pas être converti, notamment s’il s’agit d’une valeur numérique hors de la plage de Date32, la fonction renvoie une valeur par défaut, qui correspond soit au deuxième argument (s’il est spécifié), soit à 1900-01-01, la valeur par défaut historique de Date32 (et non sa borne inférieure, qui est 0000-01-01). Si l’argument est de type Date, ses bornes sont prises en compte.

Notez que, contrairement à toDate32, cette fonction ne sature pas un argument numérique hors plage aux bornes de Date32 ; un tel argument est traité comme non convertible.

Syntaxe

toDate32OrDefault(expr[, default])

Arguments

• expr — Expression qui renvoie un nombre ou la représentation sous forme de chaîne d’un nombre. String ou (U)Int* ou Float*
• default — Facultatif. Valeur par défaut à renvoyer si l’analyse échoue. Date32

Valeur renvoyée

Une valeur de type Date32 en cas de succès ; sinon, renvoie la valeur par défaut si elle est fournie, ou 1900-01-01 dans le cas contraire. Date32

Exemples

Conversion réussie

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

1930-01-01

Échec de la conversion

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

2020-01-01

Nombre hors plage

SELECT toDate32OrDefault(toUInt64(18446744073709551615), toDate32('2020-01-01'))

2020-01-01

Introduit dans : v21.9.0

Convertit une valeur d’entrée en une valeur de type Date32, mais renvoie NULL si un argument invalide est fourni. Identique à toDate32, mais renvoie NULL si un argument invalide est fourni.

Syntaxe

toDate32OrNull(x)

Arguments

• x — Une représentation sous forme de chaîne d’une date. String

Valeur renvoyée

Renvoie une valeur Date32 en cas de succès, sinon NULL. Date32 ou NULL

Exemples

Exemple d’utilisation

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

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

Introduit dans : v21.9.0

Convertit une valeur d’entrée en une valeur de type Date32, mais renvoie la valeur par défaut 1900-01-01 si l’argument est invalide. Identique à toDate32, mais renvoie 1900-01-01 si l’argument est invalide. Notez que 1900-01-01 est une valeur par défaut historique pour les entrées non valides, et non la borne inférieure de Date32, qui est 0000-01-01.

Voir aussi :

• toDate32
• toDate32OrNull
• toDate32OrDefault

Syntaxe

toDate32OrZero(x)

Arguments

• x — Une représentation sous forme de chaîne d’une date. String

Valeur renvoyée

Renvoie une valeur Date32 en cas de réussite ; sinon, la valeur par défaut historique pour une entrée non valide (1900-01-01). Date32

Exemples

Exemple d'utilisation

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

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

Introduit dans : v21.11.0

Comme toDate, mais en cas d'échec, renvoie une valeur par défaut : le deuxième argument (s'il est spécifié) ou, à défaut, la borne inférieure de Date.

Syntaxe

toDateOrDefault(expr[, default])

Arguments

• expr — Expression renvoyant un nombre ou une représentation textuelle d'un nombre. String ou (U)Int* ou Float*
• default — Facultatif. Valeur par défaut à renvoyer si l'analyse échoue. Date

Valeur renvoyée

Une valeur de type Date en cas de réussite ; sinon, renvoie la valeur par défaut si elle est fournie, ou 1970-01-01 dans le cas contraire. Date

Exemples

Conversion réussie

SELECT toDateOrDefault('2022-12-30')

2022-12-30

Échec de la conversion

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

2023-01-01

Introduit dans : v1.1.0

Convertit une valeur d’entrée en une valeur de type Date, mais renvoie NULL si un argument invalide est fourni. Identique à toDate, mais renvoie NULL si un argument invalide est fourni. Un argument entier est interprété de la même manière que par toDate (comme un nombre de jours depuis le 1970-01-01 s’il ne dépasse pas 65535, sinon comme un timestamp Unix) et produit NULL s’il est hors de la plage du type Date.

Syntaxe

toDateOrNull(x)

Arguments

• x — Une représentation sous forme de chaîne d’une date, ou un nombre entier de jours ou un timestamp Unix. String ou (U)Int8/16/32/64

Valeur renvoyée

Renvoie une valeur Date en cas de succès, sinon NULL. Date ou NULL

Exemples

Exemple d’utilisation

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

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

Introduit dans : v1.1.0

Convertit une valeur d'entrée en une valeur de type Date, mais renvoie la borne inférieure de Date en cas d'argument invalide. Identique à toDate, mais renvoie la borne inférieure de Date en cas d'argument invalide.

Voir aussi :

• toDate
• toDateOrNull
• toDateOrDefault

Syntaxe

toDateOrZero(x)

Arguments

• x — Une représentation sous forme de chaîne de caractères d’une date. String

Valeur renvoyée

Renvoie une valeur Date en cas de succès, sinon la borne inférieure de Date (1970-01-01). Date

Exemples

Exemple d’utilisation

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

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

Introduit dans : v1.1.0

Convertit une valeur d'entrée en type DateTime.

Syntaxe

toDateTime(expr[, time_zone])

Arguments

• expr — La valeur. String ou Int ou Date ou DateTime
• time_zone — Fuseau horaire. String

Valeur renvoyée

Renvoie une date et une heure. DateTime

Exemples

Exemple d'utilisation

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

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

Introduit dans : v20.9.0

Convertit une valeur d’entrée en type DateTime. Prend en charge la conversion depuis String, FixedString, Date, Date32, Time, DateTime, DateTime64 ou des types numériques ((U)Int8, (U)Int16, (U)Int32, (U)Int64, BFloat16, Float32, Float64). Les valeurs Decimal et Time64 ne sont pas prises en charge et lèvent une exception ; le type Time et les types d’entiers de grande taille tels que (U)Int128/(U)Int256 effectuent un bouclage au lieu de saturer. DateTime32 est un alias de DateTime et prend en charge les dates comprises entre 1970-01-01 00:00:00 et 2106-02-07 06:28:15. Lors d’une conversion depuis une chaîne ou l’un des types numériques saturants répertoriés ci-dessus, les valeurs hors de cette plage sont ramenées à ses bornes. Les valeurs à virgule flottante non finies (NaN, inf, -inf) ne peuvent pas être converties et lèvent une exception. Les conversions depuis d’autres types de date et d’heure, tels que Date32 ou DateTime64, suivent le paramètre date_time_overflow_behavior : le mode ignore par défaut peut produire des valeurs ayant subi un bouclage, saturate les ramène aux bornes de la plage et throw lève une exception.

Syntaxe

toDateTime32(x[, timezone])

Arguments

• x — Valeur d’entrée à convertir. String, FixedString, (U)Int*, Float*, BFloat16, Date, Date32, Time, DateTime ou DateTime64
• timezone — Facultatif. Fuseau horaire de la valeur DateTime renvoyée. String

Valeur renvoyée

Renvoie la valeur d’entrée convertie. DateTime

Exemples

À partir d’une chaîne

SELECT toDateTime32('2025-01-01 00:00:00') AS value, toTypeName(value);

┌───────────────value─┬─toTypeName(value)─┐
│ 2025-01-01 00:00:00 │ DateTime          │
└─────────────────────┴───────────────────┘

À partir d’un timestamp Unix

SELECT toDateTime32(1735689600, 'UTC') AS value, toTypeName(value);

┌───────────────value─┬─toTypeName(value)─┐
│ 2025-01-01 00:00:00 │ DateTime('UTC')   │
└─────────────────────┴───────────────────┘

Avec un fuseau horaire

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

┌───────────────value─┬─toTypeName(value)─────────┐
│ 2025-01-01 00:00:00 │ DateTime('Asia/Istanbul') │
└─────────────────────┴───────────────────────────┘

Introduit dans : v20.1.0

Convertit une valeur d’entrée en une valeur de type DateTime64.

Syntaxe

toDateTime64(expr, scale[, timezone])

Arguments

• expr — Expression renvoyant un nombre ou une représentation sous forme de chaîne d’un nombre. Expression
• scale — Taille du tick (précision) : 10^(-scale) secondes. UInt8
• timezone — Facultatif. Fuseau horaire de l’objet DateTime64 spécifié. String

Valeur renvoyée

Renvoie une date calendaire et une heure de la journée, avec une précision inférieure à la seconde. DateTime64

Exemples

La valeur se situe dans la plage

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

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

Sous forme de Decimal avec précision

SELECT toDateTime64(1546300800.000, 3) AS value, toTypeName(value);
-- Without the decimal point the value is still treated as Unix Timestamp in seconds
SELECT toDateTime64(1546300800000, 3) AS value, toTypeName(value);

┌───────────────────value─┬─toTypeName(value)─┐
│ 2019-01-01 00:00:00.000 │ DateTime64(3)     │
└─────────────────────────┴───────────────────┘
┌───────────────────value─┬─toTypeName(value)─┐
│ 9999-12-31 23:59:59.000 │ DateTime64(3)     │
└─────────────────────────┴───────────────────┘

Avec fuseau horaire

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

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

Introduit dans : v21.11.0

Comme toDateTime64, cette fonction convertit une valeur d'entrée en une valeur de type DateTime64, mais renvoie soit la valeur par défaut de DateTime64, soit la valeur par défaut fournie si un argument invalide est reçu.

Syntaxe

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

Arguments

• expr — Expression renvoyant un nombre ou la représentation sous forme de chaîne d'un nombre. String ou (U)Int* ou Float*
• scale — Taille du tick (précision) : 10^-precision secondes. UInt8
• timezone — Facultatif. Fuseau horaire. String
• default — Facultatif. La valeur par défaut à renvoyer si l'analyse échoue. DateTime64

Valeur renvoyée

Valeur de type DateTime64 en cas de succès, sinon renvoie la valeur par défaut si elle est fournie, ou 1970-01-01 00:00:00.000 dans le cas contraire. DateTime64

Exemples

Conversion réussie

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

1976-10-18 00:00:00.300

Échec de la conversion

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

2001-01-01 00:00:00.000

Introduit dans : v20.1.0

Convertit une valeur d'entrée en une valeur de type DateTime64, mais renvoie NULL si l'argument reçu n'est pas valide. Identique à toDateTime64, mais renvoie NULL si l'argument reçu n'est pas valide. Un argument entier est interprété comme un timestamp Unix en secondes entières et renvoie NULL s’il est hors de la plage du type DateTime64.

Syntaxe

toDateTime64OrNull(x[, precision[, timezone]])

Arguments

• x — Une représentation sous forme de chaîne d’une date et heure avec une précision sous-seconde, ou un timestamp Unix entier. String ou (U)Int8/16/32/64
• precision — Facultatif. La précision sous-seconde de la valeur renvoyée. UInt8
• timezone — Facultatif. Le fuseau horaire de la valeur renvoyée. String

Valeur renvoyée

Renvoie une valeur DateTime64 en cas de succès, sinon NULL. DateTime64 ou NULL

Exemples

Exemple d’utilisation

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

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

Introduit dans : v20.1.0

Convertit une valeur d’entrée en une valeur de type DateTime64, mais renvoie la borne inférieure de DateTime64 si l’argument est invalide. Identique à toDateTime64, mais renvoie la borne inférieure de DateTime64 si l’argument est invalide.

Voir aussi :

• toDateTime64.
• toDateTime64OrNull.
• toDateTime64OrDefault.

Syntaxe

toDateTime64OrZero(x)

Arguments

• x — Une représentation sous forme de chaîne d’une date et heure avec une précision sous-seconde. String

Valeur renvoyée

Renvoie une valeur de type DateTime64 en cas de succès, sinon la borne inférieure de DateTime64 (1970-01-01 00:00:00.000). DateTime64

Exemples

Exemple d’utilisation

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

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

Introduit dans : v21.11.0

Comme toDateTime, mais en cas d'échec, renvoie une valeur par défaut : soit le troisième argument (s'il est spécifié), soit, à défaut, la borne inférieure de DateTime.

Syntaxe

toDateTimeOrDefault(expr[, timezone, default])

Arguments

• expr — Expression renvoyant un nombre ou la représentation sous forme de chaîne d’un nombre. String ou (U)Int* ou Float*
• timezone — Facultatif. Fuseau horaire. String
• default — Facultatif. La valeur par défaut à renvoyer si l’analyse échoue. DateTime

Valeur renvoyée

Une valeur de type DateTime en cas de succès ; sinon, la valeur par défaut si elle est fournie, ou 1970-01-01 00:00:00 dans le cas contraire. DateTime

Exemples

Conversion réussie

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

2022-12-30 13:44:17

Conversion échouée

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

2023-01-01 00:00:00

Introduit dans : v1.1.0

Convertit une valeur d'entrée en valeur de type DateTime, mais renvoie NULL si l'argument est invalide. Identique à toDateTime, mais renvoie NULL si l'argument est invalide. Un argument entier est interprété comme un horodatage Unix et renvoie NULL s'il est hors de la plage du type DateTime.

Syntaxe

toDateTimeOrNull(x[, timezone])

Arguments

• x — Une représentation sous forme de chaîne d'une date et d'une heure, ou un timestamp Unix sous forme d'entier. String ou (U)Int8/16/32/64
• timezone — Facultatif. Fuseau horaire de la valeur renvoyée. String

Valeur renvoyée

Renvoie une valeur DateTime en cas de réussite, sinon NULL. DateTime ou NULL

Exemples

Exemple d'utilisation

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

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

Argument entier avec un fuseau horaire

SELECT toDateTimeOrNull(1583851242, 'Asia/Shanghai'), toDateTimeOrNull(4294967296)

┌─toDateTimeOrNull(1583851242, 'Asia/Shanghai')─┬─toDateTimeOrNull(4294967296)─┐
│                           2020-03-10 22:40:42 │                         ᴺᵁᴸᴸ │
└───────────────────────────────────────────────┴──────────────────────────────┘

Introduit dans : v1.1.0

Convertit une valeur d’entrée en une valeur de type DateTime, mais renvoie la borne inférieure de DateTime si un argument invalide est fourni. Identique à toDateTime, mais renvoie la borne inférieure de DateTime si un argument invalide est fourni.

Syntaxe

toDateTimeOrZero(x)

Arguments

• x — Une représentation sous forme de chaîne d’une date et heure. String

Valeur renvoyée

Renvoie une valeur DateTime en cas de succès ; sinon, la borne inférieure de DateTime (1970-01-01 00:00:00). DateTime

Exemples

Exemple d’utilisation

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

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

Introduit dans : v18.12.0

Convertit une valeur d'entrée en une valeur de type Decimal(38, S) avec une échelle de S. Lève une exception en cas d'erreur.

Arguments pris en charge :

• Valeurs ou représentations sous forme de chaîne de type (U)Int*.
• Valeurs ou représentations sous forme de chaîne de type Float*.

Arguments non pris en charge :

• Valeurs Float* NaN et Inf, ou leurs représentations sous forme de chaîne (insensible à la casse).
• Représentations sous forme de chaîne de valeurs binaires et hexadécimales, par exemple SELECT toDecimal128('0xc0fe', 1);.

Syntaxe

toDecimal128(expr, S)

Arguments

• expr — Expression renvoyant un nombre ou sa représentation sous forme de chaîne. Expression
• S — Paramètre d’échelle compris entre 0 et 38, qui indique le nombre de chiffres que peut comporter la partie fractionnaire d’un nombre. UInt8

Valeur renvoyée

Renvoie une valeur de type Decimal(38, S) Decimal128(S)

Exemples

Exemple d’utilisation

SELECT
    toDecimal128(99, 1) AS a, toTypeName(a) AS type_a,
    toDecimal128(99.67, 2) AS b, toTypeName(b) AS type_b,
    toDecimal128('99.67', 3) AS c, toTypeName(c) AS type_c
FORMAT Vertical

Row 1:
──────
a:      99
type_a: Decimal(38, 1)
b:      99.67
type_b: Decimal(38, 2)
c:      99.67
type_c: Decimal(38, 3)

Introduit dans : v21.11.0

Comme toDecimal128, cette fonction convertit une valeur d’entrée en une valeur de type Decimal(38, S), mais renvoie une valeur par défaut en cas d’erreur.

Syntaxe

toDecimal128OrDefault(expr, S[, default])

Arguments

• expr — Représentation sous forme de chaîne d’un nombre. String
• S — Paramètre d’échelle compris entre 0 et 38, qui spécifie le nombre de chiffres que la partie fractionnaire d’un nombre peut contenir. UInt8
• default — Facultatif. Valeur par défaut à renvoyer si la conversion en type Decimal128(S) échoue. Decimal128(S)

Valeur renvoyée

Valeur de type Decimal(38, S) en cas de réussite ; sinon, renvoie la valeur par défaut si elle est fournie, ou 0 dans le cas contraire. Decimal128(S)

Exemples

Conversion réussie

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

0.023809523809523808

Échec de la conversion

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

-1

Introduit dans : v20.1.0

Convertit une valeur d’entrée en une valeur de type Decimal(38, S), mais renvoie NULL en cas d’erreur. Comme toDecimal128, mais renvoie NULL au lieu de lever une exception en cas d’erreur de conversion.

Arguments pris en charge :

• Valeurs ou représentations sous forme de chaîne de type (U)Int*.
• Valeurs ou représentations sous forme de chaîne de type Float*.

Arguments non pris en charge (renvoient NULL) :

• Valeurs Float* NaN et Inf, ou leurs représentations sous forme de chaîne (insensible à la casse).
• Représentations sous forme de chaîne de valeurs binaires et hexadécimales.
• Valeurs qui dépassent les limites de Decimal128 : (-1*10^(38 - S), 1*10^(38 - S)).

Voir aussi :

• toDecimal128.
• toDecimal128OrZero.
• toDecimal128OrDefault.

Syntaxe

toDecimal128OrNull(expr, S)

Arguments

• expr — Expression renvoyant un nombre ou une représentation sous forme de chaîne d'un nombre. Expression
• S — Paramètre d'échelle compris entre 0 et 38, indiquant le nombre de chiffres que la partie fractionnaire d'un nombre peut comporter. UInt8

Valeur renvoyée

Renvoie une valeur Decimal(38, S) en cas de réussite, sinon NULL. Decimal128(S) ou NULL

Exemples

Exemple d'utilisation

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

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

Introduit dans : v20.1.0

Convertit une valeur d’entrée en une valeur de type Decimal(38, S), mais renvoie 0 en cas d’erreur. Comme toDecimal128, mais renvoie 0 au lieu de lever une exception en cas d’erreur de conversion.

Arguments pris en charge :

• Valeurs ou représentations sous forme de chaîne de type (U)Int*.
• Valeurs ou représentations sous forme de chaîne de type Float*.

Arguments non pris en charge (renvoient 0) :

• Valeurs ou représentations sous forme de chaîne des valeurs Float* NaN et Inf (insensible à la casse).
• Représentations sous forme de chaîne de valeurs binaires et hexadécimales.

Syntaxe

toDecimal128OrZero(expr, S)

Arguments

• expr — Expression renvoyant un nombre ou la représentation sous forme de chaîne d’un nombre. Expression
• S — Paramètre d’échelle compris entre 0 et 38, indiquant le nombre de chiffres que la partie fractionnaire d’un nombre peut comporter. UInt8

Valeur renvoyée

Renvoie une valeur Decimal(38, S) en cas de succès, sinon 0. Decimal128(S)

Exemples

Utilisation de base

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

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

Introduit dans : v20.8.0

Convertit une valeur d’entrée en une valeur de type Decimal(76, S) avec une échelle de S. Lève une exception en cas d’erreur.

Arguments pris en charge :

• Valeurs ou représentations sous forme de chaîne de type (U)Int*.
• Valeurs ou représentations sous forme de chaîne de type Float*.

Arguments non pris en charge :

• Valeurs ou représentations sous forme de chaîne des valeurs Float* NaN et Inf (insensible à la casse).
• Représentations sous forme de chaîne de valeurs binaires et hexadécimales, par exemple SELECT toDecimal256('0xc0fe', 1);.

Syntaxe

toDecimal256(expr, S)

Arguments

• expr — Expression renvoyant un nombre ou la représentation sous forme de chaîne d’un nombre. Expression
• S — Paramètre d’échelle compris entre 0 et 76, indiquant le nombre de chiffres que la partie fractionnaire d’un nombre peut comporter. UInt8

Valeur renvoyée

Renvoie une valeur de type Decimal(76, S). Decimal256(S)

Exemples

Exemple d’utilisation

SELECT
    toDecimal256(99, 1) AS a, toTypeName(a) AS type_a,
    toDecimal256(99.67, 2) AS b, toTypeName(b) AS type_b,
    toDecimal256('99.67', 3) AS c, toTypeName(c) AS type_c
FORMAT Vertical

Row 1:
──────
a:      99
type_a: Decimal(76, 1)
b:      99.67
type_b: Decimal(76, 2)
c:      99.67
type_c: Decimal(76, 3)

Introduit dans : v21.11.0

Comme toDecimal256, cette fonction convertit une valeur d’entrée en valeur de type Decimal(76, S), mais renvoie la valeur par défaut en cas d’erreur.

Syntaxe

toDecimal256OrDefault(expr, S[, default])

Arguments

• expr — Une représentation sous forme de chaîne d’un nombre. String
• S — Paramètre d’échelle compris entre 0 et 76, qui indique le nombre de chiffres que la partie fractionnaire d’un nombre peut contenir. UInt8
• default — Facultatif. Valeur par défaut à renvoyer si la conversion vers le type Decimal256(S) échoue. Decimal256(S)

Valeur renvoyée

Une valeur de type Decimal(76, S) en cas de réussite ; sinon, la valeur par défaut si elle est fournie, ou 0 dans le cas contraire. Decimal256(S)

Exemples

Conversion réussie

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

0.023809523809523808

Échec de conversion

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

-1

Introduit dans : v20.8.0

Convertit une valeur d'entrée en une valeur de type Decimal(76, S), mais renvoie NULL en cas d'erreur. Comme toDecimal256, mais renvoie NULL au lieu de lever une exception en cas d'erreur de conversion.

Arguments pris en charge :

• Valeurs ou représentations sous forme de chaîne de type (U)Int*.
• Valeurs ou représentations sous forme de chaîne de type Float*.

Arguments non pris en charge (renvoient NULL) :

• Valeurs ou représentations sous forme de chaîne des valeurs Float* NaN et Inf (insensible à la casse).
• Représentations sous forme de chaîne de valeurs binaires et hexadécimales.
• Valeurs qui dépassent les limites de Decimal256 : (-1 * 10^(76 - S), 1 * 10^(76 - S)).

Voir aussi :

• toDecimal256.
• toDecimal256OrZero.
• toDecimal256OrDefault.

Syntaxe

toDecimal256OrNull(expr, S)

Arguments

• expr — Expression renvoyant un nombre ou sa représentation sous forme de chaîne. Expression
• S — Paramètre d’échelle compris entre 0 et 76, indiquant le nombre de chiffres que peut contenir la partie fractionnaire d’un nombre. UInt8

Valeur renvoyée

Renvoie une valeur Decimal(76, S) en cas de succès, sinon NULL. Decimal256(S) ou NULL

Exemples

Exemple d’utilisation

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

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

Introduit dans : v20.8.0

Convertit une valeur d’entrée en valeur de type Decimal(76, S), mais renvoie 0 en cas d’erreur. Comme toDecimal256, mais renvoie 0 au lieu de lever une exception en cas d’erreur de conversion.

Arguments pris en charge :

• Valeurs ou représentations sous forme de chaîne de type (U)Int*.
• Valeurs ou représentations sous forme de chaîne de type Float*.

Arguments non pris en charge (renvoient 0) :

• Valeurs ou représentations sous forme de chaîne de caractères de valeurs Float* NaN et Inf (insensible à la casse).
• Représentations sous forme de chaîne de valeurs binaires et hexadécimales.

Voir aussi :

• toDecimal256.
• toDecimal256OrNull.
• toDecimal256OrDefault.

Syntaxe

toDecimal256OrZero(expr, S)

Arguments

• expr — Expression renvoyant un nombre ou la représentation sous forme de chaîne d’un nombre. Expression
• S — Paramètre d’échelle compris entre 0 et 76, indiquant combien de chiffres peut comporter la partie fractionnaire d’un nombre. UInt8

Valeur renvoyée

Renvoie une valeur Decimal(76, S) en cas de succès, sinon 0. Decimal256(S)

Exemples

Exemple d’utilisation

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

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

Introduit dans : v18.12.0

Convertit une valeur d’entrée en une valeur de type Decimal(9, S) avec une échelle de S. Lève une exception en cas d’erreur.

Arguments pris en charge :

• Valeurs ou représentations sous forme de chaîne de type (U)Int*.
• Valeurs ou représentations sous forme de chaîne de type Float*.

Arguments non pris en charge :

• Valeurs ou représentations sous forme de chaîne des valeurs Float* NaN et Inf (insensible à la casse).
• Représentations sous forme de chaîne de valeurs binaires et hexadécimales, par ex. SELECT toDecimal32('0xc0fe', 1);.

Syntaxe

toDecimal32(expr, S)

Arguments

• expr — Expression renvoyant un nombre ou une représentation d’un nombre sous forme de chaîne. Expression
• S — Paramètre d’échelle compris entre 0 et 9, indiquant le nombre de chiffres que peut comporter la partie fractionnaire d’un nombre. UInt8

Valeur renvoyée

Renvoie une valeur de type Decimal(9, S) Decimal32(S)

Exemples

Exemple d’utilisation

SELECT
    toDecimal32(2, 1) AS a, toTypeName(a) AS type_a,
    toDecimal32(4.2, 2) AS b, toTypeName(b) AS type_b,
    toDecimal32('4.2', 3) AS c, toTypeName(c) AS type_c
FORMAT Vertical

Row 1:
──────
a:      2
type_a: Decimal(9, 1)
b:      4.2
type_b: Decimal(9, 2)
c:      4.2
type_c: Decimal(9, 3)

Introduit dans : v21.11.0

À l’instar de toDecimal32, cette fonction convertit une valeur d’entrée en une valeur de type Decimal(9, S), mais renvoie la valeur par défaut en cas d’erreur.

Syntaxe

toDecimal32OrDefault(expr, S[, default])

Arguments

• expr — Une représentation sous forme de chaîne d’un nombre. String
• S — Paramètre d’échelle compris entre 0 et 9, qui spécifie le nombre de chiffres que la partie fractionnaire d’un nombre peut contenir. UInt8
• default — Facultatif. La valeur par défaut à renvoyer si la conversion en type Decimal32(S) échoue. Decimal32(S)

Valeur renvoyée

Une valeur de type Decimal(9, S) en cas de réussite ; sinon, la valeur par défaut si elle est fournie, ou 0 dans le cas contraire. Decimal32(S)

Exemples

Conversion réussie

SELECT toDecimal32OrDefault(toString(0.0001), 5)

0.0001

Échec de conversion

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

-1

Introduit dans : v20.1.0

Convertit une valeur d’entrée en une valeur de type Decimal(9, S), mais renvoie NULL en cas d’erreur. Comme toDecimal32, mais renvoie NULL au lieu de lever une exception en cas d’erreur de conversion.

Arguments pris en charge :

• Valeurs ou représentations sous forme de chaîne de type (U)Int*.
• Valeurs ou représentations sous forme de chaîne de type Float*.

Arguments non pris en charge (renvoient NULL) :

• Valeurs ou représentations sous forme de chaîne des valeurs Float* NaN et Inf (insensible à la casse).
• Représentations sous forme de chaîne de valeurs binaires et hexadécimales.
• Valeurs qui dépassent les limites de Decimal32 :(-1*10^(9 - S), 1*10^(9 - S)).

Voir aussi :

• toDecimal32.
• toDecimal32OrZero.
• toDecimal32OrDefault.

Syntaxe

toDecimal32OrNull(expr, S)

Arguments

• expr — Expression renvoyant un nombre ou une représentation sous forme de chaîne d’un nombre. Expression
• S — Paramètre d’échelle compris entre 0 et 9, indiquant le nombre de chiffres que peut comporter la partie fractionnaire d’un nombre. UInt8

Valeur renvoyée

Renvoie une valeur Decimal(9, S) en cas de succès, sinon NULL. Decimal32(S) ou NULL

Exemples

Exemple d’utilisation

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

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

Introduit dans : v20.1.0

Convertit une valeur d'entrée en une valeur de type Decimal(9, S), mais renvoie 0 en cas d'erreur. Comme toDecimal32, mais renvoie 0 au lieu de lever une exception en cas d'erreur de conversion.

Arguments pris en charge :

• Valeurs ou représentations sous forme de chaîne du type (U)Int*.
• Valeurs ou représentations sous forme de chaîne du type Float*.

Arguments non pris en charge (renvoient 0) :

• Valeurs Float* NaN et Inf, ou leurs représentations sous forme de chaîne (insensible à la casse).
• Représentations sous forme de chaîne de valeurs binaires et hexadécimales.

Syntaxe

toDecimal32OrZero(expr, S)

Arguments

• expr — Expression renvoyant un nombre ou sa représentation sous forme de chaîne. Expression
• S — Paramètre d’échelle compris entre 0 et 9, indiquant le nombre de chiffres que peut comporter la partie fractionnaire d’un nombre. UInt8

Valeur renvoyée

Renvoie une valeur Decimal(9, S) en cas de réussite, sinon 0. Decimal32(S)

Exemples

Exemple d’utilisation

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

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

Introduit dans : v18.12.0

Convertit une valeur d’entrée en une valeur de type Decimal(18, S) avec une échelle de S. Lève une exception en cas d’erreur.

Arguments pris en charge :

• Valeurs ou représentations sous forme de chaîne de type (U)Int*.
• Valeurs ou représentations sous forme de chaîne de type Float*.

Arguments non pris en charge :

• Valeurs ou représentations sous forme de chaîne des valeurs Float* NaN et Inf (insensible à la casse).
• Représentations sous forme de chaîne de valeurs binaires ou hexadécimales, par ex. SELECT toDecimal64('0xc0fe', 1);.

Syntaxe

toDecimal64(expr, S)

Arguments

• expr — Expression renvoyant un nombre ou la représentation sous forme de chaîne d’un nombre. Expression
• S — Paramètre d’échelle compris entre 0 et 18, indiquant le nombre de chiffres que peut comporter la partie fractionnaire d’un nombre. UInt8

Valeur renvoyée

Renvoie une valeur de type décimal. Decimal(18, S)

Exemples

Exemple d’utilisation

SELECT
    toDecimal64(2, 1) AS a, toTypeName(a) AS type_a,
    toDecimal64(4.2, 2) AS b, toTypeName(b) AS type_b,
    toDecimal64('4.2', 3) AS c, toTypeName(c) AS type_c
FORMAT Vertical

Row 1:
──────
a:      2
type_a: Decimal(18, 1)
b:      4.2
type_b: Decimal(18, 2)
c:      4.2
type_c: Decimal(18, 3)

Introduit dans : v21.11.0

Comme toDecimal64, cette fonction convertit une valeur d’entrée en une valeur de type Decimal(18, S), mais renvoie la valeur par défaut en cas d’erreur.

Syntaxe

toDecimal64OrDefault(expr, S[, default])

Arguments

• expr — Une représentation d’un nombre sous forme de chaîne. String
• S — Paramètre d’échelle compris entre 0 et 18, indiquant le nombre de chiffres que peut contenir la partie fractionnaire d’un nombre. UInt8
• default — Facultatif. Valeur par défaut à renvoyer si la conversion vers le type Decimal64(S) échoue. Decimal64(S)

Valeur renvoyée

Une valeur de type Decimal(18, S) en cas de réussite ; sinon, la valeur par défaut si elle est fournie, ou 0 dans le cas contraire. Decimal64(S)

Exemples

Conversion réussie

SELECT toDecimal64OrDefault(toString(0.0001), 18)

0.0001

Échec de la conversion

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

-1

Introduit dans : v20.1.0

Convertit une valeur d’entrée en une valeur de type Decimal(18, S), mais renvoie NULL en cas d’erreur. Comme toDecimal64, mais renvoie NULL au lieu de lever une exception en cas d’erreur de conversion.

Arguments pris en charge :

• Valeurs ou représentations sous forme de chaîne de type (U)Int*.
• Valeurs ou représentations sous forme de chaîne de type Float*.

Arguments non pris en charge (renvoient NULL) :

• Valeurs ou représentations sous forme de chaîne des valeurs Float* NaN et Inf (insensible à la casse).
• Représentations sous forme de chaîne de valeurs binaires et hexadécimales.
• Valeurs qui dépassent les limites de Decimal64 : (-1*10^(18 - S), 1*10^(18 - S)).

Voir aussi :

• toDecimal64.
• toDecimal64OrZero.
• toDecimal64OrDefault.

Syntaxe

toDecimal64OrNull(expr, S)

Arguments

• expr — Expression renvoyant un nombre ou une représentation sous forme de chaîne d'un nombre. Expression
• S — Paramètre d'échelle compris entre 0 et 18, indiquant le nombre de chiffres que peut comporter la partie fractionnaire d'un nombre. UInt8

Valeur renvoyée

Renvoie une valeur Decimal(18, S) en cas de réussite, sinon NULL. Decimal64(S) ou NULL

Exemples

Exemple d'utilisation

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

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

Introduit dans : v20.1.0

Convertit une valeur d'entrée en une valeur de type Decimal(18, S), mais renvoie 0 en cas d'erreur. Comme toDecimal64, mais renvoie 0 au lieu de lever une exception en cas d'erreur de conversion.

Arguments pris en charge :

• Valeurs ou représentations sous forme de chaîne de type (U)Int*.
• Valeurs ou représentations sous forme de chaîne de type Float*.

Arguments non pris en charge (renvoient 0) :

• Valeurs ou représentations sous forme de chaîne des valeurs Float* NaN et Inf (insensible à la casse).
• Représentations sous forme de chaîne de valeurs binaires et hexadécimales.

Voir aussi :

• toDecimal64.
• toDecimal64OrNull.
• toDecimal64OrDefault.

Syntaxe

toDecimal64OrZero(expr, S)

Arguments

• expr — Expression renvoyant un nombre ou la représentation sous forme de chaîne d’un nombre. Expression
• S — Paramètre d’échelle compris entre 0 et 18, indiquant le nombre de chiffres que peut contenir la partie fractionnaire d’un nombre. UInt8

Valeur renvoyée

Renvoie une valeur Decimal(18, S) en cas de réussite, sinon 0. Decimal64(S)

Exemples

Exemple d’utilisation

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

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

Introduit dans : v23.3.0

Convertit une valeur numérique en String avec le nombre spécifié de chiffres fractionnaires.

La fonction arrondit la valeur d'entrée au nombre spécifié de décimales. Si la valeur d'entrée comporte moins de chiffres fractionnaires que demandé, le résultat est complété par des zéros afin d'obtenir exactement le nombre de chiffres fractionnaires spécifié.

Syntaxe

toDecimalString(number, scale)

Arguments

• number — Valeur numérique à convertir en chaîne. Peut être de n’importe quel type numérique (Int, UInt, Float, Decimal). Int8 ou Int16 ou Int32 ou Int64 ou UInt8 ou UInt16 ou UInt32 ou UInt64 ou Float32 ou Float64 ou Decimal
• scale — Le nombre de chiffres à afficher après la virgule. Le résultat sera arrondi si nécessaire. UInt8

Valeur renvoyée

Renvoie une représentation String du nombre avec exactement le nombre spécifié de chiffres après la virgule. String

Exemples

Arrondir et formater un nombre

SELECT toDecimalString(2.1456, 2)

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

Remplir avec des zéros

SELECT toDecimalString(5, 3)

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

Différents types numériques

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

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

Introduit dans : v1.1.0

Convertit un argument String en FixedString(N) (une chaîne de longueur fixe N).

Si la chaîne comporte moins d’octets que N, elle est remplie à droite avec des octets nuls. Si la chaîne comporte plus d’octets que N, une exception est levée.

Syntaxe

toFixedString(s, N)

Arguments

• s — Chaîne à convertir. String
• N — Longueur de la FixedString obtenue. const UInt*

Valeur renvoyée

Renvoie une FixedString de longueur N. FixedString(N)

Exemples

Exemple d'utilisation

-- The padding is made of null bytes, so the result is shown with `hex`.
SELECT hex(toFixedString('foo', 8)) AS s;

┌─s────────────────┐
│ 666F6F0000000000 │
└──────────────────┘

Introduit dans : v1.1.0

Convertit une valeur d’entrée en valeur de type Float32. Lève une exception en cas d’erreur.

Arguments pris en charge :

• Valeurs de type (U)Int*.
• Représentations sous forme de chaîne de (U)Int8/16/32/128/256.
• Valeurs de type Float*, y compris NaN et Inf.
• Représentations sous forme de chaîne de Float*, y compris NaN et Inf (insensibles à la casse).

Arguments non pris en charge :

• Représentations sous forme de chaîne de valeurs binaires et hexadécimales, par exemple SELECT toFloat32('0xc0fe');.

Voir aussi :

• toFloat32OrZero.
• toFloat32OrNull.
• toFloat32OrDefault.

Syntaxe

toFloat32(expr)

Arguments

• expr — Expression renvoyant un nombre ou la représentation sous forme de chaîne d'un nombre. Expression

Valeur renvoyée

Renvoie une valeur à virgule flottante 32 bits. Float32

Exemples

Exemple d'utilisation

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

Row 1:
──────
toFloat32(42.7):   42.7
toFloat32('42.7'): 42.7
toFloat32('NaN'):  nan

Introduit dans : v21.11.0

Comme toFloat32, cette fonction convertit une valeur d'entrée en une valeur de type Float32, mais renvoie la valeur par défaut en cas d'erreur. Si aucune valeur default n'est fournie, 0 est renvoyé en cas d'erreur.

Syntaxe

toFloat32OrDefault(expr[, default])

Arguments

• expr — Expression qui renvoie un nombre ou la représentation sous forme de chaîne d’un nombre. String ou (U)Int* ou Float*
• default — Facultatif. La valeur par défaut à renvoyer si l’interprétation échoue. Float32

Valeur renvoyée

Renvoie une valeur de type Float32 en cas de réussite ; sinon, renvoie la valeur par défaut si elle est fournie, ou 0 dans le cas contraire. Float32

Exemples

Conversion réussie

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

8

Échec de conversion

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

0

Introduit dans : v1.1.0

Convertit une valeur d’entrée en valeur de type Float32, mais renvoie NULL en cas d’erreur. Comme toFloat32, mais renvoie NULL au lieu de lever une exception en cas d’erreur de conversion.

Arguments pris en charge :

• Valeurs de type (U)Int*.
• Représentations sous forme de chaîne de (U)Int8/16/32/128/256.
• Valeurs de type Float*, y compris NaN et Inf.
• Représentations sous forme de chaîne de Float*, y compris NaN et Inf (insensibles à la casse).

Arguments non pris en charge (renvoie NULL) :

• Représentations sous forme de chaîne de valeurs binaires et hexadécimales, par ex. SELECT toFloat32OrNull('0xc0fe');.
• Formats de chaîne non valides.

Voir aussi :

• toFloat32.
• toFloat32OrZero.
• toFloat32OrDefault.

Syntaxe

toFloat32OrNull(x)

Arguments

• x — Une représentation sous forme de chaîne d’un nombre. String

Valeur renvoyée

Renvoie une valeur Float32 en cas de réussite, sinon NULL. Float32 ou NULL

Exemples

Exemple d’utilisation

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

Row 1:
──────
toFloat32OrNull('42.7'): 42.7
toFloat32OrNull('NaN'):  nan
toFloat32OrNull('abc'):  ᴺᵁᴸᴸ

Introduit dans : v1.1.0

Convertit une valeur d'entrée en valeur de type Float32, mais renvoie 0 en cas d'erreur. Comme toFloat32, mais renvoie 0 au lieu de lever une exception en cas d'erreur de conversion.

Voir aussi :

• toFloat32.
• toFloat32OrNull.
• toFloat32OrDefault.

Syntaxe

toFloat32OrZero(x)

Arguments

• x — Une représentation sous forme de chaîne d’un nombre. String

Valeur renvoyée

Renvoie une valeur de type Float32 en cas de succès, sinon 0. Float32

Exemples

Exemple d'utilisation

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

Row 1:
──────
toFloat32OrZero('42.7'): 42.7
toFloat32OrZero('abc'):  0

Introduit dans : v1.1.0

Convertit une valeur d’entrée en une valeur de type Float64. Lève une exception en cas d’erreur.

Arguments pris en charge :

• Valeurs de type (U)Int*.
• Représentations sous forme de chaîne de (U)Int8/16/32/128/256.
• Valeurs de type Float*, y compris NaN et Inf.
• Représentations sous forme de chaîne de type Float*, y compris NaN et Inf (insensible à la casse).

Arguments non pris en charge :

• Représentations sous forme de chaîne de valeurs binaires et hexadécimales, par exemple SELECT toFloat64('0xc0fe');.

Voir aussi :

• toFloat64OrZero.
• toFloat64OrNull.
• toFloat64OrDefault.

Syntaxe

toFloat64(expr)

Arguments

• expr — Expression renvoyant un nombre ou la représentation sous forme de chaîne d'un nombre. Expression

Valeur renvoyée

Renvoie une valeur en virgule flottante sur 64 bits. Float64

Exemples

Exemple d'utilisation

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

Row 1:
──────
toFloat64(42.7):   42.7
toFloat64('42.7'): 42.7
toFloat64('NaN'):  nan

Introduit dans : v21.11.0

Comme toFloat64, cette fonction convertit une valeur d'entrée en valeur de type Float64, mais renvoie la valeur par défaut en cas d'erreur. Si aucune valeur default n'est fournie, 0 est renvoyé en cas d'erreur.

Syntaxe

toFloat64OrDefault(expr[, default])

Arguments

• expr — Expression renvoyant un nombre ou une représentation sous forme de chaîne d'un nombre. String ou (U)Int* ou Float*
• default — Facultatif. La valeur par défaut à renvoyer si l'analyse échoue. Float64

Valeur renvoyée

Renvoie une valeur de type Float64 en cas de réussite ; sinon, renvoie la valeur par défaut si elle est fournie, ou 0 dans le cas contraire. Float64

Exemples

Conversion réussie

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

8

Échec de la conversion

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