Today's date.
| Field | Value |
|---|---|
| Category | Date and time |
| Type | Scalar (operates value by value) |
| Arity | no arguments |
| Compiles to SQL (calculated column) | Yes |
| Version | Formula engine v3. |
Aliases#
Canonical name: HOJE. Accepted aliases (case-insensitive): today.
Syntax#
HOJE()All arguments are expressions.
Returns#
Date.
Null handling#
Invalid or missing dates become a friendly error or blank, depending on the function.
Evaluation context#
Scalar — evaluated on the result of the arguments (in calculated columns, it runs row by row).
Differences from DAX#
- DAX equivalent: TODAY
- Compatibility: DIFFERS from DAX — different semantics, watch out
- Note: Uses the America/Sao_Paulo time zone; DAX TODAY uses the service's time zone (typically UTC).
Examples#
DATADIF(pedido_em; HOJE(); "DIA")Example with values#
Input: call with no arguments (today's date, America/Sao_Paulo time zone).
HOJE() → 2025-03-15Expected result: 2025-03-15
NOT deterministic — changes every day; here we fix 2025-03-15 just to illustrate.
Business example#
Time analysis — order age, accrual month/year, accounting close.
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.