閉じる

C#のMath.Truncateで数値の整数部を取得する方法:Floorや型変換との使い分けを解説

C#を利用してアプリケーションを開発する際、数値の小数点以下を切り捨てて「整数部のみ」を取得したい場面は頻繁に登場します。

例えば、ECサイトのポイント計算や、ゲーム開発における座標計算、あるいは統計データの整形などが挙げられます。

C#の標準ライブラリであるSystem名前空間には、これを実現するためのMath.Truncateメソッドが用意されています。

しかし、単純に「切り捨て」と言っても、負の数の扱いや戻り値の型によって、Math.Floorやキャスト(型変換)との使い分けが必要になります。

この記事では、2026年現在の.NET環境に基づき、Math.Truncateの正しい使い方と、他の手法との決定的な違いについて詳しく解説します。

Math.Truncateとは:数値の整数部を取得する基本

Math.Truncateは、指定した数値の小数点以下を完全に取り除き、整数部分のみを返すメソッドです。

このメソッドの最大の特徴は、「常に0に近い方向の整数」に向かって値を丸める点にあります。

まずは、基本的な構文とオーバーロードを確認しましょう。

Math.Truncateのシグネチャ

Math.Truncateには、主に2つのオーバーロードが存在します。

C#
// double型を受け取り、double型を返す
public static double Truncate(double d);

// decimal型を受け取り、decimal型を返す
public static decimal Truncate(decimal d);

戻り値がintなどの整数型ではなく、元の型(doubleまたはdecimal)を維持したまま返される点に注意が必要です。

これは、大きな数値を扱った場合に整数型の範囲を超えてオーバーフローすることを防ぐための設計です。

基本的な使用例

実際に正の数と負の数に対してMath.Truncateを適用したコードを見てみましょう。

C#
using System;

double positiveNum = 123.456;
double negativeNum = -123.456;

Console.WriteLine($"正の数の切り捨て: {Math.Truncate(positiveNum)}");
Console.WriteLine($"負の数の切り捨て: {Math.Truncate(negativeNum)}");
実行結果
正の数の切り捨て: 123
負の数の切り捨て: -123

実行結果から分かる通り、正の数の場合は小数点以下を削り、負の数の場合も符号を維持したまま小数点以下を削っています。

Math.TruncateとMath.Floorの決定的な違い

初心者の方が最も混同しやすいのが、Math.TruncateMath.Floorの違いです。

どちらも日本語では「切り捨て」と表現されることが多いため、同じ動作をすると誤解されがちです。

しかし、負の数を扱う際の挙動が大きく異なります。

正負の数における挙動の比較

Math.Truncateが「0の方向」へ丸めるのに対し、Math.Floorは「より小さい(負の無限大に近い)整数」へ丸めます。

この違いを以下の表にまとめました。

元の数値Math.Truncate(値)Math.Floor(値)
3.83.03.0
-3.1-3.0-4.0
-3.8-3.0-4.0

このように、負の値においてMath.Floorは「その数値を超えない最大の整数」を返すため、-3.1は-4.0になります。

一方で、単に「符号を無視して整数部分だけを抽出したい」という用途にはMath.Truncateが適しています。

コードによる比較検証

実際に、挙動の違いを比較するプログラムを実行してみましょう。

C#
double value = -5.7;

double truncated = Math.Truncate(value);
double floored = Math.Floor(value);

Console.WriteLine($"元の値: {value}");
Console.WriteLine($"Truncateの結果: {truncated}"); // -5
Console.WriteLine($"Floorの結果: {floored}");       // -6
実行結果
元の値: -5.7
Truncateの結果: -5
Floorの結果: -6

この違いを理解していないと、座標計算や財務計算において意図しないバグを引き起こす可能性があるため、「0に向かうのか、負の無限大に向かうのか」を常に意識しましょう。

型変換(キャスト)による整数部取得との違い

C#では、(int)(long)といった明示的なキャストを用いても、小数点以下を切り捨てることができます。

Math.Truncateを使うのと何が違うのか?」という疑問を持つ方も多いでしょう。

結論から言うと、精度、範囲、および可読性に違いがあります。

キャストを使用する場合の注意点

キャストによる切り捨ては非常に高速ですが、いくつかのリスクを伴います。

C#
double largeValue = 3000000000.5; // intの範囲を超える値

// intにキャストするとオーバーフローが発生する可能性がある
int castedValue = (int)largeValue; 
Console.WriteLine($"キャストの結果: {castedValue}");

// Math.Truncateはdoubleとして返すので安全
double truncatedValue = Math.Truncate(largeValue);
Console.WriteLine($"Truncateの結果: {truncatedValue}");

double型の数値がint.MaxValue(約21億)を超えている場合、(int)でキャストすると意図しない数値(オーバーフロー)になります。

一方、Math.Truncateは元のデータ型を保持するため、巨大な数値であっても安全に整数部を取り出すことが可能です。

戻り値の型と精度の維持

decimal型を使用している場合、Math.Truncateの利点はさらに際立ちます。

金融系の計算では、doubleではなくdecimalが推奨されますが、キャストで整数に変換してしまうと、その後の計算でdecimal特有の高精度が失われてしまいます。

Math.Truncateであれば、decimal型の精度を保ったまま整数部を取得し、計算を継続できるというメリットがあります。

実践的な使い分けシーン

ここでは、開発現場でよく遭遇するシチュエーションに応じた使い分けを整理します。

1. 財務・会計計算:Math.Truncate(decimal)

消費税の計算などで、「端数は常に切り捨てる」という仕様がある場合、Math.Truncateが最適です。

特に、負の金額が発生し得るケース(返金処理など)では、Math.Floorを使うと「返金額が1円増えてしまう」といったミスが起こりやすいため、0方向への切り捨てが安全です。

2. ページネーションの計算:Math.Ceiling

逆に、「あまりが出たら切り上げる」必要があるページネーションなどの処理には、Math.Ceilingを使用します。

整数部取得の文脈からは外れますが、TruncateFloorCeilingはセットで覚えておくべき概念です。

3. パフォーマンス重視のループ内処理:(int)キャスト

対象の数値が必ずintの範囲内に収まることが保証されており、何百万回ものループ内で処理を行う場合は、キャストの方が高速に動作します。

ただし、2026年現在のモダンな.NETランタイムでは、Math.Truncateの最適化も進んでおり、極端な速度差が問題になることは少なくなっています。

浮動小数点数の精度問題とMath.Truncate

double型やfloat型を扱う際には、「浮動小数点数の丸め誤差」に注意しなければなりません。

コンピュータ内部で数値が2進数として扱われるため、人間が認識する10進数の数値が正確に表現できない場合があります。

C#
double val = 0.99999999999999999; // ほぼ1だが内部的には1ではない
Console.WriteLine(Math.Truncate(val)); // 0 と出力される

このように、見た目上はほぼ1であっても、内部的な微差によってMath.Truncateの結果が0になることがあります。

極めて高い精度が求められる数値計算では、最初からdecimal型を使用することを強く推奨します。

最新の.NETにおける数値操作

.NET 8や.NET 9、そして最新の.NET 10/11へと続く進化の中で、数値操作に関するAPIはより直感的になっています。

例えば、System.Mathクラスだけでなく、double型自体にインスタンスメソッドとしての丸め処理を期待する声もありますが、現在のところMath.Truncateという静的メソッドを利用するのが最も標準的かつ安全な手法です。

また、C# 12以降で導入された数学的改善により、ジェネリック数学(Generic Math)を利用した抽象的な数値処理も可能になっています。

しかし、特定の整数部取得という単一の目的においては、伝統的なMath.Truncateがその明確なセマンティクス(意味論)により、コードの可読性を高めてくれます。

まとめ

C#で数値の整数部を取得する際は、用途に応じて最適な手法を選択することが重要です。

  • Math.Truncate: 正負に関わらず「小数点以下を切り捨てる(0の方向へ丸める)」。型を維持したい場合に最適。
  • Math.Floor: 数値を超えない「最大の整数(負の無限大方向へ丸める)」。負の数の扱いに注意。
  • キャスト (int): 範囲内であることが確実な場合の高速な切り捨て。

日常的なプログラミングにおいては、「負の数の挙動を予測しやすいMath.Truncate」を第一選択にするのが、バグの少ない安全なコードへの近道です。

データの性質や業務要件を正しく把握し、これらのメソッドを適切に使い分けられるようになりましょう。

URLをコピーしました!