Document new Date util behaviour, note Decimal numbers.

Pending https://github.com/plomino/Plomino/pull/294