$abs (絶対値)

最終更新：2026-10-09

$abs (絶対値)

$abs は単一の数値式の絶対値を返します。実績と目標の差、地理的なオフセットなどの距離・偏差・誤差の計算によく使われます。null または欠落した引数は null を返します。正の無限大はそのまま、負の数は正になります。$sign と組み合わせると、数の大きさと符号の両方を得られます。$abs は整数、double、Decimal をサポートします。

📝 構文

{ $abs: <numeric-expression> }

⚙️ パラメータ

戻り値：絶対値。引数が null または欠落している場合は null

▶ 例

以下のコマンドをローカルの mongosh で実行してください（mongod が起動済みである必要があります）：

// $abs: 実績と目標の差を計算
db.sales.aggregate([
  { $project: {
      gap: { $abs: { $subtract: ['$actual', '$target'] } }
  } }
])

出力：

{ '_id': 1, 'gap': 5 }
{ '_id': 2, 'gap': 3 }

📌 注意事項

• null・欠落した引数は null を返す
• 負の無限大は正の無限大になる
• abs で符号は消える。元の符号が重要な場合は $sign と組み合わせる

🏷️ 関連タグ

💡 関連ケース

📚 関連チュートリアル

❓ よくある質問

Web-Tutorial 技術チーム

複数の開発者によって共同維持されているプログラミングチュートリアルプラットフォーム。各チュートリアルは専門分野の開発者が執筆・レビューしています。正確で信頼性の高いコンテンツを目指しています — 問題を見つけた場合はお知らせください。

私たちについて