החזרת משתנה (תאריך) המכיל את השעה עבור שעה, דקה ושניה מסוימות.
תחביר
TimeSerial ( hour, minute, second )
אזהרה ודא שהארגומנטים נמצאים בטווח הערכים הנכון. ארגומנט לא חוקי עלול לגרום לתוצאה שגויה.
תחביר הפונקציה TimeSerial מכיל את הארגומנטים הבאים:
|
ארגומנט |
תיאור |
|
שעה |
נדרש. משתנה (מספר שלם). מספר בין 0 (12:00 ל- 23 (23:00), כולל, או ביטוי מספרי. |
|
דקה |
נדרש. משתנה (מספר שלם). כל ביטוי מספרי. |
|
השני |
נדרש. משתנה (מספר שלם). כל ביטוי מספרי. |
הערות
כדי לציין שעה, כגון 11:59:59, טווח המספרים עבור כל ארגומנט TimeSerial צריך להיות בטווח הרגיל עבור היחידה; לדוגמה, 0-23 עבור שעות ו- 0-59 עבור דקות שניות. עם זאת, באפשרותך גם לציין שעות יחסיות עבור כל ארגומנט באמצעות כל ביטוי מספרי המייצג מספר מסוים של שעות, דקות או שניות לפני או אחרי פרק זמן מסוים. הדוגמה הבאה משתמשת בביטויים במקום במספרי זמן מוחלטים. הפונקציה TimeSerial מחזירה שעה עבור 15 דקות לפני (-15) ) שש שעות לפני הצהריים (12 - 6) או 5:45:00.
TimeSerial(12 - 6, -15, 0)
כאשר ארגומנט כלשהו חורג מהטווח הרגיל עבור ארגומנט זה, הוא גדל ליחידה הגדולה הבאה, בהתאם לצורך. לדוגמה, אם תציין 75 דקות, הוא יוערך כשעה אחת ו- 15 דקות. אם ארגומנט בודד כלשהו נמצא מחוץ לטווח -32,768 עד 32,767, מתרחשת שגיאה. אם השעה שצוינה על-ידי שלושת הארגומנטים גורמת לתאריך להופיע מחוץ לטווח התאריכים המקובל, מתרחשת שגיאה.
דוגמה לשאילתה
|
Expression |
תוצאות |
|
SELECT TimeSerial(18,12,10) AS NewTime FROM ProductSales GROUP BY TimeSerial(18,12,10); |
הפונקציה מחזירה את הערך "Time" מורכב משעה, דקה ושנייה שצוינו שהוזנו בארגומנטים של הפונקציה ומציגה בעמודה NewTime. תוצאה: "18:12:10". |
דוגמה ל- VBA
הערה: הדוגמאות הבאות מדגימות את השימוש של פונקציה זו במודול Visual Basic for Applications (VBA). לקבלת מידע נוסף אודות עבודה עם VBA, בחר הפניית מפתח ברשימה הנפתחת שליד חיפוש והזן מונח אחד או יותר בתיבת החיפוש.
דוגמה זו משתמשת בפונקציה TimeSerial כדי להחזיר שעה עבור השעה, הרגע והשנייה שצוינו.
Dim MyTime
MyTime = TimeSerial(16, 35, 17)
' MyTime contains serial representation of 4:35:17 PM.
