函數清單

Cast Iron® Express® 可選取在對映內使用的函數。這些函數可以用來操作所對映的欄位值,例如,變更字串內容、對數字執行數值作業,以及操作日期和時間值。

依預設,當登錄 Cast Iron Express 帳戶時,會停用此函數。若要使用這個額外函數,請按一下附加程式,並選取對映函數 套件。如需相關資訊,請參閱新增函數至 Express 帳戶

表 1. 字串函數. 此表格列出和說明字串函數
對映函數 說明

連結

接受兩個以上的引數,並將它們強制轉型為字串。傳回轉換之後為其引數值連結的字串。使用者也可以配置字首和(或)字尾字串,以及將在每一個引數之間插入的定界字元。

長度

傳回等於引數值長度(以字元為單位)的整數。如果引數值是空序列,則會傳回整數 0。

小寫

將每個字元轉換為其小寫對應項目(定義於 Unicode 標準的適當大小寫對映小節中)之後,傳回引數值。

大寫

將每個字元轉換為其大寫對應項目(定義於 Unicode 標準的適當大小寫對映小節中)之後,傳回引數值。

取代

傳回透過下列作業所取得的字串:將輸入中符合所提供型樣的每一個非重疊子字串,取代為出現的取代字串。

開始於

傳回布林結果,指出第一個引數值的開頭是否為第二個引數的值。

字串

傳回以字串形式代表的引數的值。此值可以用來將數值資料類型強制轉型為字串,以防止對映顯示警告。

子字串

傳回在第二個引數值所指出位置開始的第一個引數值的部分,並持續第三個引數的值所指出的字元數。若為子字串,只有一個欄位作為函數的「輸入」。不過,若為函數,起始索引和長度值是配置於函數對話視窗中。在現有文字(和所有其他說明)中,引數 用於這兩種狀況中。

修整

傳回含有空格的引數值,該值是透過下列方式正規化:刪除前置和尾端空格,並將一系列一個以上空格字元取代為單一空格。

表 2. 數學函數. 此表格列出和說明數學函數
對映函數 說明

絕對值

傳回數字的數值(或模數),而不考慮其正負號。

平均值

傳回輸入順序中值的平均值(即值的總和除以值的數目)。

上限

傳回不小於 X 的最小整數。

傳回第一個引數除以第二個引數的結果值。

下限

傳回不大於 X 的最大整數。

格式

format-number 函數會將它的第一個引數轉換為字串,方法為使用第二個引數所指定的格式型樣字串,以及第三個引數所指定的十進位格式,或是預設十進位格式(如果沒有第三個引數)。

第二個參數的格式選項如下:
  • 0 - 數字
  • # - 數字(零顯示為不存在)
  • . - 小數點的位置。例如:###.##
  • , - 千位群組分隔字元。例如:###,###.##
  • % - 以百分比顯示數字。例如:##%
  • ; - 型樣分隔字元。第一個型樣會用於正數,第二個則是用於負數
第三個參數的十進位格式可協助本地化數字,而且可以使用下列選項:
  • 0 - 數字
  • # - 數字(零顯示為不存在)
  • . - 小數點或貨幣小數點
  • - - 減號
  • , - 分組分隔字元
  • E - 以科學記號表示法區隔假數與指數。字首或字尾中不需要加上引號
  • ; - 區隔正數與負數子型樣
  • % - 乘上 100,並以百分比顯示
  • \u2030 - 乘上 1000,並以千分比值顯示
  • ¤ (\u00A4) - 貨幣符號,取代為貨幣符號。如果加倍,則取代為國際貨幣符號。如果出現在型樣中,則會使用貨幣小數點,而不是小數點
  • ' - 用來括住字首或字尾中的特殊字元。例如,'#'#123 格式化為 #123。若要建立單引號本身,請連續使用兩個:# o''clock

上限

傳回傳遞為引數的節點的最大值。

下限

傳回傳遞為引數的節點的最小值。

模數

傳回模數,或第一個引數除以第二個引數之後的餘數值。

傳回所有引數相乘的值。

數字

將引數轉換為十進位。

捨入

傳回最接近引數且沒有小數部分的數字。如果有兩個這類數字,則會傳回最接近正無限大的數字。

傳回第一個引數減去第二個引數的值

總和

傳回將引數中的值相加而取得的值。

表 3. 布林函數. 此表格列出和說明布林函數
對映函數 說明

布林

計算引數的有效布林值。

如果有效布林值為 false,則傳回 true,如果有效布林值為 true,則傳回 false。

表 4. 日期函數. 此表格列出和說明日期函數
對映函數 說明

日期時間(日期)

第一個引數必須為日期格式,而第二個引數是時間格式。結果是引數中同時具有日期和時間的 DateTime 格式。

日期到字串(日期)

第二個引數是顯示如何格式化日期/時間的字串。下列重要字元會取代為日期/時間的各部分:
  • 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。

如需「日期到字串」函數的相關資訊,請參閱 Studio 說明小節中的「格式化日期字串」主題。

調整到時區(日期)

轉換 TimeDate 以保留特定時區,或轉換為無。例如,套用的時區是第二個引數:
  • -10H - 減去 10 小時的時區
  • +5H30M - 加上 5 小時 30 分鐘的時區
  • 0H - 0 小時的時區
表 5. 公用程式函數. 此表格列出和說明公用程式函數
對映函數 說明

複合

鏈結一系列函數。




意見 | 注意事項


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