說明
ToText 函式將布林值、數字、貨幣、日期、時間與日期時間值轉換成文字字串。
引數
| |
|---|
| x 引數是即將轉換成字串的布林值，可為 True 或 False。
|
| x 引數是即將轉換成文字字串的數字或貨幣值；可以是整數或分數值。 y 引數是一個整數，指示 x 中數值的小數位數 (這個引數是可省略的)。 z 引數是單一字元的文字字串，指示即將用來在 x 中分隔千位數的字元。預設值是在 [國別設定] 控制台中指定的字元(這個引數是可省略的)。 w 引數是單一字元的文字字串，指示即將在 x 中做為小數點分隔符號的字元，預設值是在 [國別設定] 控制台中指定的字元(這個引數是可省略的)。
|
| x 引數是即將轉換成文字字串的數字或貨幣值；可以是整數或分數值。 y 引數是一個文字字串，用來指示 x 中數值的顯示格式。如需有關建立格式字串的資訊，請參閱 「格式字串」。 z 引數是一個整數，指示 x 中數值的小數位數(這個引數是可省略的)。 w 引數是單一字元的文字字串，指示即將用來在 x 中分隔千位數的字元，預設值是在 [國別設定] 控制台中指定的字元(這個引數是可省略的)。 q 引數是單一字元的文字字串，指示即將在 x 中做為小數點分隔符號的字元。預設值是在 [國別設定] 控制台中指定的字元(這個引數是可省略的)。
|
| |
| z 引數是即將做為 A.M. (上午) 時間標籤的文字字串(這個引數是可省略的)。 w 引數是即將做為 P.M. (下午) 時間標籤的文字字串(這個引數是可省略的)。
|
| z 引數是即將做為 A.M. (上午) 時間標籤的文字字串(這個引數是可省略的)。 w 引數是即將做為 P.M. (下午) 時間標籤的文字字串(這個引數是可省略的)。
|
動作
ToText 函式將布林值、數字、貨幣、日期、時間與日期時間值轉換成文字字串。
典型用法
此函式可用來將布林值、數字、貨幣、日期、時間或日期時間值轉換成文字字串，而以文字的形式顯示在報表上 (信件、註解等)。
範例
ToText({orders.SHIPPED})當 ({訂貨主檔.已送貨}) 中的數值為 True 時，傳回 True。
ToText(123.45)
傳回 "123.45"。
ToText(12345.6749,2)
傳回 "12345.67"。
ToText(12345.6750,2)
傳回 "12345.68"。
ToText(12345.4999,0)
傳回 "12345"。
ToText(12345.5000,0)
傳回 "12346"。
ToText({file.AMT} * {file.QUANTITY})當 Amt = 24.45 且 Quantity = 1836 時，傳回 44,890.20。
若想將轉換過的數字或其他數值與其他文字字串組合 (串聯) 成句子時，ToText 就很有用：
"The base price of item # " + {file.ITEM NUMBER} + " is $" + ToText({file.BASE PRICE}) + "."會印出 "The base price of item A1/4520/B12 is $50.00." 這個句子，其中 Item number 是 A1/4520/B12，而 Base Price 是 50.00，並且已轉換成文字，格式化為兩位小數。
ToText(CDate(1996, 11, 1), "yy MMM dd, dddd")
傳回 96 Nov 01, Friday。
ToText(DateTime(1995,10,12,3,30,11),"HH:mm, yy MMMM ddd")
傳回 03:30, 95 October Thu。
ToText(Time(12, 10, 10), "HH*mm*ss tt", "amStr", "pmStr")
傳回 12*10*10 pmStr。
註解
轉換布林值：
將 ToText function 用於布林值時，最適合用來將布林值與其他文字組合 (串聯)。否則只要在 [格式編輯器] 的 [布林值] 索引標籤上變更格式，就可以在報表上以 True 或 False 形式顯示布林值欄位。
轉換數字與貨幣值：
如果指定小數位數，這個函式在將數字轉換成文字時不會刪減位數，而會四捨五入到指定的小數位數。如需有關四捨五入程序的詳細資訊，請參閱
「四捨五入」。
轉換日期、時間與日期時間值：
除了日期或時間格式字元之外，任何字元都可以用於格式字串中。例如，您可能想用斜線分隔日期的不同元素 (月、日、年)，如 "12/30/95"，或者您可能想用冒號分隔時間的不同元素 (時、分、秒)，如 "12:30:10 "。
如果想在格式字串中使用上述任何字元，必須將它們括在引號中。例如：ToText(CDateTime(1995,10,12,13,20,22), "MM/dd/yy hh 'h' mm 'min' ss 'sec' tt", 'am', 'pm') = "10/12/95 01 h 20 min 22 sec pm"
傳遞選擇性的引數：
ToText 函式的許多引數是指定為選擇性的引數。然而，如果某個引數後面的所有引數都空白，那麼這個引數也要空白。換句話說，不能只提供 w 引數，而將 y 與 z 引數空白。然而，只要空下來的引數後面不提供任何引數，就可以將一個、兩個或全部選擇性引數空白。為 ToText 函式提供引數時，可以有下列幾種組合：
若在時間格式字串中使用 "t" 或 "tt" 格式字元，就會提供預設字串來表示 a.m. (上午) 與 p.m. (下午) 時間。"t" 只會產生單一字元 "a" 或 "p"，"tt" 則會產生整個字串，"am" 或 "pm"。您可以傳遞您自己的自訂字串，來指示 am/pm 字串。(有關利用 ToText 轉換時間與日期時間值的引數，請參閱前述「引數」一節。)如果確已傳遞您自己的 am/pm 字串，"t" 與 "tt" 格式字元對它們具有同樣的作用 (產生單一字元對多字元字串)。