类型转换函数

内部数据类型进行类型转换的执行函数。



字符串格式转换数值函数(FormatRead)
涵义
按指定的格式对指定字符串进行解析,并将其转换为数值。
返回值
数据类型 注释
数值型 转换后的数值型数据。
详细参数
参数名 数据类型 注释
转换对象字符串 字符型 指定转换的字符串对象。
字符串解析格式 字符型 指定字符串解析格式的元字符组合。
元字符指定格式
  • 数值
    当转换为数值后,转换结果的精度为14位。 这是由于返回值的
    内部数据类型数值型。 转换结果可以写入内部数据类型对应的数值字符串型的输出表格栏中,但一旦转换为数值型后将被再次转换为数值字符串型,因此有效位将不能增加。
    9 将包含"," (comma)、"$"的字符串转换为数值(在函数中把"\"作为"$"进行处理)。
  • 日期
    当转换为日期后,转换后的数值结果将以(从1/1/1900起的天数,每天以1.0计算)来计算。 当年、月、日、时、分、秒被省略时,将以默认值(1/1/1900 0:00:00)来计算。 举个例子,当"转换对象字符串"为"12:34:56"并且"字符串解析格式"为"HH:MM:SS"时,返回值为0.5242592592(从1/1/1900到1/1/1900 12:34:56经过的天数)。由于1/1/1900被填满。
    yyyy 从指定位置读取的年份(4位数)。
    yy 从指定位置读取的年份(2位数)。
    从1964年到1999年为64到99。 从2000年到2063年则为00到63.
    ggg 备注
    gg 备注
    g 备注
    ee 备注
    e 备注
    mmmm 从指定位置读取的月份(英文全称)。
    "January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"。
    mmm 从指定位置读取的月份(英文简称)。
    "Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"。
    mm 从指定位置读取的月份(1位或2位数)。
    m
    dd 从指定位置读取的日期(1位或2位数)。
    d
    dddd 从指定位置读取的周日(英文全称)。
    "Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"。
    ddd 从指定位置读取的周日期(英文简称)。
    "Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"。
    aaaa 备注
    aaa 备注
    Am/Pm 从指定位置读取的"am"或"pm"。
    AM/PM 从指定位置读取的"AM"或"PM"。
    a/p 备注
    HH 从指定位置读取的小时(1位或2位数)。
    H
    MM 从指定位置读取的分钟(1位或2位数)。
    M
    SS 从指定位置读取的秒数(1位或2位数)。
    S
补充说明 1
补充说明 2
举例 1:转换为数值
转换对象字符串 字符串解析格式 转换结果
123456.789 9 123456.789
123,456.789 9 123456.789
-$123,456.789 9 -123456.789
举例 2:转换为日期
转换对象字符串 字符串解析格式 转换结果
1955/08/22 yyyy/mm/dd 20321(从1/1/1900到8/22/1955经过的天数(从1/1/1900起的天数,每天以1.0计算))
06:35 HH:MM 0.274305556(从1/1/1900到1/1/1900 6:35:00 am经过的天数(从1/1/1900起的天数,每天以1.0计算))


数值格式转换字符串函数(FormatWrite)
涵义
将数值(1900年1月1日起的天数),按指定的格式转换为字符串。
返回值
数据类型 注释
字符型 转换后的字符型数据。
详细参数
参数名 数据类型 注释
转换对象的数值 数值型 指定转换的数值对象(1900年1月1日起的天数)。
数值(日期/时间)解析格式 字符型 指定数值(日期/时间)解析格式的元字符组合。
元字符指定格式
  • 数值
    当转换为数值后,转换结果的精度为14位。 由于该类型是在被转换为字符型后再次被转换为数值型的。 转换后数值的有效位不能被增加,但
    内部数据类型可以指定转换数值的十进制数类型。 当有效位为15或超过15位,使用数值转换字符串函数进行校验。 然而在数值转换字符串函数中不能以指定的数值(日期/时间)解析格式进行转换。
    9 转换为1位的数字字符(无零限制)。
    Z 转换为1位的数字字符(零限制)。
    . 在指定位置设置小数点。
    , 每隔3位设置一个","(逗号)。
    + 在指定位置输出符号。 无论变换对象值是正数还是负数,变换结果一定有符号输出。
    - 在指定位置输出符号。 当数值为负数,输出该符号。 当数值为正数,输出空格。
    当元字符指定格式"+"、"-"不被使用,那么只有当数值为负数时符号才会在转换结果的左端被表示。
    其它字符 原封不动输出读写格式里的字符串。
  • 日期
    当日期被转换,从1/1/1900起的日期(从1/1/1900起的天数,每天以1.0计算)将被指定为转换对象的数值。
    yyyy 在指定位置输出年份(4位数)。
    yy 在指定位置输出年份(2位数)。
    从1964年到1999年对应为64到99。 从2000年到2063年对应为00到63。
    ggg 备注
    gg 备注
    g 备注
    ee 备注
    e 备注
    mmmm 在指定位置输出月份(英文全称)。
    "January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"。
    mmm 在指定位置输出月份(英文简称)。
    "Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"。
    mm 在指定位置返回月份(2位数)。
    m 在指定位置返回月份(1位或2位数)。
    dd 在指定位置返回日期(2位数)。
    d 在指定位置返回日期(1位或2位数)。
    dddd 在指定位置返回周日期(英文全称)。
    "Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"。
    ddd 在指定位置返回周日期(英文简称)。
    "Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"。
    aaaa 备注
    aaa 备注
    Am/Pm 向指定位置写入"am"或"pm"。
    AM/PM 向指定位置写入"AM"或"PM"。
    a/p 备注
    HH 向指定位置写入小时(2位数)。
    H 向指定位置写入小时(1位或2位数)。
    MM 向指定位置写入分钟(2位数)。
    M 向指定位置写入分钟(1位或2位数)。
    SS 向指定位置写入秒数(2位数)。
    S 向指定位置写入秒数(1位或2位数)。
补充说明 1
补充说明 2
举例 1:转换为数值
转换对象的数值 数值(日期/时间)解析格式 转换结果
123456.789 9.999 123456.789
123456.789 ZZZ,ZZZ,ZZ9.ZZZZZZ ssss123,456.789sss ("s"表示1个字符)
123456.789 Z,ZZ9 123,456
-123456.789 $ZZZ,ZZZ,ZZ9.999 -$ssss123,456.789 ("s"表示1个字符)
举例 2:转换为日期
转换对象的数值 数值(日期/时间)解析格式 转换结果
20321.274305556(从1/1/1900到8/22/1955 6:35:00 am经过的天数(从1/1/1900起的天数,每天以1.0计算)) yyyy/mm/dd 1955/08/22
20321.274305556(从1/1/1900到8/22/1955 6:35:00 am经过的天数(从1/1/1900起的天数,每天以1.0计算)) HH:MM 06:35


字符串转换数值函数(String2Number)
涵义
将字符型数据转换为数值型数据。
返回值
数据类型 注释
数值型 转换后的数值型数据。
详细参数
参数名 数据类型 注释
转换对象字符串 字符型 指定转换的字符串对象。
补充说明 1
补充说明 2


数值转换字符串函数(Number2String)
涵义
将数值型数据转换为字符型数据。
返回值
数据类型 注释
字符型 转换字符串。
当转换数值型数据时,转换对象的后6位小数部分将转换为字符串。 在小数部分后缀0将被零限制。 被零限制后,零不会转换为空格字符,因此字符串将会自行调整。 若小数部分是0,那么小数表记(小数点)也将被限制。
当转换数值型字符串数据时,数值型字符串数据的全部有效位将转换为字符串。 小数点后的位数由数值型字符串数据的有效位决定。 整数部分的头部0和小数部分的后缀0都是被限制的。 若小数部分为0位,那么小数表记(小数点)也将被限制。
当使用上述以外的格式进行字符串转换时,请尝试使用数值格式转换字符串函数。 但是,由于数值格式转换字符串函数是将数据由数值型转换为字符串的,因此在转换数值型字符串数据时,可能会引起有效位的丢失。
详细参数
参数名 数据类型 注释
转换对象的数值 数值型 指定转换对象的数值。
补充说明
  • 当"转换对象的数值"参数为NULL,返回值也将为NULL。


日期转换数值函数(Date2Number)
涵义
将日期型数据转换为数值型数据。
返回值
数据类型 注释
数值型 1900年1月1日起的日期/时间。
详细参数
参数名 数据类型 注释
转换对象日期值 日期型 指定转换对象的日期值。
种类 数值型 1:日期型
2:时间型
3:日期时间型
若种类未指定,则默认将被指定为"1:日期型"。
补充说明 1
  • 当"转换对象日期值"参数为NULL,返回值也将为NULL。
  • 当"种类"参数为不在1~3之间,函数将异常结束。
  • 当"种类"参数为不是整数(小数部分不为零),函数将异常结束。
  • 当"种类"参数为NULL,函数将异常结束。
补充说明 2
举例:
转换对象日期值 种类 转换结果
19550822063500 (8/22/1955 6:35 am对应的日期)。 1 20321
19550822063500 (8/22/1955 6:35 am对应的日期)。 2 0.274305556
19550822063500 (8/22/1955 6:35 am对应的日期)。 3 20321.274305556


数值转换日期函数(Number2Date)
涵义
将数值型数据转换为日期型数据。
返回值
数据类型 注释
日期型 转换后的日期值。
详细参数
参数名 数据类型 注释
天数 数值型 指定1900年1月1日起的天数(数值一天以1.0计算)。
种类 数值型 1:日期型
2:时间型
3:日期时间型
若种类未指定,则默认将被指定为"1:日期型"。
补充说明 1
  • 当转换的数据类型数据超出可转换范围,函数将异常结束。
  • 当"天数"参数为NULL,返回值也将为NULL。
  • 当"种类"参数不在1~3之间,函数将异常结束。
  • 当"种类"参数不是整数(小数部分不为零),函数将异常结束。
  • 当"种类"参数为NULL,函数将异常结束。
补充说明 2
举例:
天数 种类 转换结果
20321.274305556(从1/1/1900到8/22/1955 6:35:00 am经过的天数(从1/1/1900起的天数,每天以1.0计算)) 1 19550822 (8/22/1955对应的日期)。
20321.274305556(从1/1/1900到8/22/1955 6:35:00 am经过的天数(从1/1/1900起的天数,每天以1.0计算)) 2 19000101063500(1/1/1900 6:35:00 am对应的日期)(日期部分变为1/1/1900)
20321.274305556(从1/1/1900到8/22/1955 6:35:00 am经过的天数(1/1/1900 6:35:00 am对应的日期)) 3 19550822063500(8/22/1955 6:35:00 am对应的日期)


日期转换字符串函数(Date2String)
涵义
将日期型数据转换为字符型数据。
返回值
数据类型 注释
字符型 转换后的字符串。
详细参数
参数名 数据类型 注释
转换对象日期值 日期型 指定转换的日期值对象。
种类 数值型 1:日期型
2:时间型
3:日期时间型
若种类未指定,则默认将被指定为"1:日期型"。
补充说明
  • 当"转换对象日期值"参数为NULL,返回值也将为NULL。
  • 当"种类"参数为不在1~3之间,函数将异常结束。
  • 当"种类"参数为不是整数(小数部分不为零),函数将异常结束。
  • 当"种类"参数为NULL,函数将异常结束。
举例:
转换对象日期值 种类 转换结果
19550822154500 (8/22/1955 15:45:00对应的日期) 1 19550822
19550822154500 (8/22/1955 15:45:00对应的日期) 2 154500
19550822154500(8/22/1955 15:45:00对应的日期) 3 19550822154500


字符串转换日期函数(String2Date)
涵义
将字符型数据转换为日期型数据。
返回值
数据类型 注释
日期型 转换后的日期值。
详细参数
参数名 数据类型 注释
转换对象半角字符串 字符型 指定转换的半角字符串对象。
种类 数值型 1:日期型
2:时间型
3:日期时间型
若种类未指定,则默认将被指定为"1:日期型"。
补充说明
  • 当转换的数据类型数据超出可转换范围,函数将异常结束。
  • 当转换数据为无效,函数将异常结束。
  • 当转换类型不能被执行,函数将异常结束。
  • 当"转换对象半角字符串"参数为NULL,返回值也将为NULL。
  • 当"转换对象半角字符串"参数为零长度字符串,返回值为19000101000000(1/1/1900 0:00:00 am对应的日期)。
  • 当"种类"参数为不在1~3之间,函数将异常结束。
  • 当"种类"参数为不是整数(小数部分不为零),函数将异常结束。
  • 当"种类"参数为NULL,函数将异常结束。
举例:
转换对象半角字符串 种类 转换结果
19550822 1 19550822 (8/22/1955对应的日期)
195508221545 2 19000101154500 (1/1/1900 15:45:00对应的日期)(日期部分变为1/1/1900)
195508221545 3 19550822154500 (8/22/1955 15:45:00对应的日期)