1º dia do mês (período, no calendário fiscal/4-4-5) do grupo atual.
| Campo | Valor |
|---|---|
| Categoria | Data e tempo |
| Tipo | Agregação (opera sobre um conjunto de linhas) |
| Aridade | 1 argumento (fixo) |
| Compila para SQL (coluna calculada) | Não |
| Versão | Motor de fórmulas v3, com suporte a calendário fiscal/4-4-5. |
Aliases#
Nome canônico: INICIO_MES. Aliases aceitos (maiúsc./minúsc. indiferente): startofmonth.
Assinatura#
code
INICIO_MES(coluna)O 1º argumento é o nome de uma coluna (identificador nu); os demais são expressões.
Retorno#
Data.
Tratamento de nulos#
Datas inválidas ou ausentes viram erro amigável ou vazio, conforme a função.
Contexto de avaliação#
Agregação — percorre as linhas do grupo atual do visual.
Diferenças para DAX#
- Equivalente DAX: STARTOFMONTH
- Compatibilidade: DIFERE do DAX — semântica diferente, atenção
- Observação: Devolve a data (escalar) do 1º dia do mês/período fiscal do grupo; o STARTOFMONTH do DAX devolve uma tabela.
Exemplos#
code
INICIO_MES(dia)Exemplo com valores#
Entrada: grupo de março/25.
code
INICIO_MES(dia) → 2025-03-01Resultado esperado: 2025-03-01
Exemplo de negócio#
Análise temporal — idade do pedido, mês/ano de competência, fechamento contábil.
Erros comuns#
Erros de digitação em nome de coluna, tipo incompatível ou argumento inválido viram mensagem amigável (pt-BR) — o motor nunca devolve um número errado em silêncio.