GH-47441: [Python][Parquet] Allow passing write_time_adjusted_to_utc to Python's ParquetWriter

[rmnskb]

Rationale for this change

Please see #47441 and #41476.
The ArrowWriterProperties.write_time_adjusted_to_utc flag is available in C++, yet isn't accessible from Python. This PR introduces the said flag to Python API as well.

What changes are included in this PR?

Exposure of use_time_adjusted_to_utc boolean argument in Python's API.

Are these changes tested?

Yes, roundtrip parquet tests for all combinations of time types and their respective time units.

Are there any user-facing changes?

The users will be able to adjust the said flag directly from Python API.

• GitHub Issue: [Python][Parquet] Allow passing write_time_adjusted_to_utc #47441

[github-actions]

⚠️ GitHub issue #47411 has been automatically assigned in GitHub to PR creator.

[github-actions]

⚠️ GitHub issue #47441 has no components, please add labels for components.

[github-actions]

⚠️ GitHub issue #47441 has no components, please add labels for components.

[github-actions]

⚠️ GitHub issue #47441 has no components, please add labels for components.

[rmnskb]

Hey @pitrou, I've exposed the UTC flag to the Python's Parquet API.
However, I wanted to ask you if it would make sense to test these changes? The original PR that I've linked tests them by checking the ArrowWriterProperties, which are not available to Python from the pq.ParquetWriter.writer. Would it make sense to write an end to end test?
Thank you for your input in advance!

[pitrou]

You'll need to update the docstrings as well (see _parquet_writer_arg_docs)

[pitrou]

However, I wanted to ask you if it would make sense to test these changes? The original PR that I've linked tests them by checking the ArrowWriterProperties, which are not available to Python from the pq.ParquetWriter.writer. Would it make sense to write an end to end test?

We can indeed write a simple end-to-end test. Showing that the data roundtrips is IMHO sufficient.

[rmnskb]

We can indeed write a simple end-to-end test. Showing that the data roundtrips is IMHO sufficient.

Thanks!
Is there any way from the Python API to check the metadata if the UTC flag was successfully applied? I could not find anything in the documentation.

[pitrou]

Is there any way from the Python API to check the metadata if the UTC flag was successfully applied? I could not find anything in the documentation.

I don't think so, no.

[github-actions]

⚠️ GitHub issue #47441 has no components, please add labels for components.

[pitrou]

LGTM, just one small suggestion

[conbench-apache-arrow]

After merging your PR, Conbench analyzed the 3 benchmarking runs that have been run so far on merge-commit ed91f6f.

There were no benchmark performance regressions. 🎉

The full Conbench report has more details. It also includes information about 1 possible false positive for unstable benchmarks that are known to sometimes produce them.