VBAで自動化 VBA一覧 セル・値の取得と貼り付け 取得

【VBA】Textプロパティでセルの値を文字列として取得する方法｜表示形式をそのまま扱う実務テクニック

Excel VBAでセルの値を取得する場合、多くの方はValueプロパティを使用します。しかし、請求書番号や郵便番号、金額表示など「セルに表示されている文字列をそのまま取得したい」場面では、Valueプロパティでは期待した結果にならないことがあります。

例えばセルに「00123」と表示されていても、Valueで取得すると「123」になったり、日付がシリアル値として扱われたりすることがあります。

このような場合に役立つのがTextプロパティです。

この記事では、VBAのTextプロパティの使い方からValueとの違い、実務で利用する場面、注意点まで詳しく解説します。

✅ VBAのTextプロパティとは

VBAにはセルの値を取得する方法が複数あります。

ValueやValue2を使うケースが一般的ですが、Textプロパティには別の役割があります。

実務ではValueだけを覚えていると、表示形式が関係する処理で思わぬ不具合が発生することがあります。

特に帳票作成やCSV出力では重要な知識になります。

まずはTextプロパティの基本を理解しておきましょう。

・Textプロパティの役割

Textプロパティは、

「セルに表示されている文字列」

を取得するプロパティです。

例えばセルA1に

12345

が入力され、

表示形式で

￥12,345

と表示されている場合、

ValueとTextでは取得結果が異なります。

取得方法結果
Value12345
Text￥12,345

つまりTextは見た目の表示結果を取得します。

・基本構文

セルA1の表示文字列を取得する場合は以下のように記述します。

Dim displayText As String

displayText = Range("A1").Text

非常にシンプルですが、Valueとは取得結果が大きく異なるため用途を理解して使い分けることが重要です。

✅ Textプロパティでセルの表示値を取得する方法

Textプロパティは単純に使用できますが、どのような場面で効果を発揮するのかを理解しておくことが重要です。

特に帳票出力やデータ変換処理ではValueより適しているケースがあります。

まずは基本的な取得方法を見ていきましょう。

・表示されている文字列を取得する例

以下のコードはA1セルに表示されている内容を取得します。

まずは最もシンプルな構成です。

このコードでは「値」ではなく「表示結果」を取得することを目的としています。

Sub GetDisplayText()

    Dim displayText As String

    ' セルに表示されている文字列を取得
    displayText = Range("A1").Text

    MsgBox displayText

End Sub

この方法のメリットは表示形式を考慮した結果が取得できることです。

例えば、

  • 通貨表示
  • パーセント表示
  • 日付表示

なども見た目のまま取得できます。

実務では帳票内容をそのままメール本文へ転記したい場合などによく利用します。

✅ ValueとTextの違いを理解する

Textプロパティを正しく使うためには、Valueとの違いを理解することが欠かせません。

ここを誤解していると、思った通りのデータが取得できずトラブルの原因になります。

実務では両者を目的に応じて使い分けることが重要です。

・ValueとTextの取得結果比較

セルA1に日付が入力されているとします。

表示形式は

2025/07/15

です。

以下のコードを実行します。

Sub CompareValueAndText()

    Dim cellValue As Variant
    Dim displayText As String

    cellValue = Range("A1").Value
    displayText = Range("A1").Text

    MsgBox "Value：" & cellValue & vbCrLf & _
           "Text：" & displayText

End Sub

Valueは日付型として取得されます。

一方でTextは表示されている文字列を取得します。

・なぜ使い分けが重要なのか

Valueは計算向きです。

例えば、

  • 数値計算
  • 比較処理
  • 集計処理

に向いています。

一方Textは、

  • CSV出力
  • メール本文作成
  • 帳票転記

など表示内容が重要な処理に向いています。

取得目的によって選択することが重要です。

今回はTextプロパティを中心に紹介しましたが、実務ではValueプロパティとの使い分けを理解することが重要です。それぞれの取得結果や適した使用場面については、【VBA】ValueプロパティとTextプロパティの違いとは？取得値と使用場面を解説で詳しく解説しています。

✅ 実務でTextプロパティが活躍する場面

Textプロパティは日常的に使うものではありません。

しかし、特定の業務では非常に重要な役割を持っています。

実務ではValueよりもTextを使うべき場面が存在します。

その判断基準を理解しておきましょう。

・帳票データをそのまま出力したい場合

請求書や売上表などを出力する場合、

セル表示をそのまま取得したいケースがあります。

例えば、

  • ￥1,234,567
  • 15.0%
  • 2025/07/15

などです。

この場合ValueではなくTextが適しています。

・郵便番号やコード管理

郵便番号が

001-0001

と表示されている場合、

Valueでは数値扱いになる可能性があります。

Textを利用すると表示内容をそのまま取得できます。

・メール本文へ転記する場合

実務ではExcelからOutlookメールを作成するケースがあります。

その際、

表示されている金額や日付をそのまま本文へ出力したい場合はTextプロパティが便利です。

Textプロパティ以外にも、Valueで取得したデータを文字列へ変換して扱う方法があります。CStr関数やFormat関数を使った文字列変換の考え方については、【VBA】Valueを文字列に変換する方法｜CStr・Format・実務で失敗しない型変換の考えで詳しく解説しています。

✅ なぜ変数へ格納して処理するのか

実務ではTextプロパティを直接使うよりも、一度変数へ格納する設計が推奨されます。

これは保守性と再利用性を高めるためです。

後から処理内容が変更になった場合にも対応しやすくなります。

・保守性を高める実務設計

以下のようなコードは避けた方がよいケースがあります。

MsgBox Range("A1").Text

動作はしますが、後から処理追加が難しくなります。

実務では次のような形がおすすめです。

Sub ShowDisplayText()

    Dim displayText As String

    ' 表示文字列を取得
    displayText = Range("A1").Text

    ' 必要に応じて加工処理を追加できる
    MsgBox displayText

End Sub

・この設計が実務向きな理由

変数化しておくことで、

  • ログ出力
  • ファイル出力
  • メール本文作成

などへ流用しやすくなります。

またデバッグ時も確認しやすくなります。

将来的な仕様変更を考慮すると、変数経由の方が管理しやすい設計です。

✅ Textプロパティを使うときの注意点

便利なTextプロパティですが、注意すべき点もあります。

Valueと同じ感覚で使用すると、意図しない結果になる場合があります。

実務では以下のポイントを理解しておきましょう。

・列幅によって取得結果が変わる

Textプロパティは表示内容を取得します。

そのため列幅が狭く、

のように表示されている場合、

その表示結果を取得してしまうことがあります。

帳票処理では特に注意が必要です。

・数値計算には向かない

Textは文字列です。

そのため数値計算には適していません。

計算や比較処理を行う場合はValueを利用しましょう。

・表示形式に依存する

ユーザーが表示形式を変更すると取得結果も変わります。

例えば、

  • 2025/07/15
  • 25/07/15

ではTextの結果が変わります。

表示形式依存であることを理解して使用する必要があります。

Textプロパティは便利ですが、セルの表示形式に結果が左右される点には注意が必要です。日付や数値を任意の形式で文字列化したい場合は、【VBA】Format関数で文字列に変換する方法｜日付・数値・表示形式を完全整理で解説しているFormat関数の活用もおすすめです。

✅ TextとValueをどう使い分けるべきか

VBAではどちらか一方だけを覚えるのではなく、用途によって使い分けることが重要です。

多くの業務システムでは両方が登場します。

適切な選択ができるように整理しておきましょう。

・Valueを選ぶべき場面

以下のような場合はValueがおすすめです。

  • 計算処理
  • 集計処理
  • 条件判定
  • データ比較

・Textを選ぶべき場面

以下のような場合はTextが向いています。

  • 帳票出力
  • メール本文作成
  • CSV出力
  • 表示内容の取得

・迷ったらどうするべきか

基本はValueを使用します。

表示形式込みで取得したい場合のみTextを選ぶと考えると判断しやすくなります。

実務でもこの考え方が最もトラブルを防ぎやすいです。

TextとValueの使い分けを理解したら、次は実際に文字列として取得する方法も押さえておきましょう。Cells・Range・Valueを使った文字列取得のパターンについては、【VBA】文字列として取得する方法｜Cells・Range・Valueの安全な使い分けで詳しく解説しています。

 

✅ まとめ：Textプロパティで表示文字列を安全に取得しよう

Textプロパティはセルに表示されている文字列をそのまま取得できる便利な機能です。

Valueとは役割が異なるため、目的に応じて使い分けることが重要です。

特に帳票作成やメール出力では非常に活躍します。

  • Textは表示されている文字列を取得する
  • Valueは実際の値を取得する
  • 通貨や日付表示の取得に便利
  • CSV出力や帳票作成で活躍する
  • 計算処理にはValueが向いている
  • 列幅や表示形式の影響を受ける
  • 実務では変数へ格納して利用すると保守しやすい

Textプロパティを正しく理解すると、表示形式を考慮したデータ取得ができるようになります。Valueとの違いを意識しながら、実務に適した方法を選択していきましょう。

    -VBAで自動化, VBA一覧, セル・値の取得と貼り付け, 取得