Função GOMONTH( )
Retorna a data que é um 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
Adicione três meses
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)
Subtraia três meses
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)
Valores de entrada de campo
Adicione três meses
Retorna a data três meses após cada data no campo Data_fatura:
GOMONTH(Data_fatura; 3)
Adicione três meses e quinze dias
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)
Exemplos avançados
Arredondamento de data para evitar datas inexistentes
Se a combinação de data/datahora e meses produzisse uma data não existente, a função GOMONTH( ) usa um "arredondamento de data" para retornar a data válida anterior mais próxima.
Não é necessário arredondamento de data
Adicionar um mês a 30 de março de 2014 retorna `20140430`, exibido como 30 de abril de 2014, assumindo um formato de exibição de data atual do Analytics de DD MMM AAAA:
GOMONTH(`20140330`; 1)
Arredondamento de data aplicado
Adicionar um mês a 31 de março de 2014 também retorna `20140430`, exibido como 30 de abril de 2014, assumindo um formato de exibição de data atual do Analytics de DD MMM AAAA: O arredondamento de data impede que o segundo exemplo retorne 31 de abril de 2014, que é uma data inválida.
GOMONTH(`20140331`; 1)
Observações
Às vezes, pode ser um desafio usar corretamente as data e hora. Na Ajuda, os tópicos de função descrevem os detalhes específicos do funcionamento de cada função. Para obter informações sobre algumas considerações gerais ao usar as funções de data e hora, consulte os seguintes tópicos:
- Usar datahoras em expressões
- Datahoras seriais
- Como os deslocamentos do UTC afetam as expressões de datahora
- Opções de data e hora
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
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.
