החזרת משתנה (תאריך).
תחביר
DateValue ( date )
התאריך הנדרשארגומנט בדרך ביטוי מחרוזת תאריך מ- 1 בינואר 100 עד 31 בדצמבר 9999. עם זאת , תאריך יכול להיות ביטוי יכול לייצג תאריך, שעה או תאריך ושעה, בטווח זה.
הערות
אם date הוא מחרוזת הכוללת רק מספרים המופרדים באמצעות מפרידי תאריכים חוקי, DateValue מזהה את הסדר עבור חודש, יום ושנה בהתאם לתבנית Short Date שציינת עבור המערכת שלך. DateValue מזהה גם תאריכים חד-משמעיים המכילים שמות חודשים, בתבנית ארוכה או מקוצרת. לדוגמה, בנוסף לזיהוי 30/12/1991 ו- 30/12/91, DateValue מזהה גם הוא את 30 בדצמבר, 1991 ואת 30 בדצמבר, 1991.
אם חלק השנה של התאריך מושמט, DateValue משתמש בשנה הנוכחית מתאריך המערכת של המחשב שלך.
אם ארגומנט התאריך כולל מידע אודות שעה, DateValue אינו מחזיר אותו. עם זאת, אם תאריך כולל מידע זמן לא חוקי (כגון "89:98"), תתרחש שגיאה.
הערה: עבור תאריך, אם הגדרת המאפיין לוח שנה היא לועזית, התאריך שסופק חייב להיות לועזי. אם לוח השנה הוא איסלמי, התאריך שסופק חייב להיות איסלמי. אם התאריך שסופק הוא איסלמי, תאריך הארגומנט הוא מחרוזת המייצגת תאריך מ- 1/1/100 (2 באוגוסט הלועזי, 718) עד 3/4/9666 (31 בדצמבר הלועזי, 9999).
דוגמאות שאילתה
Expression |
תוצאות |
SELECT DateValue([DateTime]) AS Expr1 FROM ProductSales; |
החזרת ערכי התאריך של השדה "DateTime" בתבנית Short date ללא פרטי השעה. |
SELECT DateValue([DateTime]) AS NewDate, Count(ProductSales.DateTime) AS CountOfDateTime FROM ProductSales GROUP BY DateValue([DateTime]); |
החזרת ערכי התאריך של השדה "DateTime" בתבנית Short date ללא פרטי השעה. |
דוגמה ל- VBA
הערה: הדוגמאות הבאות מדגימות את השימוש של פונקציה זו במודול Visual Basic for Applications (VBA). לקבלת מידע נוסף אודות עבודה עם VBA, בחר הפניית מפתח ברשימה הנפתחת שליד חיפוש והזן מונח אחד או יותר בתיבת החיפוש.
דוגמה זו משתמשת בפונקציה DateValue כדי להמיר מחרוזת לתאריך. באפשרותך גם להשתמש בליטרלי תאריך כדי להקצות תאריך ישירות למשתנה משתנה או תאריך, לדוגמה, MyDate = #2/12/69#.
Dim MyDate
MyDate = DateValue("February 12, 1969") ' Return a date.