Refactor: libcrmcommon,libpe_status: best practices for get_effective_time()

Move from libpe_status to libcrmcommon, rename to
pcmk__scheduler_epoch_time(), add a doxygen block, and improve log
messages and formatting.