DATE_ADD - Realtime Compute for Apache Flink: Central de Documentação do Alibaba Cloud

DATE_ADD(startdate, days) retorna a data correspondente a days dias após startdate.

Limitações

Compatível apenas com o Realtime Compute for Apache Flink que usa Ververica Runtime (VVR) 3.0.0 ou posterior.

Sintaxe

DATE DATE_ADD(VARCHAR startdate, INT days)
DATE DATE_ADD(TIMESTAMP time, INT days)

Parâmetros

Parâmetro	Tipo de dado	Descrição
`startdate`	VARCHAR	String de data no formato `yyyy-MM-dd` ou `yyyy-MM-dd HH:mm:ss`.
`time`	TIMESTAMP	Valor de timestamp.
`days`	INT	Número de dias a adicionar.

Nota

Se algum parâmetro de entrada for NULL ou ocorrer um erro de análise, a função retornará NULL.

Retorno

DATE: a data correspondente a days dias após a data de entrada.

Exemplos

Os exemplos a seguir usam estes dados de teste:

datetime1 (VARCHAR)	nullstr (VARCHAR)
2017-09-15 00:00:00	NULL

Instruções de teste

SELECT
  DATE_ADD(datetime1, 30)                       AS var1,  -- VARCHAR input: 2017-09-15 + 30 days
  DATE_ADD(TIMESTAMP '2017-09-15 23:00:00', 30) AS var2,  -- TIMESTAMP input: date portion + 30 days
  DATE_ADD(nullstr, 30)                         AS var3   -- NULL input: returns NULL
FROM T1;

Resultados

var1 (DATE)	var2 (DATE)	var3 (DATE)
2017-10-15	2017-10-15	NULL

Observações principais:

var1 e var2 resultam em 2017-10-15 porque 15 de setembro mais 30 dias equivale a 15 de outubro, independentemente de a entrada ser VARCHAR ou TIMESTAMP.
var3 é NULL porque o parâmetro de entrada nullstr é NULL.