---
schema_version: "1"
id: 6f5b706725a5085786a62254262b77359083433b7b7701cfdb7d04fcd4b734d9
title: toTimeOrNull
collection: mulesoft
version: current
locale: ja-jp
portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/dataweave/2.8/dw-coercions-functions-totimeornull.md
canonical_url: https://docs.mulesoft.com/jp/dataweave/2.8/dw-coercions-functions-totimeornull
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 8ab50f4d4a8df489f2bf94320d093dcde702af9a258ee41e715e9d8caa391758
description: MuleSoft Documentation Site
release: "2.8"
latest: false
---
# toTimeOrNull

## [](#totimeornull1)toTimeOrNull(str: String, formatters: Array<Formatter>): Time | Null

変換する特定の値に一致する最初の​`フォーマッター`​を使用して、​`String`​ 値を ​`Time`​ 値に変換します。

指定した値に一致する​`フォーマッター`​がない場合、関数は ​`null`​ 値を返します。

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

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

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<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>str</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">String (文字列)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Time</code>​ 値に変換する ​<code>String</code>​ 値。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>formatters</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Array&lt;Formatter&gt;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Time</code>​ 値に対して使用する書式設定の​<code>配列</code>​。</p></td>
</tr>
</tbody>
</table>

### [](#例)例

次の例では、さまざまな入力での ​`toTimeOrNull`​ の動作を示します。 `application/dw`​ 形式の出力が生成されます。

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

```DataWeave
%dw 2.0
import * from dw::util::Coercions
output application/dw
---
{
  a: toTimeOrNull("13:44:12.283-08:00", [{format: "HH:mm:ss.xxx"}, {format: "HH:mm:ss.nxxx"}]),
  b: toTimeOrNull("13:44:12.283-08:00", [{format: "HH:mm:ss.xxx"}])
}
```

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

```DataWeave
{
  a: |13:44:12.000000283-08:00| as Time {format: "HH:mm:ss.nxxx"},
  b: null
}
```