timestamp.get_timestamp

נתמך ב:

כללים חיפוש

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

תיאור

הפונקציה הזו מחזירה מחרוזת בפורמט YYYY-MM-DD, שמייצגת את היום שבו חותמת הזמן נמצאת.

• ‫unix_seconds הוא מספר שלם שמייצג את מספר השניות שעברו מאז ראשית זמן יוניקס (Unix epoch), כמו $e.metadata.event_timestamp.seconds, או placeholder שמכיל את הערך הזה.
• ‫timestamp_format הוא אופציונלי ומייצג מחרוזת של הפורמט של חותמת הזמן. אם לא מציינים ערך, ברירת המחדל היא %F %T. אפשר לציין את הפורמט באמצעות מחרוזת של פורמט תאריך ושעה או באמצעות אחת מיחידות הזמן הבאות: SECOND,‏ MINUTE,‏ HOUR,‏ DATE,‏ WEEK,‏ MONTH או YEAR. אפשרויות עיצוב נוספות מפורטות במאמר עיצוב רכיבים של תאריך ושעה
• השדה time_zone הוא אופציונלי ומכיל מחרוזת שמייצגת אזור זמן. אם לא מציינים ערך, ברירת המחדל היא GMT. אפשר לציין אזורי זמן באמצעות מחרוזות מילוליות. האפשרויות הן:
  • השם של מסד הנתונים של אזורי הזמן בפורמט IANA (TZ), לדוגמה, America/Los_Angeles. למידע נוסף, אפשר לעיין ברשימת אזורי הזמן במסד הנתונים tz ב-Wikipedia.
  • ההפרש מאזור הזמן UTC, בפורמט (+|-)H[H][:M[M]], לדוגמה: ‎"-08:00".

הערה: כדי לשמור על עקביות עם שנים בלוח השנה הגרגוריאני הרגיל, צריך תמיד להשתמש בפורמט ‎ %Y עם 4 ספרות. כדי למנוע שגיאות במיון, לא מומלץ להשתמש ב-‎ %y (2 digits)‎, ולא מומלץ להשתמש ב-‎ %G (ISO year)‎, כי התאריכים יכולים להשתנות ליד השנה החדשה בהתאם למחזור השבועי.

דוגמאות לtime_zone מפרטים תקינים שאפשר להעביר כארגומנט השני לפונקציות לחילוץ זמן:

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

סוגי נתונים של פרמטרים

‫INT, STRING, STRING

סוג הערך שמוחזר

STRING

דוגמאות קוד

דוגמה 1

בדוגמה הזו, הארגומנט time_zone מושמט, ולכן ברירת המחדל שלו היא GMT.

$ts = $e.metadata.collected_timestamp.seconds

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

דוגמה 2

בדוגמה הזו נעשה שימוש במחרוזת מילולית כדי להגדיר את time_zone.

$ts = $e.metadata.collected_timestamp.seconds

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

דוגמה 3

בדוגמה הזו נעשה שימוש במחרוזת מילולית כדי להגדיר את timestamp_format.

$ts = $e.metadata.collected_timestamp.seconds

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

דוגמה 4

בדוגמה הזו, חותמת זמן של Unix מעוצבת כמחרוזת ברמת דיוק של שנייה.

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

דוגמה 5

בדוגמה הזו, חותמת זמן של Unix מעוצבת כמחרוזת ברמת דיוק של דקה.

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

דוגמה 6

בדוגמה הזו, חותמת זמן של Unix מעוצבת כמחרוזת ברמת דיוק של שעה.

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

דוגמה 7

בדוגמה הזו, חותמת זמן של מערכת Unix מעוצבת כמחרוזת ברמת גרנולריות של יום.

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

דוגמה 8

בדוגמה הזו, חותמת זמן של Unix מעוצבת כמחרוזת ברמת גרנולריות של שבוע.

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

דוגמה 9

בדוגמה הזו, חותמת זמן של Unix מעוצבת כמחרוזת ברמת גרנולריות של חודש.

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

דוגמה 10

בדוגמה הזו, חותמת זמן של Unix מעוצבת כמחרוזת ברמת דיוק של שנה.

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