Refactor: libcrmcommon: clean up pcmk__time_format_hr() a bit

Add comments including a doxygen block, scope variables more tightly where
possible, move (shorter) NULL case first, and improve formatting.