DATEDIFFfunción _ en Amazon QLDB - Base de datos Amazon Quantum Ledger (AmazonQLDB)
SintaxisArgumentosTipo de retornoEjemplosFunciones relacionadas

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

DATEDIFFfunción _ en Amazon QLDB

importante

Aviso de fin de soporte: los clientes actuales podrán usar Amazon QLDB hasta que finalice el soporte, el 31 de julio de 2025. Para obtener más información, consulte Migración de un Amazon QLDB Ledger a Amazon Aurora SQL Postgre.

En AmazonQLDB, usa la DATE_DIFF función para devolver la diferencia entre las partes de fecha especificadas de dos marcas de tiempo determinadas.

Sintaxis

DATE_DIFF( datetimepart, timestamp1, timestamp2 )

Argumentos

datetimepart

La parte de la fecha o la hora sobre la que opera la función. Este parámetro puede ser uno de los siguientes:

  • year

  • month

  • day

  • hour

  • minute

  • second

timestamp1, timestamp2

Los dos nombres de cambo o expresiones del tipo de datos timestamp que compara la función. Si timestamp2 es posterior a timestamp1, el resultado es positivo. Si timestamp2 es anterior a timestamp1, el resultado es negativo.

El valor literal de una marca de tiempo de Ion se puede indicar con comillas invertidas (`...`). Para obtener más detalles sobre formatos y ejemplos de valores de marcas de tiempo, consulte Marcas de tiempo en el documento de especificaciones de Amazon Ion.

Tipo de retorno

int

Ejemplos

DATE_DIFF(year, `2010-01-01T`, `2011-01-01T`)            -- 1
DATE_DIFF(year, `2010-12T`, `2011-01T`)                  -- 0 (must be at least 12 months apart to evaluate as a 1 year difference)
DATE_DIFF(month, `2010T`, `2010-05T`)                    -- 4 (2010T is equivalent to 2010-01-01T00:00:00.000Z)
DATE_DIFF(month, `2010T`, `2011T`)                       -- 12
DATE_DIFF(month, `2011T`, `2010T`)                       -- -12
DATE_DIFF(month, `2010-12-31T`, `2011-01-01T`)           -- 0 (must be at least a full month apart to evaluate as a 1 month difference)
DATE_DIFF(day, `2010-01-01T23:00Z`, `2010-01-02T01:00Z`) -- 0 (must be at least 24 hours apart to evaluate as a 1 day difference)

-- Runnable statements
SELECT DATE_DIFF(year, `2010-01-01T`, `2011-01-01T`) FROM << 0 >> -- 1
SELECT DATE_DIFF(month, `2010T`, `2010-05T`) FROM << 0 >>         -- 4

Funciones relacionadas