---
schema_version: "1"
id: d50f491b2977d471cd03fbfd4e968c2fb8558f88db772ac25b4ca6cbdacd0da0
title: toString
collection: mulesoft
version: current
locale: ja-jp
portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/dataweave/2.7/dw-coercions-functions-tostring.md
canonical_url: https://docs.mulesoft.com/jp/dataweave/2.7/dw-coercions-functions-tostring
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 60f9fc43c0d6c305ea5dae60fc58e3beb7b8071dd8db3a6ad4896b2eb7b13872
description: MuleSoft Documentation Site
release: "2.7"
latest: false
---
# toString

## [](#tostring1)toString(number: Number, format: String | Null = null, locale: String | Null = null, roundMode: RoundingMode | Null = null): String

`Number`​ 値 (整数または小数) を ​`String`​ 値に変換し、形式、ロケール、丸めモード値を受け入れる ​`toString`​ のバリエーション。

_DataWeave バージョン 2.4.0 で導入されました。_

### [](#パラメーター)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 25%;">
<col style="width: 75%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>number</code></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>書式設定する ​<code>Number</code>​ 値。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>format</code></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>Number</code>​ 値に適用する書式設定。
           ​<code>format</code>​ は ​<em>10 進数</em>​値のプレースホルダーとして ​<code>#</code>​ または ​<code>0</code>​ (ただし両方ではない) を受け入れ、1 つの小数点しか使用できません。​<code>null</code>​ 値または空の ​<code>String</code>​ 値は ​<code>Number</code>​ 値に対して無効です。他のほとんどの値はリテラルとして扱われますが、ドル記号などの特殊文字はエスケープする必要があります (たとえば、​<code>\$</code>​)。
           内側の引用符は閉じる必要があり、囲む引用符とは異なります。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>locale</code></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する省略可能な ISO 3166 国コード (​<code>US</code>​、​<code>AR</code>​、​<code>ES</code>​ など)。​<code>null</code>​ または欠落値では JVM のデフォルトが使用されます。​<code>eeee</code>​ や ​<code>MMMM</code>​ などの翻訳可能な形式を渡すと、​<code>locale</code>​ (​<code>"ES</code>​ など) は対応する数値をローカライズ済みの文字列に変換します。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>roundMode</code></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>小数 ​<code>0.15</code>​ の ​<code>0.#</code>​ の形式など、書式設定で丸めの選択肢が提供される場合の丸め小数値の省略可能なパラメーター。
              デフォルトは ​<code>HALF_UP</code>​ で、​<code>null</code>​ 値の場合は ​<code>HALF_UP</code>​ と同じように動作します。
              次の値のうち 1 つしか使用できません。</p>
</div>
<div class="ulist">
<ul>
<li>
<p><code>UP</code>​: 常に小数点以下を切り上げます (たとえば、​<code>0.01</code>​ を ​<code>"0.1"</code>​ に、​<code>-0.01</code>​ を ​<code>"-0.1"</code>​ にします)。前の桁を 0 以外の端数まで大きくし、計算済みの値の絶対値が小さくなることはありません。</p>
</li>
<li>
<p><code>DOWN</code>​: 常に端数処理を行います (たとえば、​<code>0.19</code>​ を ​<code>"0.1"</code>​ に、​<code>-0.19</code>​ を ​<code>"-0.1"</code>​ にします)。端数の前の桁を大きくすることはなく (前の桁に切り上げる)、計算済みの値の絶対値が大きくなることはありません。</p>
</li>
<li>
<p><code>CEILING</code>​: 正の無限大に丸めて、結果が正の場合は ​<code>UP</code>​ と同じように動作します (たとえば、​<code>0.35</code>​ を ​<code>"0.4"</code>​ にする)。
結果が負の場合、このモードは ​<code>DOWN</code>​ と同じように動作します (たとえば、​<code>-0.35</code>​ を ​<code>"-0.3"</code>​ にする)。このモードでは、計算済みの値が小さくなることはありません。</p>
</li>
<li>
<p><code>FLOOR</code>​: 負の無限大に丸めて、結果が正の場合は DOWN と同じように動作します (たとえば、​<code>0.35</code>​ を ​<code>"0.3"</code>​ にする)。
結果が負の場合、このモードは ​<code>UP</code>​ と同じように動作します (たとえば、​<code>-0.35</code>​ を ​<code>"-0.4"</code>​ にする)。このモードでは、計算済みの値が大きくなることはありません。</p>
</li>
<li>
<p><code>HALF_UP</code>​: デフォルトのモードで、上と下の一番近い数値が同じ近さでない限り、「一番近い数値」に丸めます。上と下の一番近い数値の近さが同じ場合、このモードでは切り上げます。たとえば、​<code>0.35</code>​ は ​<code>"0.4"</code>​ に、​<code>0.34</code>​ は ​<code>"0.3"</code>​ に、​<code>0.36</code>​ は ​<code>"0.4"</code>​ に丸められます。負の小数も同様に丸められます。たとえば、​<code>-0.35</code>​ は ​<code>"-0.4</code>​" に丸められます。</p>
</li>
<li>
<p><code>HALF_DOWN</code>​: 上と下の一番近い数値が同じ近さでない限り、「一番近い数値」に丸めます。上と下の一番近い数値の近さが同じ場合、このモードでは切り下げます。たとえば、​<code>0.35</code>​ は ​<code>"0.3"</code>​ に、​<code>0.34</code>​ は ​<code>"0.3"</code>​ に、​<code>0.36</code>​ は ​<code>"0.4"</code>​ に丸められます。負の小数も同様に丸められます。たとえば、​<code>-0.35</code>​ は ​<code>"-0.3"</code>​ に丸められます。</p>
</li>
<li>
<p><code>HALF_EVEN</code>​: 末尾が ​<code>5</code>​ の小数 (​<code>1.125</code>​ や ​<code>1.135</code>​ など) の場合、動作は ​<code>5</code>​ の前にある数値に応じて異なります。
​<code>HALF_EVEN</code>​ では、​<code>5</code>​ の前の最後から 2 番目の桁が奇数の場合は切り上げ、最後から 2 番目の桁が偶数の場合は切り下げます。たとえば、​<code>0.225</code>​ は ​<code>"0.22"</code>​ に丸められ、​<code>0.235</code> ​<em>と</em>​ ​<code>0.245</code>​ はいずれも ​<code>"0.24"</code>​ に丸められ、​<code>0.255</code>​ は ​<code>"0.26"</code>​ に丸められます。
負の小数も同様に丸められ、たとえば ​<code>-0.225</code>​ は ​<code>"-0.22"</code>​ に丸められます。最後の桁が ​<code>5</code>​ でない場合、この設定の動作は ​<code>HALF_UP</code>​ と同じようになります。金額値の丸めは ​<code>HALF_EVEN</code>​ パターンに従う場合があります。</p>
</li>
</ul>
</div></div></td>
</tr>
</tbody>
</table>

### [](#例)例

次の例では、さまざまな入力での ​`toString`​ の動作を示します。

#### [](#ソース)ソース

```DataWeave
%dw 2.0
import * from dw::util::Coercions
output application/json
---
{
    a: toString(1.0),
    b: toString(0.005,".00"),
    c: toString(0.035,"#.##","ES"),
    d: toString(0.005,"#.##","ES","HALF_EVEN"),
    e: toString(0.035,"#.00",null,"HALF_EVEN"),
    f: toString(1.1234,"\$.## 'in my account'")
}
```

#### [](#出力)出力

```Json
{
  "a": "1",
  "b": ".01",
  "c": "0,04",
  "d": "0",
  "e": ".04",
  "f": "$1.12 in my account"
}
```

## [](#tostring2)toString(date: Date | DateTime | LocalDateTime | LocalTime | Time, format: String | Null = null, locale: String | Null = null): String

`Date`​、​`DateTime`​、​`LocalTime`​、​`LocalDateTime`​、または ​`Time`​ 値を ​`String`​ 値に変換する ​`toString`​ のバリエーション。

_DataWeave バージョン 2.4.0 で導入されました。_

### [](#パラメーター-2)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 25%;">
<col style="width: 75%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>date</code></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>String</code>​ 型に強制変換する ​<code>Date</code>​、​<code>DateTime</code>​、​<code>LocalTime</code>​、​<code>LocalDateTime</code>​、または ​<code>Time</code>​ 値。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>format</code></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>日付または時刻で使用する ISO-8601 書式設定。
           たとえば、このパラメーターでは Java 8 の ​<code>java.time.format</code>​ に基づいた文字パターンを受け入れます。
           ​<code>null</code>​ 値はこの値に対して無効です。デフォルト:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><code>Date</code>​ の例: <code>2011-12-03</code>​ (同等の形式: <code>uuuu-MM-dd</code>​)</p>
</li>
<li>
<p><code>DateTime</code>​ の例: <code>2011-12-03T10:15:30.000000+01:00</code>​ (同等の形式: <code>uuuu-MM-dd HH:mm:ssz</code>​)</p>
</li>
<li>
<p><code>LocalDateTime</code>​ の例: <code>2011-12-03T10:15:30.000000</code>​ (同等の形式: <code>uuuu-MM-dd HH:mm:ss</code>​)</p>
</li>
<li>
<p><code>LocalTime</code>​ の例: <code>10:15:30.000000</code>​ (同等の形式: <code>HH:mm:ss.n</code>​)</p>
</li>
<li>
<p><code>Time</code>​ の例: <code>10:15:30.000000Z</code>​ (同等の形式: <code>HH:mm:ss.nxxxz</code>​)</p>
</li>
</ul>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>locale</code></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する省略可能な ISO 3166 国コード (​<code>US</code>​、​<code>AR</code>​、​<code>ES</code>​ など)。​<code>null</code>​ または欠落値では JVM のデフォルトが使用されます。​<code>eeee</code>​ や ​<code>MMMM</code>​ などの翻訳可能な形式を渡すと、​<code>locale</code>​ (​<code>"ES</code>​ など) は対応する数値をローカライズ済みの文字列に変換します。</p>
</div></div></td>
</tr>
</tbody>
</table>

### [](#例-2)例

次の例では、さまざまな入力での ​`toString`​ の動作を示します。

#### [](#ソース-2)ソース

```DataWeave
%dw 2.0
import * from dw::util::Coercions
output application/json
---
{
   aDate: toString(|2003-10-01|, "uuuu/MM/dd"),
   aDateTime: toString(|2018-09-17T22:13:00-03:00|),
   aLocalTime: toString(|23:57:59|, "HH-mm-ss"),
   aLocalDateTime : toString(|2015-10-01T23:57:59|),
   aLocalDateTimeFormatted: toString(|2003-10-01T23:57:59|, "uuuu-MM-dd HH:mm:ss a"),
   aLocalDateTimeFormattedAndLocalizedSpain: toString(|2003-01-01T23:57:59|, "eeee, dd MMMM, uuuu HH:mm:ss a", "ES"),
   aTime: typeOf(|22:10:18Z|),
   aTimeZone: toString(|-03:00|)
}
```

#### [](#出力-2)出力

```Json
{
  "aDate": "2003/10/01",
  "aDateTime": "2018-09-17T22:13:00-03:00",
  "aLocalTime": "23-57-59",
  "aLocalDateTime": "2015-10-01T23:57:59",
  "aLocalDateTimeFormatted": "2003-10-01 23:57:59 PM",
  "aLocalDateTimeFormattedAndLocalizedSpain": "miércoles, 01 enero, 2003 23:57:59 p. m.",
  "aTime": "Time",
  "aTimeZone": "-03:00"
}
```

## [](#tostring3)toString(binary: Binary, encoding: String): String

指定されたエンコーディングを使用して ​`Binary`​ 値を ​`String`​ 値に変換する ​`toString`​ のバリエーション。

_DataWeave バージョン 2.4.0 で導入されました。_

### [](#パラメーター-3)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 25%;">
<col style="width: 75%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>binary</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>String</code>​ 値に強制変換する ​<code>Binary</code>​ 値。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>encoding</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>String</code>​ 値に適用するエンコーディング。JDK でサポートされているエンコーディングを受け入れます。たとえば、​<code>encoding</code>​ は Oracle JDK 8 と JDK 11 の基本および拡張エンコーディングセットの Java 正規名と別名を受け入れます。</p></td>
</tr>
</tbody>
</table>

### [](#例-3)例

次の例では、さまざまな入力での ​`toString`​ の動作を示します。

#### [](#ソース-3)ソース

```DataWeave
%dw 2.0
import * from dw::util::Coercions
var binaryData= "DW Test" as Binary {encoding: "UTF-32"}
output application/json
---
{
  a: toString(binaryData, "UTF-32"),
}
```

#### [](#出力-3)出力

```Json
{
  "a": "DW Test"
}
```

## [](#tostring4)toString(data: TimeZone | Uri | Boolean | Period | Regex | Key): String

`TimeZone`​、​`Uri`​、​`Boolean`​、​`Period`​、​`Regex`​、または ​`Key`​ 値を文字列に変換する ​`toString`​ のバリエーション。

_DataWeave バージョン 2.4.0 で導入されました。_

### [](#パラメーター-4)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 25%;">
<col style="width: 75%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>data</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>String</code>​ 値に強制変換する ​<code>TimeZone</code>​、​<code>Uri</code>​、​<code>Boolean</code>​、​<code>Period</code>​、​<code>Regex</code>​、または ​<code>Key</code>​ 値。</p></td>
</tr>
</tbody>
</table>

### [](#例-4)例

次の例では、さまざまな入力での ​`toString`​ の動作を示します。

#### [](#ソース-4)ソース

```DataWeave
%dw 2.0
import * from dw::util::Coercions
output application/json
---
{
  transformTimeZone: toString(|Z|),
  transformBoolean: toString(true),
  transformPeriod: toString(|P1D|),
  transformRegex: toString(/a-Z/),
  transformPeriod: toString(|PT8M10S|),
  transformUri: toString("https://docs.mulesoft.com/" as Uri)
}  ++
{ transformKey : toString((keysOf({ "aKeyToString" : "aValue"})[0])) }
```

#### [](#出力-4)出力

```Json
{
  "transformTimeZone": "Z",
  "transformBoolean": "true",
  "transformPeriod": "P1D",
  "transformRegex": "a-Z",
  "transformPeriod": "PT8M10S",
  "transformUri": "https://docs.mulesoft.com/",
  "transformKey": "aKeyToString"
}
```

## [](#tostring5)toString(arr: Array<String>): String

文字の ​`Array`​ を 1 つの ​`String`​ 値に結合する ​`toString`​ のバリエーション。

_DataWeave バージョン 2.4.0 で導入されました。_

### [](#パラメーター-5)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 25%;">
<col style="width: 75%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>arr</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>String</code>​ 値に変換する文字の ​<code>Array</code>​。</p></td>
</tr>
</tbody>
</table>

### [](#例-5)例

次の例では、さまざまな入力での ​`toString`​ の動作を示します。

#### [](#ソース-5)ソース

```DataWeave
%dw 2.0
import * from dw::util::Coercions
output application/json
---
{
  a: toString([]),
  b: toString(["h", "o", "l", "a"])
}
```

#### [](#出力-5)出力

```Json
{
  "a": "",
  "b": "hola"
}
```