Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# DATE\$1DIFF-Funktion in Amazon QLDB
DATE\$1DIFF

**Wichtig**  
Hinweis zum Ende des Supports: Bestandskunden können Amazon QLDB bis zum Ende des Supports am 31.07.2025 nutzen. Weitere Informationen finden Sie unter [Migrieren eines Amazon QLDB-Ledgers zu Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

Verwenden Sie in Amazon QLDB die `DATE_DIFF` Funktion, um die Differenz zwischen den angegebenen Datumsteilen zweier gegebener Zeitstempel zurückzugeben.

## Syntax


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

## Argumente


*datetimepart*  
Der Datums- oder Uhrzeitteil, an dem die Funktion ausgeführt wird. Bei diesem Parameter kann es sich um einen der Folgenden handeln:  
+ `year`
+ `month`
+ `day`
+ `hour`
+ `minute`
+ `second`

*timestamp1*, *timestamp2*  
Die beiden Feldnamen oder Ausdrücke des Datentyps `timestamp`, die die Funktion vergleicht. Wenn *timestamp2* es später ist als*timestamp1*, ist das Ergebnis positiv. Wenn *timestamp2* es früher ist als*timestamp1*, ist das Ergebnis negativ.  
Ein Ion-Zeitstempel-Literalwert kann mit Backticks () bezeichnet werden. ``...`` Formatierungsdetails und Beispiele für Zeitstempelwerte finden Sie unter [Zeitstempel](https://amzn.github.io/ion-docs/docs/spec.html#timestamp) im Amazon Ion-Spezifikationsdokument.

## Rückgabetyp


`int`

## Beispiele


```
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
```

## Verwandte Funktionen

+ [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)