DOC add to_datetime to api.rst
WIP some to_datetime docs additions
WIP to_datetime docs more rewriting
FIX final tweaks
Merge pull request #3859 from hayd/DOC_add_to_datetime

DOC add to_datetime to api.rst