DATETIME_TRUNC

חיתוך תאריך לרמת הפירוט שצוינה.

דוגמאות לשימוש

DATETIME_TRUNC(Order Date, MONTH)

תחביר

DATETIME_TRUNC( date_expression, part )

פרמטרים

‫date_expression – שדה או ביטוי של תאריך או של תאריך ושעה.

‫part – החלק של השעה שרוצים להחזיר. הפונקציה DATETIME_TRUNC תומכת בחלקים הבאים של השעה:

  • ‫MICROSECOND: זמין לשדות או לביטויים של תאריך ושעה.
  • ‫MILLISECOND: זמין לשדות או לביטויים של תאריך ושעה.
  • ‫SECOND: זמין לשדות או לביטויים של תאריך ושעה.
  • ‫MINUTE: זמין לשדות או לביטויים של תאריך ושעה.
  • ‫HOUR: זמין לשדות או לביטויים של תאריך ושעה.
  • DAY
  • ‫WEEK: החלק הזה של התאריך מתחיל ביום ראשון.
  • ‫ISOWEEK: משתמש בגבולות של שבוע ISO 8601. השבועות לפי תקן ISO מתחילים ביום שני.
  • MONTH
  • QUARTER
  • YEAR
  • ‫ISOYEAR: משתמש בגבולות של שנת מספור השבועות לפי ISO 8601. הגבול של שנת ISO הוא יום שני של השבוע הראשון שבו יום חמישי שייך לשנה המתאימה בלוח השנה הגרגוריאני.

סוג הנתונים שמוחזר

תאריך ושעה

דוגמאות

נוסחה לדוגמה תשובה
DATETIME_TRUNC(DATE '2008-12-25', MONTH) 2008-12-01 00:00:00
DATETIME_TRUNC(DATETIME "2008-12-25 15:30:00", DAY) 2008-12-25 00:00:00

בדוגמה הבאה, הביטוי המקורי date_expression הוא בשנה 2015 בלוח השנה הגרגוריאני. עם זאת, הפונקציה DATE_TRUNC עם החלק ISOYEAR של התאריך חותכת את הביטוי date_expression לתחילת השנה לפי תקן ISO, ולא לתחילת השנה לפי הלוח הגרגוריאני. יום חמישי הראשון בשנת 2015 היה 2015-01-01, ולכן שנת ISO 2015 מתחילה ביום שני הקודם, 2014-12-29. לכן, הגבול של שנת ISO שלפני date_expression ‏2015-06-15 הוא 2014-12-29.

נוסחה לדוגמה תשובה
DATE_TRUNC('2015-06-15', ISOYEAR) 2014-12-29
EXTRACT(ISOYEAR FROM DATETIME '2015-06-15') 2015

הערות

הפונקציה הזו לא זמינה לסוגי תאריכים במצב תאימות.