mirror of
https://github.com/python/cpython.git
synced 2025-12-23 09:19:18 +00:00
[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
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:
parent
2aeae241ca
commit
57b5baf3f9
1 changed files with 13 additions and 2 deletions
|
|
@ -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
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue