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 o Ververica Runtime (VVR) 3.0.0 ou superior.

Sintaxe

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

Parâmetros

Parâmetro	Tipo de dados	Descrição
`startdate`	TIMESTAMP, VARCHAR	Uma string contendo uma data no formato `yyyy-MM-dd` ou `yyyy-MM-dd HH:mm:ss`.
`time`	TIMESTAMP	Um valor de timestamp.
`days`	INT	O 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

Principais observações:

var1 e var2 produzem 2017-10-15 porque 15 de setembro mais 30 dias resulta em 15 de outubro, independentemente de a entrada ser VARCHAR ou TIMESTAMP.
var3 é NULL porque a entrada nullstr é NULL.