timestamp.get_day_of_week
timestamp.get_day_of_week(unix_seconds [, time_zone])
Descripción
Esta función devuelve un número entero del intervalo [1, 7]
que representa el día de la semana, empezando por el domingo. Por ejemplo, 1 = domingo y 2 = lunes.
unix_seconds
es un número entero que representa el número de segundos transcurridos desde el inicio del registro de tiempo Unix, como$e.metadata.event_timestamp.seconds
, o un marcador de posición que contiene ese valor.time_zone
es opcional y es una cadena que representa una zona horaria. Si se omite, el valor predeterminado es "GMT". Puedes especificar zonas horarias mediante literales de cadena. Las opciones son las siguientes:- El nombre de la base de datos de zonas horarias, por ejemplo, "America/Los_Angeles". Para obtener más información, consulta la columna"Nombre de la base de datos de zonas horarias" de esta página.
- El desfase de la zona horaria con respecto a UTC, en formato
(+|-)H[H][:M[M]]
. Por ejemplo: "-08:00".
A continuación, se muestran ejemplos de especificadores de time_zone válidos que puede usar como segundo argumento de las funciones de extracción de tiempo:
"America/Los_Angeles", or "-08:00". ("PST" is not supported)
"America/New_York", or "-05:00". ("EST" is not supported)
"Europe/London"
"UTC"
"GMT"
Tipos de datos de parámetros
INT
, STRING
Tipo de devolución
INT
Códigos de ejemplo
Ejemplo 1
En este ejemplo, se omite el argumento time_zone
, por lo que se utiliza el valor predeterminado "GMT".
$ts = $e.metadata.collected_timestamp.seconds
timestamp.get_day_of_week($ts) = 6
Ejemplo 2
En este ejemplo se usa un literal de cadena para definir el time_zone
.
$ts = $e.metadata.collected_timestamp.seconds
timestamp.get_day_of_week($ts, "America/Los_Angeles") = 6