Função DATEADD

Adiciona um número especificado de unidades a uma data válida. Pode-se usar qualquer unidade Datetime aceita (por exemplo, minute, month, year etc.). A entrada precisa ser uma referência de coluna com datas.

OBSERVAÇÃO: se esta função calcular valores fora do intervalo aceito de datas, os valores serão gravados como incompatíveis, e a coluna provavelmente será digitada como Datetime. Para mais informações sobre os períodos aceitos, consulte Tipo de dados data/hora.

Uso básico

derive type:single value:DATEADD(myDate, 3, month)

Saída: gera uma coluna com o cálculo dos valores da coluna myDate com o acréscimo de três meses.

OBSERVAÇÃO: as datas de saída sempre são formatadas com traços. Por exemplo, se os valores de entrada incluem 12/31/2016, uma saída da função DATEADD pode ser 03-31-2016.

Sintaxe

derive type:single value:DATEADD(date,delta,date_units)

ArgumentoObrigatório?Tipo de dadosDescrição
dateSdatetimeData de início para comparar
deltaSnúmero inteiroNúmero de unidades para aplicar ao valor da data.
date_unitsSstringLiteral de string que representa as unidades de data para usar na comparação

Para mais informações sobre os padrões de sintaxe, consulte as Observações de sintaxe da documentação da linguagem.

date

Valores de data aos quais adicionar. É necessário que sejam uma referência de coluna.

Observações sobre o uso:

Obrigatório?Tipo de dadosValor de exemplo
SimString (referência de coluna de data)LastContactDate

delta

Número de unidades para aplicar aos valores de data.

  • Valores inteiros negativos são aceitos.

Observações sobre o uso:

Obrigatório?Tipo de dadosValor de exemplo
SimNúmero inteiro-3

date_units

Unidade de medida de data à qual aplicar o valor delta.

Observações sobre o uso:

Obrigatório?Tipo de dadosValor de exemplo
SimStringyear

Valor aceito para unidades de data:

  • year
  • quarter
  • month
  • dayofyear

  • day
  • hour
  • minute
  • second
  • millisecond

Exemplos

Exemplo: função DATEADD

Origem:

Veja a seguir algumas faturas de exemplo e as respectivas datas. Você quer calcular os limites de 90 e 180 dias, a partir dos quais serão cobrados juros.

InvNumInvDate
inv000101/01/2016
inv000215/07/2016
inv000330/12/2016

Transformação:

derive type:single value:DATEADD(InvDate,90,day) as:'plus90'

derive type:single value:DATEADD(InvDate,180,day) as:'plus180'

Resultados:

OBSERVAÇÃO: o formato de saída é sempre formatado com traços.

InvNumInvDateplus90plus180
inv000101/01/201631-03-201629-06-2016
inv000215/07/201613-10-201611-01-2017
inv000330/12/201630-03-201728-06-2017

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Documentação do Google Cloud Dataprep
Precisa de ajuda? Acesse nossa página de suporte.