Refactor: libcrmcommon: best practices for pe_cron_range_satisfied()

Rename to pcmk__evaluate_date_spec(), add a doxygen block, and improve
variable names and comments.

Also, flip the order of the arguments for consistency with other rule
evaluation functions, and refactor to loop through a struct of ranges
to avoid the need for CHECK_ONE().