ב-PostgreSQL יש שני טיפוסי חותמות זמן. timestamptz (timestamp with time zone) שומר רגע מדויק: מומר ל-UTC בקלט, ומוצג באזור הזמן של ה-session בפלט. timestamp (timestamp without time zone) שומר תאריך ושעה של שעון קיר בלי אזור. אף אחד מהם לא שומר את האזור שכתבתם. לכל דבר שקרה בנקודה מסוימת בזמן, השתמשו ב-timestamptz.
אותו קלט נותן 2026-03-01 12:00:00 ו-2026-03-01 21:00:00+09. ערך ה-timestamptz הוא אותו רגע כמו קודם, שמוצג עכשיו בשעון טוקיו. לערך ה-timestamp אין אזור להמיר ממנו, ולכן הוא לא זז.
מה קורה לאזור זמן שבקלט
כשהקלט כולל היסט (offset), timestamptz משתמש בו כדי למצוא את הרגע. timestamp משמיט אותו בשקט:
plain הוא 2026-03-01 12:00:00, וה-+02 נזרק. with_zone הוא 2026-03-01 10:00:00+00, אותו רגע ב-UTC. כך זמנים יוצאים בהפרש של כמה שעות: אפליקציה שולחת מחרוזת ISO עם היסט לעמודת timestamp, וההיסט נעלם.
מתי להשתמש בכל אחד
| שימוש | טיפוס |
|---|---|
| נוצר, עודכן, שולם, התחבר | timestamptz |
| שעה מקומית מתוזמנת שהולכת לפי השעון המקומי ("9:00 כל יום באזור של המשתמש") | timestamp ועמודה עם שם האזור |
| יום בלוח השנה בלי שעה | date |
| משך זמן | interval |
שני הטיפוסים תופסים 8 בתים ושומרים מיקרו שניות. קבעו את האזור של ה-session עם SET TIME ZONE 'Europe/Paris'. השתמשו בשמות אזור מלאים, לא בקיצורים כמו EST: קיצור הוא היסט קבוע שמתעלם משעון קיץ.
המרה בין אזורים עם AT TIME ZONE
AT TIME ZONE עובד בשני הכיוונים. על timestamptz הוא מחזיר את שעת שעון הקיר באזור הזה, כ-timestamp. על timestamp הוא קורא את הערך כשעה מקומית באזור הזה ומחזיר את הרגע כ-timestamptz.
צהריים ב-UTC הם 08:00 בניו יורק ביולי, ו-9:00 בפריז הן 07:00 ב-UTC. השתמשו בצורה הראשונה כדי להציג זמן באזור של המשתמש, ובשנייה כדי להפוך שעה מקומית שהמשתמש הקליד לרגע בזמן.
שעון קיץ וחשבון עם interval
הוספה של interval '1 day' ל-timestamptz שומרת על אותה שעת שעון מקומית גם כשעוברים לשעון קיץ. הוספה של '24 hours' מוסיפה שעות מדויקות. בארצות הברית השעונים מוקדמים ב-8 במרץ 2026:
הראשון נותן 2026-03-08 12:00:00-04, והשני 2026-03-08 13:00:00-04. התוצאה תלויה באזור הזמן של ה-session, אז קבעו אותו במפורש בקוד שעושה חשבון של תאריכים.
הזמן הנוכחי
now() ו-current_timestamp מחזירים את זמן ההתחלה של הטרנזקציה הנוכחית כ-timestamptz, אותו ערך לכל שורה שפקודה נוגעת בה. clock_timestamp() מחזיר את הזמן האמיתי בכל קריאה. current_date מחזיר date, ו-localtimestamp מחזיר timestamp. עמודה טיפוסית היא created_at timestamptz NOT NULL DEFAULT now().
להמיר עמודת timestamp ל-timestamptz
אם עמודת timestamp קיימת מחזיקה זמנים ב-UTC, המירו אותה עם USING ... AT TIME ZONE 'UTC', כך שהערכים ייקראו כ-UTC ולא באזור של ה-session:
הערך עכשיו 2026-01-15 09:30:00+01, מוצג בשעון ברלין. השינוי כותב מחדש את הטבלה, אז בטבלה גדולה הריצו אותו בשעה שקטה (ALTER TABLE מסביר שינויי טיפוס). פונקציות כמו date_trunc, extract ו-age נמצאות בדף על פונקציות תאריך, ופרק טיפוסי התאריך והשעה מפרט את כל פורמטי הקלט.
שאלות נפוצות
האם timestamptz שומר את אזור הזמן ב-PostgreSQL?
לא. הוא ממיר את הקלט ל-UTC ושומר רק את הרגע הזה. האזור שכתבתם הולך לאיבוד; הפלט מוצג לפי ההגדרה TimeZone של ה-session. שמרו את שם האזור בעמודת text נפרדת אם תצטרכו אותו אחר כך.
מה ההבדל בין now() ל-clock_timestamp()?
now() (זהה ל-current_timestamp) מחזיר את זמן ההתחלה של הטרנזקציה הנוכחית, ולכן הוא נשאר זהה לכל שורה ולכל פקודה בתוכה. clock_timestamp() מחזיר את הזמן האמיתי ברגע הקריאה ומשתנה גם בתוך פקודה אחת.
איך מקבלים את התאריך של היום ב-PostgreSQL?
current_date מחזיר את התאריך של היום באזור הזמן של ה-session. now()::date נותן אותו דבר, ו-localtimestamp מחזיר את התאריך והשעה הנוכחיים כ-timestamp בלי אזור.
כמה מקום תופס timestamp ב-PostgreSQL?
8 בתים גם ל-timestamp וגם ל-timestamptz, ברזולוציה של מיקרו שנייה. date תופס 4 בתים.