Refactor: libcrmcommon: best practices for parse_xml_duration()

Move to libcrmcommon as pcmk__unpack_duration(), add a doxygen block and unit
tests, improve argument validation, and return a standard Pacemaker return
code.