HOWTO · JavaScript

在 JavaScript 中計算中位數

本 JavaScript 教程解釋了中位數是什麼以及如何在值列表中找到它。

本頁內容

中位數是將數字按升冪排列後位於中間的值,會把排序後的資料分成較低與較高兩半。JavaScript 沒有內建的中位數方法,因此可以用一個簡單函式將數值排序,再找出中間值。本指南使用有限數值陣列;輸入不符合此條件時,函式會回傳 null。

中位數的意義

元素個數為奇數時,會有一個值位於正中央;個數為偶數時,中央位置落在兩個值之間,因此中位數是這兩個值的算術平均。例如,將 [3, 1, 4, 2] 排序後會得到 [1, 2, 3, 4];其中位數為 (2 + 3) / 2,也就是 2.5。必須使用數值排序:JavaScript 的預設 sort() 會將值當成字串比較,可能因此把 12 排在 3 前面。傳入 (a, b) => a - b 即可指定依數值升冪排序。

實作中位數函式

此函式適用於只包含有限數值的陣列。它會排序陣列副本,因此傳入的陣列會保留原本順序。

執行以下範例:

本節中的程式碼以及顯示的標籤或輸出仍為英文。

function calculateMedian(values) {
  if (!Array.isArray(values) || values.length === 0) return null;
  for (let i = 0; i < values.length; i++) {
    if (!Object.prototype.hasOwnProperty.call(values, i) ||
        typeof values[i] !== "number" || !Number.isFinite(values[i])) {
      return null;
    }
  }

  const sorted = [...values].sort((a, b) => a - b);
  const middle = Math.floor(sorted.length / 2);
  return sorted.length % 2 === 1
    ? sorted[middle]
    : (sorted[middle - 1] + sorted[middle]) / 2;
}

console.log(calculateMedian([7, 1, 5, 3]));
console.log(calculateMedian([8, 2, 6, 4, 10]));
4
6

第一次呼叫傳入四個值,因此函式會取兩個中央值的平均;第二次傳入五個值,因此會回傳單一中央值。這兩次呼叫顯示的輸出依序為 4 和 6。函式只接受非空陣列,且每個索引都必須有自己的有限數值。

選擇是否修改輸入

Array.prototype.sort() 會重新排列呼叫它的陣列。修改呼叫端的資料,可能影響後續計算、畫面呈現,或依賴原始順序進行的比較。上方的函式使用 [...values] 在排序前建立淺層副本;因此 [...values].sort((a, b) => a - b) 不會改變呼叫端的陣列。對原始數值而言,淺層複製已足夠。如果你確實想直接重新排列原陣列,可以直接對它排序,並向呼叫端說明這項副作用。

處理空輸入與無效輸入

輸入不是陣列、陣列為空,或陣列中含有非有限數值時,函式都會回傳 null。函式會拒絕整個輸入,而不會篩除個別值:默默丟棄字串或 null 可能改變要摘要的資料;篩選後也可能沒有任何值可供選取。Number.isFinite() 會排除 NaN、Infinity 和 -Infinity;typeof 檢查也會排除看起來像數字的字串。呼叫端可以檢查是否回傳 null,再決定要顯示訊息、略過計算,或提早驗證來源資料。如果應用程式需要採用其他政策,例如篩除無效記錄,請明確設定該政策,並在找出中間值之前確認至少還有一個可用數值。

效能與限制

主要工作是排序;對 n 個值而言,通常需要 O(n log n) 次比較。複製陣列會額外使用 O(n) 空間;原地排序可以省下這份副本,但會改變輸入。資料集非常大時,反覆完整排序可能成本過高,可考慮適合該工作負載的選擇演算法或統計函式庫。簡單平均公式 (a + b) / 2 對兩個非常大的有限值可能發生溢位;若資料可能有這種數值範圍,請選擇並記錄數值上更安全的平均計算方式,並依應用程式的數值範圍進行測試。