add typehints to date classes
polished the docblocks in the date classes a bit
closes #997