dc_datetime function documentation

Hi, Enclosed is a patch that documents all of the dc_datetime functions. The CAVEATS are important because calling gmtime et al from a library might not be expected. (They touch the zoneinfo files, which may not be available on embedded or sandboxed systems.) I also specifically note the differences to "struct tm" in terms of the year and month field. Best, Kristaps