Fonction DATE_DIFF dans Amazon QLDB - Amazon Quantum Ledger Database (Amazon QLDB)
SyntaxeArgumentsType de retourExemplesRéférences Références

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Fonction DATE_DIFF dans Amazon QLDB

Dans Amazon QLDB, utilisez laDATE_DIFF fonction pour renvoyer la différence entre les parties de date spécifiées de deux horodatages donnés.

Syntaxe

DATE_DIFF( datetimepart, timestamp1, timestamp2 )

Arguments

date/heure (partie)

Références sur lesquelles la fonction opère. Ce paramètre peut avoir l'une des valeurs suivantes :

  • year

  • month

  • day

  • hour

  • minute

  • second

horodatage1, horodatage2

Les deux noms de champs ou expressions du type de donnéestimestamp que la fonction compare. Si timestamp2 est postérieur à timestamp1, le résultat est positif. Si timestamp2 est antérieur à timestamp1, le résultat est négatif.

Une valeur littérale d'horodatage Ion peut être indiquée par des crochets inverses (`...`). Pour plus de détails sur le formatage et des exemples de valeurs d'horodatage, consultez la section Horodatages du document de spécifications Amazon Ion.

Type de retour

int

Exemples

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

Références Références