החזרת משתנה (תאריך) המכיל את השעה.
תחביר
TimeValue(time)
הארגומנט Timeהנדרש הוא בדרך כלל ביטוי מחרוזת המייצג שעה החל מ- 0:00:00 (12:00:00 A.M.) עד 23:59:59 (11:59:59 P.M.), כולל. עם זאת, Time יכול גם להיות כל ביטוי המייצג שעה בטווח זה. אם time מכיל Null, מוחזר Null .
הערות
באפשרותך להזין שעות חוקיות באמצעות שעון של 12 שעות או 24 שעות. לדוגמה, "2:24PM" שניהם ארגומנטים "14:24" חוקיים של שעה .
אם הארגומנט time מכיל מידע על תאריך, TimeValue אינו מחזיר אותו. עם זאת, אם השעה כוללת מידע תאריך לא חוקי, מתרחשת שגיאה.
דוגמאות לשאילתות
| ביטוי | תוצאות |
|---|---|
| SELECT TimeValue([DateTime]) AS Expr1 FROM ProductSales; | החזרת ערכי השעה של השדה "DateTime" ללא פרטי התאריך והצגה בעמודה Expr1. |
| SELECT TimeValue([DateTime]) AS JustTime FROM ProductSales; | החזרת ערכי השעה של השדה "DateTime" ללא פרטי התאריך והצגה בעמודה JustTime. |
דוגמה ל- VBA
הערה
הדוגמאות הבאות מדגימות את השימוש של פונקציה זו במודול Visual Basic for Applications (VBA). לקבלת מידע נוסף אודות עבודה עם VBA, בחר הפניית מפתח ברשימה הנפתחת שליד חיפוש והזן מונח אחד או יותר בתיבת החיפוש.
דוגמה זו משתמשת בפונקציה TimeValue כדי להמיר מחרוזת לשעה. באפשרותך גם להשתמש בליטרלים של תאריך כדי להקצות שעה ישירות למשתנה או משתנה תאריך , לדוגמה, MyTime = #4:35:17 PM#.
Dim MyTime
MyTime = TimeValue("4:35:17 PM") ' Return a time.