simplify dates

Also update documentation (so see doc for details).