在 Salesforce 公式中使用 VALUE(Text_Field__c),可將包含數字的文字欄位轉換為數字。
請將 Text_Field__c 替換為實際文字欄位的 API 名稱。產生的公式可向其他計算、比較或公式欄位提供數值。它不會變更儲存的欄位或其資料類型;只有在評估公式時才會轉換文字。
有一項重要差異會影響工作流程:Salesforce 的 VALUE() 只能處理數字文字,不能處理以英文文字拼寫的數字。若記錄包含「two hundred forty-six」,請先在 Salesforce 外部將該片語轉換為數字,再將數字表示形式放入文字欄位,並依照下文使用 VALUE()。

VALUE() 在 Salesforce 公式中會變更什麼
Salesforce 公式欄位可以使用 VALUE(),將數字的文字表示形式轉換為數值結果。來源欄位必須包含 VALUE() 能解讀為數字的值。若來源已是 Number 欄位,請直接參照該欄位;不需用 VALUE() 加以包裝。
| 來源條件 | 公式模式 | 預期行為 |
|---|---|---|
| 文字欄位僅包含數字 | VALUE(Text_Field__c) | 為周圍的公式傳回數值。 |
| 文字欄位為空白 | IF(ISBLANK(Text_Field__c), 0, VALUE(Text_Field__c)) | 使用此模式中明確指定的備援值。 |
| 文字欄位包含非數字字詞 | VALUE(Text_Field__c) | 當文字無法轉換時,產生公式錯誤。 |
| 來源欄位已是 Number 欄位 | Text_Field__c | 不需使用 VALUE(),直接使用儲存的數字。 |
因此,VALUE() 是數字字串轉換器,而不是英文數字解析器。標籤、貨幣名稱、單位、多餘的標點符號或數字字詞片語,仍可能使公式失敗。請測試來源系統實際產生的精確文字,不要假設外觀相似的值會以相同方式轉換。
此轉換也不會改寫原始記錄。若您的組織必須保留原始措辭以供稽核追蹤,請讓原始欄位保持不變,並將轉換後的數字存放於獨立的暫存或工作欄位。
在 Salesforce 中建立文字轉數字的公式
請在需要 Number 輸出的位置建立公式,並在整個運算式中使用來源欄位的實際 API 名稱。
- 識別來源欄位。 在 Salesforce Setup 中開啟 Object Manager,選擇相關物件,然後選取 Fields & Relationships。確認來源為 Text 欄位,並記下其 API 名稱。自訂欄位的名稱通常以 __c 結尾,標準欄位則使用其各自的標準名稱。
- 選擇公式的目的位置。 若要建立新的公式欄位,請選取 New,然後選擇 Formula,並將公式輸出類型設為 Number。若計算已存在於現有的 Number 公式中,請改為開啟該公式。
- 輸入核心轉換。 請先輸入 VALUE(Text_Field__c)。將 Text_Field__c 替換為來源欄位的 API 名稱,並保留其大小寫及任何必要的欄位後綴。
- 決定空白的處理方式。 防範空白的模式為 IF(ISBLANK(Text_Field__c), 0, VALUE(Text_Field__c))。此範例中的零是業務規則,並非自動轉換結果。若空白應產生其他結果,請將該備援值替換為適當的值。
- 儲存前測試無效值。 當 VALUE() 遇到無法轉換的文字字串時,Salesforce 會傳回錯誤。請檢查來源欄位是否意外空白、包含標籤或標點符號,或存放的是片語而非數字。
- 儲存並驗證下游使用情況。 請儲存公式,檢查具有有效與無效來源值的記錄,然後測試將使用此數值輸出的位置。公式在編輯器中看似有效,仍可能在特定記錄上失敗。
實例:從數字字詞轉換為 Salesforce 數字
假設來源片語為 「two hundred forty-six」。請在 Words to Numbers Converter 中僅輸入該片語,選擇 Convert to digits,並讀取結果 246。若數字表示形式已儲存在 Salesforce 文字欄位中,核心公式 VALUE("246") 會求值為數字 246。這是手動準備步驟;Salesforce 公式本身並不會呼叫瀏覽器轉換器。
在拼寫的值送入 Salesforce 前先加以準備
Words to Numbers Converter 僅適用於輸入為明確英文基數整數片語的情況。它可接受從零到十億尺度的值,包括選用的連字號、連接詞「and」,以及由「minus」或「negative」引入的負號。其嚴格解析器很有用,因為它會傳回錯誤,而不會猜測格式錯誤的措辭。
- 只將英文基數整數片語複製到轉換器中。移除周圍的標籤、說明文字、單位及貨幣名稱。
- 選擇 Convert to digits。
- 讀取以逗號分隔的整數結果。
- 若出現錯誤,請修正標示出的文法邊界,或移除不支援的單位、小數及周圍的說明文字。
- 將產生的數字用於提供 Salesforce 公式資料的文字欄位或來源記錄。若您的流程要求稽核追蹤,請勿覆寫原始片語。
| 片語或條件 | 轉換器行為 | 動作 |
|---|---|---|
| 帶連字號或不含連字號的複合詞 | 接受 | 可保留任一熟悉的拼寫形式。 |
| 「One hundred and five」 | 接受 | 在熟悉形式中,可以使用此連接詞。 |
| 「One million million」 | 拒絕 | 尺度字詞必須依序由十億遞減為百萬,再遞減為千。 |
| 「Zero five」 | 拒絕 | 零可單獨使用,但不能置於較大的基數片語中。 |
| 小數、百分比、貨幣、序數、科學記號、電話形式的數字字串、lakh 或 crore 分組,以及非英文數字系統 | 拒絕 | 請為該格式使用獨立且明確的文法,不要強迫將其納入整數轉換器。 |
支援的整數範圍為負 999,999,999,999 至正 999,999,999,999。在此範圍內,hundred 必須接在 1 至 9 的值之後,而十位數字詞後最多只能接一個單位。這些是轉換器的限制,而非 Salesforce 本身處理數字的限制。
所有解析作業都在目前的瀏覽器分頁中進行。轉換器不會上傳、保留、翻譯或將片語傳送至伺服器。其確定性處理表示,同一有效片語每次都會產生相同的整數,而無效片語則會產生特定錯誤。其語言表格遵循 Unicode LDML Part 3 rule-based number formatting,並另外參照 EF’s guide to numbers in English 進行檢查。
轉換器會顯示以逗號分隔的結果。若 Salesforce 必須評估更長的數字字串,請在您的組織中測試貼上的表示形式。若已確認逗號是千位分隔符,但 VALUE() 拒絕這些逗號,請儲存純數字,或使用 VALUE(SUBSTITUTE(Text_Field__c, ",", "")) 明確移除逗號。在確認預期格式前,請勿對小數逗號或其他地區特定慣例套用此清理方式。
對空白與無效項目採用明確政策
可靠的公式取決於可靠的輸入契約。請明確定義來源欄位允許哪些表示形式、由誰負責修正,以及缺少值時應進行哪些下游計算。
- 空白值: 當缺少記錄而需要明確的備援值時,請使用 ISBLANK()。請決定備援值應為零、其他業務值,或應在公式外部產生錯誤。
- 非數字文字: VALUE() 無法將任意說明文字轉換為數字。請修正來源,不要假設會產生看似合理的結果。
- 數字字詞片語: 若其符合轉換器嚴格的英文基數整數規則,請先透過瀏覽器工具轉換。對於不支援的格式,請定義獨立的轉換規則。
- 分隔符與格式: 請盡可能儲存純數字,或僅正規化已確認在資料中具有特定意義的分隔符。
- 原始記錄: 若可追溯性很重要,請保留來源文字。讓公式或暫存欄位承載數字表示形式。
請勿將某筆記錄成功轉換的結果,視為每筆記錄都能正常運作的證據。最嚴格的測試集應包含使用者實際貼入欄位的格式變體,尤其是空白、負號、不一致的分隔符及句子片段。
在轉換結果驅動下游工作前先加以測試
將 Salesforce 公式發佈至正式環境前,請使用具代表性的記錄進行測試。內容應包含正整數、負整數、零、空白,以及已通過數字字詞轉換器的值。也請包含格式錯誤的文字,讓管理員能看見預期的失敗,而不是在報表週期中才發現問題。
- 確認每個有效數字字串都會在 Number 公式欄位中產生預期的數值行為。
- 確認空白記錄會遵循您刻意選定的備援政策。
- 確認不支援的數字字詞片語會明確失敗,並由準備工作流程處理。
- 檢查負號、連字號及連接詞「and」是否符合轉換器的文件規則。
- 請使用實際來源資料,而非手動輸入的範例,驗證任何千位分隔符清理方式。
- 請在公式結果會提供給其他公式、比較或操作流程的各處進行測試。
當來源包含財務、法律或測量值時,請先將轉換結果與原始來源比較,再於下游使用該數字。進行語音轉錄時,也請將書寫的片語與錄音比較:省略尺度字詞,可能使數值相差數個數量級。轉換器與 VALUE() 能使表示形式成為數字,但無法還原原始文字中遺失或轉錄錯誤的資訊。
如需更深入了解,請參閱 BAC Calculator by Hour: Formula, Inputs, and Limits。
如需更深入了解,請參閱 Chinese Gender Predictor Formula: Myth vs. Chart Lookup。