Expressões de data

Além de datas completas, como 31/12/2026, os campos do tipo data do sistema aceitam expressões de data: pequenos textos que representam uma data relativa ao dia atual. Ao digitar fm-1m em um campo de data, por exemplo, o sistema preenche o campo com o último dia do mês anterior.

As expressões são especialmente úteis quando o valor informado precisa ser reavaliado no futuro, como nos agendamentos de relatórios , nos filtros das visualizações e nos valores salvos das grades de variáveis. Nesses casos, a expressão é gravada no lugar da data e o resultado é calculado novamente a cada uso. Um relatório agendado com o período de im-1m a fm-1m sempre será emitido com os dados do mês anterior à sua execução.

Resumo

Letras maiúsculas e minúsculas são equivalentes e os espaços são ignorados: FM-1M, fm-1m e fm - 1m representam a mesma data.

Como uma expressão é formada

Uma expressão é composta por uma âncora opcional seguida de zero ou mais deslocamentos:

[âncora][deslocamento][deslocamento]...

• fm-1m: âncora fm (fim do mês) e deslocamento -1m (um mês para trás);
• -30d: sem âncora, apenas o deslocamento -30d (30 dias para trás);
• h: apenas a âncora h (hoje);
• -1m-1d: sem âncora, dois deslocamentos (um mês e um dia para trás).

Unidades

As unidades são representadas por uma letra e são usadas tanto nos deslocamentos quanto nas âncoras de período:

A unidade de dia (d) só é usada em deslocamentos. Não existem âncoras id e fd.

Âncoras de dia

Definem o dia a partir do qual os deslocamentos serão aplicados. Quando nenhuma âncora é informada, é considerado o dia atual.

Exemplos: o-1m é o dia anterior a hoje, um mês atrás. h-1a é equivalente a -1a.

Âncoras de período

Levam a data ao início (i) ou ao fim (f) do período que a contém. São formadas pela letra i ou f seguida da letra da unidade:

Deslocamentos

Um deslocamento é formado por um sinal (+ para frente, - para trás), uma quantidade e, opcionalmente, uma unidade: +2d, -1m, -3t, +1a.

Quando a unidade não é informada, como em +2 ou -10, ela depende do tipo do campo:

Para evitar dúvidas, prefira sempre informar a unidade, principalmente em expressões que serão gravadas para uso futuro.

Ordem de avaliação

Uma expressão é avaliada sempre na mesma ordem, independentemente da posição em que os seus elementos foram escritos:

1. parte-se da âncora de dia (hoje, quando não informada);
2. aplicam-se os deslocamentos, da esquerda para a direita;
3. por fim, aplica-se a âncora de período, se houver.

Por isso, fm-1m resulta no último dia do mês anterior, mesmo em meses de tamanhos diferentes. Em 31/03/2026, por exemplo:

• -1m leva a 28/02/2026;
• fm leva ao fim de fevereiro, 28/02/2026.

Uma consequência dessa regra é que não é possível deslocar uma data a partir do início ou do fim de um período. Uma expressão como im+4d resulta no primeiro dia do mês, pois a âncora im é aplicada depois do deslocamento de 4 dias. Para obter um dia fixo do mês atual, informe apenas o número do dia, como 05.

Meses de tamanhos diferentes

Deslocamentos em meses, trimestres, semestres e anos preservam o dia sempre que possível. Quando o dia não existe no mês de destino, é utilizado o último dia desse mês:

Para obter o último dia de um mês, use a âncora fm em vez de contar com esse ajuste: fm-1m em vez de -1m.

Expressões frequentes

Períodos comuns em relatórios e filtros, informados em dois campos (início e fim):

Campos de mês/ano e semana/ano

Campos que exibem apenas o mês e o ano, como 09/2026, ou a semana e o ano, como 40/2026, também aceitam expressões. A data resultante é convertida para o mês ou a semana que a contém. Nesses campos:

• deslocamentos sem unidade usam mês ou semana, conforme a tabela de deslocamentos ;
• nos campos de mês/ano, as âncoras o (ontem) e a (amanhã) representam o mês atual;
• quando o campo representa o fim de um intervalo, o sistema considera o último dia do mês ou da semana obtidos.

Assistente de expressões

Alguns locais do sistema, como os filtros de data das visualizações e os valores salvos das grades, oferecem uma lista de expressões com nomes amigáveis, como “Fim do mês” e “Dia anterior”. Essa lista é mantida no cadastro de expressões de tempo e pode ser ampliada pelos administradores com qualquer expressão descrita nesta página.

Erros comuns

• +1x ou -1q: a unidade informada não existe. Use uma das unidades suportadas.
• im+4d: resulta no início do mês, pois a âncora de período é aplicada por último. Veja a ordem de avaliação .
• -1m para o fim do mês anterior: resulta no mesmo dia do mês anterior, e não no seu último dia. Use fm-1m.
• is para o início da semana: s é semestre. A semana é representada por w: iw.