Menu

timestamp מול timestamptz ב-PostgreSQL (עם אזור זמן)

timestamptz שומר רגע בזמן ומציג אותו באזור הזמן של ה-session; ‏timestamp שומר שעה של שעון קיר בלי אזור. אף אחד מהם לא שומר את האזור שכתבתם. השתמשו ב-timestamptz כמעט לכל דבר.

בדף הזה יש עורכים שאפשר להריץ. לערוך, להריץ ולראות את הפלט מיד.

ב-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 בתים.

איור של שפות התכנות ב-Coddy

ללמוד תכנות עם Coddy

להתחיל