Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
timestamp.as_unix_seconds
timestamp.as_unix_seconds(timestamp [, time_zone])
Description
Cette fonction renvoie un entier représentant le nombre de secondes écoulées depuis l'epoch Unix pour la chaîne d'horodatage donnée.
timestamp est une chaîne représentant un code temporel Unix valide. Le format doit être %F %T.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 :
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
STRING – STRING
Type renvoyé
INT
Exemples de code
Exemple 1
Code temporel epoch valide
timestamp.as_unix_seconds("2024-02-22 10:43:00") = 1708598580
Exemple 2
Code temporel Unix valide avec le fuseau horaire America/New_York
timestamp.as_unix_seconds("2024-02-22 10:43:00", "America/New_York") = 1708616580
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/29 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/07/29 (UTC)."],[[["\u003cp\u003eThis function, \u003ccode\u003etimestamp.as_unix_seconds\u003c/code\u003e, converts a given timestamp string into the number of seconds past the Unix epoch.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003etimestamp\u003c/code\u003e input must be a string in the \u003ccode\u003e%F %T\u003c/code\u003e format, while the optional \u003ccode\u003etime_zone\u003c/code\u003e input is a string representing a time zone, defaulting to GMT if omitted.\u003c/p\u003e\n"],["\u003cp\u003eValid \u003ccode\u003etime_zone\u003c/code\u003e formats include TZ database names like "America/Los_Angeles" or offsets like "-08:00", but abbreviations such as "PST" are not supported.\u003c/p\u003e\n"],["\u003cp\u003eThe function's return type is an integer (\u003ccode\u003eINT\u003c/code\u003e) and it is supported in both Rules and Search functionalities.\u003c/p\u003e\n"]]],[],null,["### timestamp.as_unix_seconds\n\nSupported in: \n[Rules](/chronicle/docs/detection/default-rules) [Search](/chronicle/docs/investigation/udm-search) \n\n timestamp.as_unix_seconds(timestamp [, time_zone])\n\n#### Description\n\nThis function returns an integer representing the number of seconds past a Unix epoch for the given timestamp string.\n\n- `timestamp` is a string representing a valid epoch timestamp. The format needs to be `%F %T`.\n- `time_zone` is optional and is a string representing a time zone. If omitted, the default is `GMT`. You can specify time zones using string literals. The options are as follows:\n - The TZ database name, for example `America/Los_Angeles`. For more information, see the [list of tz database time zones on Wikipedia](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).\n - The time zone offset from UTC, in the format`(+|-)H[H][:M[M]]`, for example: \"-08:00\".\n\nHere are examples of valid `time_zone` specifiers, which you can pass as the second argument to time extraction functions: \n\n \"America/Los_Angeles\", or \"-08:00\". (\"PST\" is not supported)\n \"America/New_York\", or \"-05:00\". (\"EST\" is not supported)\n \"Europe/London\"\n \"UTC\"\n \"GMT\"\n\n#### Param data types\n\n`STRING`, `STRING`\n\n#### Return type\n\n`INT`\n\n#### Code samples\n\n##### Example 1\n\nValid epoch timestamp \n\n timestamp.as_unix_seconds(\"2024-02-22 10:43:00\") = 1708598580\n\n##### Example 2\n\nValid epoch timestamp with the America/New_York time zone \n\n timestamp.as_unix_seconds(\"2024-02-22 10:43:00\", \"America/New_York\") = 1708616580"]]
