diff --git a/Doc/library/zipfile.rst b/Doc/library/zipfile.rst index 6a4fa67332e179..757dabba2127d0 100644 --- a/Doc/library/zipfile.rst +++ b/Doc/library/zipfile.rst @@ -818,7 +818,18 @@ 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 mod file time" and "last mod file date" + fields from the ZIP file's central directory. + + .. note:: + + 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. Future Python + versions may use alternative timestamp sources if they provide better accuracy + or precision. + + The tuple contains: +-------+--------------------------+ | Index | Value | @@ -838,7 +849,10 @@ Instances have the following methods and attributes: .. note:: - The ZIP file format does not support timestamps before 1980. + 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. .. attribute:: ZipInfo.compress_type