timestamp.get_timestamp
timestamp.get_timestamp(unix_seconds, optional timestamp_format/time_granularity, optional timezone)
Beschreibung
Diese Funktion gibt einen String im Format YYYY-MM-DD
zurück, der den Tag angibt, an dem sich ein Zeitstempel befindet.
unix_seconds
ist eine Ganzzahl, die die Anzahl der Sekunden seit der Unix-Epoche darstellt, z. B.$e.metadata.event_timestamp.seconds
, oder ein Platzhalter, der diesen Wert enthält.timestamp_format
ist optional und ein String, der das Format für den Zeitstempel darstellt. Wenn keine Angabe gemacht wird, lautet der Standardwert%F %T
. Sie können das Format mit einem Datums-/Zeitformatstring oder einer der folgenden Zeitgranularitäten angeben:SECOND
,MINUTE
,HOUR
,DATE
,WEEK
,MONTH
oderYEAR
. Weitere Formatierungsoptionen finden Sie unter Elemente für Datums- und Uhrzeitangaben formatieren.time_zone
ist optional und ein String, der eine Zeitzone darstellt. Wenn keine Angabe gemacht wird, lautet der StandardwertGMT
. Sie können Zeitzonen mit Stringliteralen angeben. Folgende Optionen sind verfügbar:- Der Name der IANA-Zeitzonendatenbank (TZ), z. B.
America/Los_Angeles
. Weitere Informationen finden Sie in der Liste der Zeitzonen in der tz-Datenbank bei Wikipedia. - Der Zeitzonenversatz von UTC im Format
(+|-)H[H][:M[M]]
, z. B. „-08:00“.
- Der Name der IANA-Zeitzonendatenbank (TZ), z. B.
Hier sind Beispiele für gültige time_zone
-Spezifizierer, die Sie als zweites Argument an Funktionen zur Zeitextraktion übergeben können:
"America/Los_Angeles", or "-08:00". ("PST" is not supported)
"America/New_York", or "-05:00". ("EST" is not supported)
"Europe/London"
"UTC"
"GMT"
Parameterdatentypen
INT
, STRING
, STRING
Rückgabetyp
STRING
Codebeispiele
Beispiel 1
In diesem Beispiel wird das Argument time_zone
weggelassen. Es wird also standardmäßig auf GMT
gesetzt.
$ts = $e.metadata.collected_timestamp.seconds
timestamp.get_timestamp($ts) = "2024-02-22 10:43:51"
Beispiel 2
In diesem Beispiel wird ein Stringliteral verwendet, um die time_zone
zu definieren.
$ts = $e.metadata.collected_timestamp.seconds
timestamp.get_timestamp($ts, "%F %T", "America/Los_Angeles") = "2024-02-22 10:43:51"
Beispiel 3
In diesem Beispiel wird ein Stringliteral verwendet, um die timestamp_format
zu definieren.
$ts = $e.metadata.collected_timestamp.seconds
timestamp.get_timestamp($ts, "%Y-%m", "GMT") = "2024-02"
Beispiel 4
In diesem Beispiel wird ein Unix-Zeitstempel als String mit einer Granularität von Sekunden formatiert.
timestamp.get_timestamp(1708598631, "SECOND", "GMT") = "2024-02-22 10:43:51"
Beispiel 5
In diesem Beispiel wird ein Unix-Zeitstempel als String mit einer Granularität von einer Minute formatiert.
timestamp.get_timestamp(1708598631, "MINUTE", "GMT") = "2024-02-22 10:43"
Beispiel 6
In diesem Beispiel wird ein Unix-Zeitstempel als String mit einer Granularität von einer Stunde formatiert.
timestamp.get_timestamp(1708598631, "HOUR", "GMT") = "2024-02-22 10"
Beispiel 7
In diesem Beispiel wird ein Unix-Zeitstempel mit dem Detaillierungsgrad „Tag“ als String formatiert.
timestamp.get_timestamp(1708598631, "DATE", "GMT") = "2024-02-22"
Beispiel 8
In diesem Beispiel wird ein UNIX-Zeitstempel als String auf Wochenbasis formatiert.
timestamp.get_timestamp(1708598631, "WEEK", "GMT") = "2024-02-18"
Beispiel 9
In diesem Beispiel wird ein Unix-Zeitstempel als String auf Monatsebene formatiert.
timestamp.get_timestamp(1708598631, "MONTH", "GMT") = "2024-02"
Beispiel 10
In diesem Beispiel wird ein UNIX-Zeitstempel als String auf Jahresebene formatiert.
timestamp.get_timestamp(1708598631, "YEAR", "GMT") = "2024"