timestamp.get_timestamp
timestamp.get_timestamp(unix_seconds, optional timestamp_format, optional timezone)
Description
Cette fonction renvoie une chaîne au format YYYY-MM-DD
, représentant le jour d'un code temporel.
unix_seconds
est un entier représentant le nombre de secondes après l'époque Unix, comme$e.metadata.event_timestamp.seconds
, ou un espace réservé contenant cette valeur.timestamp_format
est facultatif. Il s'agit d'une chaîne représentant le format du du code temporel. Si aucune valeur n'est spécifiée, la valeur par défaut est%F %T
. Vous pouvez spécifier le format à l'aide de littéraux de chaîne. Pour en savoir plus, consultez Mettre en forme les éléments des parties date et heure.time_zone
est facultatif et est une chaîne représentant un fuseau horaire. Si est omis, la valeur par défaut estGMT
. Vous pouvez spécifier des fuseaux horaires à l'aide de littéraux de chaîne. Les options sont les suivantes:- Nom de la base de données des fuseaux horaires (TZ) IANA, par exemple
America/Los_Angeles
. Pour plus consultez la liste des fuseaux horaires de la base de données tz sur Wikipédia. - Décalage horaire par rapport à l'heure UTC, au format
(+|-)H[H][:M[M]]
, par exemple : "-08:00".
- Nom de la base de données des fuseaux horaires (TZ) IANA, par exemple
Voici des exemples de spécificateurs time_zone
valides que vous pouvez transmettre en tant que deuxième argument aux fonctions d'extraction de temps :
"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
et STRING
Type renvoyé
STRING
Exemples de code
Exemple 1
Dans cet exemple, l'argument time_zone
est omis. La valeur par défaut est donc 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 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 timestamp_format
.
$ts = $e.metadata.collected_timestamp.seconds
timestamp.get_timestamp($ts, "%Y-%m", "GMT") = "2024-02"