פונקציות המרת סוג

כל פונקציה מכפית ביטוי לפונקציה מסוימת סוג נתונים.

תחביר

CBool( expression )

CByte( expression )

CCur( expression )

CDate( expression )

CDbl( expression )

CDec( expression )

CInt( expression )

CLng( expression )

CSng( expression )

CStr( expression )

CVar( expression )

הביטוי הנדרש ארגומנט כל ביטוי מחרוזת או ביטוי מספרי.

סוגי החזרה

שם הפונקציה קובע את סוג ההחזרה כפי שמוצג בדוגמה הבאה:

פונקציה	סוג החזרה	טווח עבור *ארגומנט* ביטוי
CBool	בוליאני	כל מחרוזת חוקית או ביטוי מספרי חוקי.
CByte	בית	0 עד 255.
CCur	מטבע	-922,337,203,685,477.5808 עד 922,337,203,685,477.5807.
CDate	תאריך	כל ביטוי תאריך חוקי.
CDbl	Double	-1.79769313486231E308 עד -4.94065645841247E-324 עבור ערכים שליליים; 4.94065645841247E-324 עד 1.79769313486232E308 עבור ערכים חיוביים.
CDec	Decimal	+/-79,228,162,514,264,337,593,543,950,335 עבור מספרים בקנה מידה של אפס, לדוגמה, מספרים ללא מקומות עשרוניים. עבור מספרים עם 28 מקומות עשרוניים, הטווח הוא +/-7.9228162514264337593543950335. המספר הקטן ביותר האפשרי שאינו אפס הוא 0.00000000000000000000000000000001.
CInt	מספר שלם	-32,768 עד 32,767; שברים מעוגלים.
CLng	זמן	-2,147,483,648 עד 2,147,483,647; שברים מעוגלים.
CSng	Single	-3.402823E38 עד -1.401298E-45 עבור ערכים שליליים; 1.401298E-45 עד 3.402823E38 עבור ערכים חיוביים.
CStr	String	החזרות עבור CStr תלויות בארגומנט הביטוי.
CVar	משתנה	טווח זהה לערך כפול עבור מספרים. טווח זהה למחרוזת עבור מספרים שאינם מספריים.

הערות

אם הביטוי שהועבר לפונקציה נמצא מחוץ לטווח של סוג הנתונים שמומר אליו, תתרחש שגיאה.

באופן כללי, באפשרותך לתעוד את הקוד שלך באמצעות פונקציות ההמרה של סוג הנתונים כדי להראות שיש לבטא את התוצאה של פעולה מסוימת כסוג נתונים מסוים במקום כסוג הנתונים המוגדר כברירת מחדל. לדוגמה, השתמש ב- CCur כדי לכפות אריתמטי של מטבע במקרים שבהם בדרך כלל מתרחשת חשבונית ברמת דיוק בודד, דיוק כפול או מספר שלם.

עליך להשתמש בפונקציות ההמרה של סוג הנתונים במקום ב- Val כדי לספק המרות מודעות בינלאומיות מסוג נתונים אחד לאחר. לדוגמה, בעת שימוש ב- CCur, מפרידים עשרוניים שונים, מפרידי אלפים שונים ואפשרויות שונות של מטבעות מזוהים כראוי בהתאם להגדרת האזור של המחשב.

כאשר ערך השבר הוא בדיוק 0.5, CInt ו - CLng תמיד מעגלים אותו למספר הזוגי הקרוב ביותר. לדוגמה, 0.5 מעגל ל- 0 ו- 1.5 מעגל ל- 2. הפונקציות CIntו- CLng שונות מהפונקציות Fix ו- Int , המקוצרות, ולא מעגלות, את חלק השבר של מספר. כמו כן, Fix ו - Int תמיד מחזירים ערך מאותו סוג שבו מועבר.

השתמש בפונקציה IsDate כדי לקבוע אם ניתן להמיר תאריך לתאריך או שעה. הפונקציה CDate מזהה ליטרלי תאריך ותואר שעה וכן מספרים מסוימים השייכים לטווח התאריכים המקובלים. בעת המרת מספר לתאריך, חלק המספר כולו מומר לתאריך. כל חלק שבר של המספר מומר בשעה ביום, החל מחצות.

CDate מזהה תבניות תאריך בהתאם אזור של המערכת שלך. אין לקבוע את הסדר הנכון של יום, חודש ושנה אם הוא מסופק בתבנית שאינה אחת מהגדרות התאריך המזוהות. בנוסף, תבנית תאריך ארוכה אינה מזוהה אם היא מכילה גם את המחרוזת של יום בשבוע.

פונקציית CVDate מסופקת גם לצורך תאימות עם גירסאות קודמות של Visual Basic. עם זאת, התחביר של הפונקציה CVDate זהה לפונקציה CDate, אך הפונקציה CVDate מחזירה משתנה שסוג המשנה שלו הוא Date במקום סוג תאריך בפועל. מאחר מעתה קיים סוג תאריך פנימי , אין צורך נוסף ב- CVDate. ניתן להשיג את אותו אפקט על-ידי המרת ביטוי לתאריך ולאחר מכן הקצאתו למשתנה. שיטה זו תואמת את ההמרה של כל סוגי המשנה הפנימיים האחרים לסוגי המשנה שווי הערך שלהם ב- Variant .

הערה: הפונקציה CDec אינה מחזירה סוג נתונים דיסקרטי; במקום זאת, הוא תמיד מחזיר משתנה שהערך שלו הומר לסוג משנה עשרוני.

דוגמאות שאילתה

Expression	תוצאות
SELECT SalePrice,FinalPrice,CBool(SalePrice>FinalPrice) AS Expr1 FROM productSales;	החזרת "SalePrice", "FinalPrice" והערכה אם SalePrice גדול מהמחיר הסופי. החזרת "-1" אם הערך הוא True ו- "0" אם הוא false.
SELECT ProductID, CByte(Quantity) AS Expr1 FROM productSales;	החזרת "ProductID",המרת הערכים בשדה "כמות" לתבנית בתים ומציגה בעמודה Expr1 החזרת "ProductID", ממירה את הערכים בשדה "כמות" לתבנית 'מטבע' ומציגה בעמודה Expr1.
SELECT ProductID, CDate(DateofSale) AS Expr1 FROM productSales;	החזרת "ProductID", המרת הערכים בשדה "DateofSale" לתבנית תאריך ומציגה בעמודה Expr1.
SELECT ProductID, CDbl(Discount) AS Expr1 FROM productSales;	החזרת "ProductID", המרת הערכים בשדה "הנחה" לתבנית כפולה ותציגה בעמודה Expr1.
SELECT ProductID, CInt(Discount) AS Expr1 FROM productSales;	החזרת "ProductID",המרת הערכים בשדה "הנחה" לתבנית מספר שלם ומציגה בעמודה Expr1.
SELECT ProductID, CLng(Discount) AS Expr1 FROM productSales;	החזרת "ProductID", המרת הערכים בשדה "Discount" לתבנית ארוכה ותציגה בעמודה Expr1.
SELECT ProductID, CSng(Discount) AS Expr1 FROM productSales;	החזרת "ProductID", המרת הערכים בשדה "הנחה" לתבנית יחידה ותציגה בעמודה Expr1.
SELECT ProductID, CStr(Discount) AS Expr1 FROM productSales;	החזרת "ProductID", ממירה את הערכים בשדה "Discount" לתבנית מחרוזת ומציגה בעמודה Expr1.
SELECT ProductID, CVar(Discount) AS Expr1 FROM productSales;	החזרת "ProductID", המרת הערכים בשדה "Discount" לערך כפול עבור ערכים מספריים ומחרוזת עבור ערכים לא מספריים.

דוגמאות VBA

הערה: הדוגמאות הבאות מדגימות את השימוש של פונקציה זו במודול Visual Basic for Applications‏ (VBA). לקבלת מידע נוסף אודות עבודה עם VBA, ראה Access VBA Reference.

הפונקציה CBool

דוגמה זו משתמשת בפונקציה CBool כדי להמיר ביטוי לבוליאני. אם הביטוי מוערך כערך שאינו אפס, הפונקציה CBool מחזירה True; אחרת, הוא מחזיר False.

Dim A, B, Check
A = 5: B = 5    ' Initialize variables.
Check = CBool(A = B)    ' Check contains True.
A = 0    ' Define variable.
Check = CBool(A)    ' Check contains False.

הפונקציה CByte

דוגמה זו משתמשת בפונקציה CByte כדי להמיר ביטוי לבית.

Dim MyDouble, MyByte
MyDouble = 125.5678    ' MyDouble is a Double.
MyByte = CByte(MyDouble)    ' MyByte contains 126.

הפונקציה CCur

דוגמה זו משתמשת בפונקציה CCur כדי להמיר ביטוי למטבע.

Dim MyDouble, MyCurr
MyDouble = 543.214588    ' MyDouble is a Double.
MyCurr = CCur(MyDouble * 2)    
' Convert result of MyDouble * 2 (1086.429176) to a 
' Currency (1086.4292).

הפונקציה CDate

דוגמה זו משתמשת בפונקציה CDate כדי להמיר מחרוזת לתאריך. באופן כללי, לא מומלץ לבצע קידוד קשיח של תאריכים ושעות בתור מחרוזות (כפי שמוצג בדוגמה זו). השתמש בליטרלי תאריך ותואר שעה, כגון #12/12/1969# ו- #4:45:23 PM#, במקום זאת.

Dim MyDate, MyShortDate, MyTime, MyShortTime
MyDate = "February 12, 1969" 
' Convert to Date data type.
MyShortDate = CDate(MyDate)
MyTime = "4:35:47 PM" 
' Convert to Date data type.
MyShortTime = CDate(MyTime)

הפונקציה CDbl

דוגמה זו משתמשת בפונקציה CDbl כדי להמיר ביטוי ל-Double.

Dim MyCurr, MyDouble
MyCurr = CCur(234.456784)
' Convert result to a Double.
MyDouble = CDbl(MyCurr * 8.2 * 0.01)

הפונקציה CDec

דוגמה זו משתמשת בפונקציה CDec כדי להמיר ערך מספרי לערך עשרוני.

Dim MyDecimal, MyCurr
MyCurr = 10000000.0587    ' MyCurr is a Currency.
MyDecimal = CDec(MyCurr)     ' MyDecimal is a Decimal.

הפונקציה CInt

דוגמה זו משתמשת בפונקציה CInt כדי להמיר ערך למספר שלם.

Dim MyDouble, MyInt
MyDouble = 2345.5678    ' MyDouble is a Double.
MyInt = CInt(MyDouble)    ' MyInt contains 2346.

הפונקציה CLng

דוגמה זו משתמשת בפונקציה CLng כדי להמיר ערך ל- Long.

Dim MyVal1, MyVal2, MyLong1, MyLong2
MyVal1 = 25427.45
MyVal2 = 25427.55  ' MyVal1, MyVal2 are Doubles.
MyLong1 = CLng(MyVal1)
' MyLong1 contains 25427.
MyLong2 = CLng(MyVal2)
' MyLong2 contains 25428.

הפונקציה CSng

דוגמה זו משתמשת בפונקציה CSng כדי להמיר ערך לערך יחיד.

Dim MyDouble1, MyDouble2, MySingle1, MySingle2
' MyDouble1, MyDouble2 are Doubles.
MyDouble1 = 75.3421115: MyDouble2 = 75.3421555
MySingle1 = CSng(MyDouble1)
' MySingle1 contains 75.34211.
MySingle2 = CSng(MyDouble2)
' MySingle2 contains 75.34216.

הפונקציה CStr

דוגמה זו משתמשת בפונקציה CStr כדי להמיר ערך מספרי למחרוזת.

Dim MyDouble, MyString
MyDouble = 437.324    ' MyDouble is a Double.
MyString = CStr(MyDouble)
' MyString contains "437.324".

הפונקציה CVar

דוגמה זו משתמשת בפונקציה CVar כדי להמיר ביטוי למשתנה.

Dim MyInt, MyVar
MyInt = 4534    ' MyInt is an Integer.
MyVar = CVar(MyInt & "000") 
' MyVar contains the string 4534000.