Natural logarithm.
| Field | Value |
|---|---|
| Category | Math |
| Type | Scalar (operates value by value) |
| Arity | 1 argument (fixed) |
| Compiles to SQL (calculated column) | Yes |
| Version | Formula engine v3. |
Aliases#
Canonical name: LN. Accepted aliases (case-insensitive): (nenhum).
Syntax#
code
LN(expr)All arguments are expressions.
Returns#
Number.
Null handling#
Text that is not a number, or a blank value in a calculation, becomes a friendly error (pt-BR) — never a silent zero.
Evaluation context#
Scalar — evaluated on the result of the arguments (in calculated columns, it runs row by row).
Differences from DAX#
- DAX equivalent: LN
- Compatibility: Compatible with DAX
- Note: Natural logarithm; requires a number > 0.
Examples#
code
LN(receita)Example with values#
Input: number 1.
code
LN(1) → 0Expected result: 0
Business example#
Normalize financial numbers — round prices, remove the sign from a deviation, compute powers/roots.
Common errors#
LN: número deve ser maior que zero.