说明
CStr 函数将数字、货币、日期、时间和日期时间值转换成文本字符串。
参数
| |
|---|
| 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.(下午)时间的标记。(此参数是可选的。)
|
操作
CStr 函数将数字、货币、日期、时间和日期时间值转换成文本字符串。
典型用法
使用该函数将数字、货币、日期、时间或日期时间值转换成一个将显示为报表中的文本(套用信函、注释等)的文本字符串。
示例
CStr ({Orders.Shipped})如果 {订单.已发货} 的值是 True,则返回“True”。
CStr(123.45)
返回“123.45”。
CStr(12345.6749,2)
返回“12345.67”。
CStr(12345.6750,2)
返回“12345.68”。
CStr(12345.4999,0)
返回“12345”。
CStr(12345.5000,0)
返回“12346”。
CStr({file.AMT} * {file.QUANTITY})返回“44,890.20”,其中 Amt = 24.45,Quantity = 1836。
在希望通过将转换后的数字或其他值与其他文本字符串进行组合(连接)以生成一个句子时,CStr 非常有用:
"The base price of item # " + {file.ITEM NUMBER} + " is $" + CStr({file.BASE PRICE}) + "."打印句子“The base price of item A1/4520/B12 is $50.00.”,其中 Item number 为 A1/4520/B12,Base Price 为 50.00,后者被转换成文本并带两位小数。
CStr(CDate(1996, 11, 1), "yy MMM dd, dddd")
返回“96 Nov 01, Friday”。
CStr(CDateTime(1995,10,12,3,30,11),"HH:mm, yy MMMM ddd")
返回“03:30, 95 October Thu”。
CStr(CTime(12, 10, 10), "HH*mm*ss tt", "amStr", "pmStr")
返回“12*10*10 pmStr”。
注释
转换布尔值:
CStr 函数在与布尔值一起用来组合(连接)布尔值与其他文本时非常有用。不过,只更改“格式编辑器”中布尔值选项卡上的格式就可以将布尔值字段的格式设置为在报表中显示 True 或 False。
转换数字和货币值:
如果已经指定了小数位数,该函数在转换成文本时并不截断该数,而是将该数四舍五入到指定的小数位数。有关四舍五入过程的更多信息,请参阅
“Round”。
转换日期、时间和日期时间值:
任何字符(日期或时间格式字符除外)都可以在格式字符串中使用。例如,您可能想用斜杠符号来分隔不同的日期元素(年、月、日),如“12/30/95”,也可能想用冒号来分隔不同的时间元素(时、分、秒),如“12:30:10”。
如果想在格式字符串中使用上述字符中的任意一种,则这些字符必须用引号引起来。例如:CStr(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"
传递可选参数:
CStr 函数的许多参数已被指定为可选。然而,也可以只将一个参数置空,条件是将所有跟随的参数都置空。也就是说,您不可以将 y 和 z 参数置空,而只给 w 提供参数。然而,将一个、两个或全部可选参数置空是可能的,只要不在空白参数后提供任何参数就行。在给 CStr 函数提供参数时,下列组合是可行的:
在时间格式字符串中使用“t”或“tt”格式字符提供默认的字符串,用来表示 a.m.(上午)和 p.m.(下午)时间。“t”只产生单个字符“a”或“p”,而“tt”产生整个字符串“am”或“pm”。可以传递自定义的字符串,用来表明 am/pm 字符串。(有关用 CStr 转换时间值和日期时间值时所用参数的信息,参见上面的“参数”部分。)如果确实传递了自定义的 am/pm 字符串,则“t”和“tt”格式字符将对它们产生相同的效果(生成单个字符和生成多个字符的字符串)。