To understand the basics of the API at first glance, there should be a simple diagram which shows the different classes, their differences, and how to convert between them.
I think Lubridate's "Cheat Sheet" from R could be a fantastic inspiration for this. They really did a solid job conveying the concepts of datetimes, durations, and intervals visually.
To understand the basics of the API at first glance, there should be a simple diagram which shows the different classes, their differences, and how to convert between them.