Refactor: libcrmcommon: best practices for crm_time_set_if_earlier()

Move to libcrmcommon as pcmk__set_time_if_earlier(), add a doxygen block,
improve formatting, and add unit tests.