issue #1031: updated documentation for date functions