document the time conversion functions