$toLong (64 ビット整数への変換)

最終更新：2026-10-09

$toLong (64 ビット整数への変換)

$toLong は値を 64 ビット符号付き整数（BSON long）に変換します。int よりはるかに広い範囲を持ち、タイムスタンプや ID などの大きな整数に最適です。数値、数値文字列、ブール値を受け付け、null は null のままです。代表的な用途は、高精度の ID 文字列の数値化や、秒・ミリ秒タイムスタンプの処理です。文字列は整数リテラルである必要があります。to: long の $convert 短縮形で、int と long を混ぜた演算は自動的に long へ昇格します。

📝 構文

{ $toLong: <expression> }

⚙️ パラメータ

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

▶ 例

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

// $toLong: タイムスタンプ文字列を数値に変換
db.events.aggregate([
  { $project: {
      ts: { $toLong: '$tsStr' }
  } }
])

出力：

{ '_id': 1, 'ts': 1780000000000 }

📌 注意事項

• 64 ビットの範囲ならミリ秒タイムスタンプを余裕で保持できる
• 文字列は整数リテラルである必要があり、違うとエラー
• int と long の混在は自動的に long へ昇格する

🏷️ 関連タグ

💡 関連ケース

📚 関連チュートリアル

❓ よくある質問

Web-Tutorial 技術チーム

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

私たちについて