timestamp.get_timestamp
timestamp.get_timestamp(unix_seconds, optional timestamp_format/time_granularity, optional timezone)
Descripción
Esta función devuelve una cadena con el formato YYYY-MM-DD
, que representa el día en el que se encuentra una marca de tiempo.
unix_seconds
es un número entero que representa la cantidad de segundos transcurridos desde la época de Unix, como$e.metadata.event_timestamp.seconds
, o un marcador de posición que contiene ese valor.timestamp_format
es opcional y es una cadena que representa el formato de la marca de tiempo. Si se omite, el valor predeterminado es%F %T
. Puedes especificar el formato con una cadena de formato de fecha y hora o con una de las siguientes granularidades de tiempo:SECOND
,MINUTE
,HOUR
,DATE
,WEEK
,MONTH
oYEAR
. Para ver más opciones de formato, consulta Elementos de formato para partes de fecha y horatime_zone
es opcional y es una cadena que representa una zona horaria. Si se omite, el valor predeterminado esGMT
. Puedes especificar zonas horarias con literales de cadena. Las opciones son las siguientes:- Nombre de la base de datos de zona horaria (TZ) de IANA, por ejemplo,
America/Los_Angeles
. Para obtener más información, consulta la lista de zonas horarias de la base de datos tz en Wikipedia. - Es el desplazamiento de zona horaria desde UTC, en el formato
(+|-)H[H][:M[M]]
, por ejemplo, "-08:00".
- Nombre de la base de datos de zona horaria (TZ) de IANA, por ejemplo,
Estos son ejemplos de especificadores de time_zone
válidos que puedes pasar como segundo argumento a 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
, STRING
Tipo de datos que se muestra
STRING
Muestras de código
Ejemplo 1
En este ejemplo, se omite el argumento time_zone
, por lo que se establece de forma predeterminada en GMT
.
$ts = $e.metadata.collected_timestamp.seconds
timestamp.get_timestamp($ts) = "2024-02-22 10:43:51"
Ejemplo 2
En este ejemplo, se usa un literal de cadena para definir el time_zone
.
$ts = $e.metadata.collected_timestamp.seconds
timestamp.get_timestamp($ts, "%F %T", "America/Los_Angeles") = "2024-02-22 10:43:51"
Ejemplo 3
En este ejemplo, se usa un literal de cadena para definir el timestamp_format
.
$ts = $e.metadata.collected_timestamp.seconds
timestamp.get_timestamp($ts, "%Y-%m", "GMT") = "2024-02"
Ejemplo 4
En este ejemplo, se da formato a una marca de tiempo de Unix como una cadena con una granularidad de segundos.
timestamp.get_timestamp(1708598631, "SECOND", "GMT") = "2024-02-22 10:43:51"
Ejemplo 5
En este ejemplo, se da formato a una marca de tiempo de Unix como una cadena con un nivel de detalle por minuto.
timestamp.get_timestamp(1708598631, "MINUTE", "GMT") = "2024-02-22 10:43"
Ejemplo 6
En este ejemplo, se da formato a una marca de tiempo de Unix como una cadena con una granularidad de horas.
timestamp.get_timestamp(1708598631, "HOUR", "GMT") = "2024-02-22 10"
Ejemplo 7
En este ejemplo, se le da formato a una marca de tiempo Unix como una cadena con granularidad diaria.
timestamp.get_timestamp(1708598631, "DATE", "GMT") = "2024-02-22"
Ejemplo 8
En este ejemplo, se da formato a una marca de tiempo de Unix como una cadena con una granularidad semanal.
timestamp.get_timestamp(1708598631, "WEEK", "GMT") = "2024-02-18"
Ejemplo 9
En este ejemplo, se da formato a una marca de tiempo de Unix como una cadena con una granularidad mensual.
timestamp.get_timestamp(1708598631, "MONTH", "GMT") = "2024-02"
Ejemplo 10
En este ejemplo, se da formato a una marca de tiempo de Unix como una cadena con una granularidad anual.
timestamp.get_timestamp(1708598631, "YEAR", "GMT") = "2024"