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