FORMAT(...)

All functions > STRING > FORMAT(...)

C-style string formatting: a VARCHAR template plus one scalar per placeholder.

Signatures

Returns: Formatted string

FORMAT_FN(format: VARCHAR, values: scalars…) → VARCHAR
sql
ParameterTypeRequiredDescription
formatVARCHARYesFormat string with C-style placeholders
valuesscalars…YesOne expression per placeholder, in order

Notes

  • Variadic FORMAT(...) / PRINTF(...) bundles trailing arguments like variadic CONCAT_WS(sep, ...)
  • NULL in a value position typically makes the whole result NULL; use COALESCE for sentinels

Related operators

Examples

FORMAT_FN(...)

FeatureQL
SELECT
    f1 := FORMAT_FN('n=%s', ARRAY['7']) -- Array form with one value
;
Result
f1 VARCHAR
n=7

Last update at: 2026/05/26 17:22:09