החזרת משתנה (תאריך) עבור שנה, חודש ויום שצוינו.
תחביר
DateSerial ( year, month, day )
אזהרה ודא שהארגומנטים נמצאים בטווח הערכים הנכון. ארגומנט לא חוקי עלול לגרום לתוצאה שגויה.
תחביר הפונקציה DateSerial מכיל את הארגומנטים הבאים:
|
ארגומנט |
תיאור |
|
שנה |
נדרש. מספר שלם. מספר בין 100 ל- 9999, כולל או ביטוי מספרי. |
|
חודש |
נדרש. מספר שלם. כל ביטוי מספרי. |
|
יום |
נדרש. מספר שלם. כל ביטוי מספרי. |
הערות
כדי לציין תאריך, כגון 31 בדצמבר 1991, טווח המספרים עבור כלארגומנט תאריך צריך להיות בטווח המקובל עבור היחידה; לדוגמה, 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, מתרחשת שגיאה. אם התאריך שצוין על-ידי שלושת הארגומנטים חורג מטווח התאריכים המקובל, מתרחשת שגיאה.
הערה: עבור שנה, חודשויום, אם הגדרת המאפיין לוח שנה היא לועזית, הפונקציה מניחה שהערך שסופק הוא לועזי. אם הגדרת המאפיין לוח שנה היא איסלמי, הפונקציה מניחה שהערך שסופק הוא איסלמי.
חלק התאריך המוחזר הוא ביחידות פרק הזמן של לוח השנה הנוכחי של Visual Basic. לדוגמה, אם לוח השנה הנוכחי הוא איסלמי ותאריך ההחזרה הוא השנה, ערך השנה הוא שנה איסלמית. עבור שנת הארגומנט, הערכים בין 0 ל- 99, כולל, מפורשים כהשנים 1400-1499. עבור כל שאר ערכי השנה, השתמש בשנה בת ארבע הספרות המלאה (לדוגמה, 1520).
דוגמה לשאילתה
|
Expression |
תוצאות |
|
SELECT Dateserial(2018,12,13) AS NewDate FROM ProductSales; |
הפונקציה מחזירה את ה"תאריך" עבור השנה, החודש והיום שצוינו שהוזנו בארגומנטים של הפונקציה ומציגה בעמודה "NewDate". תוצאה: "12/13/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.
