timestamp.get_week

נתמך ב:

כללים חיפוש

timestamp.get_week(unix_seconds [, time_zone])

תיאור

הפונקציה הזו מחזירה מספר שלם בטווח [0, 53] שמייצג את השבוע בשנה. השבוע מתחיל ביום ראשון. תאריכים שלפני יום ראשון הראשון של השנה הם בשבוע 0.

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

דוגמאות ל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

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

INT

דוגמאות קוד

דוגמה 1

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

$ts = $e.metadata.collected_timestamp.seconds

timestamp.get_week($ts) = 0

דוגמה 2

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

$ts = $e.metadata.collected_timestamp.seconds

timestamp.get_week($ts, "America/Los_Angeles") = 0