$toDecimal (Decimal128 への変換)

最終更新：2026-10-09

$toDecimal (Decimal128 への変換)

$toDecimal は値を Decimal128 に変換します。Decimal128 は、金額や精度が重要な演算向けの高精度 10 進型で、double の 2 進浮動小数点誤差を回避できます。数値、数値文字列、ブール値を受け付け、null は null のままです。代表的な用途は、注文金額の累積と比較です。double との混合演算は自動的に decimal へ昇格しますが、無効な文字列の変換はエラーになるため、$convert の onError でガードしてください。

📝 構文

{ $toDecimal: <expression> }

⚙️ パラメータ

戻り値：Decimal128 値。入力が null の場合は null

▶ 例

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

// $toDecimal: 金額文字列を高精度で解析
db.orders.aggregate([
  { $project: {
      amount: { $toDecimal: '$amountStr' }
  } }
])

出力：

{ '_id': 1, 'amount': { '$numberDecimal': '199.90' } }

📌 注意事項

• 金額には double の精度誤差を避けるため decimal を優先する
• 無効な数値文字列（例: 'abc'）はエラー
• null の入力は null を返す

🏷️ 関連タグ

💡 関連ケース

📚 関連チュートリアル

❓ よくある質問

Web-Tutorial 技術チーム

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

私たちについて