[ARROW-5545] [C++][Docs] Clarify expectation of UTC values for timestamps with time zones in C++ API docs

• Type: Improvement
• Status: Resolved
• Priority: Trivial
• Resolution: Fixed
• Fix Version/s: 0.14.0
• Component/s: C++
• Labels: documentation pull-request-available
• External issue URL: https://github.com/apache/arrow/issues/21991
• Assignee: TP Boudreau
• Reporter: TP Boudreau
• Created: 10/Jun/19 17:23
• Updated: 11/Jan/23 07:41
• Resolved: 14/Jun/19 12:59

Description

For timestamp datatypes, if the timezone parameter is non-empty, the int64 array values in the associated column are assumed to be normalized to UTC.  This requirement should be made clear to the C++ API user.  (It can be inferred from the flatbuffers schema, but that internal implementation document probably wouldn't ordinarily be consulted by a C++ API consumer.)

Issue Links

• links to: GitHub Pull Request #4555