toLocalDateTimeOrNull

toLocalDateTimeOrNull(str: String, formatters: Array<Formatter>): LocalDateTime | Null

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

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

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

パラメーター

名前型説明

名前	型	説明
`str`	String (文字列)	`LocalDateTime` 値に変換する `String` 値。
`formatters`	Array<Formatter>	`LocalDateTime` 値に対して使用する書式設定の`配列`。

str

String (文字列)

LocalDateTime 値に変換する String 値。

formatters

Array<Formatter>

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

例

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

ソース

%dw 2.0
import * from dw::util::Coercions
output application/dw
---
{
  a: toLocalDateTimeOrNull("2003-10-01 23:57:59", [{format: "uuuu/MM/dd HH:mm:ss"}, {format: "uuuu-MM-dd HH:mm:ss"}]),
  b: toLocalDateTimeOrNull("2003-10-01 23:57:59", [{format: "uuuu/MM/dd HH:mm:ss"}])
}

出力

{
  a: |2003-10-01T23:57:59| as LocalDateTime {format: "uuuu-MM-dd HH:mm:ss"},
  b: null
}