DATE_ DIFF fonctionne sur Amazon QLDB - Base de données Amazon Quantum Ledger (AmazonQLDB)
SyntaxeArgumentsType de retourExemplesFonctions associées

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.

DATE_ DIFF fonctionne sur Amazon QLDB

Important

Avis de fin de support : les clients existants pourront utiliser Amazon QLDB jusqu'à la fin du support le 31 juillet 2025. Pour plus de détails, consultez Migrer un Amazon QLDB Ledger vers Amazon Aurora SQL Postgre.

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

Syntaxe

DATE_DIFF( datetimepart, timestamp1, timestamp2 )

Arguments

datetimepart

Partie de date ou d'heure sur laquelle la fonction fonctionne. Ce paramètre peut avoir l'une des valeurs suivantes :

  • year

  • month

  • day

  • hour

  • minute

  • second

timestamp1, timestamp2

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

Une valeur littérale d'horodatage ionique peut être indiquée par backticks (). `...` Pour obtenir des informations sur le formatage et des exemples de valeurs d'horodatage, consultez la section Horodatages du document de spécification 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

Fonctions associées