timestamp.get_timestamp

Compatível com:

Regras Pesquisa

timestamp.get_timestamp(unix_seconds, optional timestamp_format/time_granularity, optional timezone)

Descrição

Essa função retorna uma string no formato YYYY-MM-DD, representando o dia em que um carimbo de data/hora está.

• unix_seconds é um número inteiro que representa o número de segundos desde a época do Unix, como $e.metadata.event_timestamp.seconds, ou um marcador de posição que contém esse valor.
• timestamp_format é opcional e é uma string que representa o formato do carimbo de data/hora. Se omitido, o padrão é %F %T. É possível especificar o formato usando uma string de formato de data e hora ou uma das seguintes granularidades de tempo: SECOND, MINUTE, HOUR, DATE, WEEK, MONTH ou YEAR. Para mais opções de formatação, consulte Formatar elementos para partes de data e hora.
• time_zone é opcional e é uma string que representa um fuso horário. Se omitido, o padrão será GMT. É possível especificar fusos horários usando literais de string. As opções são:
  • O nome do banco de dados de fuso horário (TZ) da IANA. Por exemplo, America/Los_Angeles. Para mais informações, consulte a lista de fusos horários do banco de dados tz na Wikipédia.
  • O ajuste do fuso horário em relação ao UTC, no formato (+|-)H[H][:M[M]], por exemplo, "-08:00".

Confira exemplos de especificadores time_zone válidos, que podem ser transmitidos como o segundo argumento para funções de extração de 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"

Tipos de dados de parâmetros

INT, STRING, STRING

Tipo de retorno

STRING

Amostras de código

Exemplo 1

Neste exemplo, o argumento time_zone é omitido, então o padrão é GMT.

$ts = $e.metadata.collected_timestamp.seconds

timestamp.get_timestamp($ts) = "2024-02-22 10:43:51"

Exemplo 2

Este exemplo usa uma string literal para definir o time_zone.

$ts = $e.metadata.collected_timestamp.seconds

timestamp.get_timestamp($ts, "%F %T", "America/Los_Angeles") = "2024-02-22 10:43:51"

Exemplo 3

Este exemplo usa uma string literal para definir o timestamp_format.

$ts = $e.metadata.collected_timestamp.seconds

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

Exemplo 4

Este exemplo formata um carimbo de data/hora do Unix como uma string com granularidade de segundo.

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

Example 5

Este exemplo formata um carimbo de data/hora do Unix como uma string com granularidade de minutos.

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

Exemplo 6

Este exemplo formata um carimbo de data/hora Unix como uma string com granularidade de hora.

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

Exemplo 7

Este exemplo formata um carimbo de data/hora Unix como uma string com granularidade diária.

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

Exemplo 8

Este exemplo formata um carimbo de data/hora do Unix como uma string com granularidade semanal.

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

Exemplo 9

Este exemplo formata um carimbo de data/hora Unix como uma string na granularidade mensal.

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

Exemplo 10

Este exemplo formata um carimbo de data/hora Unix como uma string na granularidade anual.

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