החזרת משתנה (תאריך) המכיל את השעה.
תחביר
TimeValue(time)
ארגומנט הזמן הנדרש הוא בדרך כלל ביטוי מחרוזת המייצג שעה מ- 0:00:00 (12:00:00 A.M.) עד 23:59:59 (11:59:59, כולל. עם זאת , שעה יכולה להיות גם כל ביטוי המייצג שעה בטווח זה. אם time מכיל Null, מוחזר Null.
הערות
באפשרותך להזין שעות חוקיות באמצעות שעון של 12 שעות או 24 שעות. לדוגמה, שניהם "2:24PM""14:24" ארגומנטים חוקיים של שעה.
אם ארגומנט השעה מכיל פרטי תאריך, 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.