Number → text (pt-BR format).
| Field | Value |
|---|---|
| Category | Text |
| Type | Scalar (operates value by value) |
| Arity | 1 to 2 arguments |
| Compiles to SQL (calculated column) | Yes |
| Version | Formula engine v3. |
Aliases#
Canonical name: TEXTO. Accepted aliases (case-insensitive): format.
Syntax#
code
TEXTO(expr; [arg2])All arguments are expressions.
Returns#
Text.
Null handling#
Blank becomes empty text ("").
Evaluation context#
Scalar — evaluated on the result of the arguments (in calculated columns, it runs row by row).
Differences from DAX#
- DAX equivalent: FORMAT
- Compatibility: DIFFERS from DAX — different semantics, watch out
- Note: It is NOT a format string: the 2nd argument is the number of decimal places (pt-BR format). For rich formatting, use the field's format options.
Examples#
code
TEXTO(receita; 2)Example with values#
Input: number 1234,5 with 2 places.
code
TEXTO(1234,5; 2) → "1.234,50"Expected result: "1.234,50"
Business example#
Format revenue with 2 decimal places for the data label.
Common errors#
Typos in a column name, an incompatible type, or an invalid argument become a friendly message (pt-BR) — the engine never silently returns a wrong number.