DATETIME_SUB

מחסירה מרווח זמן שצוין מתאריך.

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

DATETIME_SUB(Order Date, INTERVAL 1 WEEK)

תחביר

DATETIME_SUB( datetime_expression, INTERVAL integer part )

פרמטרים

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

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

תאריך ושעה

דוגמאות

נוסחה לדוגמה תשובה
DATETIME_SUB(DATETIME "2008-12-25 15:30:00", INTERVAL 10 MINUTE) 2008-12-25 15:20:00
DATETIME_SUB(DATE "2008-12-25", INTERVAL 5 DAY) 2008-12-20

הערות

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

נדרש טיפול מיוחד בחלקים MONTH,‏ QUARTER ו-YEAR כשהתאריך הוא ביום האחרון של החודש (או קרוב אליו). אם בחודש שמתקבל יש פחות ימים מהיום בתאריך המקורי או בתאריך ובשעה המקוריים, היום שמתקבל הוא היום האחרון בחודש החדש.