Datumsfunktionen

Dieser Abschnitt beschreibt Funktionen und Operatoren zum Untersuchen und Manipulieren von DATE-Werten.

Datumsoperatoren

Die folgende Tabelle zeigt die verfügbaren mathematischen Operatoren für DATE-Typen.

Operator	Beschreibung	Beispiel	Ergebnis
`+`	Addition von Tagen (Ganzzahlen)	`DATE '1992-03-22' + 5`{:.language-sql .highlight}	`1992-03-27`
`+`	Addition eines `INTERVAL`	`DATE '1992-03-22' + INTERVAL 5 DAY`{:.language-sql .highlight}	`1992-03-27 00:00:00`
`+`	Addition eines variablen `INTERVAL`	`SELECT DATE '1992-03-22' + INTERVAL (d.days) DAY FROM (VALUES (5), (11)) d(days)`{:.language-sql .highlight}	`1992-03-27 00:00:00` und `1992-04-02 00:00:00`
`-`	Subtraktion von `DATE`s	`DATE '1992-03-27' - DATE '1992-03-22'`{:.language-sql .highlight}	`5`
`-`	Subtraktion eines `INTERVAL`	`DATE '1992-03-27' - INTERVAL 5 DAY`{:.language-sql .highlight}	`1992-03-22 00:00:00`
`-`	Subtraktion eines variablen `INTERVAL`	`SELECT DATE '1992-03-27' - INTERVAL (d.days) DAY FROM (VALUES (5), (11)) d(days)`{:.language-sql .highlight}	`1992-03-22 00:00:00` und `1992-03-16 00:00:00`

Das Addieren zu oder Subtrahieren von unendlichen Werten liefert denselben unendlichen Wert.

Datumsfunktionen

Die folgende Tabelle zeigt die verfügbaren Funktionen für DATE-Typen. Daten können durch Typpromotion auch mit den Zeitstempelfunktionen manipuliert werden.

Name	Beschreibung
`date_add(date, interval)`	Addiert das Intervall zum Datum und liefert einen `DATETIME`-Wert.
`date_diff(part, startdate, enddate)`	Die Anzahl der `part`-Grenzen zwischen `startdate` und `enddate`, einschließlich des größeren und ausschließlich des kleineren Datums.
`date_part(part, date)`	Holt ein Teilfeld (gleichwertig mit `extract`).
`date_sub(part, startdate, enddate)`	Die vorzeichenbehaftete Länge des Intervalls zwischen `startdate` und `enddate`, auf ganze Vielfache von `part` abgeschnitten.
`date_trunc(part, date)`	Schneidet auf die angegebene Genauigkeit zu.
`dayname(date)`	Der (englische) Name des Wochentags.
`days_in_month(date)`	Die Anzahl der Tage im Monat des angegebenen Datums.
`extract(part from date)`	Holt ein Teilfeld aus einem Datum.
`greatest(date, date)`	Das spätere von zwei Daten.
`isfinite(date)`	Liefert wahr, wenn das Datum endlich ist, sonst falsch.
`isinf(date)`	Liefert wahr, wenn das Datum unendlich ist, sonst falsch.
`julian(date)`	Extrahiert die Julianische Tageszahl aus einem Datum.
`last_day(date)`	Der letzte Tag des entsprechenden Monats im Datum.
`least(date, date)`	Das frühere von zwei Daten.
`make_date(year, month, day)`	Das Datum für die angegebenen Bestandteile.
`monthname(date)`	Der (englische) Name des Monats.
`strftime(date, format)`	Wandelt ein Datum gemäß der Formatzeichenkette in eine Zeichenkette um.
`time_bucket(bucket_width, date[, offset])`	Schneidet `date` auf ein Raster der Breite `bucket_width` zu. Das Raster ist bei `2000-01-01[ + offset]` verankert, wenn `bucket_width` eine Anzahl von Monaten oder gröberen Einheiten ist, sonst bei `2000-01-03[ + offset]`. Beachten Sie, dass `2000-01-03` ein Montag ist.
`time_bucket(bucket_width, date[, origin])`	Schneidet `timestamptz` auf ein Raster der Breite `bucket_width` zu. Das Raster ist am Zeitstempel `origin` verankert, der standardmäßig `2000-01-01` ist, wenn `bucket_width` eine Anzahl von Monaten oder gröberen Einheiten ist, sonst `2000-01-03`. Beachten Sie, dass `2000-01-03` ein Montag ist.
`today()`	Aktuelles Datum (Beginn der aktuellen Transaktion) in der lokalen Zeitzone.

`date_add(date, interval)`

`date_diff(part, startdate, enddate)`

`date_part(part, date)`

`date_sub(part, startdate, enddate)`

`date_trunc(part, date)`

`dayname(date)`

`days_in_month(date)`

`extract(part from date)`

`greatest(date, date)`

`isfinite(date)`

`isinf(date)`

`julian(date)`

`last_day(date)`

`least(date, date)`

`make_date(year, month, day)`

`monthname(date)`

`strftime(date, format)`

`time_bucket(bucket_width, date[, offset])`

| Beschreibung | Schneidet date auf ein Raster der Breite bucket_width zu. Das Raster ist bei 2000-01-01[ + offset] verankert, wenn bucket_width eine Anzahl von Monaten oder gröberen Einheiten ist, sonst bei 2000-01-03[ + offset]. Beachten Sie, dass 2000-01-03 ein Montag ist. | | Beispiel | time_bucket(INTERVAL '2 months', DATE '1992-04-20', INTERVAL '1 month') | | Ergebnis | 1992-04-01 |

`time_bucket(bucket_width, date[, origin])`

| Beschreibung | Schneidet timestamptz auf ein Raster der Breite bucket_width zu. Das Raster ist am Zeitstempel origin verankert, der standardmäßig 2000-01-01 ist, wenn bucket_width eine Anzahl von Monaten oder gröberen Einheiten ist, sonst 2000-01-03. Beachten Sie, dass 2000-01-03 ein Montag ist. | | Beispiel | time_bucket(INTERVAL '2 weeks', DATE '1992-04-20', DATE '1992-04-01') | | Ergebnis | 1992-04-15 |

`today()`

Funktionen zur Extraktion von Datumsbestandteilen

Es gibt auch eigene Extraktionsfunktionen, um die Teilfelder zu holen. Einige Beispiele sind das Extrahieren des Tages aus einem Datum oder des Wochentags aus einem Datum.

Auf unendliche Daten angewendete Funktionen liefern entweder dieselben unendlichen Daten (z. B. greatest) oder NULL (z. B. date_part), je nachdem, was „sinnvoll“ ist. Im Allgemeinen ist das Ergebnis NULL, wenn die Funktion die Bestandteile des unendlichen Datums untersuchen muss.