Skip to main content
Version: Java (Groovy)

parsePeriodQuiet

The parsePeriodQuiet method returns the string argument as a Period, which is a unit of time in terms of calendar time (days, weeks, months, years).

"Quiet" methods return null instead of throwing an exception when encountering a string that cannot be parsed.

Syntax​

parsePeriodQuiet(s)

Parameters​

ParameterTypeDescription
sstring

The string to be converted.

Date-time strings are formatted according to the ISO-8601 duration format as PnYnMnD and PnW, where the coefficients can be positive or negative. Zero coefficients can be omitted. Optionally, the string can begin with a negative sign.

Examples: "P2Y" -- Period.ofYears(2) "P3M" -- Period.ofMonths(3) "P4W" -- Period.ofWeeks(4) "P5D" -- Period.ofDays(5) "P1Y2M3D" -- Period.of(1, 2, 3) "P1Y2M3W4D" -- Period.of(1, 2, 25) "P-1Y2M" -- Period.of(-1, 2, 0) "-P1Y2M" -- Period.of(-1, -2, 0)

Returns​

A Period, or null if invalid input is given.

Examples​

period = parsePeriodQuiet("P33Y4M23D")

invalid_period = parsePeriodQuiet("invalid")

println period
println invalid_period