הפונקציה DAvg

באפשרותך להשתמש בפונקציה DAvg כדי לחשב את הממוצע של קבוצת ערכים בקבוצת רשומות שצוינה (תחום). השתמש בפונקציה DAvg במודול Visual Basic for Applications (VBA), במאקרו, בביטוי שאילתה או בפקד מחושב.

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

תחביר

DAvg(expr, domain [, criteria] )

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

ארגומנט	תיאור
expr	נדרש. ביטוי המזהה את השדה המכיל את הנתונים המספריים שברצונך לחשב עבורם ממוצע. הוא יכול להיות ביטוי מחרוזת המזהה שדה בטבלה או בשאילתה, או ביטוי המבצע חישוב בנתונים בשדה זה. ב - expr, באפשרותך לכלול שם של שדה בטבלה, פקד בטופס, קבוע או פונקציה. אם expr כולל פונקציה, הוא יכול להיות מוכלל או מוגדר על-ידי המשתמש, אך לא צבירה המופעלת על תחום אחר או פונקציית צבירה של SQL.
domain	נדרש. ביטוי מחרוזת המזהה את קבוצת הרשומות המהווה את התחום. הוא יכול להיות שם טבלה או שם שאילתה עבור שאילתה שאינה דורשת פרמטר.
criteria	אופציונלי. ביטוי מחרוזת המשמש כדי להגביל את טווח הנתונים שבו מבוצעת הפונקציה DAvg . לדוגמה, criteria מקביל לעתים קרובות למשפט WHERE בביטוי של SQL, ללא המילה WHERE. אם criterias מושמט, הפונקציה DAvg מעריכה את expr מול התחום כולו. כל שדה הכלול בקריטריונים חייב להיות גם שדה בתחום; אחרת, הפונקציה DAvg מחזירה ערך Null.

    

הערות

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

בין שאתה משתמש בפונקציה DAvg במאקרו או במודול, בביטוי שאילתה או בפקד מחושב, עליך לבנות את הארגומנט criteria בקפידה כדי לוודא שהוא יוערך כראוי.

באפשרותך להשתמש בפונקציה DAvg כדי לציין קריטריונים בשורה 'קריטריונים' של שאילתה. לדוגמה, נניח שברצונך להציג רשימה של כל המוצרים שהוזמנו בכמויות העולות על כמות ההזמנה הממוצעת. באפשרותך ליצור שאילתה בטבלאות Orders, Order Details ו- Products, ולכלול את השדה Product Name ואת השדה Quantity, עם הביטוי הבא בשורה Criteria מתחת לשדה Quantity:

>DAvg("[Quantity]", "Orders")

ניתן להשתמש בפונקציה DAvg גם בתוך ביטוי שדה מחושב בשאילתה, או בשורה 'עדכן ל' של שאילתת עדכון.

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

=DAvg("[Freight]", "Orders", "[ShipRegion] = 'CA'")

אם ברצונך פשוט לחשב ממוצע של כל הרשומות בתחום, השתמש בפונקציה Avg .

באפשרותך להשתמש בפונקציה DAvg במודול או במאקרו או בפקד מחושב בטופס אם שדה שעליך להציג אינו נמצא במקור הרשומה שעליו מבוסס הטופס שלך. לדוגמה, נניח שיש לך טופס המבוסס על הטבלה Orders, וברצונך לכלול את השדה Quantity מהטבלה Order Details כדי להציג את המספר הממוצע של פריטים שהוזמנו על-ידי לקוח מסוים. באפשרותך להשתמש בפונקציה DAvg כדי לבצע חישוב זה ולהציג את הנתונים בטופס.

טיפים

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

דוגמה

הפונקציה הבאה מחזירה את עלות ההובלה הממוצעת עבור הזמנות שנשלחו בתאריך נתון או אחריו. התחום הוא טבלת הזמנות. הארגומנט criteria מגביל את קבוצת הרשומות המתקבלת בהתבסס על המדינה/האזור ותאריך המשלוח הנתונים. שים לב שמילת המפתח AND כלולה במחרוזת כדי להפריד בין השדות המרובים בארגומנט criteria . כל הרשומות הכלולות בחישוב הפונקציה DAvg יקבלו את שני הקריטריונים הללו.

Public Function AvgFreightCost _
    (ByVal strCountryRegion As String, _
     ByVal dteShipDate As Date) As Double
    AvgFreightCost = DAvg("[Freight]", "Orders", _
        "[ShipCountryRegion] = '" & strCountryRegion & _
        "'AND [ShippedDate] >= #" & dteShipDate & "#")
End Function

כדי לקרוא לפונקציה, השתמש בשורת הקוד הבאה בחלון Tמיידי:

:AvgFreightCost "UK", #1/1/96#