Função GOMONTH( )

Retorna a data que é o número específico de meses antes ou depois de uma data específica.

Sintaxe

GOMONTH(data/datahora; meses)

Parâmetros

Nome Tipo Descrição
data/datahora

datahora

O campo, expressão ou valor literal do qual será calculada a data resultante.
meses

numérico

O número de meses antes ou após data/datahora.

Nota

Você pode especificar um valor datahora para data/datahora, mas a parte da hora do valor é ignorada.

Saída

Datahora. O valor de data resultante usa o formato de exibição de data atual do Analytics.

Exemplos

Exemplos básicos

Valores de entrada literal

Retorna `20140415` exibido como 15 Abr 2014 presumindo um formato de exibição atual de data do Analytics de DD MMM AAAA:

GOMONTH(`20140115`; 3)

Retorna `20131015` exibido como 15 Out 2013 presumindo um formato de exibição atual de data do Analytics de DD MMM AAAA:

GOMONTH(`20140115`; -3)

Retorna `20140430` exibido como 30 Abr 2014 presumindo um formato de exibição atual de data do Analytics de DD MMM AAAA (o arredondamento de datas impede de voltar em 31 Abr 2014, que é uma data inválida):

GOMONTH(`20140330`; 1)
GOMONTH(`20140331`; 1)

Retorna `20140501` exibido como 1 Mai 2014 presumindo um formato de exibição atual de data do Analytics de DD MMM AAAA:

GOMONTH(`20140401`; 1)

Valores de entrada de campo

Retorna a data três meses após cada data no campo Data_fatura:

GOMONTH(Data_fatura; 3)

Retorna a data três meses após cada data no campo Data_fatura, mais um período de carência de 15 dias:

GOMONTH(Data_fatura + 15; 3)

Observações

Formatos datahora

Um campo especificado para data/datahora pode usar qualquer formato de data ou datahora, desde que a definição do campo defina corretamente o formato.

Um valor de data literal deve usar um dos seguintes formatos:

  • AAAAMMDD
  • AAMMDD

Você precisa incluir os valores de data literais entre apóstrofos invertidos. Por exemplo: `20141231`

Como funciona o valor meses

  • Valor positivo a data resultante é mais recente que a data/datahora especificada
  • Valor for negativo a data resultante é anterior à data/datahora especificada
  • Valor omitido ou '0' (zero) a data de saída é a mesma que a data/datahora

Arredondamento de data para evitar datas inexistentes

Se a combinação de data/datahora e meses produzir uma data não existente, a função GOMONTH( ) usa um "arredondamento de data" para retornar a data válida mais próxima dentro do mesmo mês.

Retorna `20140430` (30 Abr 2014) porque 31 Abr 2014 é uma data inválida:

GOMONTH(`20140331`;1)

Funções relacionadas

Use a função EOMONTH( ) se quiser retornar a data do último dia do mês, em vez da data exata, que é o número de meses especificado antes ou depois de uma data específica.

[ Voltar ao início ]

Guia de scripting do ACL 14.1