From b99a527cdfe0f62816420084c6446d44cb508cac Mon Sep 17 00:00:00 2001 From: Tadeja Kadunc Date: Fri, 19 Jun 2026 14:39:41 +0200 Subject: [PATCH] #50227 new pr - old #37227 --- docs/source/python/parquet.rst | 17 ++++++++--------- 1 file changed, 8 insertions(+), 9 deletions(-) diff --git a/docs/source/python/parquet.rst b/docs/source/python/parquet.rst index 2c6ed0d12d8c..4fc1368fb270 100644 --- a/docs/source/python/parquet.rst +++ b/docs/source/python/parquet.rst @@ -368,9 +368,9 @@ Storing timestamps Some Parquet readers may only support timestamps stored in millisecond (``'ms'``) or microsecond (``'us'``) resolution. Since pandas uses nanoseconds -to represent timestamps, this can occasionally be a nuisance. By default -(when writing version 1.0 Parquet files), the nanoseconds will be cast to -microseconds ('us'). +to represent timestamps, this can occasionally be a nuisance. When writing +older ``version='1.0'`` or ``version='2.4'`` Parquet files, the nanoseconds +will be cast to microseconds (``'us'``). In addition, We provide the ``coerce_timestamps`` option to allow you to select the desired resolution: @@ -388,17 +388,16 @@ an exception will be raised. This can be suppressed by passing >>> pq.write_table(table, 'example.parquet', coerce_timestamps='ms', ... allow_truncated_timestamps=True) -Timestamps with nanoseconds can be stored without casting when using the -more recent Parquet format version 2.6: +Timestamps with nanoseconds can be stored without casting when using +Parquet format version 2.6, which is the default: .. code-block:: python >>> pq.write_table(table, 'example.parquet', version='2.6') -However, many Parquet readers do not yet support this newer format version, and -therefore the default is to write version 1.0 files. When compatibility across -different processing frameworks is required, it is recommended to use the -default version 1.0. +However, some Parquet readers may not yet support this newer format version. +When compatibility across different processing frameworks is required, the +older ``version='1.0'`` or ``version='2.4'`` remain available. Older Parquet implementations use ``INT96`` based storage of timestamps, but this is now deprecated. This includes some older