toLocalTimeOrNull

toLocalTimeOrNull(str: String, formatters: Array<Formatter>): LocalTime | Null

Transforms a String value into a LocalTime value using the first Formatter that matches with the given value to transform.

If none of the Formatter matches with the given value, the function returns a null value.

Introduced in DataWeave version 2.5.0.

Parameters

Name Type Description

Name	Type	Description
`str`	String	The `String` value to transform into a `LocalTime` value.
`formatters`	Array<Formatter>	The `array` of formatting to use on the `LocalTime` value.

str

String

The String value to transform into a LocalTime value.

formatters

Array<Formatter>

The array of formatting to use on the LocalTime value.

Example

This example shows how toLocalTimeOrNull behaves with different inputs. It produces output in the application/dw format.

Source

%dw 2.0
import * from dw::util::Coercions
output application/dw
---
{
  a: toLocalTimeOrNull("23:57:59", [{format: "HH:mm:ss.n"}, {format: "HH:mm:ss"}]),
  b: toLocalTimeOrNull("23:57:59", [{format: "HH:mm:ss.n"}])
}

Output

{
  a: |23:57:59| as LocalTime {format: "HH:mm:ss"},
  b: null
}