Problèmes courants de conversion des données
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.
Gardez à l’esprit qu’il existe un risque de perte de données si des valeurs d’un type sont converties vers un type plus petit (par exemple de
Int64 vers Int32) ou entre
des types incompatibles (par exemple de String vers Int). Vérifiez soigneusement que le résultat correspond bien à ce que vous attendez.Remarques sur les fonctions toString
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
toStringappliquée à un argumentDateTimepeut 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é.
Remarques sur les fonctions toDate/toDateTime
toDate/toDateTime sont définis comme suit :
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
Query
Response
toUnixTimestamp.
CAST
Any
Exemples
Utilisation de base
Query
Response
Query
Response
Query
Response
DATE
toDate. Son comportement est identique à celui de toDate.
Syntaxe
Date.
Exemples
Utilisation de base
Query
Response
accurateCast
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
Any
Exemples
Conversion réussie
Query
Response
Query
Response
accurateCastOrDefault
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
x— Une valeur à convertir.AnyT— Le nom du type de données cible.const Stringdefault_value— Facultatif. Valeur par défaut à renvoyer si la conversion échoue.Any
Any
Exemples
Conversion réussie
Query
Response
Query
Response
Query
Response
accurateCastOrNull
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
NULL si la conversion n’est pas possible. Any
Exemples
Conversion réussie
Query
Response
Query
Response
formatRow
Si le format contient un suffixe/préfixe, il sera écrit sur chaque ligne.
Seuls les formats basés sur les lignes sont pris en charge par cette fonction.
String
Exemples
Utilisation de base
Query
Response
Query
Response
formatRowNoNewline
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
String
Exemples
Utilisation de base
Query
Response
fromUnixTimestamp64Micro
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
value— Timestamp Unix en microsecondes.Int64timezone— Facultatif. Fuseau horaire de la valeur renvoyée.String
DateTime64 avec une précision en microsecondes. DateTime64(6)
Exemples
Exemple d’utilisation
Query
Response
fromUnixTimestamp64Milli
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
value— timestamp Unix en millisecondes.Int64timezone— Facultatif. Fuseau horaire de la valeur renvoyée.String
DateTime64 avec une précision à la milliseconde. DateTime64(3)
Exemples
Exemple d’utilisation
Query
Response
fromUnixTimestamp64Nano
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).
Veuillez noter que la valeur d’entrée est traitée comme un timestamp UTC, et non selon son fuseau horaire.
value— timestamp Unix en nanosecondes.Int64timezone— Facultatif. Fuseau horaire de la valeur renvoyée.String
DateTime64 avec une précision à la nanoseconde. DateTime64(9)
Exemples
Exemple d’utilisation
Query
Response
fromUnixTimestamp64Second
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
value— timestamp Unix en secondes.Int64timezone— Facultatif. Fuseau horaire de la valeur renvoyée.String
DateTime64 avec une précision à la seconde. DateTime64(0)
Exemples
Exemple d’utilisation
Query
Response
parseDateTime
formatDateTime.
Elle analyse un argument de type String à l’aide d’une chaîne de format String. Elle renvoie un type DateTime.
Syntaxe
TO_UNIXTIME
Arguments
time_string— Chaîne à analyser en DateTime.Stringformat— Chaîne de format indiquant comment analyser time_string.Stringtimezone— Facultatif. Fuseau horaire.String
DateTime
Exemples
Exemple d’utilisation
Query
Response
parseDateTime32BestEffort
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
time_string—Stringcontenant une date et une heure à convertir.Stringtime_zone— Facultatif. Fuseau horaire selon lequeltime_stringest interprété.String
time_string en DateTime. DateTime
Exemples
Exemple d’utilisation
Query
Response
Query
Response
Query
Response
parseDateTime32BestEffortOrNull
parseDateTime32BestEffort, sauf qu’elle renvoie NULL lorsqu’elle rencontre un format de date qu’elle ne peut pas traiter.
Syntaxe
time_string—Stringcontenant une date et une heure à convertir.Stringtime_zone— Facultatif. Fuseau horaire selon lequeltime_stringest interprété.String
DateTime interprété à partir de la chaîne, ou NULL si l’analyse échoue. DateTime
Exemples
Exemple d’utilisation
Query
Response
parseDateTime32BestEffortOrZero
parseDateTime32BestEffort, sauf qu’elle renvoie une date nulle ou une date et heure nulles lorsqu’elle rencontre un format de date qui ne peut pas être traité.
Syntaxe
time_string—Stringcontenant une date et une heure à convertir.Stringtime_zone— Facultatif. Fuseau horaire selon lequeltime_stringest interprétée.String
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
Query
Response
parseDateTime64
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 1900 à 2299 avec une précision sub-secondes.
Syntaxe
time_string— Chaîne à analyser pour obtenir unDateTime64.Stringformat— Chaîne de format indiquant comment analyser time_string.Stringtimezone— Facultatif. Fuseau horaire.String
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
Query
Response
parseDateTime64BestEffort
parseDateTimeBestEffort, mais prend également en charge l’analyse des millisecondes et des microsecondes, et renvoie le type de données DateTime64.
Syntaxe
time_string—Stringcontenant une date ou une date avec heure à convertir.Stringprecision— Facultatif. Précision requise.3pour les millisecondes,6pour les microsecondes. Par défaut :3.UInt8time_zone— Facultatif. Fuseau horaire. La fonction interprètetime_stringen fonction du fuseau horaire.String
time_string converti en type de données DateTime64. DateTime64
Exemples
Exemple d’utilisation
Query
Response
parseDateTime64BestEffortOrNull
parseDateTime64BestEffort, sauf qu’elle renvoie NULL lorsqu’elle rencontre un format de date impossible à traiter.
Syntaxe
time_string—Stringcontenant une date ou une date avec heure à convertir.Stringprecision— Facultatif. Précision requise.3pour les millisecondes,6pour les microsecondes. Valeur par défaut :3.UInt8time_zone— Facultatif. Fuseau horaire. La fonction interprètetime_stringselon le fuseau horaire.String
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
Query
Response
parseDateTime64BestEffortOrZero
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
time_string—Stringcontenant une date ou une date et heure à convertir.Stringprecision— Facultatif. Précision requise.3pour les millisecondes,6pour les microsecondes. Par défaut :3.UInt8time_zone— Facultatif. Fuseau horaire. La fonction interprètetime_stringselon ce fuseau horaire.String
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
Query
Response
parseDateTime64BestEffortUS
parseDateTime64BestEffort, sauf que cette fonction privilégie le format de date américain (MM/DD/YYYY, etc.) en cas d’ambiguïté.
Syntaxe
time_string—Stringcontenant une date ou une date avec heure à convertir.Stringprecision— Facultatif. Précision requise.3pour les millisecondes,6pour les microsecondes. Par défaut :3.UInt8time_zone— Facultatif. Fuseau horaire. La fonction interprètetime_stringselon le fuseau horaire.String
time_string converti en DateTime64 en privilégiant le format de date US dans les cas ambigus. DateTime64
Exemples
Exemple d’utilisation
Query
Response
parseDateTime64BestEffortUSOrNull
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 qu’elle ne peut pas traiter.
Syntaxe
time_string—Stringcontenant une date ou une date avec heure à convertir.Stringprecision— Facultatif. Précision requise.3pour les millisecondes,6pour les microsecondes. Valeur par défaut :3.UInt8time_zone— Facultatif. Fuseau horaire. La fonction analysetime_stringen fonction du fuseau horaire.String
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
Query
Response
parseDateTime64BestEffortUSOrZero
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 traité.
Syntaxe
time_string—Stringcontenant une date ou une date avec heure à convertir.Stringprecision— Facultatif. Précision requise.3pour les millisecondes,6pour les microsecondes. Par défaut :3.UInt8time_zone— Facultatif. Fuseau horaire. La fonction interprètetime_stringselon ce fuseau horaire.String
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
Query
Response
parseDateTime64InJodaSyntax
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 1900 à 2299 avec une précision inférieure à la seconde.
Consultez la documentation Joda Time pour les motifs de format.
Syntaxe
time_string— Chaîne à interpréter en DateTime64.Stringformat— Chaîne de format en syntaxe Joda indiquant comment interpréter time_string.Stringtimezone— Facultatif. Fuseau horaire.String
DateTime64
Exemples
Exemple d’utilisation
Query
Response
parseDateTime64InJodaSyntaxOrNull
parseDateTime64InJodaSyntax, mais renvoie NULL si le format de date ne peut pas être analysé.
Syntaxe
time_string— Chaîne à analyser en DateTime64.Stringformat— Chaîne de format en syntaxe Joda indiquant comment analyser time_string.Stringtimezone— Facultatif. Fuseau horaire.String
Nullable(DateTime64)
Exemples
Exemple d’utilisation
Query
Response
parseDateTime64InJodaSyntaxOrZero
parseDateTime64InJodaSyntax, mais renvoie une date zéro lorsqu’elle rencontre un format de date impossible à analyser.
Syntaxe
time_string— Chaîne à analyser en DateTime64.Stringformat— Chaîne de format en syntaxe Joda, indiquant comment analyser time_string.Stringtimezone— Facultatif. Fuseau horaire.String
DateTime64
Exemples
Exemple d’utilisation
Query
Response
parseDateTime64OrNull
parseDateTime64, mais renvoie NULL lorsqu’elle rencontre un format de date non analysable.
Syntaxe
time_string— Chaîne à analyser en DateTime64.Stringformat— Chaîne de format indiquant comment analyser time_string.Stringtimezone— Facultatif. Fuseau horaire.String
Nullable(DateTime64)
Exemples
Exemple d’utilisation
Query
Response
parseDateTime64OrZero
parseDateTime64, mais renvoie une date zéro lorsqu’un format de date ne peut pas être analysé.
Syntaxe
time_string— Chaîne à convertir en DateTime64.Stringformat— Chaîne de format indiquant comment analyser time_string.Stringtimezone— Facultatif. Fuseau horaire.String
DateTime64
Exemples
Exemple d’utilisation
Query
Response
parseDateTimeBestEffort
- 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,MMest remplacé par01. - 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.
time_string— Chaîne contenant une date et une heure à convertir.Stringtime_zone— Facultatif. Fuseau horaire utilisé pour analysertime_string.String
time_string sous forme de DateTime. DateTime
Exemples
Exemple d’utilisation
Query
Response
Query
Response
Query
Response
parseDateTimeBestEffortOrNull
parseDateTimeBestEffort, sauf qu’elle renvoie NULL lorsqu’elle rencontre un format de date impossible à traiter.
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,MMest remplacé par01. - 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.
time_string—Stringcontenant une date et une heure à convertir.Stringtime_zone— Facultatif. Fuseau horaire selon lequeltime_stringest interprétée.String
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
Query
Response
parseDateTimeBestEffortOrZero
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-YYetc. - Une chaîne avec un jour et une heure :
DD,DD hh,DD hh:mm. Dans ce cas,MMest remplacé par01. - 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.
time_string—Stringcontenant une date et une heure à convertir.Stringtime_zone— Facultatif. Fuseau horaire utilisé pour interprétertime_string.String
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
Query
Response
parseDateTimeBestEffortUS
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 US 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
time_string—Stringcontenant une date et une heure à convertir.Stringtime_zone— Facultatif. Fuseau horaire selon lequeltime_stringest interprétée.String
time_string sous forme de DateTime, en privilégiant le format de date américain dans les cas ambigus. DateTime
Exemples
Exemple d’utilisation
Query
Response
parseDateTimeBestEffortUSOrNull
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
time_string— Chaîne contenant une date et une heure à convertir.Stringtime_zone— Facultatif. Fuseau horaire selon lequeltime_stringest analysé.String
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
Query
Response
parseDateTimeBestEffortUSOrZero
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
time_string—Stringcontenant une date et une heure à convertir.Stringtime_zone— Facultatif. Fuseau horaire selon lequeltime_stringest analysé.String
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
Query
Response
parseDateTimeInJodaSyntax
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
time_string— Chaîne à convertir en DateTime.Stringformat— Chaîne de format en syntaxe Joda indiquant comment interpréter time_string.Stringtimezone— Facultatif. Fuseau horaire.String
DateTime
Exemples
Exemple d’utilisation
Query
Response
parseDateTimeInJodaSyntaxOrNull
parseDateTimeInJodaSyntax, mais renvoie NULL en présence d’un format de date impossible à analyser.
Syntaxe
time_string— Chaîne à analyser pour obtenir un DateTime.Stringformat— Chaîne de format en syntaxe Joda indiquant comment analyser time_string.Stringtimezone— Facultatif. Fuseau horaire.String
Nullable(DateTime)
Exemples
Exemple d’utilisation
Query
Response
parseDateTimeInJodaSyntaxOrZero
parseDateTimeInJodaSyntax, mais renvoie une date zéro en cas de format de date impossible à analyser.
Syntaxe
time_string— Chaîne à analyser pour obtenir un DateTime.Stringformat— Chaîne de format en syntaxe Joda indiquant comment analyser time_string.Stringtimezone— Optionnel. Fuseau horaire.String
DateTime
Exemples
Exemple d’utilisation
Query
Response
parseDateTimeOrNull
parseDateTime, mais renvoie NULL lorsqu’il rencontre un format de date non analysable.
Syntaxe
str_to_date
Arguments
time_string— Chaîne à analyser pour la convertir enDateTime.Stringformat— Chaîne de format indiquant comment analyser time_string.Stringtimezone— Facultatif. Fuseau horaire.String
DateTime obtenu à partir de la chaîne d’entrée, ou NULL si l’analyse échoue. Nullable(DateTime)
Exemples
Exemple d’utilisation
Query
Response
parseDateTimeOrZero
parseDateTime, mais renvoie une date zéro lorsqu’un format de date ne peut pas être analysé.
Syntaxe
time_string— Chaîne à convertir en DateTime.Stringformat— Chaîne de format indiquant comment analyser time_string.Stringtimezone— Facultatif. Fuseau horaire.String
DateTime
Exemples
Exemple d’utilisation
Query
Response
reinterpret
x fournie et la réinterprète dans le type de destination.
Syntaxe
x— N’importe quel type.Anytype— Type de destination. S’il s’agit d’un tableau, le type des éléments du tableau doit être de longueur fixe.String
Any
Exemples
Exemple d’utilisation
Query
Response
Query
Response
reinterpretAsDate
x— Nombre de jours depuis le début de l’époque Unix.(U)Int*ouFloat*ouDateouDateTimeouUUIDouStringouFixedString
Date
Exemples
Exemple d’utilisation
Query
Response
reinterpretAsDateTime
x— Nombre de secondes écoulées depuis le début de l’époque Unix.(U)Int*ouFloat*ouDateouDateTimeouUUIDouStringouFixedString
DateTime
Exemples
Exemple d’utilisation
Query
Response
reinterpretAsFixedString
x. FixedString
Exemples
Exemple d’utilisation
Query
Response
reinterpretAsFloat32
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
x— Valeur à réinterpréter comme Float32.(U)Int*ouFloat*ouDateouDateTimeouUUIDouStringouFixedString
x réinterprétée. Float32
Exemples
Exemple d’utilisation
Query
Response
reinterpretAsFloat64
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
x— Valeur à réinterpréter en Float64.(U)Int*ouFloat*ouDateouDateTimeouUUIDouStringouFixedString
x réinterprétée. Float64
Exemples
Exemple d’utilisation
Query
Response
reinterpretAsInt128
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
x— Valeur à réinterpréter en Int128.(U)Int*ouFloat*ouDateouDateTimeouUUIDouStringouFixedString
x réinterprétée. Int128
Exemples
Exemple d’utilisation
Query
Response
reinterpretAsInt16
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
x— Valeur à réinterpréter en Int16.(U)Int*ouFloat*ouDateouDateTimeouUUIDouStringouFixedString
x réinterprétée. Int16
Exemples
Exemple d’utilisation
Query
Response
reinterpretAsInt256
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
x— Valeur à réinterpréter en Int256.(U)Int*ouFloat*ouDateouDateTimeouUUIDouStringouFixedString
x réinterprétée. Int256
Exemples
Exemple d’utilisation
Query
Response
reinterpretAsInt32
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
x— Valeur à réinterpréter en Int32.(U)Int*ouFloat*ouDateouDateTimeouUUIDouStringouFixedString
x. Int32
Exemples
Exemple d’utilisation
Query
Response
reinterpretAsInt64
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
x— Valeur à réinterpréter en Int64.(U)Int*ouFloat*ouDateouDateTimeouUUIDouStringouFixedString
x réinterprétée. Int64
Exemples
Exemple d’utilisation
Query
Response
reinterpretAsInt8
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
x— Valeur à réinterpréter en Int8.(U)Int*ouFloat*ouDateouDateTimeouUUIDouStringouFixedString
x. Int8
Exemples
Exemple d’utilisation
Query
Response
reinterpretAsString
x. String
Exemples
Exemple d’utilisation
Query
Response
reinterpretAsUInt128
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
x— Valeur à réinterpréter en UInt128.(U)Int*ouFloat*ouDateouDateTimeouUUIDouStringouFixedString
x réinterprétée. UInt128
Exemples
Exemple d’utilisation
Query
Response
reinterpretAsUInt16
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
x— Valeur à réinterpréter comme UInt16.(U)Int*ouFloat*ouDateouDateTimeouUUIDouStringouFixedString
x réinterprétée. UInt16
Exemples
Exemple d’utilisation
Query
Response
reinterpretAsUInt256
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
x— valeur à réinterpréter en UInt256.(U)Int*ouFloat*ouDateouDateTimeouUUIDouStringouFixedString
x réinterprétée. UInt256
Exemples
Exemple d’utilisation
Query
Response
reinterpretAsUInt32
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
x— Valeur à réinterpréter sous forme de UInt32.(U)Int*ouFloat*ouDateouDateTimeouUUIDouStringouFixedString
x réinterprétée. UInt32
Exemples
Exemple d’utilisation
Query
Response
reinterpretAsUInt64
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
x— Valeur à réinterpréter en UInt64.Int*ouUInt*ouFloat*ouDateouDateTimeouUUIDouStringouFixedString
x réinterprétée. UInt64
Exemples
Exemple d’utilisation
Query
Response
reinterpretAsUInt8
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
x— Valeur à réinterpréter en UInt8.(U)Int*ouFloat*ouDateouDateTimeouUUIDouStringouFixedString
x réinterprétée. UInt8
Exemples
Exemple d’utilisation
Query
Response
reinterpretAsUUID
fixed_string— Chaîne d’octets au format big-endian.FixedString
UUID
Exemples
Chaîne en UUID
Query
Response
toBFloat16
expr— Expression qui renvoie un nombre ou sa représentation sous forme de chaîne.Expression
BFloat16
Exemples
Exemple d’utilisation
Query
Response
toBFloat16OrNull
- Représentations sous forme de chaîne de valeurs numériques.
NULL) :
- Représentations sous forme de chaîne de valeurs binaires et hexadécimales.
- Valeurs numériques.
La fonction autorise une perte de précision silencieuse lors de la conversion depuis la représentation sous forme de chaîne.
x— Représentation sous forme de chaîne d’un nombre.String
NULL. BFloat16 ou NULL
Exemples
Exemple d’utilisation
Query
Response
toBFloat16OrZero
- Représentations String de valeurs numériques.
0) :
- Représentations String de valeurs binaires et hexadécimales.
- Valeurs numériques.
La fonction autorise une perte de précision silencieuse lors de la conversion depuis une représentation String.
x— Représentation sous forme de chaîne d’un nombre.String
0. BFloat16
Exemples
Exemple d’utilisation
Query
Response
toBool
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*ouFloat*ouStringouExpression
true ou false en fonction de l’évaluation de l’argument. Bool
Exemples
Exemple d’utilisation
Query
Response
toDate
Date.
Prend en charge la conversion à partir de String, FixedString, DateTime ou de types numériques.
Syntaxe
x— Valeur d’entrée à convertir.StringouFixedStringouDateTimeou(U)Int*ouFloat*
Date
Exemples
Conversion de String en Date
Query
Response
Query
Response
Query
Response
toDate32
toDate32 renvoie les valeurs limites prises en charge par Date32.
Si l’argument est de type Date, ses limites sont prises en compte.
Syntaxe
Date32
Exemples
Dans la plage
Query
Response
Query
Response
toDate32OrDefault
toDate32OrDefault renvoie la valeur de borne inférieure prise en charge par Date32. Si l’argument est de type Date, ses bornes sont prises en compte. Renvoie la valeur par défaut si un argument invalide est fourni.
Syntaxe
expr— Expression qui renvoie un nombre ou la représentation textuelle d’un nombre.Stringou(U)Int*ouFloat*default— Facultatif. Valeur par défaut à renvoyer si l’analyse échoue.Date32
Date32
Exemples
Conversion réussie
Query
Response
Query
Response
toDate32OrNull
NULL si un argument invalide est fourni.
Identique à toDate32, mais renvoie NULL si un argument invalide est fourni.
Syntaxe
x— Une représentation sous forme de chaîne d’une date.String
NULL. Date32 ou NULL
Exemples
Exemple d’utilisation
Query
Response
toDate32OrZero
x— Une représentation textuelle d’une date.String
Date32 en cas de réussite ; sinon, la borne inférieure de Date32 (1900-01-01). Date32
Exemples
Exemple d’utilisation
Query
Response
toDateOrDefault
expr— Expression renvoyant un nombre ou une représentation textuelle d’un nombre.Stringou(U)Int*ouFloat*default— Facultatif. Valeur par défaut à renvoyer si l’analyse échoue.Date
Date
Exemples
Conversion réussie
Query
Response
Query
Response
toDateOrNull
Date, mais renvoie NULL si un argument invalide est fourni.
Identique à toDate, mais renvoie NULL si un argument invalide est fourni.
Syntaxe
x— Une date sous forme de chaîne de caractères.String
Date en cas de succès, sinon NULL. Date ou NULL
Exemples
Exemple d’utilisation
Query
Response
toDateOrZero
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 :
Syntaxe
x— Une représentation sous forme de chaîne de caractères d’une date.String
1970-01-01). Date
Exemples
Exemple d’utilisation
Query
Response
toDateTime
Si
expr est un nombre, il est interprété comme le nombre de secondes écoulées depuis le début de l’époque Unix (c’est-à-dire comme un timestamp Unix).
Si expr est une String, elle peut être interprétée soit comme un timestamp Unix, soit comme la représentation sous forme de chaîne d’une date / date avec heure.
Par conséquent, l’analyse des représentations sous forme de chaîne de nombres courts (jusqu’à 4 chiffres) est explicitement désactivée en raison de cette ambiguïté. Par exemple, la chaîne '1999' peut représenter soit une année (une représentation sous forme de chaîne incomplète de Date / DateTime), soit un timestamp Unix. Les chaînes numériques plus longues sont autorisées.DateTime
Exemples
Exemple d’utilisation
Query
Response
toDateTime32
DateTime.
Prend en charge la conversion depuis String, FixedString, Date, Date32, DateTime ou des types numériques ((U)Int*, Float*, Decimal).
DateTime32 offre une plage étendue par rapport à DateTime et prend en charge des dates allant de 1900-01-01 à 2299-12-31.
Syntaxe
x— Valeur d’entrée à convertir.StringouFixedStringouUInt*ouFloat*ouDateouDateTimeouDateTime64timezone— Facultatif. Fuseau horaire de la valeurDateTimerenvoyée.String
DateTime
Exemples
La valeur est comprise dans la plage
Query
Response
Query
Response
Query
Response
toDateTime64
DateTime64.
Syntaxe
expr— Expression renvoyant un nombre ou une représentation sous forme de chaîne d’un nombre.Expressionscale— Taille du tick (précision) : 10^(-scale) secondes.UInt8timezone— Facultatif. Fuseau horaire de l’objetDateTime64spécifié.String
DateTime64
Exemples
La valeur se situe dans la plage
Query
Response
Query
Response
Query
Response
toDateTime64OrDefault
expr— Expression renvoyant un nombre ou la représentation sous forme de chaîne d’un nombre.Stringou(U)Int*ouFloat*scale— Taille du tick (précision) : 10^-precision secondes.UInt8timezone— Facultatif. Fuseau horaire.Stringdefault— Facultatif. La valeur par défaut à renvoyer si l’analyse échoue.DateTime64
DateTime64
Exemples
Conversion réussie
Query
Response
Query
Response
toDateTime64OrNull
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.
Syntaxe
x— Une représentation sous forme de chaîne d’une date et heure avec une précision sous-seconde.String
DateTime64 en cas de succès, sinon NULL. DateTime64 ou NULL
Exemples
Exemple d’utilisation
Query
Response
toDateTime64OrZero
x— Une représentation sous forme de chaîne d’une date et heure avec une précision sous-seconde.String
1970-01-01 00:00:00.000). DateTime64
Exemples
Exemple d’utilisation
Query
Response
toDateTimeOrDefault
expr— Expression renvoyant un nombre ou la représentation sous forme de chaîne d’un nombre.Stringou(U)Int*ouFloat*timezone— Facultatif. Fuseau horaire.Stringdefault— Facultatif. La valeur par défaut à renvoyer si l’analyse échoue.DateTime
DateTime
Exemples
Conversion réussie
Query
Response
Query
Response
toDateTimeOrNull
DateTime, mais renvoie NULL si l’argument n’est pas valide.
Identique à toDateTime, mais renvoie NULL si l’argument n’est pas valide.
Syntaxe
x— Une représentation sous forme de chaîne d’une date et d’une heure.String
DateTime en cas de réussite, sinon NULL. DateTime ou NULL
Exemples
Exemple d’utilisation
Query
Response
toDateTimeOrZero
x— Une représentation sous forme de chaîne d’une date et heure.String
1970-01-01 00:00:00). DateTime
Exemples
Exemple d’utilisation
Query
Response
toDecimal128
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*.
- Valeurs Float*
NaNetInf, 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);.
Un dépassement de capacité peut se produire si la valeur de
expr dépasse les bornes de Decimal128 :(-1*10^(38 - S), 1*10^(38 - S)).
Les chiffres excédentaires de la partie fractionnaire sont ignorés (sans arrondi).
Les chiffres excédentaires de la partie entière entraîneront une exception.expr— Expression renvoyant un nombre ou sa représentation sous forme de chaîne.ExpressionS— 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
Decimal(38, S) Decimal128(S)
Exemples
Exemple d’utilisation
Query
Response
toDecimal128OrDefault
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
expr— Représentation sous forme de chaîne d’un nombre.StringS— 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.UInt8default— Facultatif. Valeur par défaut à renvoyer si la conversion en type Decimal128(S) échoue.Decimal128(S)
Decimal128(S)
Exemples
Conversion réussie
Query
Response
Query
Response
toDecimal128OrNull
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*.
NULL) :
- Valeurs Float*
NaNetInf, 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)).
expr— Expression renvoyant un nombre ou une représentation sous forme de chaîne d’un nombre.ExpressionS— Paramètre d’échelle compris entre 0 et 38, indiquant le nombre de chiffres que la partie fractionnaire d’un nombre peut comporter.UInt8
NULL. Decimal128(S) ou NULL
Exemples
Exemple d’utilisation
Query
Response
toDecimal128OrZero
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*.
0) :
- Valeurs ou représentations sous forme de chaîne des valeurs Float*
NaNetInf(insensible à la casse). - Représentations sous forme de chaîne de valeurs binaires et hexadécimales.
Si la valeur d’entrée dépasse les limites de
Decimal128 :(-1*10^(38 - S), 1*10^(38 - S)), la fonction renvoie 0.expr— Expression renvoyant un nombre ou la représentation sous forme de chaîne d’un nombre.ExpressionS— Paramètre d’échelle compris entre 0 et 38, indiquant le nombre de chiffres que la partie fractionnaire d’un nombre peut comporter.UInt8
0. Decimal128(S)
Exemples
Utilisation de base
Query
Response
toDecimal256
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*.
- Valeurs ou représentations sous forme de chaîne de valeurs Float*
NaNetInf(insensible à la casse). - Représentations sous forme de chaîne de valeurs en binaire et en hexadécimal, par exemple
SELECT toDecimal256('0xc0fe', 1);.
Un dépassement de capacité peut se produire si la valeur de
expr dépasse les bornes de Decimal256 : (-1*10^(76 - S), 1*10^(76 - S)).
Les chiffres en trop dans la partie fractionnaire sont ignorés (sans arrondi).
Les chiffres en trop dans la partie entière entraîneront une exception.expr— Expression renvoyant un nombre ou la représentation sous forme de chaîne d’un nombre.ExpressionS— Paramètre d’échelle compris entre 0 et 76, indiquant le nombre de chiffres que la partie fractionnaire d’un nombre peut comporter.UInt8
Decimal(76, S). Decimal256(S)
Exemples
Exemple d’utilisation
Query
Response
toDecimal256OrDefault
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
expr— Une représentation sous forme de chaîne d’un nombre.StringS— Paramètre d’échelle compris entre 0 et 76, qui indique le nombre de chiffres que la partie fractionnaire d’un nombre peut contenir.UInt8default— Facultatif. Valeur par défaut à renvoyer si la conversion vers le type Decimal256(S) échoue.Decimal256(S)
Decimal256(S)
Exemples
Conversion réussie
Query
Response
Query
Response
toDecimal256OrNull
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*.
NULL) :
- Valeurs ou représentations sous forme de chaîne des valeurs Float*
NaNetInf(insensible à la casse). - Représentations sous forme de chaîne de valeurs en binaire et en hexadécimal.
- Valeurs qui dépassent les limites de
Decimal256:(-1 * 10^(76 - S), 1 * 10^(76 - S)).
expr— Expression renvoyant un nombre ou sa représentation sous forme de chaîne.ExpressionS— Paramètre d’échelle compris entre 0 et 76, indiquant le nombre de chiffres que peut contenir la partie fractionnaire d’un nombre.UInt8
NULL. Decimal256(S) ou NULL
Exemples
Exemple d’utilisation
Query
Response
toDecimal256OrZero
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*.
0) :
- Valeurs ou représentations sous forme de chaîne de caractères de valeurs Float*
NaNetInf(insensible à la casse). - Représentations sous forme de chaîne de valeurs binaires et hexadécimales.
Si la valeur d’entrée dépasse les limites de
Decimal256 : (-1*10^(76 - S), 1*10^(76 - S)), la fonction renvoie 0.expr— Expression renvoyant un nombre ou la représentation sous forme de chaîne d’un nombre.ExpressionS— Paramètre d’échelle compris entre 0 et 76, indiquant combien de chiffres peut comporter la partie fractionnaire d’un nombre.UInt8
0. Decimal256(S)
Exemples
Exemple d’utilisation
Query
Response
toDecimal32
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*.
- Valeurs ou représentations sous forme de chaîne des valeurs Float*
NaNetInf(insensible à la casse). - Représentations sous forme de chaîne de valeurs binaires et hexadécimales, par ex.
SELECT toDecimal32('0xc0fe', 1);.
Un dépassement de capacité peut se produire si la valeur de
expr dépasse les limites de Decimal32 :(-1*10^(9 - S), 1*10^(9 - S)).
Les chiffres en trop dans la partie fractionnaire sont supprimés (sans arrondi).
Les chiffres en trop dans la partie entière entraînent une exception.expr— Expression renvoyant un nombre ou une représentation d’un nombre sous forme de chaîne.ExpressionS— Paramètre d’échelle compris entre 0 et 9, indiquant le nombre de chiffres que peut comporter la partie fractionnaire d’un nombre.UInt8
Decimal(9, S) Decimal32(S)
Exemples
Exemple d’utilisation
Query
Response
toDecimal32OrDefault
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
expr— Une représentation sous forme de chaîne d’un nombre.StringS— 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.UInt8default— Facultatif. La valeur par défaut à renvoyer si la conversion en type Decimal32(S) échoue.Decimal32(S)
Decimal32(S)
Exemples
Conversion réussie
Query
Response
Query
Response
toDecimal32OrNull
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*.
NULL) :
- Valeurs ou représentations sous forme de chaîne des valeurs Float*
NaNetInf(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)).
expr— Expression renvoyant un nombre ou une représentation sous forme de chaîne d’un nombre.ExpressionS— Paramètre d’échelle compris entre 0 et 9, indiquant le nombre de chiffres que peut comporter la partie fractionnaire d’un nombre.UInt8
NULL. Decimal32(S) ou NULL
Exemples
Exemple d’utilisation
Query
Response
toDecimal32OrZero
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*.
0) :
- Valeurs Float*
NaNetInf, 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.
Si la valeur d’entrée dépasse les limites de
Decimal32 :(-1*10^(9 - S), 1*10^(9 - S)), la fonction renvoie 0.expr— Expression renvoyant un nombre ou sa représentation sous forme de chaîne.ExpressionS— Paramètre d’échelle compris entre 0 et 9, indiquant le nombre de chiffres que peut comporter la partie fractionnaire d’un nombre.UInt8
0. Decimal32(S)
Exemples
Exemple d’utilisation
Query
Response
toDecimal64
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*.
- Valeurs ou représentations sous forme de chaîne des valeurs Float*
NaNetInf(insensible à la casse). - Représentations sous forme de chaîne de valeurs binaires ou hexadécimales, par ex.
SELECT toDecimal64('0xc0fe', 1);.
Un dépassement peut se produire si la valeur de
expr dépasse les limites de Decimal64 :(-1*10^(18 - S), 1*10^(18 - S)).
Les chiffres en trop dans la partie fractionnaire sont ignorés (sans arrondi).
Les chiffres en trop dans la partie entière entraînent une exception.expr— Expression renvoyant un nombre ou la représentation sous forme de chaîne d’un nombre.ExpressionS— Paramètre d’échelle compris entre 0 et 18, indiquant le nombre de chiffres que peut comporter la partie fractionnaire d’un nombre.UInt8
Decimal(18, S)
Exemples
Exemple d’utilisation
Query
Response
toDecimal64OrDefault
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
expr— Une représentation d’un nombre sous forme de chaîne.StringS— Paramètre d’échelle compris entre 0 et 18, indiquant le nombre de chiffres que peut contenir la partie fractionnaire d’un nombre.UInt8default— Facultatif. Valeur par défaut à renvoyer si la conversion vers le type Decimal64(S) échoue.Decimal64(S)
Decimal64(S)
Exemples
Conversion réussie
Query
Response
Query
Response
toDecimal64OrNull
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*.
NULL) :
- Valeurs ou représentations sous forme de chaîne des valeurs Float*
NaNetInf(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)).
expr— Expression renvoyant un nombre ou une représentation sous forme de chaîne d’un nombre.ExpressionS— Paramètre d’échelle compris entre 0 et 18, indiquant le nombre de chiffres que peut comporter la partie fractionnaire d’un nombre.UInt8
NULL. Decimal64(S) ou NULL
Exemples
Exemple d’utilisation
Query
Response
toDecimal64OrZero
0 en cas d’erreur.
Comme toDecimal64, mais renvoie 0 au lieu de générer 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*.
0) :
- Valeurs ou représentations sous forme de chaîne des valeurs Float*
NaNetInf(insensible à la casse). - Représentations sous forme de chaîne de valeurs binaires et hexadécimales.
Si la valeur d’entrée dépasse les limites de
Decimal64 : (-1*10^(18 - S), 1*10^(18 - S)), la fonction renvoie 0.expr— Expression renvoyant un nombre ou la représentation sous forme de chaîne d’un nombre.ExpressionS— Paramètre d’échelle compris entre 0 et 18, indiquant le nombre de chiffres que peut contenir la partie fractionnaire d’un nombre.UInt8
0. Decimal64(S)
Exemples
Exemple d’utilisation
Query
Response
toDecimalString
number— Valeur numérique à convertir en chaîne. Peut être de n’importe quel type numérique (Int, UInt, Float, Decimal).Int8ouInt16ouInt32ouInt64ouUInt8ouUInt16ouUInt32ouUInt64ouFloat32ouFloat64ouDecimalscale— Le nombre de chiffres à afficher après la virgule. Le résultat sera arrondi si nécessaire.UInt8
String
Exemples
Arrondir et formater un nombre
Query
Response
Query
Response
Query
Response
toFixedString
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
s— Chaîne à convertir.StringN— Longueur de laFixedStringobtenue.const UInt*
FixedString de longueur N. FixedString(N)
Exemples
Exemple d’utilisation
Query
Response
toFloat32
- 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
NaNetInf. - Représentations sous forme de chaîne de Float*, y compris
NaNetInf(insensibles à la casse).
- Représentations sous forme de chaîne de valeurs binaires et hexadécimales, par exemple
SELECT toFloat32('0xc0fe');.
expr— Expression renvoyant un nombre ou la représentation sous forme de chaîne d’un nombre.Expression
Float32
Exemples
Exemple d’utilisation
Query
Response
toFloat32OrDefault
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
expr— Expression qui renvoie un nombre ou la représentation sous forme de chaîne d’un nombre.Stringou(U)Int*ouFloat*default— Facultatif. La valeur par défaut à renvoyer si l’interprétation échoue.Float32
Float32
Exemples
Conversion réussie
Query
Response
Query
Response
toFloat32OrNull
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
NaNetInf. - Représentations sous forme de chaîne de Float*, y compris
NaNetInf(insensibles à la casse).
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.
x— Une représentation sous forme de chaîne d’un nombre.String
Float32 en cas de réussite, sinon NULL. Float32 ou NULL
Exemples
Exemple d’utilisation
Query
Response
toFloat32OrZero
0 en cas d’erreur.
Comme toFloat32, mais renvoie 0 au lieu de lever une exception en cas d’erreur de conversion.
Voir aussi :
Syntaxe
x— Une représentation sous forme de chaîne d’un nombre.String
Float32 en cas de succès, sinon 0. Float32
Exemples
Exemple d’utilisation
Query
Response
toFloat64
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
NaNetInf. - Représentations sous forme de chaîne de type Float*, y compris
NaNetInf(insensible à la casse).
- Représentations sous forme de chaîne de valeurs binaires et hexadécimales, par exemple
SELECT toFloat64('0xc0fe');.
expr— Expression renvoyant un nombre ou la représentation sous forme de chaîne d’un nombre.Expression
Float64
Exemples
Exemple d’utilisation
Query
Response
toFloat64OrDefault
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
expr— Expression renvoyant un nombre ou une représentation sous forme de chaîne d’un nombre.Stringou(U)Int*ouFloat*default— Facultatif. La valeur par défaut à renvoyer si l’analyse échoue.Float64
Float64
Exemples
Conversion réussie
Query
Response
Query
Response
toFloat64OrNull
NULL en cas d’erreur.
Comme toFloat64, 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
NaNetInf. - Représentations sous forme de chaîne du type Float*, y compris
NaNetInf(insensible à la casse).
NULL) :
- Représentations sous forme de chaîne de valeurs binaires et hexadécimales, par ex.
SELECT toFloat64OrNull('0xc0fe');. - Formats de chaîne non valides.
x— La représentation sous forme de chaîne d’un nombre.String
Float64 en cas de réussite, sinon NULL. Float64 ou NULL
Exemples
Exemple d’utilisation
Query
Response
toFloat64OrZero
0 en cas d’erreur.
Comme toFloat64, mais renvoie 0 au lieu de lever une exception en cas d’erreur de conversion.
Voir aussi :
Syntaxe
x— Une représentation sous forme de chaîne d’un nombre.String
Float64 en cas de réussite, sinon 0. Float64
Exemples
Exemple d’utilisation
Query
Response
toInt128
- Valeurs ou représentations sous forme de chaîne de type (U)Int*.
- Valeurs de type Float*.
- Représentations sous forme de chaîne de valeurs de type Float*, y compris
NaNetInf. - Représentations sous forme de chaîne de valeurs binaires et hexadécimales, par ex.
SELECT toInt128('0xc0fe');.
Si la valeur d’entrée ne peut pas être représentée dans les limites de Int128, le résultat déborde par excès ou par défaut.
Cela n’est pas considéré comme une erreur.
expr— Expression renvoyant un nombre ou une représentation sous forme de chaîne d’un nombre.Expression
Int128
Exemples
Exemple d’utilisation
Query
Response
toInt128OrDefault
toInt128, cette fonction convertit une valeur d’entrée en une valeur de type Int128, 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
expr— Expression renvoyant un nombre ou la représentation sous forme de chaîne d’un nombre.Stringou(U)Int*ouFloat*default— Facultatif. La valeur par défaut à renvoyer si l’analyse échoue.Int128
Int128
Exemples
Conversion réussie
Query
Response
Query
Response
toInt128OrNull
toInt128, cette fonction convertit une valeur d’entrée en une valeur de type Int128, mais renvoie NULL en cas d’erreur.
Arguments pris en charge :
- Représentations sous forme de chaîne de (U)Int*.
NULL) :
- Représentations sous forme de chaîne de valeurs Float*, y compris
NaNetInf. - Représentations sous forme de chaîne de valeurs binaires et hexadécimales, par exemple
SELECT toInt128OrNull('0xc0fe');.
Si la valeur d’entrée ne peut pas être représentée dans les limites de Int128, un dépassement de capacité du résultat se produit, par valeur supérieure ou inférieure.
Cela n’est pas considéré comme une erreur.
x— Représentation d’un nombre sous forme de chaîne de caractères.String
NULL si la conversion échoue. Int128 ou NULL
Exemples
Exemple d’utilisation
Query
Response
toInt128OrZero
0 en cas d’erreur.
Comme toInt128, mais renvoie 0 au lieu de lever une exception.
Voir aussi :
Syntaxe
x— Valeur d’entrée à convertir.StringouFixedStringouFloat*ouDecimalou(U)Int*ouDateouDateTime
0 si la conversion échoue. Int128
Exemples
Exemple d’utilisation
Query
Response
Query
Response
toInt16
Int16.
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 de type Float*.
- Représentations sous forme de chaîne de valeurs Float*, y compris
NaNetInf. - Représentations sous forme de chaîne de valeurs binaires et hexadécimales, par exemple
SELECT toInt16('0xc0fe');.
Si la valeur d’entrée ne peut pas être représentée dans les bornes de Int16, un dépassement inférieur ou supérieur se produit dans le résultat.
Cela n’est pas considéré comme une erreur.
Par exemple :
SELECT toInt16(32768) == -32768;.La fonction utilise l’arrondi vers zéro, c’est-à-dire qu’elle tronque les chiffres après la virgule.
expr— Expression renvoyant un nombre ou une représentation sous forme de chaîne d’un nombre.Expression
Int16
Exemples
Exemple d’utilisation
Query
Response
toInt16OrDefault
toInt16, cette fonction convertit une valeur d’entrée en valeur de type Int16, 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
expr— Expression renvoyant un nombre ou la représentation sous forme de chaîne d’un nombre.Stringou(U)Int*ouFloat*default— Facultatif. Valeur par défaut à renvoyer si l’analyse échoue.Int16
Int16
Exemples
Conversion réussie
Query
Response
Query
Response
toInt16OrNull
toInt16, cette fonction convertit une valeur d’entrée en une valeur de type Int16, mais renvoie NULL en cas d’erreur.
Arguments pris en charge :
- Représentations sous forme de chaînes de caractères de (U)Int*.
NULL) :
- Représentations sous forme de chaînes de caractères de valeurs Float*, y compris
NaNetInf. - Représentations sous forme de chaînes de caractères de valeurs binaires et hexadécimales, par exemple
SELECT toInt16OrNull('0xc0fe');.
Si la valeur d’entrée ne peut pas être représentée dans les limites de Int16, un dépassement de capacité ou sous-dépassement du résultat se produit.
Cela n’est pas considéré comme une erreur.
x— Une représentation sous forme de chaîne d’un nombre.String
Int16, ou NULL si la conversion échoue. Int16 ou NULL
Exemples
Exemple d’utilisation
Query
Response
toInt16OrZero
toInt16, cette fonction convertit une valeur d’entrée en une valeur de type Int16, mais renvoie 0 en cas d’erreur.
Arguments pris en charge :
- représentation sous forme de chaîne de caractères de (U)Int*.
0) :
- représentation sous forme de chaîne de caractères de valeurs Float*, y compris
NaNetInf. - représentation sous forme de chaîne de caractères de valeurs binaires et hexadécimales, par exemple
SELECT toInt16OrZero('0xc0fe');.
Si la valeur d’entrée ne peut pas être représentée dans les limites de Int16, le résultat subit un dépassement de capacité ou sous-dépassement.
Cela n’est pas considéré comme une erreur.
x— Une représentation sous forme de chaîne d’un nombre.String
0 si la conversion échoue. Int16
Exemples
Exemple d’utilisation
Query
Response
toInt256
- Valeurs ou représentations sous forme de chaîne de type (U)Int*.
- Valeurs de type Float*.
- Représentations sous forme de chaîne de valeurs Float*, y compris
NaNetInf. - Représentations sous forme de chaîne de valeurs binaires et hexadécimales, par ex.
SELECT toInt256('0xc0fe');.
Si la valeur d’entrée ne peut pas être représentée dans les limites d’Int256, le résultat déborde.
Cela n’est pas considéré comme une erreur.
expr— Expression renvoyant un nombre ou la représentation sous forme de chaîne d’un nombre.Expression
Int256
Exemples
Exemple d’utilisation
Query
Response
toInt256OrDefault
toInt256, cette fonction convertit une valeur d’entrée en valeur de type Int256, 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
expr— Expression renvoyant un nombre ou une représentation sous forme de chaîne d’un nombre.Stringou(U)Int*ouFloat*default— Facultatif. Valeur par défaut à renvoyer si l’analyse échoue.Int256
Int256
Exemples
Conversion réussie
Query
Response
Query
Response
toInt256OrNull
toInt256, cette fonction convertit une valeur d’entrée en une valeur de type Int256, mais renvoie NULL en cas d’erreur.
Arguments pris en charge :
- Représentations sous forme de chaîne de caractères de (U)Int*.
NULL) :
- Représentations sous forme de chaîne de caractères de valeurs Float*, y compris
NaNetInf. - Représentations sous forme de chaîne de caractères de valeurs binaires et hexadécimales, par exemple
SELECT toInt256OrNull('0xc0fe');.
Si la valeur d’entrée ne peut pas être représentée dans les limites de Int256, un dépassement de capacité ou un sous-dépassement du résultat se produit.
Cela n’est pas considéré comme une erreur.
x— Une représentation sous forme de chaîne d’un nombre.String
NULL si la conversion échoue. Int256 ou NULL
Exemples
Exemple d’utilisation
Query
Response
toInt256OrZero
0 en cas d’erreur.
Comme toInt256, mais renvoie 0 au lieu de lever une exception.
Voir aussi :
Syntaxe
x— Valeur d’entrée à convertir.StringouFixedStringouFloat*ouDecimalou(U)Int*ouDateouDateTime
0 si la conversion échoue. Int256
Exemples
Exemple d’utilisation
Query
Response
Query
Response
toInt32
Int32.
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 de type Float*.
- Représentations sous forme de chaîne de valeurs Float*, y compris
NaNetInf. - Représentations sous forme de chaîne de valeurs binaires et hexadécimales, par exemple
SELECT toInt32('0xc0fe');.
Si la valeur d’entrée ne peut pas être représentée dans les limites de Int32, le résultat déborde, par excès ou par défaut.
Cela n’est pas considéré comme une erreur.
Par exemple :
SELECT toInt32(2147483648) == -2147483648;La fonction utilise l’arrondi vers zéro, ce qui signifie qu’elle tronque la partie fractionnaire des nombres.
expr— Expression renvoyant un nombre ou la représentation sous forme de chaîne d’un nombre.Expression
Int32
Exemples
Exemple d’utilisation
Query
Response
toInt32OrDefault
toInt32, cette fonction convertit une valeur d’entrée en valeur de type Int32, 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
expr— Expression renvoyant un nombre ou la représentation sous forme de chaîne d’un nombre.Stringou(U)Int*ouFloat*default— Facultatif. Valeur par défaut à renvoyer si l’analyse échoue.Int32
Int32
Exemples
Conversion réussie
Query
Response
Query
Response
toInt32OrNull
toInt32, cette fonction convertit une valeur d’entrée en une valeur de type Int32, mais renvoie NULL en cas d’erreur.
Arguments pris en charge :
- représentation sous forme de chaîne de caractères de (U)Int*.
NULL) :
- représentation sous forme de chaîne de caractères de valeurs Float*, y compris
NaNetInf. - représentation sous forme de chaîne de caractères de valeurs binaires et hexadécimales, par exemple
SELECT toInt32OrNull('0xc0fe');.
Si la valeur d’entrée ne peut pas être représentée dans les limites de Int32, un dépassement de capacité du résultat, par excès ou par défaut, se produit.
Cela n’est pas considéré comme une erreur.
x— Une représentation sous forme de chaîne d’un nombre.String
NULL si la conversion échoue. Int32 ou NULL
Exemples
Exemple d’utilisation
Query
Response
toInt32OrZero
toInt32, cette fonction convertit une valeur en entrée en une valeur de type Int32, mais renvoie 0 en cas d’erreur.
Arguments pris en charge :
- Représentations sous forme de chaîne de caractères de (U)Int*.
0) :
- Représentations sous forme de chaîne de caractères de valeurs Float*, y compris
NaNetInf. - Représentations sous forme de chaîne de caractères de valeurs binaires et hexadécimales, par exemple
SELECT toInt32OrZero('0xc0fe');.
Si la valeur en entrée ne peut pas être représentée dans les limites de Int32, un dépassement de capacité du résultat, par excès ou par défaut, se produit.
Cela n’est pas considéré comme une erreur.
x— Une représentation sous forme de chaîne de caractères d’un nombre.String
0 si la conversion échoue. Int32
Exemples
Exemple d’utilisation
Query
Response
toInt64
Int64.
Lève une exception en cas d’erreur.
Arguments pris en charge :
- Valeurs ou représentation sous forme de chaîne de caractères de type (U)Int*.
- Valeurs de type Float*.
- représentation sous forme de chaîne de caractères de valeurs Float*, y compris
NaNetInf. - représentation sous forme de chaîne de caractères de valeurs binaires et hexadécimales, par exemple
SELECT toInt64('0xc0fe');.
Si la valeur d’entrée ne peut pas être représentée dans les limites de Int64, le résultat déborde.
Cela n’est pas considéré comme une erreur.
Par exemple :
SELECT toInt64(9223372036854775808) == -9223372036854775808;La fonction utilise l’arrondi vers zéro, ce qui signifie qu’elle tronque la partie fractionnaire des nombres.
expr— Expression renvoyant un nombre ou une représentation sous forme de chaîne d’un nombre. Pris en charge : valeurs ou représentation sous forme de chaîne de caractères de type (U)Int*, valeurs de type Float*. Non pris en charge : représentation sous forme de chaîne de caractères de valeurs Float*, y compris NaN et Inf, représentation sous forme de chaîne de caractères de valeurs binaires et hexadécimales.Expression
Int64
Exemples
Exemple d’utilisation
Query
Response
toInt64OrDefault
toInt64, cette fonction convertit une valeur d’entrée en une valeur de type Int64, 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
expr— Expression renvoyant un nombre ou la représentation sous forme de chaîne d’un nombre.Stringou(U)Int*ouFloat*default— Facultatif. La valeur par défaut à renvoyer si l’analyse échoue.Int64
Int64
Exemples
Conversion réussie
Query
Response
Query
Response
toInt64OrNull
toInt64, cette fonction convertit une valeur d’entrée en une valeur de type Int64, mais renvoie NULL en cas d’erreur.
Arguments pris en charge :
- Représentations sous forme de chaîne de (U)Int*.
NULL) :
- Représentations sous forme de chaîne de valeurs Float*, y compris
NaNetInf. - Représentations sous forme de chaîne de valeurs binaires et hexadécimales, par exemple
SELECT toInt64OrNull('0xc0fe');.
Si la valeur d’entrée ne peut pas être représentée dans les limites de Int64, un dépassement de capacité ou sous-dépassement du résultat se produit.
Cela n’est pas considéré comme une erreur.
x— La représentation sous forme de chaîne d’un nombre.String
NULL si la conversion échoue. Int64 ou NULL
Exemples
Exemple d’utilisation
Query
Response
toInt64OrZero
0 en cas d’erreur.
Comme toInt64, mais renvoie 0 au lieu de générer une exception.
Voir aussi :
Syntaxe
x— Valeur d’entrée à convertir.StringouFixedStringouFloat*ouDecimalou(U)Int*ouDateouDateTime
0 si la conversion échoue. Int64
Exemples
Exemple d’utilisation
Query
Response
Query
Response
toInt8
Int8.
Déclenche une exception en cas d’erreur.
Arguments pris en charge :
- Valeurs ou représentations sous forme de chaîne de type (U)Int*.
- Valeurs de type Float*.
- Représentations sous forme de chaîne de valeurs Float*, y compris
NaNetInf. - Représentations sous forme de chaîne de valeurs binaires et hexadécimales, par ex.
SELECT toInt8('0xc0fe');.
Si la valeur d’entrée ne peut pas être représentée dans l’intervalle de Int8, le résultat subit un dépassement de capacité ou sous-dépassement.
Cela n’est pas considéré comme une erreur.
Par exemple :
SELECT toInt8(128) == -128;.La fonction utilise l’arrondi vers zéro, ce qui signifie qu’elle tronque la partie fractionnaire des nombres.
expr— Expression renvoyant un nombre ou la représentation sous forme de chaîne d’un nombre.Expression
Int8
Exemples
Exemple d’utilisation
Query
Response
toInt8OrDefault
toInt8, cette fonction convertit une valeur d’entrée en une valeur de type Int8, 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
expr— Expression qui renvoie un nombre ou la représentation sous forme de chaîne d’un nombre.Stringou(U)Int*ouFloat*default— Facultatif. Valeur par défaut à renvoyer si l’analyse échoue.Int8
Int8
Exemples
Conversion réussie
Query
Response
Query
Response
toInt8OrNull
toInt8, cette fonction convertit une valeur d’entrée en une valeur de type Int8, mais renvoie NULL en cas d’erreur.
Arguments pris en charge :
- Représentations sous forme de chaîne de (U)Int*.
NULL) :
- Représentations sous forme de chaîne de valeurs Float*, y compris
NaNetInf. - Représentations sous forme de chaîne de valeurs binaires et hexadécimales, par exemple
SELECT toInt8OrNull('0xc0fe');.
Si la valeur d’entrée ne peut pas être représentée dans les limites de Int8, il se produit un dépassement de capacité ou sous-dépassement.
Cela n’est pas considéré comme une erreur.
x— Une représentation sous forme de chaîne d’un nombre.String
NULL si la conversion échoue. Int8 ou NULL
Exemples
Exemple d’utilisation
Query
Response
toInt8OrZero
toInt8, cette fonction convertit une valeur d’entrée en une valeur de type Int8, mais renvoie 0 en cas d’erreur.
Arguments pris en charge :
- Représentations sous forme de chaîne de (U)Int*.
0) :
- Représentations sous forme de chaîne de valeurs Float*, y compris
NaNetInf. - Représentations sous forme de chaîne de valeurs binaires et hexadécimales, par exemple
SELECT toInt8OrZero('0xc0fe');.
Si la valeur d’entrée ne peut pas être représentée dans les limites de Int8, un dépassement de capacité ou sous-dépassement du résultat se produit.
Cela n’est pas considéré comme une erreur.
x— Une représentation sous forme de chaîne d’un nombre.String
0 si la conversion échoue. Int8
Exemples
Exemple d’utilisation
Query
Response
toInterval
toIntervalSecond, toIntervalMinute, toIntervalDay, etc.,
mais permet de spécifier l’unité dynamiquement sous forme de paramètre de chaîne.
Syntaxe
value— La valeur numérique représentant le nombre d’unités. Peut être de n’importe quel type numérique.Int8ouInt16ouInt32ouInt64ouUInt8ouUInt16ouUInt32ouUInt64ouFloat32ouFloat64unit— L’unité de temps. Doit être une chaîne constante. Valeurs valides : ‘nanosecond’, ‘microsecond’, ‘millisecond’, ‘second’, ‘minute’, ‘hour’, ‘day’, ‘week’, ‘month’, ‘quarter’, ‘year’.String
Interval
Exemples
Créer des intervalles avec des unités différentes
Query
Response
Query
Response
Query
Response
toIntervalDay
n jours, de type de données IntervalDay.
Syntaxe
n— Nombre de jours. Nombres entiers ou leur représentation sous forme de chaîne, ainsi que les nombres à virgule flottante.(U)Int*ouFloat*ouString
n jours. Interval
Exemples
Exemple d’utilisation
Query
Response
toIntervalHour
n heures, de type IntervalHour.
Syntaxe
n— Nombre d’heures. Nombres entiers ou leur représentation sous forme de chaîne, ainsi que nombres à virgule flottante.Int*orUInt*orFloat*orString
n heures. Interval
Exemples
Exemple d’utilisation
Query
Response
toIntervalMicrosecond
n microsecondes, de type de données IntervalMicrosecond.
Syntaxe
n microsecondes. Interval
Exemples
Exemple d’utilisation
Query
Response
toIntervalMillisecond
n millisecondes du type de données IntervalMillisecond.
Syntaxe
n millisecondes. Interval
Exemples
Exemple d’utilisation
Query
Response
toIntervalMinute
n minutes du type de données IntervalMinute.
Syntaxe
n— Nombre de minutes. Nombres entiers ou leurs représentations sous forme de chaînes, ainsi que nombres à virgule flottante.(U)Int*ouFloat*ouString
n minutes. Interval
Exemples
Exemple d’utilisation
Query
Response
toIntervalMonth
n mois, de type de données IntervalMonth.
Syntaxe
n mois. Interval
Exemples
Exemple d’utilisation
Query
Response
toIntervalNanosecond
n nanosecondes, de type de données IntervalNanosecond.
Syntaxe
n nanosecondes. Interval
Exemples
Exemple d’utilisation
Query
Response
toIntervalQuarter
n trimestres, de type de données IntervalQuarter.
Syntaxe
n trimestres. Interval
Exemples
Exemple d’utilisation
Query
Response
toIntervalSecond
n secondes du type de données IntervalSecond.
Syntaxe
n— Nombre de secondes. Nombres entiers ou leurs représentations sous forme de chaîne, ainsi que nombres à virgule flottante.(U)Int*ouFloat*ouString
n secondes. Interval
Exemples
Exemple d’utilisation
Query
Response
toIntervalWeek
n semaines de type de données IntervalWeek.
Syntaxe
n semaines. Interval
Exemples
Exemple d’utilisation
Query
Response
toIntervalYear
n ans de type de données IntervalYear.
Syntaxe
n ans. Interval
Exemples
Exemple d’utilisation
Query
Response
toLowCardinality
expr— Expression produisant l’un des types de données pris en charge.StringouFixedStringouDateouDateTimeou(U)Int*ouFloat*
LowCardinality. LowCardinality
Exemples
Exemple d’utilisation
Query
Response
toString
value— Valeur à convertir en chaîne de caractères.Anytimezone— Facultatif. Nom du fuseau horaire pour la conversion de DateTime.String
String
Exemples
Exemple d’utilisation
Query
Response
toStringCutToZero
s— String ou FixedString à traiter.StringouFixedString
String
Exemples
Exemple d’utilisation
Query
Response
toTime
x— Valeur d’entrée à convertir.StringouFixedStringouDateTimeou(U)Int*ouFloat*
Time
Exemples
Conversion de String en Time
Query
Response
Query
Response
Query
Response
toTime64
x— Valeur d’entrée à convertir.StringorFixedStringorDateTime64or(U)Int*orFloat*
Time64(6)
Exemples
Conversion de String en Time64
Query
Response
Query
Response
Query
Response
toTime64OrNull
Time64, mais renvoie NULL en cas d’erreur.
Comme toTime64, mais renvoie NULL au lieu de lever une exception en cas d’erreur de conversion.
Voir aussi :
Syntaxe
x— Une représentation sous forme de chaîne d’une heure avec une précision à la sous-seconde.String
Time64 en cas de succès, sinon NULL. Time64 ou NULL
Exemples
Exemple d’utilisation
Query
Response
toTime64OrZero
00:00:00.000 en cas d’erreur.
Comme toTime64, mais renvoie 00:00:00.000 au lieu de lever une exception lors d’une erreur de conversion.
Syntaxe
x— Une représentation sous forme de chaîne d’une heure avec une précision à la sous-seconde.String
Time64 en cas de réussite, sinon 00:00:00.000. Time64
Exemples
Exemple d’utilisation
Query
Response
toTimeOrNull
NULL en cas d’erreur.
Comme toTime, mais renvoie NULL au lieu de lever une exception en cas d’erreur de conversion.
Voir aussi :
Syntaxe
x— Représentation sous forme de chaîne d’une heure.String
Time en cas de succès, sinon NULL. Time ou NULL
Exemples
Exemple d’utilisation
Query
Response
toTimeOrZero
00:00:00 en cas d’erreur.
Comme toTime, mais renvoie 00:00:00 au lieu de générer une exception en cas d’erreur de conversion.
Syntaxe
x— Une représentation sous forme de chaîne d’une heure.String
Time en cas de réussite, sinon 00:00:00. Time
Exemples
Exemple d’utilisation
Query
Response
toUInt128
UInt128.
Lève une exception en cas d’erreur.
La fonction utilise l’arrondi vers zéro, c’est-à-dire qu’elle tronque les chiffres après la virgule.
Arguments pris en charge :
- Valeurs ou représentations sous forme de chaîne de type (U)Int*.
- Valeurs de type Float*.
- Représentations sous forme de chaîne de valeurs Float*, y compris
NaNetInf. - Représentations sous forme de chaîne de valeurs binaires et hexadécimales, par ex.
SELECT toUInt128('0xc0fe');.
Si la valeur d’entrée ne peut pas être représentée dans la plage de UInt128, le résultat produit un dépassement de capacité supérieur ou inférieur.
Cela n’est pas considéré comme une erreur.
expr— Expression renvoyant un nombre ou sa représentation sous forme de chaîne.Expression
UInt128
Exemples
Exemple d’utilisation
Query
Response
toUInt128OrDefault
toUInt128, cette fonction convertit une valeur d’entrée en une valeur de type UInt128, 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
expr— Expression renvoyant un nombre ou une représentation textuelle d’un nombre.Stringou(U)Int*ouFloat*default— Facultatif. Valeur par défaut à renvoyer si l’analyse échoue.UInt128
UInt128
Exemples
Conversion réussie
Query
Response
Query
Response
toUInt128OrNull
toUInt128, cette fonction convertit une valeur d’entrée en valeur de type UInt128, mais renvoie NULL en cas d’erreur.
Arguments pris en charge :
- Représentations sous forme de chaîne de (U)Int*.
NULL) :
- Représentations sous forme de chaîne de valeurs Float*, y compris
NaNetInf. - Représentations sous forme de chaîne de valeurs binaires et hexadécimales, par exemple
SELECT toUInt128OrNull('0xc0fe');.
Si la valeur d’entrée ne peut pas être représentée dans les limites de
UInt128, un dépassement de capacité (overflow ou underflow) du résultat se produit.
Cela n’est pas considéré comme une erreur.x— Une représentation sous forme de chaîne d’un nombre.String
NULL si la conversion échoue. UInt128 ou NULL
Exemples
Exemple d’utilisation
Query
Response
toUInt128OrZero
toUInt128, cette fonction convertit une valeur d’entrée en une valeur de type UInt128, mais renvoie 0 en cas d’erreur.
Arguments pris en charge :
- Représentations sous forme de chaîne de caractères de (U)Int*.
0) :
- Représentations sous forme de chaîne de caractères de valeurs Float*, y compris
NaNetInf. - Représentations sous forme de chaîne de caractères de valeurs binaires et hexadécimales, par exemple
SELECT toUInt128OrZero('0xc0fe');.
Si la valeur d’entrée ne peut pas être représentée dans les limites de
UInt128, un dépassement de capacité du résultat se produit.
Cela n’est pas considéré comme une erreur.x— Une représentation sous forme de chaîne de caractères d’un nombre.String
0 si la conversion échoue. UInt128
Exemples
Exemple d’utilisation
Query
Response
toUInt16
UInt16.
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 de type Float*.
- Représentations sous forme de chaîne de valeurs Float*, y compris
NaNetInf. - Représentations sous forme de chaîne de valeurs binaires et hexadécimales, par exemple
SELECT toUInt16('0xc0fe');.
Si la valeur d’entrée ne peut pas être représentée dans les limites de
UInt16, un dépassement de capacité inférieur ou supérieur se produit dans le résultat.
Cela n’est pas considéré comme une erreur.
Par exemple : SELECT toUInt16(65536) == 0;.La fonction utilise l’arrondi vers zéro, ce qui signifie qu’elle tronque les chiffres après la virgule.
expr— Expression renvoyant un nombre ou sa représentation sous forme de chaîne.Expression
UInt16
Exemples
Exemple d’utilisation
Query
Response
toUInt16OrDefault
toUInt16, cette fonction convertit une valeur d’entrée en une valeur de type UInt16, 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
expr— Expression renvoyant un nombre ou une représentation d’un nombre sous forme de chaîne.Stringou(U)Int*ouFloat*default— Facultatif. La valeur par défaut à renvoyer si l’analyse échoue.UInt16
UInt16
Exemples
Conversion réussie
Query
Response
Query
Response
toUInt16OrNull
toUInt16, cette fonction convertit une valeur d’entrée en une valeur de type UInt16, mais renvoie NULL en cas d’erreur.
Arguments pris en charge :
- Représentations sous forme de chaîne de (U)Int8/16/32/128/256.
NULL) :
- Représentations sous forme de chaîne de valeurs Float*, y compris
NaNetInf. - Représentations sous forme de chaîne de valeurs binaires et hexadécimales, par ex.
SELECT toUInt16OrNull('0xc0fe');.
Si la valeur d’entrée ne peut pas être représentée dans les limites de
UInt16, un dépassement de capacité (overflow ou underflow) se produit dans le résultat.
Cela n’est pas considéré comme une erreur.x— Représentation sous forme de chaîne d’un nombre.String
UInt16, ou NULL si la conversion échoue. UInt16 ou NULL
Exemples
Exemple d’utilisation
Query
Response
toUInt16OrZero
toUInt16, cette fonction convertit une valeur d’entrée en valeur de type UInt16, mais renvoie 0 en cas d’erreur.
Arguments pris en charge :
- Représentations sous forme de chaîne de (U)Int8/16/32/128/256.
0) :
- Représentations sous forme de chaîne de valeurs Float*, y compris
NaNetInf. - Représentations sous forme de chaîne de valeurs binaires et hexadécimales, par exemple
SELECT toUInt16OrZero('0xc0fe');.
Si la valeur d’entrée ne peut pas être représentée dans les limites de
UInt16, il se produit un dépassement de capacité par excès ou par défaut du résultat.
Cela n’est pas considéré comme une erreur.x— Une représentation sous forme de chaîne d’un nombre.String
0 si la conversion échoue. UInt16
Exemples
Exemple d’utilisation
Query
Response
toUInt256
- Valeurs ou représentations sous forme de chaîne de type (U)Int*.
- Valeurs de type Float*.
- Représentations sous forme de chaîne de valeurs de type Float*, y compris
NaNetInf. - Représentations sous forme de chaîne de valeurs binaires et hexadécimales, par exemple
SELECT toUInt256('0xc0fe');.
Si la valeur d’entrée ne peut pas être représentée dans les bornes de UInt256, le résultat déborde par excès ou par défaut.
Cela n’est pas considéré comme une erreur.
expr— Expression qui renvoie un nombre ou la représentation sous forme de chaîne d’un nombre.Expression
UInt256
Exemples
Exemple d’utilisation
Query
Response
toUInt256OrDefault
toUInt256, cette fonction convertit une valeur d’entrée en valeur de type UInt256, 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
expr— Expression renvoyant un nombre ou la représentation sous forme de chaîne d’un nombre.Stringou(U)Int*ouFloat*default— Facultatif. Valeur par défaut à renvoyer si l’analyse échoue.UInt256
UInt256
Exemples
Conversion réussie
Query
Response
Query
Response
toUInt256OrNull
toUInt256, cette fonction convertit une valeur d’entrée en une valeur de type UInt256, mais renvoie NULL en cas d’erreur.
Arguments pris en charge :
- Représentations sous forme de chaîne de (U)Int*.
NULL) :
- Représentations sous forme de chaîne de valeurs Float*, y compris
NaNetInf. - Représentations sous forme de chaîne de valeurs binaires et hexadécimales, par exemple
SELECT toUInt256OrNull('0xc0fe');.
Si la valeur d’entrée ne peut pas être représentée dans les limites de
UInt256, un dépassement de capacité par excès ou par défaut se produit.
Cela n’est pas considéré comme une erreur.x— Représentation sous forme de chaîne d’un nombre.String
NULL si la conversion échoue. UInt256 ou NULL
Exemples
Exemple d’utilisation
Query
Response
toUInt256OrZero
toUInt256, cette fonction convertit une valeur d’entrée en une valeur de type UInt256, mais renvoie 0 en cas d’erreur.
Arguments pris en charge :
- Représentations sous forme de chaîne de (U)Int*.
0) :
- Représentations sous forme de chaîne de valeurs Float*, y compris
NaNetInf. - Représentations sous forme de chaîne de valeurs binaires et hexadécimales, par exemple
SELECT toUInt256OrZero('0xc0fe');.
Si la valeur d’entrée ne peut pas être représentée dans les limites de
UInt256, un dépassement de capacité par excès ou par défaut se produit dans le résultat.
Cela n’est pas considéré comme une erreur.x— Représentation sous forme de chaîne d’un nombre.String
0 si la conversion échoue. UInt256
Exemples
Exemple d’utilisation
Query
Response
toUInt32
UInt32.
Lève une exception en cas d’erreur.
Arguments pris en charge :
- Les valeurs ou les représentations sous forme de chaîne de caractères du type (U)Int*.
- Les valeurs de type Float*.
- Les représentations sous forme de chaîne de caractères de valeurs Float*, y compris
NaNetInf. - Les représentations sous forme de chaîne de caractères de valeurs binaires et hexadécimales, par ex.
SELECT toUInt32('0xc0fe');.
Si la valeur d’entrée ne peut pas être représentée dans la plage de
UInt32, le résultat déborde ou sous-déborde.
Cela n’est pas considéré comme une erreur.
Par exemple : SELECT toUInt32(4294967296) == 0;La fonction utilise l’arrondi vers zéro, ce qui signifie qu’elle tronque la partie fractionnaire des nombres.
expr— Expression renvoyant un nombre ou la représentation textuelle d’un nombre.Expression
UInt32
Exemples
Exemple d’utilisation
Query
Response
toUInt32OrDefault
toUInt32, cette fonction convertit une valeur d’entrée en une valeur de type UInt32, 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
expr— expression renvoyant un nombre ou la représentation sous forme de chaîne d’un nombre.Stringou(U)Int*ouFloat*default— Facultatif. La valeur par défaut à renvoyer si l’analyse n’aboutit pas.UInt32
UInt32
Exemples
Conversion réussie
Query
Response
Query
Response
toUInt32OrNull
toUInt32, cette fonction convertit une valeur d’entrée en une valeur de type UInt32, mais renvoie NULL en cas d’erreur.
Arguments pris en charge :
- Représentations sous forme de chaîne de (U)Int8/16/32/128/256.
NULL) :
- Représentations sous forme de chaîne de valeurs Float*, y compris
NaNetInf. - Représentations sous forme de chaîne de valeurs binaires et hexadécimales, par ex.
SELECT toUInt32OrNull('0xc0fe');.
Si la valeur d’entrée ne peut pas être représentée dans les limites de
UInt32, un dépassement de capacité par excès ou par défaut du résultat se produit.
Cela n’est pas considéré comme une erreur.x— Une représentation sous forme de chaîne d’un nombre.String
UInt32 ; sinon, NULL si la conversion échoue. UInt32 ou NULL
Exemples
Exemple d’utilisation
Query
Response
toUInt32OrZero
toUInt32, cette fonction convertit une valeur d’entrée en une valeur de type UInt32, mais renvoie 0 en cas d’erreur.
Arguments pris en charge :
- Représentations sous forme de chaîne de (U)Int8/16/32/128/256.
0) :
- Représentations sous forme de chaîne de valeurs Float*, y compris
NaNetInf. - Représentations sous forme de chaîne de valeurs binaires et hexadécimales, par exemple
SELECT toUInt32OrZero('0xc0fe');.
Si la valeur d’entrée ne peut pas être représentée dans les limites de
UInt32, un dépassement de capacité par excès ou par défaut se produit.
Cela n’est pas considéré comme une erreur.x— Une représentation sous forme de chaîne d’un nombre.String
0 si la conversion échoue. UInt32
Exemples
Exemple d’utilisation
Query
Response
toUInt64
UInt64.
lever une exception en cas d’erreur.
Arguments pris en charge :
- Valeurs ou représentations sous forme de chaîne de type (U)Int*.
- Valeurs de type Float*.
- Représentations sous forme de chaîne de valeurs Float*, y compris
NaNetInf. - Représentations sous forme de chaîne de valeurs binaires et hexadécimales, par exemple
SELECT toUInt64('0xc0fe');.
Si la valeur d’entrée ne peut pas être représentée dans les limites de
UInt64, le résultat fait l’objet d’un dépassement supérieur ou inférieur.
Cela n’est pas considéré comme une erreur.
Par exemple : SELECT toUInt64(18446744073709551616) == 0;La fonction utilise l’arrondi vers zéro, ce qui signifie qu’elle tronque les chiffres fractionnaires des nombres.
expr— Expression renvoyant un nombre ou sa représentation sous forme de chaîne.Expression
UInt64
Exemples
Exemple d’utilisation
Query
Response
toUInt64OrDefault
toUInt64, cette fonction convertit une valeur d’entrée en une valeur de type UInt64, 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
expr— Expression qui renvoie un nombre ou la représentation sous forme de chaîne d’un nombre.Stringou(U)Int*ouFloat*default— Facultatif. La valeur par défaut à renvoyer si l’analyse échoue.UInt64
UInt64
Exemples
Conversion réussie
Query
Response
Query
Response
toUInt64OrNull
toUInt64, cette fonction convertit une valeur d’entrée en une valeur de type UInt64, mais renvoie NULL en cas d’erreur.
Arguments pris en charge :
- Représentations sous forme de chaîne de (U)Int*.
NULL) :
- Représentations sous forme de chaîne de valeurs Float*, y compris
NaNetInf. - Représentations sous forme de chaîne de valeurs binaires et hexadécimales, par ex.
SELECT toUInt64OrNull('0xc0fe');.
Si la valeur d’entrée ne peut pas être représentée dans les limites de
UInt64, le résultat subit un dépassement de capacité, par excès ou par défaut.
Cela n’est pas considéré comme une erreur.x— Représentation sous forme de chaîne d’un nombre.String
NULL si la conversion échoue. UInt64 ou NULL
Exemples
Exemple d’utilisation
Query
Response
toUInt64OrZero
toUInt64, cette fonction convertit une valeur d’entrée en une valeur de type UInt64, mais renvoie 0 en cas d’erreur.
Arguments pris en charge :
- Représentations sous forme de chaîne de (U)Int*.
0) :
- Représentations sous forme de chaîne de valeurs Float*, y compris
NaNetInf. - Représentations sous forme de chaîne de valeurs binaires et hexadécimales, par exemple
SELECT toUInt64OrZero('0xc0fe');.
Si la valeur d’entrée ne peut pas être représentée dans les limites de
UInt64, il se produit un dépassement de capacité par excès ou par défaut du résultat.
Cela n’est pas considéré comme une erreur.x— Une représentation sous forme de chaîne d’un nombre.String
0 si la conversion échoue. UInt64
Exemples
Exemple d’utilisation
Query
Response
toUInt8
UInt8.
lever une exception en cas d’erreur.
Arguments pris en charge :
- Valeurs ou représentations sous forme de chaîne de type (U)Int*.
- Valeurs de type Float*.
- Représentations sous forme de chaîne de valeurs Float*, y compris
NaNetInf. - Représentations sous forme de chaîne de valeurs binaires et hexadécimales, par exemple
SELECT toUInt8('0xc0fe');.
Si la valeur d’entrée ne peut pas être représentée dans la plage de UInt8, un dépassement de capacité par excès ou par défaut du résultat se produit.
Cela n’est pas considéré comme une erreur.
Par exemple :
SELECT toUInt8(256) == 0;.La fonction utilise l’arrondi vers zéro, ce qui signifie qu’elle tronque les chiffres fractionnaires des nombres.
expr— Expression renvoyant un nombre ou sa représentation sous forme de chaîne.Expression
UInt8
Exemples
Exemple d’utilisation
Query
Response
toUInt8OrDefault
toUInt8, cette fonction convertit une valeur d’entrée en une valeur de type UInt8, 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
expr— Expression renvoyant un nombre ou la représentation sous forme de chaîne d’un nombre.Stringou(U)Int*ouFloat*default— Facultatif. Valeur par défaut à renvoyer si l’analyse échoue.UInt8
UInt8
Exemples
Conversion réussie
Query
Response
Query
Response
toUInt8OrNull
toUInt8, cette fonction convertit une valeur d’entrée en une valeur de type UInt8, mais renvoie NULL en cas d’erreur.
Arguments pris en charge :
- Représentations sous forme de chaîne de caractères de (U)Int8/16/32/128/256.
NULL) :
- Représentations sous forme de chaîne de caractères de valeurs Float* ordinaires, y compris
NaNetInf. - Représentations sous forme de chaîne de caractères de valeurs binaires et hexadécimales, par ex.
SELECT toUInt8OrNull('0xc0fe');.
Si la valeur d’entrée ne peut pas être représentée dans les limites de
UInt8, un dépassement de capacité par excès ou par défaut du résultat se produit.
Cela n’est pas considéré comme une erreur.x— Une représentation sous forme de chaîne d’un nombre.String
NULL si la conversion échoue. UInt8 ou NULL
Exemples
Exemple d’utilisation
Query
Response
toUInt8OrZero
toUInt8, cette fonction convertit une valeur d’entrée en une valeur de type UInt8, mais renvoie 0 en cas d’erreur.
Arguments pris en charge :
- Représentations sous forme de chaîne de (U)Int8/16/32/128/256.
0) :
- Représentations sous forme de chaîne de valeurs Float* ordinaires, y compris
NaNetInf. - Représentations sous forme de chaîne de valeurs binaires et hexadécimales, par exemple
SELECT toUInt8OrZero('0xc0fe');.
Si la valeur d’entrée ne peut pas être représentée dans les limites de
UInt8, un dépassement de capacité (par excès ou par défaut) du résultat se produit.
Cela n’est pas considéré comme une erreur.x— Une représentation sous forme de chaîne d’un nombre.String
0 si la conversion échoue. UInt8
Exemples
Exemple d’utilisation
Query
Response
toUUID
string— UUID sous forme de chaîne.StringouFixedString
UUID
Exemples
Exemple d’utilisation
Query
Response
toUUIDOrZero
toUUID, mais renvoie un UUID nul (00000000-0000-0000-0000-000000000000) au lieu de lever une exception en cas d’erreur de conversion.
Arguments pris en charge :
- Représentations sous forme de chaîne d’un UUID au format standard (8-4-4-4-12 chiffres hexadécimaux).
- Représentations sous forme de chaîne d’un UUID sans tirets (32 chiffres hexadécimaux).
- Formats de chaîne non valides.
- Types autres que chaîne.
x— Une représentation sous forme de chaîne d’un UUID.String
00000000-0000-0000-0000-000000000000). UUID
Exemples
Exemple d’utilisation
Query
Response
toUnixTimestamp64Micro
DateTime64 en une valeur Int64 avec une précision fixe à la microseconde.
La valeur d’entrée est mise à l’échelle de manière appropriée en fonction de sa précision.
La valeur de sortie est relative à l’UTC, et non au fuseau horaire de la valeur d’entrée.
value— ValeurDateTime64avec une précision quelconque.DateTime64
Int64
Exemples
Exemple d’utilisation
Query
Response
toUnixTimestamp64Milli
DateTime64 en une valeur Int64 avec une précision fixe à la milliseconde.
La valeur d’entrée est mise à l’échelle à la hausse ou à la baisse selon sa précision.
La valeur de sortie est relative à l’UTC, et non au fuseau horaire de la valeur d’entrée.
value— Valeur DateTime64, quelle que soit sa précision.DateTime64
Int64
Exemples
Exemple d’utilisation
Query
Response
toUnixTimestamp64Nano
DateTime64 en une valeur Int64 avec une précision fixe en nanosecondes.
La valeur d’entrée est mise à l’échelle à la hausse ou à la baisse selon sa précision.
La valeur de sortie est relative à l’UTC, et non au fuseau horaire de la valeur d’entrée.
value— ValeurDateTime64avec une précision quelconque.DateTime64
Int64
Exemples
Exemple d’utilisation
Query
Response
toUnixTimestamp64Second
DateTime64 en valeur Int64 avec une précision fixe à la seconde.
La valeur d’entrée est mise à l’échelle vers le haut ou vers le bas selon sa précision.
La valeur de sortie est relative à l’UTC, et non au fuseau horaire de la valeur d’entrée.
value— Valeur DateTime64 avec une précision quelconque.DateTime64
Int64
Exemples
Exemple d’utilisation
Query
Response