הפונקציה DateDiff

חשוב: מאמר זה תורגם בתרגום מכונה, ראה כתב ויתור. תוכל למצוא את הגרסה באנגלית של המאמר כאן לעיונך.

החזרת משתנה (‏ארוך) המציין את מספר מרווחי הזמן בין שני תאריכים שצוינו.

לקבלת דוגמאות

תחביר

DateDiff ( מרווח זמן, תאריך1, תאריך2 [, היום הראשון בשבוע] [, השבוע הראשון בשנה] )

תחביר הפונקציה DateDiff כולל את הארגומנטים הבאים:

עצה: ב- Access 2010, בונה הביטויים מכיל IntelliSense, כך שתוכל לראות אילו הארגומנטים דורש את הביטוי שלך.

ארגומנט

תיאור

מרווח זמן

נדרש. ביטוי מחרוזת שהוא מרווח הזמן שהמשמש לחישוב ההפרש בין תאריך1 לבין תאריך2.

תאריך1, תאריך2

נדרש. משתנה (תאריך). שני תאריכים שבה ברצונך להשתמש בחישוב.

היום הראשון בשבוע

אופציונלי. קבוע המציין את היום הראשון בשבוע. אם לא צוין, ההנחה היא יום ראשון.

השבוע הראשון בשנה

אופציונלי. קבוע המציין את השבוע הראשון בשנה. אם לא צוין, השבוע הראשון נחשב השבוע שבו חל 1 בינואר.


הגדרות

מרווח הזמן ארגומנט כולל הגדרות אלה:

הגדרה

תיאור

yyyy

Year

q

רבעון

m

Month

y

היום בשנה

d

Day

w

Weekday

ww

שבוע

h

שעה

n

דקה

s

שניה


לראש הדף

הארגומנט היום הראשון בשבוע כולל הגדרות אלה:

קבוע

Value

Description

vbUseSystem

0

השתמש בהגדרה NLS API.

vbSunday

1

ראשון (ברירת מחדל)

vbMonday

2

שני

vbTuesday

3

Tuesday

vbWednesday

4

רביעי

vbThursday

5

חמישי

vbFriday

6

שישי

vbSaturday

7

Saturday


קבוע

Value

Description

vbUseSystem

0

השתמש בהגדרה NLS API.

vbFirstJan1

1

התחל בשבוע שבו חל 1 בינואר (ברירת מחדל).

vbFirstFourDays

2

התחל השבוע הראשון בעל לפחות ארבעה ימים בשנה החדשה.

vbFirstFullWeek

3

מתחיל השבוע המלא הראשון של השנה.


הערות

באפשרותך להשתמש בפונקציה DateDiff כדי לקבוע את מספר מרווחי הזמן הקיימים בין שני תאריכים. לדוגמה, ניתן להשתמש DateDiff כדי לחשב את מספר הימים בין שני תאריכים, או את מספר השבועות בין היום הנוכחי לסוף השנה.

כדי לחשב את מספר הימים בין תאריך1 לבין תאריך2, באפשרותך להשתמש באפשרות היום בשנה ("y") או ביום ("d"). כאשר מרווח Weekday ("w"), DateDiff מחזירה את מספר השבועות בין שני התאריכים. תאריך1 נופל ביום שני, DateDiff סופרת את מספר ימי שני עד תאריך2. הפונקציה סופרת תאריך2 אך לא תאריך1. עם זאת, אם interval הוא שבוע ("ww"), הפונקציה DateDiff מחזירה את מספר השבועות בלוח השנה בין שני התאריכים. הפונקציה סופרת את מספר ימי הראשון בין תאריך1 לבין תאריך2. DateDiff סופרת תאריך2 אם הוא מופיע ביום ראשון; אך אינה סופרת תאריך1, גם אם הוא חל ביום ראשון.

אם תאריך1 מתייחס לנקודת מאוחר יותר ביחס תאריך2, הפונקציה DateDiff מחזירה מספר שלילי.

הארגומנט היום הראשון בשבוע משפיע על חישובים בהם שימוש בסימני מרווח הזמן "w" ו- "ww".

אם תאריך1 או תאריך2ליטרל תאריך, השנה שצוינה הופכת לחלק קבוע של תאריך זה. עם זאת, אם תאריך1 או תאריך2 מוקף במרכאות כפולות (""), ואתה משמיט את השנה, השנה הנוכחית נוספת לקוד שלך בכל פעם יש להעריך את הביטוי תאריך1 או תאריך2 . כך ניתן לכתוב קוד שניתן להשתמש בהם בשנים שונות.

בעת השוואת 31 בדצמבר ל- 1 בינואר של השנה העוקבת, DateDiff עבור שנה ("yyyy") מחזירה 1, אף על פי שחלף יום אחד בלבד.

הערה: עבור תאריך1 לבין תאריך2, אם הגדרת המאפיין לוח שנה גרגוריאני, התאריך המוזן להיות גרגוריאני. אם לוח השנה הוא איסלמי, התאריך המוזן להיות איסלמי.

לראש הדף

דוגמאות

השתמש בפונקציה DateDiff בביטוי     באפשרותך להשתמש בפונקציה DateDiff בכל מקום שבו באפשרותך להשתמש בביטויים. לדוגמה, נניח שיש לך טופס המשמש אותך כדי למלא הזמנות לקוחות. בטבלה orders, יש לך שדה בשם ReceiveBefore המכיל את התאריך שבו הלקוח צריך לקבל את ההזמנה. באפשרותך להשתמש בפונקציה DateDiff עם תיבת טקסט בטופס כדי להציג את מספר הימים שנותרו לפני הסדר חייבת להישלח.

בהנחה שלוקח 10 ימים לשלוח כל הזמנה, עליך להגדיר את המאפיין מקור פקד של תיבת הטקסט באופן הבא:

= DateDiff("d", Now(), [Orders].[ ReceiveBefore])-10

בעת פתיחת הטופס בתצוגת טופס, תיבת הטקסט מציגה את מספר הימים שנשארו לפני הסדר חייבת להישלח. אם יש פחות מ- 10 ימים לפני שהלקוח חייב לקבל את ההזמנה, המספר בתיבת הטקסט שלילי ומציינת כמה ימים מאוחר יהיו בהזמנה אם היא תישלח באופן מיידי.

השתמש בפונקציה DateDiff בקוד VBA   

הערה: הדוגמאות הבאות מדגימות את השימוש של פונקציה זו במודול Visual Basic for Applications‏ (VBA). לקבלת מידע נוסף אודות עבודה עם 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

הערה: כתב ויתור בנוגע לתרגום מכונה: מאמר זה תורגם על-ידי מערכת מחשב, ללא התערבות אדם. Microsoft מציעה את תרגומי המכונה כדי לסייע למשתמשים שאינם דוברי אנגלית ליהנות מתוכן בנושא מוצרים, שירותים וטכנולוגיות של Microsoft. מכיוון שהמאמר תורגם על-ידי מכונה, הוא עלול להכיל שגיאות באוצר המילים, בתחביר או בדקדוק.

הרחב את הכישורים שלך
סייר בהדרכה
קבל תכונות חדשות לפני כולם
הצטרף למשתתפי Office Insider

האם מידע זה היה שימושי?

תודה על המשוב!

תודה על המשוב! נראה שכדאי לקשר אותך לאחד מנציגי התמיכה של Office.

×