Skip to content

Commit b99a527

Browse files
committed
#50227 new pr - old #37227
1 parent 2aaac07 commit b99a527

1 file changed

Lines changed: 8 additions & 9 deletions

File tree

docs/source/python/parquet.rst

Lines changed: 8 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -368,9 +368,9 @@ Storing timestamps
368368

369369
Some Parquet readers may only support timestamps stored in millisecond
370370
(``'ms'``) or microsecond (``'us'``) resolution. Since pandas uses nanoseconds
371-
to represent timestamps, this can occasionally be a nuisance. By default
372-
(when writing version 1.0 Parquet files), the nanoseconds will be cast to
373-
microseconds ('us').
371+
to represent timestamps, this can occasionally be a nuisance. When writing
372+
older ``version='1.0'`` or ``version='2.4'`` Parquet files, the nanoseconds
373+
will be cast to microseconds (``'us'``).
374374

375375
In addition, We provide the ``coerce_timestamps`` option to allow you to select
376376
the desired resolution:
@@ -388,17 +388,16 @@ an exception will be raised. This can be suppressed by passing
388388
>>> pq.write_table(table, 'example.parquet', coerce_timestamps='ms',
389389
... allow_truncated_timestamps=True)
390390
391-
Timestamps with nanoseconds can be stored without casting when using the
392-
more recent Parquet format version 2.6:
391+
Timestamps with nanoseconds can be stored without casting when using
392+
Parquet format version 2.6, which is the default:
393393

394394
.. code-block:: python
395395
396396
>>> pq.write_table(table, 'example.parquet', version='2.6')
397397
398-
However, many Parquet readers do not yet support this newer format version, and
399-
therefore the default is to write version 1.0 files. When compatibility across
400-
different processing frameworks is required, it is recommended to use the
401-
default version 1.0.
398+
However, some Parquet readers may not yet support this newer format version.
399+
When compatibility across different processing frameworks is required, the
400+
older ``version='1.0'`` or ``version='2.4'`` remain available.
402401

403402
Older Parquet implementations use ``INT96`` based storage of
404403
timestamps, but this is now deprecated. This includes some older

0 commit comments

Comments
 (0)