הפונקציה DateDiff

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

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

ראה כמה דוגמאות

תחביר

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

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

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

ארגומנט

תיאור

מרווח זמן

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

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

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

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

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

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

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


הגדרות

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

הגדרה

תיאור

yyyy

שנה

q

רבעון

m

חודש

y

היום בשנה

d

יום

W

Weekday

ww

שבוע

H

שעה

n

דקה

s

שני


לראש הדף

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

קבוע

ערך

תיאור

vbUseSystem

0

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

vbSunday

1

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

vbMonday

2

שני

vbTuesday

3

Tuesday

vbWednesday

4

רביעי

vbThursday

5

חמישי

vbFriday

6

שישי

vbSaturday

7

Saturday


קבוע

ערך

תיאור

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
שפר את הכישורים שלך ב- Office
סייר בהדרכה
קבל תכונות חדשות לפני כולם
הצטרף למשתתפי Office Insider

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

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

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

×