timestamp.get_timestamp

Compatible avec :

Règles Rechercher

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

Description

Cette fonction renvoie une chaîne au format YYYY-MM-DD, représentant le jour auquel appartient un code temporel.

• unix_seconds est un entier représentant le nombre de secondes écoulées depuis l'époque Unix, comme $e.metadata.event_timestamp.seconds, ou un espace réservé contenant cette valeur.
• timestamp_format est facultatif et correspond à une chaîne représentant le format de l'horodatage. Si aucune valeur n'est spécifiée, la valeur par défaut est %F %T. Vous pouvez spécifier le format à l'aide d'une chaîne de format de date et d'heure ou de l'une des granularités temporelles suivantes : SECOND, MINUTE, HOUR, DATE, WEEK, MONTH ou YEAR. Pour plus d'options de mise en forme, consultez Mettre en forme les éléments des parties date et heure.
• time_zone est facultatif et correspond à une chaîne représentant un fuseau horaire. Si aucune valeur n'est spécifiée, la valeur par défaut est GMT. Vous pouvez spécifier des fuseaux horaires à l'aide de littéraux de chaîne. Vous disposez des options suivantes :
  • Nom de la base de données des fuseaux horaires IANA (TZ), par exemple America/Los_Angeles. Pour en savoir plus, consultez la liste des fuseaux horaires de la base de données tz sur Wikipédia.
  • Décalage du fuseau horaire par rapport à l'heure UTC, au format (+|-)H[H][:M[M]], par exemple "-08:00".

Voici des exemples de spécificateurs time_zone valides que vous pouvez transmettre en tant que deuxième argument aux fonctions d'extraction de l'heure :

"America/Los_Angeles", or "-08:00". ("PST" is not supported)
"America/New_York", or "-05:00". ("EST" is not supported)
"Europe/London"
"UTC"
"GMT"

Types de données des paramètres

INT, STRING, STRING

Type renvoyé

STRING

Exemples de code

Exemple 1

Dans cet exemple, l'argument time_zone est omis. Il est donc défini par défaut sur GMT.

$ts = $e.metadata.collected_timestamp.seconds

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

Exemple 2

Cet exemple utilise un littéral de chaîne pour définir le time_zone.

$ts = $e.metadata.collected_timestamp.seconds

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

Exemple 3

Cet exemple utilise un littéral de chaîne pour définir le timestamp_format.

$ts = $e.metadata.collected_timestamp.seconds

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

Exemple 4

Cet exemple met en forme un code temporel Unix sous forme de chaîne avec une précision à la seconde.

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

Exemple 5

Cet exemple met en forme un horodatage Unix sous forme de chaîne à la minute près.

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

Exemple 6

Cet exemple formate un code temporel Unix sous forme de chaîne avec une précision à l'heure près.

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

Exemple 7

Cet exemple met en forme un code temporel Unix sous forme de chaîne avec une précision au jour près.

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

Exemple 8

Cet exemple formate un code temporel Unix sous forme de chaîne avec une précision hebdomadaire.

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

Exemple 9

Cet exemple met en forme un horodatage Unix sous forme de chaîne avec une précision au mois près.

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

Exemple 10

Cet exemple formate un code temporel Unix sous forme de chaîne avec une précision annuelle.

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