Java Tips | 基本ユーティリティ：Double.toString()

Double.toString()とは何か

Javaで業務システムを開発していると、小数値を文字列へ変換したい場面が頻繁に登場します。

例えば、

• 商品価格の表示
• 割引率の出力
• CSVファイルへの書き込み
• ログ出力
• APIレスポンス作成
• デバッグ情報の表示

などです。

そのような場面で利用されるのが Double.toString() です。

Double.toString(double値)

Double.toString(double値)

このメソッドはdouble型の値をString型へ変換します。

小数を扱うシステムでは非常によく利用される基本ユーティリティです。

まずはdouble型を理解しよう

Double.toString()を理解するために、まずdouble型について学びましょう。

double型は小数を扱うためのデータ型です。

// double型
double price = 1980.50;

// double型
double price = 1980.50;

例えば次のような値を扱えます。

0.5
10.25
99.99
1234.567

業務システムでは価格や割合、温度や測定値などで利用されることがあります。

なぜ文字列に変換する必要があるのか

数値と文字列は別の型です。

// 数値
double tax = 10.0;

// 文字列
String text = "10.0";

// 数値
double tax = 10.0;

// 文字列
String text = "10.0";

画面表示、CSV出力、ログ出力などでは文字列として扱う必要があります。

そのため数値から文字列への変換処理が必要になります。

Double.toString()の基本構文

最も簡単な例を見てみましょう。

// 価格
double price = 1980.5;

// Stringへ変換
String result =
        Double.toString(price);

// 結果表示
System.out.println(result);

// 価格
double price = 1980.5;

// Stringへ変換
String result =
        Double.toString(price);

// 結果表示
System.out.println(result);

実行結果

1980.5

double型がString型へ変換されました。

ステップバイステップで理解する

ステップ1：double型の値を用意する

// 割引率
double discountRate = 5.5;

// 割引率
double discountRate = 5.5;

現在はdouble型です。

ステップ2：Double.toString()を実行する

// Stringへ変換
String rateText =
        Double.toString(
                discountRate
        );

// Stringへ変換
String rateText =
        Double.toString(
                discountRate
        );

ステップ3：文字列として利用する

// 表示
System.out.println(rateText);

// 表示
System.out.println(rateText);

実行結果

5.5

見た目は同じですが、内部的にはString型になっています。

変換後は文字列になることを理解しよう

初心者がよく勘違いするポイントです。

// double型
double value = 10.5;

// String化
String text =
        Double.toString(value);

// 文字列連結
System.out.println(text + 10);

// double型
double value = 10.5;

// String化
String text =
        Double.toString(value);

// 文字列連結
System.out.println(text + 10);

実行結果

10.510

数値計算ではありません。

文字列同士の連結が行われています。

変換後は完全にString型として扱われることを覚えておきましょう。

小数点も保持される

Double.toString()は小数点を含めて文字列化します。

// 小数
double value = 123.456;

// Stringへ変換
String result =
        Double.toString(value);

System.out.println(result);

// 小数
double value = 123.456;

// Stringへ変換
String result =
        Double.toString(value);

System.out.println(result);

実行結果

123.456

小数部分もそのまま保持されます。

整数のような値でも小数として出力される

初心者が少し驚くポイントです。

// double型
double value = 100.0;

// String化
String result =
        Double.toString(value);

System.out.println(result);

// double型
double value = 100.0;

// String化
String result =
        Double.toString(value);

System.out.println(result);

実行結果

100.0

100ではなく100.0になります。

これは元の値がdouble型だからです。

負の値も変換できる

// 負の値
double value = -50.25;

// String化
String result =
        Double.toString(value);

System.out.println(result);

// 負の値
double value = -50.25;

// String化
String result =
        Double.toString(value);

System.out.println(result);

実行結果

-50.25

符号も含めて変換されます。

実務でよくある利用例

価格表示

// 商品価格
double price = 2980.0;

// 表示用
String displayPrice =
        Double.toString(price)
        + "円";

System.out.println(displayPrice);

// 商品価格
double price = 2980.0;

// 表示用
String displayPrice =
        Double.toString(price)
        + "円";

System.out.println(displayPrice);

CSV出力

// 売上金額
double sales = 15000.5;

// CSV出力用
String csvValue =
        Double.toString(sales);

// 売上金額
double sales = 15000.5;

// CSV出力用
String csvValue =
        Double.toString(sales);

ログ出力

// レスポンス時間
double responseTime = 125.75;

// ログ出力
log.info(
        "responseTime={}",
        Double.toString(
                responseTime
        )
);

// レスポンス時間
double responseTime = 125.75;

// ログ出力
log.info(
        "responseTime={}",
        Double.toString(
                responseTime
        )
);

APIレスポンス生成

// 割引率
double rate = 5.5;

// JSON用
String json =
        "{ \"rate\": \""
                + Double.toString(rate)
                + "\" }";

// 割引率
double rate = 5.5;

// JSON用
String json =
        "{ \"rate\": \""
                + Double.toString(rate)
                + "\" }";

Double.toString()とString.valueOf()の違い

初心者が非常によく迷うポイントです。

Double.toString()

// double型専用
String result =
        Double.toString(10.5);

// double型専用
String result =
        Double.toString(10.5);

String.valueOf()

// 様々な型に対応
String result =
        String.valueOf(10.5);

// 様々な型に対応
String result =
        String.valueOf(10.5);

String.valueOf()は以下のような型にも対応しています。

String.valueOf(100);
String.valueOf(10.5);
String.valueOf(true);
String.valueOf(user);

String.valueOf(100);
String.valueOf(10.5);
String.valueOf(true);
String.valueOf(user);

double型を扱うことを明確に表現したい場合はDouble.toString()が分かりやすいです。

Double.toString()と文字列連結の違い

Javaでは次のようなコードも書けます。

// 暗黙変換
String result =
        "" + 10.5;

// 暗黙変換
String result =
        "" + 10.5;

結果は同じです。

しかしLong.toString()やDouble.toString()を利用した方が意図が明確になります。

// 明示的変換
String result =
        Double.toString(10.5);

// 明示的変換
String result =
        Double.toString(10.5);

保守性の高いコードになります。

特に重要：科学技術表記になる場合がある

Double.toString()には注意点があります。

非常に大きな値や小さな値では指数表記になることがあります。

// 非常に大きい値
double value = 1000000000.0;

// String化
System.out.println(
        Double.toString(value)
);

// 非常に大きい値
double value = 1000000000.0;

// String化
System.out.println(
        Double.toString(value)
);

環境によっては次のような表記になります。

1.0E9

業務帳票や金額表示など、人間向けの表示では期待通りにならない場合があります。

その場合はDecimalFormatを利用します。

DecimalFormat df =
        new DecimalFormat("#,##0.00");

// 表示形式を制御
String text =
        df.format(1234567.89);

DecimalFormat df =
        new DecimalFormat("#,##0.00");

// 表示形式を制御
String text =
        df.format(1234567.89);

さらに重要：金額処理との関係

業務システムでは非常に重要な話です。

double型は浮動小数点数です。

そのため誤差が発生します。

// 誤差発生例
System.out.println(
        0.1 + 0.2
);

// 誤差発生例
System.out.println(
        0.1 + 0.2
);

実行結果

0.30000000000000004

金額計算システムでは問題になります。

会計システムや決済システムではBigDecimalを利用するのが一般的です。

Double.toString()を学ぶ際は、この背景も理解しておくことが重要です。

Double.parseDouble()との関係

この2つはセットで覚えると分かりやすいです。

文字列からdoubleへ

// String → double
double value =
        Double.parseDouble(
                "10.5"
        );

// String → double
double value =
        Double.parseDouble(
                "10.5"
        );

doubleから文字列へ

// double → String
String text =
        Double.toString(
                10.5
        );

// double → String
String text =
        Double.toString(
                10.5
        );

互いに逆方向の変換を行います。

実務で使えるテンプレート集

基本変換テンプレート

// double → String
String text =
        Double.toString(value);

// double → String
String text =
        Double.toString(value);

CSV出力テンプレート

// CSV出力
writer.write(
        Double.toString(price)
);

// CSV出力
writer.write(
        Double.toString(price)
);

ログ出力テンプレート

// ログ出力
log.info(
        Double.toString(value)
);

// ログ出力
log.info(
        Double.toString(value)
);

表示用テンプレート

// 画面表示
String display =
        Double.toString(rate)
        + "%";

// 画面表示
String display =
        Double.toString(rate)
        + "%";

情報セキュリティの観点から見る重要性

Double.toString()自体はセキュリティ機能ではありません。

しかし数値データを文字列化してログへ出力する場合には注意が必要です。

例えば、

• 売上金額
• 取引情報
• 課金情報
• 顧客データ

などを不用意に出力すると情報漏えいのリスクがあります。

文字列へ変換できることと、外部へ出力してよいことは別問題です。

ログ出力や監査ログでは適切なマスキングやアクセス制御を行いましょう。

初心者が覚えておくべき重要ポイント

• double型をString型へ変換する
• 小数部分も保持される
• 変換後は完全な文字列になる
• Double.parseDouble()とは逆方向の変換である
• String.valueOf()との違いを理解する
• 金額計算ではBigDecimalも重要である
• 指数表記になるケースがあることを覚えておく

まとめ

Double.toString()は、double型をString型へ変換するためのJava標準メソッドです。

• doubleからStringへ変換できる
• 小数をそのまま文字列化できる
• ログ出力やCSV出力で頻繁に利用される
• Double.parseDouble()とは逆方向の変換である
• String.valueOf()との違いを理解して使い分ける
• 大きな値では指数表記になる場合がある
• Java開発でよく利用される基本ユーティリティである

特に業務システムでは、価格や割合、測定値などの小数データを文字列として扱う機会が非常に多くあります。Double.toString()を正しく理解することで、データ変換処理を安全かつ分かりやすく実装できるようになります。また、Double.parseDouble()とセットで理解しておくことで、小数データの入力と出力の両方を自在に扱えるようになります。