westonpace commented on code in PR #34208: URL: https://github.com/apache/arrow/pull/34208#discussion_r1110126490
########## docs/source/cpp/compute.rst: ########## @@ -1556,11 +1556,20 @@ Input timestamps are assumed to be relative to the timezone given in UTC-relative timestamps with the timezone metadata set to the above value. An error is returned if the timestamps already have the timezone metadata set. +`local_time` function converts UTC-relative timestamps to local "timezone-naive" +timestamp. The timezone is taken from the timezone metadata of the input Review Comment: ```suggestion timestamps. The timezone is taken from the timezone metadata of the input ``` ########## docs/source/cpp/compute.rst: ########## @@ -1556,11 +1556,20 @@ Input timestamps are assumed to be relative to the timezone given in UTC-relative timestamps with the timezone metadata set to the above value. An error is returned if the timestamps already have the timezone metadata set. +`local_time` function converts UTC-relative timestamps to local "timezone-naive" +timestamp. The timezone is taken from the timezone metadata of the input +timestamps. This function is the inverse of `assume_timezone`. Please note: +**all temporal functions already operate on timestamps as if they were in local +time of metadata provided timezone**. Using `local_time` is only meant to be Review Comment: ```suggestion time of the metadata provided timezone**. Using `local_time` is only meant to be ``` -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
