DATETIME_ADD

הפונקציה מוסיפה מרווח זמן שצוין לתאריך או לתאריך ולשעה.

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

DATETIME_ADD(Order Date, INTERVAL 1 WEEK)

תחביר

DATETIME_ADD( 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_ADD(DATETIME "2023-01-25 15:30:00", INTERVAL 10 MINUTE)

‫25 בינואר 2023, 15:40:00

DATETIME_ADD(DATE "2023-01-25", INTERVAL 5 DAY)

‫30 בינואר 2023, 00:00:00

הערות

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

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

לדוגמה, אם Date = 31 באוגוסט 2020, הפונקציה DATETIME_ADD(Date, INTERVAL 1 MONTH) מחזירה את התאריך 30 בספטמבר 2020.