Stowage/cpython
2
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2026-01-06 07:22:09 +00:00
Code Issues Projects Releases Packages Wiki Activity

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

Browse source 
Specifically, clarify that ZipInfo.date_time pulls the datetime information from the central directory, and that times are interpreted as local time.

Co-authored-by: Emma Smith <emma@emmatyping.dev>
This commit is contained in:
Kentaro Jay Takahashi 2025-08-23 08:52:30 +09:00 • committed by GitHub
parent 90b932e650
commit 282e88506b
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 13 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

15
Doc/library/zipfile.rst
View file

@ -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