החזרת משתנה (מחרוזת) המכיל ביטוי המעוצב לפי ההוראות המוכלות בביטוי עיצוב.
| אזהרה קיימת בעיה בשימוש בפונקציה זו. ניתן לחזור ליום שני האחרון בשנים קלנדריות מסוימות כשבוע 53, כאשר הוא אמור להיות שבוע 1. לקבלת מידע נוסף ופתרון, ראה הפונקציות Format או DatePart יכולות להחזיר מספר שבוע שגוי עבור יום שני האחרון בשנה. |
|---|
תחביר
Format( *ביטוי [, תבנית ] [, היום הראשון בשבוע ] [, השבוע הראשון בשנה ] )
תחביר הפונקציה Format מכיל את הארגומנטים הבאים:
| ארגומנט | תיאור |
|---|---|
| ביטוי | נדרש. כל ביטוי חוקי. |
| פורמט | אופציונלי. ביטוי עיצוב בעל שם חוקי או המוגדר על-ידי המשתמש. |
| היום הראשון בשבוע | אופציונלי. קבוע המציין את היום הראשון בשבוע. |
| השבוע הראשון בשנה | אופציונלי. קבוע המציין את השבוע הראשון בשנה. |
הגדרות
לארגומנט העיצוב יש אפשרות להשתמש במגוון הגדרות, בהתאם לסוג הנתונים של ארגומנט הביטוי . עיין במאמרים המפורטים בטבלה הבאה לקבלת מידע נוסף אודות ביטויי עיצוב חוקיים.
| עבור ביטויים המשתמשים בסוג נתונים זה... | עיין במאמר |
|---|---|
| כל סוג | המאפיין 'עיצוב' |
| תאריך/שעה | עיצוב שדה תאריך ושעה |
| מספרי | עיצוב שדה מספר או מטבע |
| טקסט ותזכיר | עיצוב שדה טקסט |
| כן/לא | המאפיין עיצוב - נתונים מסוג כן/לא |
הארגומנט 'היום הראשון בשבוע ' כולל את ההגדרות הבאות:
| קבוע | Value | תיאור |
|---|---|---|
| vbUseSystem | 0 | השתמש בהגדרת NLS API. |
| VbSunday | 1 | ראשון (ברירת מחדל) |
| vbMonday | 2 | שני |
| vbTuesday | 3 | שלישי |
| vbWednesday | 4 | רביעי |
| vbThursday | 5 | חמישי |
| vbFriday | 6 | שישי |
| vbSaturday | 7 | שבת |
הארגומנט של השבוע הראשון בשנה כולל את ההגדרות הבאות:
| קבוע | Value | תיאור |
|---|---|---|
| vbUseSystem | 0 | השתמש בהגדרת NLS API. |
| vbFirstJan1 | 1 | התחל בשבוע שבו חל 1 בינואר (ברירת המחדל). |
| vbFirstFourDays | 2 | התחל בשבוע הראשון שיש לו לפחות ארבעה ימים בשנה. |
| vbFirstFullWeek | 3 | התחל בשבוע המלא הראשון בשנה. |
הערות
| כדי לעצב | בצע פעולה זו |
|---|---|
| מספרים | השתמש בתבניות מספריות מוגדרות מראש בעלות שם או צור תבניות מספריות המוגדרות על-ידי המשתמש. |
| תאריכים ושעות | השתמש בתבניות תאריך/שעה מוגדרות מראש בעלות שם או צור תבניות תאריך/שעה המוגדרות על-ידי המשתמש. |
| מספרים סידוריים של תאריך ושעה | השתמש בתבניות תאריך ושעה או בתבניות מספריות. |
| מחרוזות | צור תבניות מחרוזת משלך המוגדרות על-ידי המשתמש. |
אם אתה מנסה לעצב מספר מבלי לציין תבנית, התבנית מספקת פונקציונליות דומה לזו של הפונקציה Str , למרות שהיא מקבלת מודעות בינלאומית. עם זאת, מספרים חיוביים המעוצבים כמחרוזות באמצעות Format אינם כוללים רווח מוביל השמור לסימן הערך; אלה שהומרו באמצעות Str שומרים על הרווח המוביל.
אם אתה מעצב מחרוזת מספרית שאינה מותאמת לשפות אחרות, עליך להשתמש בתבנית מספרית המוגדרת על-ידי המשתמש כדי להבטיח את המראה הרצוי.
הערה
אם ההגדרה של המאפיין Calendar היא לועזי ותבנית מציינת תבנית תאריך, הביטוי שסופק חייב להיות לועזי. אם הגדרת המאפיין Visual Basic Calendar היא 'איסלמי', הביטוי שסופק חייב להיות 'איסלמי'.
אם לוח השנה הוא לועזי, משמעות סמלי ביטוי העיצוב אינה משתנה. אם לוח השנה הוא איסלמי, לכל סמלי תבניות התאריך (לדוגמה, dddd, mmmm, yyyy) יש אותה משמעות אך הם חלים על לוח השנה האיסלמי. סמלי פורמט נשארים באנגלית; סימנים שהתוצאה שלהם היא תצוגת טקסט (לדוגמה, AM ו- PM) מציגים את המחרוזת (אנגלית או ערבית) המשויכת לסימן זה. הטווח של סמלים מסוימים משתנה כאשר לוח השנה הוא איסלמי.
| סימן | Range |
|---|---|
| d | 1-30 |
| dd | 1-30 |
| ww | 1-51 |
| mmm | הצגת שמות חודשים מלאים (לשמות חודשים איסלמיים אין קיצורים). |
| y | 1-355 |
| yyyy | 100-9666 |
דוגמאות
שימוש בפונקציה Format בביטוי באפשרותך להשתמש ב'עיצוב' בכל מקום שבו ניתן להשתמש בביטויים. לדוגמה, באפשרותך להשתמש בו בשאילתה כחלק מכינוי שדה, או במאפיין 'מקור פקד ' של תיבת טקסט בטופס או בדוח. הדוגמאות הבאות מציגות ביטוי שבו באפשרותך להשתמש במאפיין 'מסנן ' של דוח כדי להגביל את הפלט לרשומות מהשבוע הקודם.
Format([Date],"ww")=Format(Now(),"ww")-1
בדוגמה זו, מקור הרשומה של הדוח מכיל שדה בשם Date, המכיל את התאריך שבו השתנתה כל רשומה מסוימת ואשר נמצא בשימוש בדוח. בעת הפעלת הדוח, תוצאותיו מסוננות כך שיציגו רק את הרשומות שבהן השבוע עבור הערך בשדה תאריך (Format([Date],"ww")) שווה לשבוע הקודם (Format(Now(),"ww")-1).
שימוש בפונקציה Format בקוד VBA
הערה
הדוגמאות הבאות מדגימות את השימוש של פונקציה זו במודול Visual Basic for Applications (VBA). לקבלת מידע נוסף אודות עבודה עם VBA, בחר הפניית מפתח ברשימה הנפתחת שליד חיפוש והזן מונח אחד או יותר בתיבת החיפוש.
דוגמה זו מציגה שימושים שונים של הפונקציה Format לעיצוב ערכים הן באמצעות תבניות בעלות שם והן באמצעות תבניות המוגדרות על-ידי המשתמש. עבור מפריד התאריך (/), מפריד הזמן (:) והליטרל AM/PM, הפלט המעוצב בפועל המוצג על-ידי המערכת שלך תלוי בהגדרות האזור של המחשב שבו הקוד פועל. בעת הצגת זמנים ותאריכים בסביבת הפיתוח, נעשה שימוש בתבנית השעה הקצרה ובתבנית התאריך הקצר של אזור הקוד. בעת הצגה באמצעות קוד פועל, נעשה שימוש בתבנית השעה הקצרה ובתבנית התאריך הקצר של אזור המערכת, שעשויה להיות שונה מאזור הקוד. בדוגמה זו, ההנחה היא שהאזור 'אנגלית ארה"ב' נלקח.
MyTime ומוצגים MyDate בסביבת הפיתוח באמצעות הגדרת הזמן הקצר והגדרת התאריך הקצר הנוכחית של המערכת.
Dim MyTime, MyDate, MyStr
MyTime = #17:04:23#
MyDate = #January 27, 1993#
' Returns current system time in the system-defined long time format.
MyStr = Format(Time, "Long Time")
' Returns current system date in the system-defined long date format.
MyStr = Format(Date, "Long Date")
MyStr = Format(MyTime, "h:m:s") ' Returns "17:4:23".
MyStr = Format(MyTime, "hh:mm:ss AMPM") ' Returns "05:04:23 PM".
MyStr = Format(MyDate, "dddd, mmm d yyyy") ' Returns "Wednesday,
' Jan 27 1993".
' If format is not supplied, a string is returned.
MyStr = Format(23) ' Returns "23".
' User-defined formats.
MyStr = Format(5459.4, "##,##0.00") ' Returns "5,459.40".
MyStr = Format(334.9, "###0.00") ' Returns "334.90".
MyStr = Format(5, "0.00%") ' Returns "500.00%".
MyStr = Format("HELLO", "<") ' Returns "hello".
MyStr = Format("This is it", ">") ' Returns "THIS IS IT".
שימוש בתבנית עם מחרוזות באורך אפס
בגירסה 2.0 של Microsoft Access ובגירסאות קודמות, ניתן להשתמש בפונקציה Format כדי להחזיר ערך אחד עבור מחרוזת באורך אפס וערך אחר עבור ערך. לדוגמה, באפשרותך להשתמש בביטוי עיצוב כגון הביטוי הבא עם הפונקציה Format כדי להחזיר את ערך המחרוזת המתאים מקוד:
Dim varX As Variant
Dim varStrX As Variant
' Assign some value to varStrX and pass to Format function.
varX = Format(varStrX, "@;ZLS;Null")
בגירסאות 97 ואילך של Microsoft Access, עליך לבצע בדיקה נפרדת עבור רישיות Null ולהחזיר את הערך המתאים בהתבסס על התוצאה. לדוגמה, ניתן להשתמש בפונקציה IIf בביטוי עם הפונקציה Format כגון:
varX = IIf(IsNull(varStrX),"Null", Format(varStrX, "@;ZLS"))
שינוי זה חל רק בעת שימוש בפונקציה Format לעיצוב מחרוזת, בהתאם לשאלה אם היא מחרוזת באורך אפס או ערך Null. ביטויי עיצוב אחרים הנמצאים בשימוש עם הפונקציה Format ממשיכים לפעול כמו בגירסאות קודמות.
אם אתה ממיר מסד נתונים מ- Microsoft Access גירסה 2.0 וגירסאות קודמות ל- Microsoft Access 2002 ואילך, עליך לשנות את הקוד כדי לבדוק אותו בנפרד עבור רישיות Null.