This document is the API specification for dealing with dates.