[3.13] gh-133125: Clarify ZipInfo.date_time attribute documentation (GH-136082) (#138076)
Some checks are pending
Tests / (push) Blocked by required conditions
Tests / Windows MSI (push) Blocked by required conditions
Tests / Ubuntu SSL tests with OpenSSL (push) Blocked by required conditions
Tests / Docs (push) Blocked by required conditions
Tests / Change detection (push) Waiting to run
Tests / Check if the ABI has changed (push) Blocked by required conditions
Tests / Check if Autoconf files are up to date (push) Blocked by required conditions
Tests / Check if generated files are up to date (push) Blocked by required conditions
Tests / Android (aarch64) (push) Blocked by required conditions
Tests / Android (x86_64) (push) Blocked by required conditions
Tests / WASI (push) Blocked by required conditions
Tests / Hypothesis tests on Ubuntu (push) Blocked by required conditions
Tests / Address sanitizer (push) Blocked by required conditions
Tests / Sanitizers (push) Blocked by required conditions
Tests / CIFuzz (push) Blocked by required conditions
Tests / All required checks pass (push) Blocked by required conditions
Lint / lint (push) Waiting to run

gh-133125: Clarify ZipInfo.date_time attribute documentation (GH-136082)

Specifically, clarify that ZipInfo.date_time pulls the datetime information from the central directory, and that times are interpreted as local time.
(cherry picked from commit 282e88506b)

Co-authored-by: Kentaro Jay Takahashi <64148935+KentaroJay@users.noreply.github.com>
Co-authored-by: Emma Smith <emma@emmatyping.dev>
This commit is contained in:
Miss Islington (bot) 2025-08-23 02:01:37 +02:00 committed by GitHub
parent 2aeae241ca
commit 57b5baf3f9
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -799,7 +799,10 @@ Instances have the following methods and attributes:
.. attribute:: ZipInfo.date_time
The time and date of the last modification to the archive member. This is a
tuple of six values:
tuple of six values representing the "last [modified] file time" and "last [modified] file date"
fields from the ZIP file's central directory.
The tuple contains:
+-------+--------------------------+
| Index | Value |
@ -819,7 +822,15 @@ Instances have the following methods and attributes:
.. note::
The ZIP file format does not support timestamps before 1980.
The ZIP format supports multiple timestamp fields in different locations
(central directory, extra fields for NTFS/UNIX systems, etc.). This attribute
specifically returns the timestamp from the central directory. The central
directory timestamp format in ZIP files does not support timestamps before
1980. While some extra field formats (such as UNIX timestamps) can represent
earlier dates, this attribute only returns the central directory timestamp.
The central directory timestamp is interpreted as representing local
time, rather than UTC time, to match the behavior of other zip tools.
.. attribute:: ZipInfo.compress_type