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