Enhance documentation around timestamp APIs

We should review and enhance the documentation around APIs that return timestamps. Specifically their behavior in regards to distinguishing a not-set value from a zero value (if such a distinction exists).

If the documentation process leads to finding inconsistencies in the API, we should explore updating our APIs to be more consistent.