編輯頁面

`.avg()`

取得所有符合條件的記錄中，指定屬性的彙總平均值。

var average = await Something.avg(numericAttrName, criteria);

	引數	類型	詳細資訊
1	numericAttrName		將計算平均值的數值屬性名稱。
2	criteria		用於比對資料庫中記錄的 Waterline 條件。如果未指定條件，則將計算此模型所有記錄的平均值。 `avg` 查詢不支援使用 `skip` 和 `limit` 進行分頁，或使用 `select` 進行投影。

類型	描述
	所有符合條件的記錄中，指定屬性的彙總平均值。

請參閱概念 > 模型與 ORM > 錯誤，以取得在 Sails 和 Waterline 中處理錯誤的範例。

取得年齡介於 35 至 45 歲之間的人所擁有的銀行帳戶平均餘額。

var averageBalance = await BankAccount.avg('balance')
.where({
  ownerAge: { '>=': 35, '<=': 45 }
});

此方法可以與 await、promise 鏈或傳統 Node 回呼一起使用。

某些資料庫（如 MySQL）可能會針對此類查詢傳回 null，但對於 Sails/Waterline 配接器作者而言，最佳實務是傳回 0，以確保應用程式層級程式碼的一致性和型別安全。

如果您發現我們遺漏或可以改進的地方，請點擊此連結，並提交 pull request 到 sails repo。一旦我們合併它，變更將在下次部署時反映在網站上。

文件

Sails 框架是由位於德州奧斯汀的網頁和行動商店，以及我們的貢獻者共同建置。我們在 2012 年建立 Sails，以協助我們進行 Node.js 專案。自然而然地，我們將其開源。我們希望它可以讓您的生活更輕鬆一點！