החזרת משתנה (תאריך) המכיל את השעה עבור שעה, דקה ושניה מסוימות.
תחביר
TimeSerial(hour, minute, second)
אזהרה ודא שהארגומנטים נמצאים בטווח הערכים הנכון. ארגומנט לא חוקי יכול להוביל לתוצאה שגויה.
תחביר הפונקציה TimeSerial מכיל את הארגומנטים הבאים:
| ארגומנט | תיאור |
|---|---|
| שעה | נדרש. משתנה (מספר שלם). מספר בין 0 (00: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, מתרחשת שגיאה. אם השעה שצוינה על-ידי שלושת הארגומנטים גורמת לתאריך ליפול אל מחוץ לטווח המקובל של תאריכים, מתרחשת שגיאה.
דוגמה לשאילתה
| ביטוי | תוצאות |
|---|---|
| בחר TimeSerial(18,12,10) AS NewTime מקבוצת ProductSales לפי TimeSerial(18,12,10); | הפונקציה מחזירה את ה"שעה" המורכבת מהשעה, הדקה והשנייה שצוינו שהוזנו בארגומנטים של הפונקציה ומציגה בעמודה 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.