Improve documentation of ParseDateTime(). Reorder tests to prevent

writing one more value into return arrays than will fit.  This is
potentially a stack smash, though I do not think it is a problem in
current uses of the routine, since a failure return causes elog anyway.