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\$1DIFF dans Amazon QLDB
<a name="ql-functions.date_diff"></a>

**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 registre Amazon QLDB vers Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

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

## Syntaxe
<a name="ql-functions.date_diff.syntax"></a>

```
DATE_DIFF( datetimepart, timestamp1, timestamp2 )
```

## Arguments
<a name="ql-functions.date_diff.arguments"></a>

*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. Si *timestamp2* c'est plus tard que cela*timestamp1*, le résultat est positif. Si elle *timestamp2* est antérieure à*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](https://amzn.github.io/ion-docs/docs/spec.html#timestamp) de spécification Amazon Ion.

## Type de retour
<a name="ql-functions.date_diff.return-type"></a>

`int`

## Exemples
<a name="ql-functions.date_diff.examples"></a>

```
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
<a name="ql-functions.date_diff.related"></a>
+ [DATE\$1ADD](ql-functions.date_add.md)
+ [EXTRACT](ql-functions.extract.md)
+ [TO\$1STRING](ql-functions.to_string.md)
+ [TO\$1TIMESTAMP](ql-functions.to_timestamp.md)
+ [UTCNOW](ql-functions.utcnow.md)