在 Salesforce 中計算工作天數,核心就是計算兩個日期欄位之間的週一到週五天數,並把星期六和星期日從結果中剔除——Salesforce 並未內建 NETWORKDAIDS 之類的函式,因此你必須自行在公式欄位、記錄觸發流程,或小型 Apex 類別中撰寫計算邏輯。經典的宣告式做法會使用 MOD 函式偵測起始日為星期幾,再以 CASE 運算式從包含起訖日的日期跨度中扣除週末天數,最終回傳一個純數值,你可以將它放在頁面配置、報表中,或驗證規則裡。若需要在平台之外做臨時驗算——例如確認截止日期、檢查流程輸出是否合理、或規劃一個衝刺——瀏覽器型的工作天數計算機同樣能在兩次點擊內給出相同的包含起訖日計數,並允許你以逗號分隔的清單輸入選用的假日。無論走哪一條路徑,最終算出的都是同一個「星期一至星期五」天數,只要起訖日本身落在工作日,也都會一併計入。
這個單一事實——答案就是一段日期範圍內的工作日天數,端點若為工作日則計入——正是串起以下所有做法的核心。各方法的差異多半在於「計算邏輯放在哪裡」(Salesforce、瀏覽器,或你自己的腦袋),以及你願意承擔多少維護成本。

Salesforce 中所謂的工作日是什麼
在 Salesforce 報表中,工作日指的是落在兩個日期之間的星期一、星期二、星期三、星期四或星期五。星期六和星期日一律排除。起始日和結束日只要落在工作日,都會計入——這與試算表 NETWORKDAYS 函式的包含起訖行為一致,因此星期一早上開啟、星期五下午結案的個案會顯示為 5 個工作日,而非 4 個。
國定假日是另一個層次的問題。Salesforce 並沒有內建的假日曆,因此任何應該把元旦或地區性國定假日從計算中扣除的需求,都必須透過自訂物件、寫死的 CASE 清單,或外部查詢來處理。純粹的公式欄位無法自行去讀取假日資料表,這也是為什麼一旦涉及假日,許多團隊會改用流程的主要原因。
建立工作天數公式欄位
在記錄上顯示工作天數最快速的做法就是公式欄位。它會在每次讀取時執行,因此永遠反映底層日期欄位的最新值,而且不需要排程作業。
- 進入「設定」,開啟「物件管理員」,並選擇持有兩個日期欄位的物件(例如 Case、Opportunity、自訂的 Order 物件,依此類推)。
- 選擇「欄位與關係」→「新增」,然後將欄位類型選為「公式」。
- 將公式回傳類型設為 Number,小數位數設為 0。
- 使用 MOD、CASE 以及兩個日期欄位的相減來建立公式主體。其模式為:計算包含起訖日的日曆天數(結束日減去起始日再加 1),用 MOD(start − anchor, 7) 偵測起始日為星期幾,再透過 CASE 從範圍的剩餘尾部扣除正確的週末天數。
- 點擊「檢查語法」,為欄位命名(例如 Business Days Open),然後儲存。
- 將新欄位加入相關的頁面配置和報表類型,讓它顯示在所依賴的日期欄位旁邊。
真正的公式是唯一需要留意的部分。一個常見的做法是先扣掉完整的週末週數(每 7 個日曆日必定包含 2 個週末日),再透過檢查端點落在星期幾來修剪剩餘的尾部。結果就是該範圍內工作日的包含起訖計數。
公式欄位快速且採宣告式做法,但它會在每次讀取記錄時重新計算,且無法自行查詢假日資料表。對大多數團隊而言,只要問題單純是「兩個已儲存日期之間經過幾個工作日」,這樣做就已足夠。
在記錄觸發流程中實作
當你需要假日、業務時間邏輯,或一個可供查詢的儲存計數時,記錄觸發流程通常是在平台內最乾淨的做法。流程會在記錄建立或更新時執行一次,於單一 Assignment 元素中完成週末計算,並將結果寫入一個 Number 欄位,報表和清單檢視可直接讀取。
- 從「設定」進入「流程」,建立一個新的記錄觸發流程。
- 設定進入條件,讓流程在兩個相關日期其中之一被建立或變更時觸發。
- 新增一個 Assignment 元素,計算包含起訖日的日曆天數並扣除週末日,使用與公式欄位相同的 MOD 搭配 CASE 模式。這裡的優勢在於你可以使用中介變數,並在上線前用「除錯流程」工具檢查結果。
- 如果需要處理假日,新增一個 Get Records 元素,從自訂的 Holiday__c 物件中擷取符合條件的紀錄,然後迴圈比對,當每個假日落在日期範圍內且為工作日時就予以扣除。
- 新增一個 Update Records 元素,將最終計數寫回記錄上的 Number 欄位。
- 儲存並啟用流程,然後用一組已知日期進行測試,再於正式環境中依賴其結果。
流程的設定工作比公式欄位多,但它換來一個儲存值、更容易除錯的環境,以及一個附加假日邏輯的乾淨位置。
當你需要把假日納入計算時
Salesforce 並未內建國定假日曆。任何假日邏輯都必須由你自行提供。以下三種做法可涵蓋大多數情境:
- 寫死的清單。在公式中使用 CASE 運算式,扣除範圍內落在工作日的已知假日。便宜又快速,但每年都需要編輯。
- 自訂物件。建立一個含 Date 欄位的 Holiday__c 物件,讓流程或 Apex 迴圈查詢落在兩個日期之間的紀錄。日後更新隔年假日時,只要新增紀錄即可。
- 外部服務。從 Apex 類別或 future 方法呼叫假日 API,並快取結果。適合跨地區團隊,但會把外部相依性帶入你的計算邏輯。
無論選擇哪一種方式,都只計算落在你的日期範圍內且為工作日的假日。落在星期六的元旦不會改變工作日計數,因為星期六本來就不是工作日。假日表中重複列出的日期仍只應扣除一天。
在 Salesforce 之外快速驗算
當你需要快速得到答案——例如在撰寫公式前估算專案截止日、檢查流程結果是否合理、或在長週末前後規劃衝刺——工作天數計算機可在你的瀏覽器中以相同方式進行包含起訖日的計算,而且不會將日期送往伺服器。它會計算星期一至星期五的工作日,並在工作日總數之外一併顯示總日曆天數與週末天數,還可讓你貼上以逗號分隔的 YYYY-MM-DD 假日清單予以扣除。讓流程使用者得以稽核儲存值的那一招,在此同樣可讓你稽核公式結果:選取流程產出的兩個日期,看看瀏覽器的答案是否一致。
若想更深入了解同一套包含起訖日的慣例——以及它如何出現在其他商業應用程式中——兩日期之間工作天數的逐步解析會一步一步拆解其背後的數學。
如何使用工作天數計算機
此工具設計為鏡像 NETWORKDAYS 的包含起訖行為,因此答案會與你的 Salesforce 公式或流程應該回傳的結果一致。
- 選擇起始日期——計算機預設為今天,請依你實際關心的期間進行調整。
- 選擇結束日期;工作日計數、總天數與週末天數會即時更新,無需按下任何按鈕。
- 選用:將假日以逗號分隔的 YYYY-MM-DD 日期貼入假日欄位,即可從工作日總數中扣除。
操作範例。假設你把起始日設為 2025 年 3 月 3 日星期一、結束日設為 2025 年 3 月 7 日星期五。包含起訖日的日曆天數為 5 天,且剛好涵蓋一個完整的星期一至星期五週,因此計算機會回報 5 個工作日、5 個總日數,以及 0 個週末日。新增一個落在該範圍內且為工作日的假日,工作日總數就會減 1。
解讀計算機回報的數字
在工作日總數旁會顯示三個數字,讓你無需手動計算即可驗證結果。
- 工作日。你選定範圍內星期一至星期五的包含起訖計數,並扣除選用的假日。
- 總天數。從起始日到結束日的完整包含起訖日曆天數。
- 週末日。已從工作日總數中扣除的星期六與星期日數量。
- 扣除的假日。假日清單中實際落在範圍內、為工作日,因此被扣除的日期數量。
快速心算驗證:工作日 + 週末日 + 扣除的假日 應等於 總天數,前提是每個列出的假日都落在範圍內且為工作日。
Salesforce 做法 vs. 計算機:何時該用哪一個
| 做法 | 設定成本 | 可處理假日 | 儲存於記錄 | 最適合的情境 |
|---|---|---|---|---|
| 公式欄位 | 低 | 僅透過寫死清單 | 否(讀取時重新計算) | 假日很少變動的輕量計數 |
| 記錄觸發流程 | 中 | 是,透過自訂 Holiday 物件 | 是 | 正式環境的報表與稽核友善計數 |
| Apex 類別 | 高 | 是,具備完整邏輯 | 選用 | 跨地區、批次,或服務層邏輯 |
| 瀏覽器計算機 | 無 | 是,透過選用的逗號分隔清單 | 否 | 快速驗算、規劃截止日、驗證公式 |
請記住的核心觀念是:無論在哪個平台上執行,背後的數學——完整週數乘以 5,再加上星期幾的尾數——其實都是一樣的。真正改變的是公式放在哪裡,以及你需要付出多少維護成本。
若你正在權衡各種選項,《淺談日期加法運算》對此有更詳細的說明。