datetime: fix deprecation warning
datetime: fix some specs and documentation