timestamp.get_date

נתמך ב:

כללים חיפוש

timestamp.get_date(unix_seconds [, time_zone])

תיאור

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

• ‫unix_seconds הוא מספר שלם שמייצג את מספר השניות שעברו מאז ראשית זמן יוניקס (Unix epoch), כמו $e.metadata.event_timestamp.seconds, או placeholder שמכיל את הערך הזה.
• השדה time_zone הוא אופציונלי ומכיל מחרוזת שמייצגת אזור זמן. אם לא מציינים את הפרמטר, ברירת המחדל היא GMT. אפשר לציין אזורי זמן באמצעות מחרוזות מילוליות. האפשרויות הן:
  • השם של מסד הנתונים של אזורי הזמן, למשל America/Los_Angeles. מידע נוסף זמין בעמודה שם מסד הנתונים של אזור הזמן בדף הזה.
  • ההפרש מאזור הזמן UTC, בפורמט(+|-)H[H][:M[M]], לדוגמה: ‎"-08:00".

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

"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

דוגמאות קוד

דוגמה 1

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

$ts = $e.metadata.collected_timestamp.seconds

timestamp.get_date($ts) = "2024-02-19"

דוגמה 2

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

$ts = $e.metadata.collected_timestamp.seconds

timestamp.get_date($ts, "America/Los_Angeles") = "2024-02-20"