החזרת משתנה (ארוך) המציין את מספר מרווחי הזמן בין שני תאריכים שצוינו.
תחביר
DateDiff ( interval, date1, date2 [, firstdayofweek] [, השבוע הראשון בשנה] )
תחביר הפונקציה DateDiff מכיל את הארגומנטים הבאים:
|
ארגומנט |
תיאור |
|---|---|
|
interval |
נדרש. ביטוי מחרוזת שהוא מרווח הזמן שבו אתה משתמש לחישוב ההפרש בין תאריך1לתאריך2. |
|
תאריך1, תאריך2 |
נדרש. משתנה (תאריך). שני תאריכים שבהם ברצונך להשתמש בחישוב. |
|
היום הראשון בשבוע |
אופציונלי. תבנית קבוע המציינת את היום הראשון בשבוע. אם לא צוין, הפונקציה מניחה את יום ראשון. |
|
השבוע הראשון בשנה |
אופציונלי. קבוע המציין את השבוע הראשון בשנה. אם לא צוין, ההנחה היא שהשבוע הראשון הוא השבוע שבו חל 1 בינואר. |
הגדרות
מרווח הזמןארגומנט הגדרות אלה:
|
הגדרה |
תיאור |
|---|---|
|
yyyy |
שנה |
|
q |
רבעון |
|
m |
חודש |
|
y |
יום בשנה |
|
d |
יום |
|
W |
Weekday |
|
ww |
שבוע |
|
H |
שעה |
|
n |
דקה |
|
s |
שניה |
הארגומנט היום הראשון בשבוע כולל את ההגדרות הבאות:
|
קבוע |
Value |
תיאור |
|---|---|---|
|
vbUseSystem |
0 |
השתמש בהגדרת ה- API של NLS. |
|
vbSunday |
1 |
יום ראשון (ברירת מחדל) |
|
vbMonday |
2 |
שני |
|
יום שלישי של vb |
3 |
שלישי |
|
vbWednesday |
4 |
רביעי |
|
vbThursday |
5 |
חמישי |
|
יום שישי של vb |
6 |
שישי |
|
vbSaturday |
7 |
שבת |
|
קבוע |
Value |
תיאור |
|---|---|---|
|
vbUseSystem |
0 |
השתמש בהגדרת ה- API של NLS. |
|
vbFirstJan1 |
1 |
התחל משבוע שבו חל 1 בינואר (ברירת מחדל). |
|
vbFirstFourDays |
2 |
התחל מהשבוע הראשון הכולל לפחות ארבעה ימים בשנה החדשה. |
|
vbFirstFullWeek |
3 |
התחל מהשבוע המלא הראשון בשנה. |
הערות
באפשרותך להשתמש בפונקציה DateDiff כדי לקבוע כמה מרווחי זמן שצוינו קיימים בין שני תאריכים. לדוגמה, באפשרותך להשתמש ב- DateDiff כדי לחשב את מספר הימים בין שני תאריכים, או את מספר השבועות בין היום לסוף השנה.
כדי לחשב את מספר הימים בין תאריך1לתאריך2, באפשרותך להשתמש ביום בשנה ("y") או ביום ("d"). כאשר interval הוא Weekday ("w"), DateDiff מחזיר את מספר השבועות בין שני התאריכים. אם date1 נמצא ביום שני, DateDiff סופר את מספר ימי שני עד תאריך2. היא סופרת תאריך2 אך לא תאריך1. עם זאת , אם interval הוא Week ("ww"), הפונקציה DateDiff מחזירה את מספר השבועות קלנדריים בין שני התאריכים. היא סופרת את מספר ימי ראשון בין תאריך1לתאריך2. DateDiff סופר תאריך2 אם הוא נופל ביום ראשון; אך הוא אינו סופר תאריך1, גם אם הוא נופל ביום ראשון.
אם date1 מפנה לנקודה מאוחרת יותר ב- date2, הפונקציה DateDiff מחזירה מספר שלילי.
הארגומנט היום הראשון בשבוע משפיע על חישובים המשתמשים בסימני מרווחי הזמן "w" ו- "ww".
אם date1 או date2 הוא ליטרל תאריך, השנה שצוינה הופכת לחלק קבוע מתאריך זה. עם זאת, אם date1 או date2 מוקף במרכאות כפולות (" "), ואתה השמטת השנה, השנה הנוכחית נוספת לקוד שלך בכל פעם שהביטוי date1 או date2 מוערך. הדבר מאפשר לכתוב קוד שניתן להשתמש בו בשנים שונות.
בעת השוואת 31 בדצמבר ל- 1 בינואר של השנה הצליחה באופן מיידי, DateDiff עבור שנה ("yyyy") מחזיר 1, למרות שרק יום חלף.
הערה: עבור תאריך1ותאריך2, אם הגדרת המאפיין לוח שנה היא לועזית, התאריך שסופק חייב להיות לועזי. אם לוח השנה הוא איסלמי, התאריך שסופק חייב להיות איסלמי.
דוגמאות לשאילתת DateDiff
|
Expression |
תוצאות |
|---|---|
|
SELECT DateDiff("yyyy",#01/01/2010#,[DateofSale]) AS Expr1 FROM ProductSales; |
החזרת ההפרש בין תאריך2 לתאריך1 (שקול את התאריך1 כישן ביותר ותאריך2 כחדש ביותר) כמספר 'שנים'. תוצאה: הפרש בין הערכים בשדה "DateofSale" לבין התאריך "01/01/2010" כמספר 'שנים'. |
|
SELECT DateDiff("q",[DateofSale],Date()) AS DaysSinceSale FROM ProductSales; |
הפונקציה מחזירה את ההפרש בין תאריך המערכת לבין "DateofSale" כמספר 'רבעונים' (בהתבסס על שנת לוח שנה) ומציגה בעמודה "DaysSinceSale". מחזירה את ההפרש בין תאריך המערכת לבין "DateofSale" כמספר 'חודשים' ומציג בעמודה "DaysSinceSale". |
|
SELECT DateDiff("y",[DateofSale],Date()) AS DaysSinceSale FROM ProductSales; |
הפונקציה מחזירה את ההפרש בין תאריך המערכת לבין "DateofSale" כמספר 'ימים' ומציגה בעמודה "DaysSinceSale". |
|
SELECT DateDiff("d",[DateofSale],Date()) AS DaysSinceSale FROM ProductSales; |
הפונקציה מחזירה את ההפרש בין תאריך המערכת לבין "DateofSale" כמספר 'ימים' ומציגה בעמודה "DaysSinceSale". |
|
SELECT DateDiff("w",[DateofSale],Date()) AS DaysSinceSale FROM ProductSales; |
הפונקציה מחזירה את ההפרש בין תאריך המערכת לבין "DateofSale" כמספר ימי חול ומציגה בעמודה "DaysSinceSale". אם "DateofSale" נופל ביום שני, DateDiff סופר את מספר ימי שני עד לתאריך המערכת. היא סופרת את תאריך המערכת, אך לא את הערך ב- "DateofSale". |
|
SELECT DateDiff("ww",[DateofSale],Date()) AS DaysSinceSale FROM ProductSales; |
החזרת ההפרש בין תאריך המערכת לבין "DateofSale" כמספר "שבועות לוח שנה" ומציג בעמודה "DaysSinceSale". היא סופרת את ימי ראשון בין "DateofSale" לבין "תאריך מערכת". הוא יספור את תאריך המערכת אם הוא יורד ביום ראשון; אך הוא לא נחשב "DateofSale", גם אם הוא נופל ביום ראשון. |
|
SELECT DateDiff("h",[DateTime],Date()) AS DaysSinceSale FROM ProductSales; |
מחזירה את ההפרש בין תאריך המערכת לבין "DateTime" כמספר 'Hours' ומציג בעמודה "DaysSinceSale". |
|
SELECT DateDiff("n",[DateTime],Date()) AS DaysSinceSale FROM ProductSales; |
הפונקציה מחזירה את ההפרש בין תאריך המערכת לבין "DateTime" כמספר 'דקות' ומציגה בעמודה "DaysSinceSale". |
|
SELECT DateDiff("s",[DateTime],Date()) AS DaysSinceSale FROM ProductSales; |
הפונקציה מחזירה את ההפרש בין תאריך המערכת לבין "DateTime" כמספר 'שניות' ומציגה בעמודה "DaysSinceSale". |
דוגמה לביטוי
שימוש בפונקציה DateDiff בביטוי באפשרותך להשתמש בפונקציה DateDiff בכל מקום שבו ניתן להשתמש בביטויים. לדוגמה, נניח שיש לך טופס שבו אתה משתמש כדי למלא הזמנות של לקוחות. בטבלה Orders, יש לך שדה בשם ReceiveBefore המכיל את התאריך שבו הלקוח צריך לקבל את ההזמנה. באפשרותך להשתמש בפונקציה DateDiff עם תיבת טקסט בטופס כדי להציג את מספר הימים נותרו לפני שליחת ההזמנה.
בהנחה שיחלפו עשרה ימים כדי לשלוח הזמנה כלשהי, הגדר את המאפיין מקור פקד של תיבת הטקסט באופן הבא:
=DateDiff("d", Now(), [Orders].[ ReceiveBefore])-10
בעת פתיחת הטופס בתצוגת טופס, תיבת הטקסט מציגה את מספר הימים שבהם נותרו לפני שליחת ההזמנה. אם נותרו פחות מ- 10 ימים לפני שהלקוח צריך לקבל את ההזמנה, המספר בתיבת הטקסט שלילי ומציין כמה ימים מאוחר ההזמנה תישלח באופן מיידי.
דוגמה ל- VBA
שימוש בפונקציה DateDiff בקוד VBA
דוגמה זו משתמשת בפונקציה DateDiff כדי להציג את מספר הימים בין תאריך נתון להיום.
Dim TheDate As Date ' Declare variables.
Dim Msg
TheDate = InputBox("Enter a date")
Msg = "Days from today: " & DateDiff("d", Now, TheDate)
MsgBox Msg
