Zeitstempel-Funktionen

Dieser Abschnitt beschreibt Funktionen und Operatoren zum Untersuchen und Manipulieren von TIMESTAMP-Werten. Siehe auch die verwandten TIMESTAMPTZ-Funktionen.

Zeitstempel-Operatoren

Die folgende Tabelle zeigt die verfügbaren mathematischen Operatoren für den Typ TIMESTAMP.

Operator	Beschreibung	Beispiel	Ergebnis
`+`	Addition eines `INTERVAL`	`TIMESTAMP '1992-03-22 01:02:03' + INTERVAL 5 DAY`	`1992-03-27 01:02:03`
`-`	Subtraktion von `TIMESTAMP`s	`TIMESTAMP '1992-03-27' - TIMESTAMP '1992-03-22'`	`5 days`
`-`	Subtraktion eines `INTERVAL`	`TIMESTAMP '1992-03-27 01:02:03' - INTERVAL 5 DAY`	`1992-03-22 01:02:03`

Addition zu oder Subtraktion von unendlichen Werten liefert denselben unendlichen Wert.

Skalare Zeitstempel-Funktionen

Die folgende Tabelle zeigt die verfügbaren skalaren Funktionen für TIMESTAMP-Werte.

Name	Beschreibung
`age(timestamp, timestamp)`	Subtrahiert die Argumente und liefert die Zeitdifferenz zwischen den beiden Zeitstempeln.
`age(timestamp)`	Subtrahiert vom current_date.
`ago(interval)`	Subtrahiert ein Intervall vom aktuellen Zeitstempel.
`century(timestamp)`	Extrahiert das Jahrhundert eines Zeitstempels.
`current_localtimestamp()`	Gibt den aktuellen Zeitstempel zurück (zum Beginn der Transaktion).
`date_diff(part, starttimestamp, endtimestamp)`	Die Anzahl der `part`-Grenzen zwischen `starttimestamp` und `endtimestamp`, einschließlich des größeren und ausschließlich des kleineren Zeitstempels.
`date_part([part, ...], timestamp)`	Holt die aufgeführten Teilfelder als `struct`. Die Liste muss konstant sein.
`date_part(part, timestamp)`	Teilfeld holen (entspricht `extract`).
`date_sub(part, starttimestamp, endtimestamp)`	Die vorzeichenbehaftete Länge des Intervalls zwischen `starttimestamp` und `endtimestamp`, auf ganze Vielfache von `part` gekürzt.
`date_trunc(part, timestamp)`	Auf die angegebene Genauigkeit kürzen.
`dayname(timestamp)`	Der (englische) Name des Wochentags.
`epoch_ms(timestamp)`	Gibt die Gesamtzahl der Millisekunden seit der Epoche zurück.
`epoch_ns(timestamp)`	Gibt die Gesamtzahl der Nanosekunden seit der Epoche zurück.
`epoch_us(timestamp)`	Gibt die Gesamtzahl der Mikrosekunden seit der Epoche zurück.
`epoch(timestamp)`	Gibt die Gesamtzahl der Sekunden seit der Epoche zurück.
`extract(field FROM timestamp)`	Teilfeld aus einem Zeitstempel holen.
`greatest(timestamp, timestamp)`	Der spätere der beiden Zeitstempel.
`isfinite(timestamp)`	Gibt true zurück, wenn der Zeitstempel endlich ist, sonst false.
`isinf(timestamp)`	Gibt true zurück, wenn der Zeitstempel unendlich ist, sonst false.
`julian(timestamp)`	Extrahiert die Julianische Tageszahl aus einem Zeitstempel.
`last_day(timestamp)`	Der letzte Tag des Monats.
`least(timestamp, timestamp)`	Der frühere der beiden Zeitstempel.
`make_timestamp(bigint, bigint, bigint, bigint, bigint, double)`	Der Zeitstempel für die angegebenen Teile.
`make_timestamp(microseconds)`	Wandelt Mikrosekunden seit der Epoche in einen Zeitstempel um.
`make_timestamp_ms(milliseconds)`	Wandelt Millisekunden seit der Epoche in einen Zeitstempel um.
`make_timestamp_ns(nanoseconds)`	Wandelt Nanosekunden seit der Epoche in einen Zeitstempel um.
`monthname(timestamp)`	Der (englische) Name des Monats.
`strftime(timestamp, format)`	Wandelt den Zeitstempel gemäß dem Formatstring in eine Zeichenkette um.
`strptime(text, format-list)`	Wandelt die Zeichenkette `text` in einen Zeitstempel um, indem die Formatstrings in der Liste nacheinander angewendet werden, bis einer gelingt. Wirft bei Misserfolg einen Fehler. Um bei Misserfolg `NULL` zurückzugeben, verwenden Sie `try_strptime`.
`strptime(text, format)`	Wandelt die Zeichenkette `text` gemäß dem Formatstring in einen Zeitstempel um. Wirft bei Misserfolg einen Fehler. Um bei Misserfolg `NULL` zurückzugeben, verwenden Sie `try_strptime`.
`time_bucket(bucket_width, timestamp[, offset])`	Kürzt `timestamp` auf ein Raster der Breite `bucket_width`. Das Raster ist bei `2000-01-01 00:00:00[ + offset]` verankert, wenn `bucket_width` eine Anzahl von Monaten oder gröberen Einheiten ist, sonst bei `2000-01-03 00:00:00[ + offset]`. Beachten Sie, dass `2000-01-03` ein Montag ist.
`time_bucket(bucket_width, timestamp[, origin])`	Kürzt `timestamp` auf ein Raster der Breite `bucket_width`. Das Raster ist am Zeitstempel `origin` verankert, der standardmäßig `2000-01-01 00:00:00` ist, wenn `bucket_width` eine Anzahl von Monaten oder gröberen Einheiten ist, sonst `2000-01-03 00:00:00`. Beachten Sie, dass `2000-01-03` ein Montag ist.
`try_strptime(text, format-list)`	Wandelt die Zeichenkette `text` in einen Zeitstempel um, indem die Formatstrings in der Liste nacheinander angewendet werden, bis einer gelingt. Gibt bei Misserfolg `NULL` zurück.
`try_strptime(text, format)`	Wandelt die Zeichenkette `text` gemäß dem Formatstring in einen Zeitstempel um. Gibt bei Misserfolg `NULL` zurück.

Es gibt außerdem eigene Extraktionsfunktionen für die Teilfelder.

Auf unendliche Daten angewendete Funktionen geben entweder dieselben unendlichen Daten zurück (z. B. greatest) oder NULL (z. B. date_part), je nachdem, was „Sinn ergibt“. Muss die Funktion die Teile des unendlichen Datums untersuchen, ist das Ergebnis in der Regel NULL.

`age(timestamp, timestamp)`

`age(timestamp)`

`ago(interval)`

| Beschreibung | Subtrahiert ein Intervall vom aktuellen Zeitstempel und gibt einen Zeitstempel in der Vergangenheit zurück. Entspricht current_timestamp - interval. | | Beispiel | ago(INTERVAL 1 HOUR) | | Ergebnis | 2024-11-30 12:28:48.895 (wenn die aktuelle Zeit 2024-11-30 13:28:48.895 ist) |

`century(timestamp)`

`current_localtimestamp()`

`date_diff(part, starttimestamp, endtimestamp)`

| Beschreibung | Die vorzeichenbehaftete Anzahl der part-Grenzen zwischen starttimestamp und endtimestamp, einschließlich des größeren und ausschließlich des kleineren Zeitstempels. | | Beispiel | date_diff('hour', TIMESTAMP '1992-09-30 23:59:59', TIMESTAMP '1992-10-01 01:58:00') | | Ergebnis | 2 |

`date_part([part, ...], timestamp)`

| Beschreibung | Holt die aufgeführten Teilfelder als struct. Die Liste muss konstant sein. | | Beispiel | date_part(['year', 'month', 'day'], TIMESTAMP '1992-09-20 20:38:40') | | Ergebnis | {year: 1992, month: 9, day: 20} |

`date_part(part, timestamp)`

`date_sub(part, starttimestamp, endtimestamp)`

| Beschreibung | Die vorzeichenbehaftete Länge des Intervalls zwischen starttimestamp und endtimestamp, auf ganze Vielfache von part gekürzt. | | Beispiel | date_sub('hour', TIMESTAMP '1992-09-30 23:59:59', TIMESTAMP '1992-10-01 01:58:00') | | Ergebnis | 1 |

`date_trunc(part, timestamp)`

`dayname(timestamp)`

`epoch_ms(timestamp)`

`epoch_ns(timestamp)`

`epoch_us(timestamp)`

`epoch(timestamp)`

Im Gegensatz zu epoch_ms, epoch_us und epoch_ns, die BIGINT zurückgeben, gibt epoch ein DOUBLE zurück und behält daher die Subsekundengenauigkeit.

`extract(field FROM timestamp)`

`greatest(timestamp, timestamp)`

`isfinite(timestamp)`

`isinf(timestamp)`

`julian(timestamp)`

`last_day(timestamp)`

`least(timestamp, timestamp)`

`make_timestamp(bigint, bigint, bigint, bigint, bigint, double)`

`make_timestamp(microseconds)`

`make_timestamp_ms(milliseconds)`

`make_timestamp_ns(nanoseconds)`

`monthname(timestamp)`

`strftime(timestamp, format)`

`strptime(text, format-list)`

| Beschreibung | Wandelt die Zeichenkette text in einen Zeitstempel um, indem die Formatstrings in der Liste nacheinander angewendet werden, bis einer gelingt. Wirft bei Misserfolg einen Fehler. Um bei Misserfolg NULL zurückzugeben, verwenden Sie try_strptime. | | Beispiel | strptime('4/15/2023 10:56:00', ['%d/%m/%Y %H:%M:%S', '%m/%d/%Y %H:%M:%S']) | | Ergebnis | 2023-04-15 10:56:00 |

`strptime(text, format)`

| Beschreibung | Wandelt die Zeichenkette text gemäß dem Formatstring in einen Zeitstempel um. Wirft bei Misserfolg einen Fehler. Um bei Misserfolg NULL zurückzugeben, verwenden Sie try_strptime. | | Beispiel | strptime('Wed, 1 January 1992 - 08:38:40 PM', '%a, %-d %B %Y - %I:%M:%S %p') | | Ergebnis | 1992-01-01 20:38:40 |

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

| Beschreibung | Kürzt timestamp auf ein Raster der Breite bucket_width. Das Raster enthält 2000-01-01 00:00:00[ + offset], wenn bucket_width eine Anzahl von Monaten oder gröberen Einheiten ist, sonst 2000-01-03 00:00:00[ + offset]. Beachten Sie, dass 2000-01-03 ein Montag ist. | | Beispiel | time_bucket(INTERVAL '10 minutes', TIMESTAMP '1992-04-20 15:26:00-07', INTERVAL '5 minutes') | | Ergebnis | 1992-04-20 15:25:00 |

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

| Beschreibung | Kürzt timestamp auf ein Raster der Breite bucket_width. Das Raster enthält den Zeitstempel origin, der standardmäßig 2000-01-01 00:00:00 ist, wenn bucket_width eine Anzahl von Monaten oder gröberen Einheiten ist, sonst 2000-01-03 00:00:00. Beachten Sie, dass 2000-01-03 ein Montag ist. | | Beispiel | time_bucket(INTERVAL '2 weeks', TIMESTAMP '1992-04-20 15:26:00', TIMESTAMP '1992-04-01 00:00:00') | | Ergebnis | 1992-04-15 00:00:00 |

`try_strptime(text, format-list)`

| Beschreibung | Wandelt die Zeichenkette text in einen Zeitstempel um, indem die Formatstrings in der Liste nacheinander angewendet werden, bis einer gelingt. Gibt bei Misserfolg NULL zurück. | | Beispiel | try_strptime('4/15/2023 10:56:00', ['%d/%m/%Y %H:%M:%S', '%m/%d/%Y %H:%M:%S']) | | Ergebnis | 2023-04-15 10:56:00 |

`try_strptime(text, format)`

| Beschreibung | Wandelt die Zeichenkette text gemäß dem Formatstring in einen Zeitstempel um. Gibt bei Misserfolg NULL zurück. | | Beispiel | try_strptime('Wed, 1 January 1992 - 08:38:40 PM', '%a, %-d %B %Y - %I:%M:%S %p') | | Ergebnis | 1992-01-01 20:38:40 |

Zeitstempel-Tabellenfunktionen

Die folgende Tabelle zeigt die verfügbaren Tabellenfunktionen für den Typ TIMESTAMP.

Name	Beschreibung
`generate_series(timestamp, timestamp, interval)`	Erzeugt eine Tabelle von Zeitstempeln im geschlossenen Bereich, in Schritten des Intervalls.
`range(timestamp, timestamp, interval)`	Erzeugt eine Tabelle von Zeitstempeln im halboffenen Bereich, in Schritten des Intervalls.

Unendliche Werte sind als Grenzen von Tabellenfunktionen nicht erlaubt.

`generate_series(timestamp, timestamp, interval)`

| Beschreibung | Erzeugt eine Tabelle von Zeitstempeln im geschlossenen Bereich, in Schritten des Intervalls. | | Beispiel | generate_series(TIMESTAMP '2001-04-10', TIMESTAMP '2001-04-11', INTERVAL 30 MINUTE) |

`range(timestamp, timestamp, interval)`

| Beschreibung | Erzeugt eine Tabelle von Zeitstempeln im halboffenen Bereich, in Schritten des Intervalls. | | Beispiel | range(TIMESTAMP '2001-04-10', TIMESTAMP '2001-04-11', INTERVAL 30 MINUTE) |