החזרת משתנה (תאריך) עבור שנה, חודש ויום שצוינו.
תחביר
DateSerial(year, month, day)
אזהרה ודא שהארגומנטים נמצאים בטווח הערכים הנכון. ארגומנט לא חוקי יכול להוביל לתוצאה שגויה.
תחביר הפונקציה DateSerial מכיל את הארגומנטים הבאים:
| ארגומנט | תיאור |
|---|---|
| שנה | נדרש. מספר שלם. מספר בין 100 ל- 9999, כולל, או ביטוי מספרי. |
| חודש | נדרש. מספר שלם. כל ביטוי מספרי. |
| יום | נדרש. מספר שלם. כל ביטוי מספרי. |
הערות
כדי לציין תאריך, כגון 31 בדצמבר 1991, טווח המספרים עבור כל ארגומנט DateSerial צריך להיות בטווח המקובל עבור היחידה; כלומר, 1-31 עבור ימים ו-1-12 עבור חודשים. אולם, באפשרותך לציין תאריכים יחסיים עבור כל ארגומנט תוך שימוש בכל ביטוי מספרי המייצג מספר מסוים של ימים, חודשים, או שנים לפני או אחרי תאריך מסוים.
הדוגמה הבאה משתמשת בביטויים מספריים במקום במספרי תאריכים מוחלטים. במקרה זה הפונקציה DateSerial מחזירה תאריך שהוא יום לפני היום הראשון (1 - 1), חודשיים לפני אוגוסט (8 - 2), 10 שנים לפני 1990 (1990 - 10); במילים אחרות, 31 במאי 1980.
DateSerial(1990 - 10, 8 - 2, 1 - 1)
שנים הכתובות בשתי ספרות עבור הארגומנט year מפורשות בהתבסס על הגדרות המחשב שהוגדרו על-ידי המשתמש. הגדרות ברירת המחדל הן שערכים בין 0 ל- 29, כולל, מפורשים כשנים 2000–2029. ערכי ברירת המחדל בין 30 ל- 99 מפורשים כשנים 1930–1999. עבור כל שאר ארגומנטי השנים , השתמש בשנים הכתובות בארבע ספרות (לדוגמה, 1800).
גירסאות של Windows הקודמות ל- Windows 2000 מפרשות שנים הכתובות בשתי ספרות בהתבסס על ברירות המחדל שתוארו לעיל. כדי לוודא שהפונקציה מחזירה את הערך הנכון, השתמש בשנים הכתובות בארבע ספרות.
כאשר ארגומנט כלשהו חורג מהטווח המקובל עבורו, הוא גדל בהתאם ליחידה הבאה הגדולה יותר. לדוגמה, אם ציינת 35 ימים, הדבר מוערך כחודש אחד ומספר מסוים של ימים, בהתאם למיקום בשנה שהערך הוחל. אם ארגומנט יחיד כלשהו נמצא מחוץ לטווח -32,768 עד 32,767, מתרחשת שגיאה. אם התאריך שצויין על-ידי שלושת הארגומנטים נופל מחוץ לטווח המקובל של תאריכים, מתרחשת שגיאה.
הערה
עבור שנה,חודשויום, אם הגדרת המאפיין Calendar היא לועזי, ההנחה היא שהערך המסופק הוא לועזי. אם ההגדרה של המאפיין Calendar היא 'איסלמי', ההנחה היא שהערך המסופק הוא 'איסלמי'.
חלק התאריך המוחזר מופיע ביחידות הזמן של לוח השנה הנוכחי של Visual Basic. לדוגמה, אם לוח השנה הנוכחי הוא איסלמי וחלק התאריך שיש להחזיר הוא השנה, ערך השנה הוא של שנה איסלמית. עבור שנת הארגומנט, ערכים בין 0 ל- 99, כולל, מפורשים כשנים 1400-1499. עבור כל ערכי השנים האחרות, השתמש בשנה המלאה בת ארבע הספרות (לדוגמה, 1520).
דוגמה לשאילתה
| ביטוי | תוצאות |
|---|---|
| SELECT Dateserial(2018,12,13) AS NewDate FROM ProductSales; | הפונקציה מחזירה את ה"תאריך" עבור השנה, החודש והיום שצוינו שהוזנו בארגומנטים של הפונקציה ומציגה בעמודה "NewDate". תוצאה: "13/12/2018". |
דוגמה ל- VBA
הערה
הדוגמאות הבאות מדגימות את השימוש של פונקציה זו במודול Visual Basic for Applications (VBA). לקבלת מידע נוסף אודות עבודה עם VBA, בחר הפניית מפתח ברשימה הנפתחת שליד חיפוש והזן מונח אחד או יותר בתיבת החיפוש.
דוגמה זו משתמשת בפונקציה DateSerial כדי להחזיר את התאריך עבור השנה, החודש והיום המצוינים.
Dim MyDate ' MyDate contains the date for February 12, 1969. MyDate = DateSerial(1969, 2, 12) ' Return a date.