timestamp.get_timestamp
timestamp.get_timestamp(unix_seconds, optional timestamp_format, optional timezone)
Descrizione
Questa funzione restituisce una stringa nel formato YYYY-MM-DD
, che rappresenta il giorno in cui si trova un timestamp.
unix_seconds
è un numero intero che rappresenta il numero di secondi trascorsi dall'epoch di Unix, ad esempio$e.metadata.event_timestamp.seconds
, o un segnaposto contenente questo valore.timestamp_format
è facoltativo ed è una stringa che rappresenta il formato del timestamp. Se omesso, il valore predefinito è%F %T
. Puoi specificare il formato utilizzando stringhe letterali. Per le opzioni, vedi Formattare gli elementi per le parti di data e oratime_zone
è facoltativo ed è una stringa che rappresenta un fuso orario. Se viene omesso, il valore predefinito èGMT
. Puoi specificare i fusi orari utilizzando litterali di stringa. Le opzioni sono le seguenti:- Il nome del database IANA Time Zone (TZ), ad esempio
America/Los_Angeles
. Per ulteriori informazioni, consulta l'elenco dei fusi orari del database tz su Wikipedia. - L'offset del fuso orario rispetto a UTC, nel formato
(+|-)H[H][:M[M]]
, ad esempio: "-08:00".
- Il nome del database IANA Time Zone (TZ), ad esempio
Di seguito sono riportati alcuni esempi di specificatori time_zone
validi, che puoi passare come secondo argomento alle funzioni di estrazione del tempo:
"America/Los_Angeles", or "-08:00". ("PST" is not supported)
"America/New_York", or "-05:00". ("EST" is not supported)
"Europe/London"
"UTC"
"GMT"
Tipi di dati Param
INT
, STRING
, STRING
Tipo restituito
STRING
Esempi di codice
Esempio 1
In questo esempio, l'argomento time_zone
viene omesso, quindi viene impostato il valore predefinito GMT
.
$ts = $e.metadata.collected_timestamp.seconds
timestamp.get_timestamp($ts) = "2024-02-22 10:43:51"
Esempio 2
Questo esempio utilizza un valore letterale di stringa per definire time_zone
.
$ts = $e.metadata.collected_timestamp.seconds
timestamp.get_timestamp($ts, "%F %T", "America/Los_Angeles") = "2024-02-22 10:43:51"
Esempio 3
Questo esempio utilizza un valore letterale di stringa per definire timestamp_format
.
$ts = $e.metadata.collected_timestamp.seconds
timestamp.get_timestamp($ts, "%Y-%m", "GMT") = "2024-02"