函数列表

Cast Iron® Express® 提供一些函数供选择以在映射内使用。这些函数可用于对映射的字段值执行操作,如修改字符串的内容、对数字执行数值操作以及操作日期和时间值。

缺省情况下,当您注册 Cast Iron Express 帐户时,会禁用此功能。要使用该附加功能,请单击附加组件,然后选择映射函数包。有关更多信息,请参阅向您的 Express 帐户添加新功能

表 1. 字符串函数. 该表列出并描述了字符串函数
映射函数 描述

Concatenate

接受两个或更多个自变量,并将它们强制转换为字符串。返回转换后其自变量值并置成的字符串。用户还可以配置前缀和/或后缀字符串,以及将在每个自变量之间插入的定界符。

Length

返回等于自变量值字符长度的整数。如果自变量的值为空序列,那么返回整数 0。

Lowercase

按照 Unicode 标准中相应大小写映射部分中的定义将每个字符转换为其对应的小写形式后,返回自变量的值。

Uppercase

按照 Unicode 标准中相应大小写映射部分中的定义将每个字符转换为其对应的大写形式后,返回自变量的值。

Replace

返回通过将与给定模式匹配的输入的每个非重叠子串替换为出现的替换字符串获取的字符串。

Starts with

返回指示第一个自变量值是否以第二个自变量值开头的布尔值结果。

String

返回表示为字符串的自变量的值。该值可以用于将数字数据类型强制转换为字符串以防止映射显示警告。

Substring

返回从第二个自变量值指示的位置开始,一直到第三个自变量值指示的字符数为止,第一个自变量值部分。对于子串,只有一个字段作为函数的“输入”。但是,对于函数,是在函数对话框窗口中配置开始索引和长度值。 在现有文本(和所有其他描述)中,自变量用于两种情况。

Trim

返回通过除去前导和结尾空格以及使用一个空格替换一个或多个空格字符序列规范化空格的自变量值。

表 2. 数学函数. 该表列出并描述了数学函数
映射函数 描述

Absolute value

返回数字的数字值(或模数),与其符号无关。

Mean

返回输入序列中的值的平均值,即,值总和除以值数目。

Ceiling

返回不小于 X 的最小整数。

Divide

返回第一个自变量除以第二个自变量后的结果值。

Floor

返回不大于 X 的最大整数。

Format

format-number 函数使用第二个自变量指定的格式模式字符串以及第三个自变量指定的小数格式或缺省小数格式(如果没有第三个自变量)将其第一个自变量转换为字符串。

第二个自变量的格式化选项如下所示:
  • 0 - 数字
  • # - 数字(如果不存在则显示为 0)
  • . - 小数点的位置。 例如:###.##
  • , - 千分位的组分隔符。 例如:###,###.##
  • % - 以百分比显示数字。 例如:##%
  • ; - 模式分隔符。第一个模式用于正数,第二个用于负数
第三个参数的小数格式可帮助数字的本地化,可使用以下选项:
  • 0 - 数字
  • # - 数字(如果不存在则显示为 0)
  • . - 小数分隔符或货币小数分隔符
  • - - 减号
  • , - 分组分隔符
  • E - 分隔科学计数法中的尾数和指数。在前缀或后缀中不需要加引号
  • ; - 分隔正数和负数子模式
  • % - 乘以 100 并显示为百分数
  • \u2030 - 乘以 1000 并显示为千分数
  • ¤ (\u00A4) - 货币记号,由货币符号替换。如果两个同时出现,则用国际货币符号替换。 如果出现在某个模式中,则使用货币小数分隔符,而不使用小数分隔符。
  • ' - 用于在前缀或或后缀中为特殊字符加引号。例如,'#'#123 格式化为 #123。 要创建单引号本身,请连续使用两个单引号:# o''clock

Maximum

返回作为自变量传递的节点的最大值。

Minimum

返回作为自变量传递的节点的最小值。

Modulo

返回第一个自变量除以第二个自变量后的模数或余数值。

Multiply

返回所有自变量相乘的值。

Number

将自变量转换为十进制。

Round

返回最接近自变量,没有小数部分的数字。如果有两个此类数字,将返回最接近正无穷大的那个。

Subtract

返回从第一个自变量减去第二个自变量的值。

Sum

返回通过将自变量中的值相加获得的值。

表 3. 布尔值函数. 该表列出并描述了布尔值函数
映射函数 描述

Boolean

计算自变量的有效布尔值。

Not

如果有效布尔值为 false,返回 true,如果有效布尔值为 true,返回 false。

表 4. 日期函数. 该表列出并描述了日期函数
映射函数 描述

Date Time (Date)

第一个自变量必须采用日期格式,第二个自变量采用时间格式。自变量的结果为具有日期和时间的 DateTime 格式。

Date to String (Date)

第二个自变量为显示如何格式化日期/时间的字符串。以下键字符由日期/时间部分替换:
  • yy - 年份的最后两位数。例如,1986 的 86。
  • MM - 两位数月份
  • dd - 两位数日期
  • HH - 两位数小时
  • mm - 两位数分钟
  • ss - 两位数秒

例如,如果使用以下输入参数调用格式化日期字符串函数:

dateTime: 2012-02-22T16:18:00.852-08:00

格式字符串:MM/dd/yyyy

语言环境字符串:en_US

可能返回以下字符串:02/22/2012。

有关 Date to String 函数的更多信息,请参阅 Studio 帮助部分中的“格式化日期字符串”主题。

Adjust to Timezone (Date)

转换 TimeDate 以保持特定时区,或转换为无。应用的时区为第二个自变量,如:
  • -10H - 减 10 小时的时区
  • +5H30M - 加 5 小时 30 分钟的时区
  • 0H - 0 时的时区
表 5. 实用程序函数. 该表列出并描述了实用程序函数
映射函数 描述

Composite

将一系列函数链接起来。




反馈 | 声明


http://pic.dhe.ibm.com/infocenter/wci/v7r0m0/topic/com.ibm.wci.api.omniapps.doc/Integrations_ListOfFunctions.html