timestamp.get_timestamp

Supportato in:
timestamp.get_timestamp(unix_seconds, optional timestamp_format/time_granularity, 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'epoca 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 una stringa di formato data/ora o una delle seguenti granularità temporali: SECOND, MINUTE, HOUR, DATE, WEEK, MONTH o YEAR. Per altre opzioni di formattazione, vedi Elementi di formato per le parti di data e ora.
  • time_zone è facoltativo ed è una stringa che rappresenta un fuso orario. Se omesso, il valore predefinito è GMT. Puoi specificare i fusi orari utilizzando i valori letterali 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 al fuso orario UTC, nel formato (+|-)H[H][:M[M]], ad esempio: "-08:00".

Ecco alcuni esempi di specificatori time_zone validi, che puoi passare come secondo argomento alle funzioni di estrazione dell'ora:

"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 dei parametri

INT, STRING, STRING

Tipo restituito

STRING

Esempi di codice

Esempio 1

In questo esempio, l'argomento time_zone viene omesso, quindi 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 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 stringa per definire timestamp_format.

$ts = $e.metadata.collected_timestamp.seconds

timestamp.get_timestamp($ts, "%Y-%m", "GMT") = "2024-02"
Esempio 4

Questo esempio formatta un timestamp Unix come stringa con una granularità di un secondo.

timestamp.get_timestamp(1708598631, "SECOND", "GMT") = "2024-02-22 10:43:51"
Esempio 5

Questo esempio formatta un timestamp Unix come stringa con granularità al minuto.

timestamp.get_timestamp(1708598631, "MINUTE", "GMT") = "2024-02-22 10:43"
Esempio 6

Questo esempio formatta un timestamp Unix come stringa con granularità oraria.

timestamp.get_timestamp(1708598631, "HOUR", "GMT") = "2024-02-22 10"
Esempio 7

Questo esempio formatta un timestamp Unix come stringa con granularità giornaliera.

timestamp.get_timestamp(1708598631, "DATE", "GMT") = "2024-02-22"
Esempio 8

Questo esempio formatta un timestamp Unix come stringa con granularità settimanale.

timestamp.get_timestamp(1708598631, "WEEK", "GMT") = "2024-02-18"
Esempio 9

Questo esempio formatta un timestamp Unix come stringa con granularità mensile.

timestamp.get_timestamp(1708598631, "MONTH", "GMT") = "2024-02"
Esempio 10

Questo esempio formatta un timestamp Unix come stringa con granularità annuale.

timestamp.get_timestamp(1708598631, "YEAR", "GMT") = "2024"