https://github.com/python/cpython/commit/57b5baf3f9ae52178dd7b1cbce8b985ad9099384 commit: 57b5baf3f9ae52178dd7b1cbce8b985ad9099384 branch: 3.13 author: Miss Islington (bot) <[email protected]> committer: emmatyping <[email protected]> date: 2025-08-22T17:01:37-07:00 summary:
[3.13] gh-133125: Clarify ZipInfo.date_time attribute documentation (GH-136082) (#138076) 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 282e88506b1d3c2ea2a0fd2fbce6c4e27ddc1c92) Co-authored-by: Kentaro Jay Takahashi <[email protected]> Co-authored-by: Emma Smith <[email protected]> files: M Doc/library/zipfile.rst diff --git a/Doc/library/zipfile.rst b/Doc/library/zipfile.rst index 01f933386f3629..7256bf90d69a37 100644 --- a/Doc/library/zipfile.rst +++ b/Doc/library/zipfile.rst @@ -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 _______________________________________________ Python-checkins mailing list -- [email protected] To unsubscribe send an email to [email protected] https://mail.python.org/mailman3//lists/python-checkins.python.org Member address: [email protected]
