From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> Date: Thu, 11 Sep 2025 09:19:35 +0000 (+0200) Subject: [3.14] gh-133125: Clarify ZipInfo.date_time attribute documentation (GH-136082) ... X-Git-Tag: v3.14.0rc3~38 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=7e0232895a0698d842d432271311c0616fefdb44;p=thirdparty%2FPython%2Fcpython.git [3.14] gh-133125: Clarify ZipInfo.date_time attribute documentation (GH-136082) (#138077) Co-authored-by: Kentaro Jay Takahashi <64148935+KentaroJay@users.noreply.github.com> Co-authored-by: Emma Smith --- diff --git a/Doc/library/zipfile.rst b/Doc/library/zipfile.rst index a1261ec471c9..f6ec33640b60 100644 --- a/Doc/library/zipfile.rst +++ b/Doc/library/zipfile.rst @@ -830,7 +830,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 | @@ -850,7 +853,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