1. Homepage
  2. DataWeave (2.8)
  3. DataWeave リファレンス
  4. dw::util::Coercions

  5. toTime

toTime

toTime(str: String, formatters: Array<Formatter>): Time

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

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

パラメーター

名前 型 説明

str

String (文字列)

Time​ 値に変換する ​String​ 値。

formatters

Array<Formatter>

Time​ 値に対して使用する書式設定の​配列​。

例

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

ソース

%dw 2.0
import * from dw::util::Coercions
import * from dw::Runtime
output application/dw
---
{
  a: toTime("13:44:12.283-08:00", [{format: "HH:mm:ss.xxx"}, {format: "HH:mm:ss.nxxx"}]),
  b: try(() -> toTime("13:44:12.283-08:00", [{format: "HH:mm:ss.xxx"}]).error.message
}

出力

{
  a: |13:44:12.000000283-08:00| as Time {format: "HH:mm:ss.nxxx"},
  b: "Could not find a valid formatter for '13:44:12.283-08:00'"
}

toTime(str: String, format: String | Null = null, locale: String | Null = null): Time

String​ 値を ​Time​ 値に変換して、形式とロケールを受け入れます。

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

パラメーター

名前 説明

str

Time​ 値に変換する ​String​ 値。

format

Time​ 値に対して使用する書式設定。 ​null​ 値は ​Time​ 値に対して無効です。 このパラメーターでは、ISO-8601 に基づいた Java 文字パターンを受け入れます。​10:15:30.000000​ などの ​Time​ 値の形式は ​HH:mm:ss.nxxx​ となります。

locale

使用する省略可能な ISO 3166 国コード (​US​、​AR​、​ES​ など)。​null​ または欠落値では JVM のデフォルトが使用されます。

例

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

ソース

%dw 2.0
import * from dw::util::Coercions
output application/dw
---
{
   a: toTime("23:57:59Z"),
   b: toTime("13:44:12.283-08:00","HH:mm:ss.nxxx")
}

出力

{
  a: |23:57:59Z|,
  b: |13:44:12.000000283-08:00| as Time {format: "HH:mm:ss.nxxx"}
}