timestamp.get_week

Supportato in:
timestamp.get_week(unix_seconds [, time_zone])

Descrizione

Questa funzione restituisce un numero intero nell'intervallo [0, 53] che rappresenta la settimana dell'anno. Le settimane iniziano di domenica. Le date antecedenti la prima domenica dell'anno rientrano nella settimana 0.

  • unix_seconds è un numero intero che rappresenta il numero di secondi trascorsi dall'epoca di Unix, ad esempio $e.metadata.event_timestamp.seconds, o un segnaposto contenente questo valore.
  • 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:
    • Il nome del database TZ, ad esempio "America/Los_Angeles". Per saperne di più, consulta la colonna "Nome database TZ" di questa pagina.
    • L'offset del fuso orario rispetto al fuso orario UTC, nel formato(+|-)H[H][:M[M]], ad esempio: "-08:00".

Ecco alcuni esempi di identificatori 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

Tipo restituito

INT

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_week($ts) = 0
Esempio 2

Questo esempio utilizza un valore letterale stringa per definire time_zone.

$ts = $e.metadata.collected_timestamp.seconds

timestamp.get_week($ts, "America/Los_Angeles") = 0