[1] 多くのファイルを扱うシステムにファイルの時刻の属性がいくつかあります。

種別

[2] ほとんどが

... のいずれかに分類できます。

[7] ただし各日時の厳密な意味はプラットフォームとファイルシステム/データ形式/プロトコルによって異なります。

[9] NTFS では $STANDARD_INFORMATION (ファイルの内容のデータ側) と $FILE_NAME (ファイル名側) にそれぞれ4種類あります。 大まかに言って、内容が変更されれば両者が変更され、 ファイル操作が行われると後者が変更されます。 ファイル1個の情報の読み書きでは基本的に前者が使われ、 ファイル一覧の表示では後者が使われます。 ハードリンクが作られると、後者が複数個になります。

時間帯

[10] FATの日時形式は地方時を保存します。時差の情報が含まれず、 どこの時刻かわかりませんし、標準時か夏時刻かもわかりません。

[11] それより新しいほとんどのシステムは時差の概念のない絶対的な時刻の値を保存します。 利用者に表示するときはシステムの時間帯に合わせて表示されます。

[12] ZIP のように、古くからある標準のファイルの時刻は >>10 で、後から拡張として追加された (つまりすべての ZIPファイルに含まれるわけではない) ファイルの時刻は >>11 で両方が共存しているという書庫形式もあります。

データ形式

[8] ファイルの時刻に関係するプロトコル要素と機能

日時の換算

[190] ファイルの時刻の取り扱いで、意外と難関となるのが日時形式 (日時データ型) の換算暦の換算の問題です。

[191] OS, ファイルシステム, プログラミング言語, 圧縮形式、ファイルを扱う各種プロトコルでそれぞれ採用日時データ型が違うことが多いので、 処理の種類と過程に応じてどのデータ型で日時を保持し、 どこでどう換算暦の換算するかを開発者は熟慮しなければなりません。

[192] 個別具体的には各項を参照されたいのですが、概略して次のような事項に配慮が必要です。

FAT

FATの日時形式

他の日時形式との換算

[171] [PATCH V5 0/4] fat: timestamp updates, https://lore.kernel.org/all/2663d3083c4dd62f00b64612c8eaf5542bb05a4c.1538363961.git.sorenson@redhat.com/T/

[189] >>188

[213] 生成時、2秒未満は切り捨て :

  • [214] fs/fat/misc.c - kernel/common - Git at Google, https://android.googlesource.com/kernel/common/%2B/88b912e02d75b/fs/fat/misc.c
  • [219] c - Unix timestamp to FAT timestamp - Stack Overflow, https://stackoverflow.com/questions/15763259/unix-timestamp-to-fat-timestamp

[215] 生成時、 秒を round :

  • [216] fat-date/src/index.js at master · desaroger/fat-date · GitHub, https://github.com/desaroger/fat-date/blob/master/src/index.js

地方時の時刻の取り扱い

[164] Re: [PATCH] fat: Allow out-of-range FAT modification timestamps, , https://lists.gnu.org/archive/html/grub-devel/2021-09/msg00021.html

[165] timezone - VFAT, Linux: Invalid file timestamps shown after a reboot - Unix & Linux Stack Exchange, https://unix.stackexchange.com/questions/640555/vfat-linux-invalid-file-timestamps-shown-after-a-reboot

[166] c# - How do I get the correct modified datetime of a FAT32 file, regardless of timezone in .NET? - Stack Overflow, https://stackoverflow.com/questions/10068855/how-do-i-get-the-correct-modified-datetime-of-a-fat32-file-regardless-of-timezo

[167] ファイル時間 - Win32 apps | Microsoft Learn, stevewhims, , https://learn.microsoft.com/ja-jp/windows/win32/sysinfo/file-times?redirectedfrom=MSDN

[168] Handle daylight savings time changes with FAT filesystems · Issue #9227 · syncthing/syncthing, https://github.com/syncthing/syncthing/issues/9227

[169] Unwanted full rescan&resync @ SD card @ Syncthing Android after timezone/daylight saving change - Support / Android - Syncthing Community Forum, https://forum.syncthing.net/t/unwanted-full-rescan-resync-sd-card-syncthing-android-after-timezone-daylight-saving-change/21064

ZIP

[15] ZIP はファイルに対して日時を表す欄を多数有しています。

[60] ZIP はファイルごとに central directory header と local header があります。前者は ZIP 全体の索引として一括されたものであり、 後者は個別のファイルのデータに付与されたメタデータです。 どちらにも書き込まれる情報、一方にのみ書き込まれる情報、 両方に別の値で書き込まれる情報があります。 どう書き込むか仕様上で定まっている場合もあれば曖昧な場合もあり、 実データが仕様と一致していないこともよくあります。 こうした性格は日時情報各種にも当てはまります。

[120] 拡張の日付がどれも使われていない ZIPファイルは今でも非常に多いです。 つまり地方時だけで時差の情報が皆無のことが多いです。

[121] 拡張の日付が複数使われる場合もありますが、あまり多くありません。 拡張の日付が使われる場合はほとんどが mtime を指定していますが、 それ以外が指定される場合や、 mtime が 0 の場合もあります。 拡張の mtime と last mod file date / time は時差を除けば一致すると思われる場合が多いですが、 そうでない場合も散見されます。

[136] 拡張のどれが使われ、拡張のどの時刻が指定されるかは、 ファイルごとに異なる可能性があります。 特にディレクトリーと一般ファイルで違うケースが散見されます。

[135] last mod file date / time は地方時であり、どこの時刻であるかは、 ファイルごとに異なる可能性が否定できません。 拡張の時刻があれば、それとの比較で時差を算出しこれを検出できる可能性があります。

  • [36] null, , https://pkware.cachefly.net/webdocs/casestudies/APPNOTE.TXT
  • [35] null, , https://libzip.org/specifications/extrafld.txt
  • [13] zip展開後のタイムスタンプがおかしい · Issue #31 · koron/netupvim, https://github.com/koron/netupvim/issues/31
  • [14] archive/zip: handle mtime in NTFS/UNIX/ExtendedTS extra fields (18274) · Gerrit Code Review, https://go-review.googlesource.com/c/go/+/18274
  • [79] A non-scientific survey of ZIP Metadata, https://publicobject.com/2024/02/26/zip-metadata/
  • [93] X5455_ExtendedTimestamp (The Adobe Experience Manager SDK 2022.11.9850.20221116T162329Z-220900), , https://developer.adobe.com/experience-manager/reference-materials/cloud-service/javadoc/org/apache/commons/compress/archivers/zip/X5455_ExtendedTimestamp.html
  • [95] 7-Zip / Bugs / #1432 7ZFM can't recognize UNIX timestamps in .ZIP archive, https://sourceforge.net/p/sevenzip/bugs/1432/
  • [100] add support for Info-ZIP timestamp extra field by thejoshwolfe · Pull Request #86 · thejoshwolfe/yazl · GitHub, https://github.com/thejoshwolfe/yazl/pull/86/files
  • [102] go/src/archive/zip/reader.go at 9ddb8ea73724d717a9bbf44be7d585ba5587504f · golang/go · GitHub, https://github.com/golang/go/blob/9ddb8ea73724d717a9bbf44be7d585ba5587504f/src/archive/zip/reader.go#L404-L440
  • [105] File: ziptools/ziptools/ziptools/zipmodtimeutc.py, https://learning-python.com/cgi/showcode.py?name=ziptools/ziptools/ziptools/zipmodtimeutc.py
  • [132] Will *.zip file stop working after 2038 ? : r/software, https://www.reddit.com/r/software/comments/jqnc9u/will_zip_file_stop_working_after_2038/

実装戦略

[122] 実装は複数の日付のうちどれを使うかの選択を迫られます。 利用実態や精度を鑑みれば、

  1. [123] 0x000A (NTFS)
  2. [124] 0x5455
  3. [125] 0x5855
  4. [126] 0x000D (Unix)
  5. [127] last mod file date / time

... の優先順が良いと思われます。それぞれ central directory header → local header の順で、値が 0 や無指定なら無視して次を参照します。

[128] 日時の読み書きでは、 ZIPファイル上のデータ構造やプラットフォーム・ファイルシステム・プログラミング言語のデータ構造の違いと、 それに伴う値域や精度の違いに注意する必要があります。

  • [129] FATの日時形式 : - 地方時 2s 単位
  • [133] 32ビット符号付き整数 秒単位 : - (西暦2038年問題)
  • [134] 32ビット符号無し整数 秒単位 : -

[173] からまでは Unix time で記述できますが、 FATの日時形式では記述できません。 ZIP の生成を強行するなら値を不一致とせざるを得ません。 Unix time 0 () がこの範囲に含まれることに注意が必要です。

[174] 途中から途中までは32ビット符号付き整数 Unix time で記述できますが、32ビット符号無し整数 Unix time では記述できません。逆に32ビット符号無し整数 Unix time でなければまでが記述できません。ビット列だけを見てもこのどちらであるかを判定できません。ところで FATの日時形式では都合がいいことにまで記述できますので、32ビット符号無し整数で以上であることはFATの日時形式の年から判断できます。都合が悪いことにFATの日時形式では以下が記述できないため、 32ビット符号付き整数であることを確信はできませんが、32ビット符号無し整数と確定できないなら32ビット符号付き整数と判断するのが良いと思われます。

  • [175] 64ビット符号付き整数 秒単位 : -
  • [176] 64ビット符号無し整数 秒単位 : -
  • [177] 64ビット符号付き整数 ミリ秒単位 : -
  • [178] 64ビット符号付き整数 ナノ秒単位 : -

[179] POSIX 系の多くの新しいプラットフォームは64ビット符号付き整数の秒単位 Unix time を扱えます。 FATの日時形式と32ビット整数 Unix time の範囲が完全に収まるので、 ZIPファイルからの読み込みには適切といえます。 ZIPファイルへの書き込みでは、32ビット符号付き整数の範囲外の値を適切に処理する必要があります。 Java のミリ秒単位や Go のナノ秒単位の Unix time でも同じことが言えます。

[180] 64ビット符号無し整数は、以前を扱えないので、適切とはいえません。

  • [181] 64ビット符号付き整数 : - 100ns 単位
  • [182] 64ビット符号無し整数 : - 100ns 単位

[183] NTFSの日時形式は符号付き整数説と符号無し整数説があります。 実装上も実用上も安定して使えるのは両者の重なりの更に一部だけとされます。 NTFSの日時形式 従って、 ZIPファイルに含まれるNTFSの日時形式がいずれであるかを問題とする必要はありません。 ZIP の処理では、その仕様に従い符号無し整数とするのが良いと考えられます。

[184] どちらと解釈するにせよ、 64ビット符号付き整数の秒単位やミリ秒単位の Unix time を扱えるものの、精度を保つことはできません。実装は Unix time に統一して下位桁溢れを妥協するか、2種類のデータ型を併用するかの選択を求められます。

[185] 逆に Windows 系の実装は NTFSの日時形式を正とし、 Unix time の範囲の両端を扱えないことを妥協するという選択肢もあり、その方法でも実用上は問題ないと考えられます。

[186] ナノ秒単位の Unix time は NTFSの日時形式の精度を完全に記述できるものの、その範囲の両端を扱えないことを妥協する必要があり、それでも実用上は問題ないと考えられます。

[187] いずれにせよ、範囲外となる値は適切に処理する必要があります。

[130] Perlモジュール Archive::Zip は last mod file date / time が Unix time で 未満の値に設定されたとき、 に変更します。 時差の問題を避けるために始年始から12時間1分ずらされています。

[217] なお、範囲できない大きな値の検査はしておらず。成り行きとなります。

[218] FATの日時形式で2秒単位しか表現できない秒の桁は切り捨てられます。

[131] >>78 の実装は範囲外の値となるとき、直近の値 (つまり境界の値) を入れます。

[188] なお、これらの問題は ZIP 固有でなく、 FAT や NTFS や SMB などでも発生します。しかし、 どの種類の値が組合せて供給されるかなど、条件が少しずつ違います。

[78] GitHub - thejoshwolfe/yazl: yet another zip library for node, https://github.com/thejoshwolfe/yazl

When attempting to encode an mtime outside the supported range for either format, such as the year 1970 in the DOS format or the year 2039 for the modern format, the time will clamped to the closest supported time.

 [170] python - Getting Error as "ValueError: Zip does not support timestamps before 1980" while installing Setuptools-scm Pypi - Stack Overflow, https://stackoverflow.com/questions/62915376/getting-error-as-valueerror-zip-does-not-support-timestamps-before-1980-while

地方時の時差の推定

[139] 多くの実装は地方時しかないとき、プラットフォームの時差によるものと解釈します。 ZIPファイルの送受信者は同じ地域に所在することが多いと推測されますから、これでうまくいく場合が多いと思われます。

[140] ところが、 Webサイトからのダウンロードで遠隔地の ZIPファイルを入手することがあると、この前提は成り立たなくなります。あちこちから収集した ZIPファイルに機械的な処理をしたいときにも困ります。

[137] 地方時しか判明しないときでも、ファイル名の文字コードの情報があれば、文字コードと強く結びついた時間帯と推定できる場合があります。 ロケール等による文字コード判定の補助

[138] 文字コードから判断できない UTF-8 のような場合でも、言語判定によって言語と強く結びついた時間帯と推定できる場合があります。

[142] ZIPファイルがインターネットから取得したものなら、入手に使った URL の ccTLD を利用できることがあります。政府機関等の公開データは ccTLD を使った Webサイトで配布されていることが多いので、多くの国で有効と期待できます。

[141] その他ファイルの中身の分析なども考えられ、例えばワープロの文書形式はメタ情報として変更日時を記録していることが多そうですし、ただのテキストファイルでも言語判定で推測できるかもしれませんが、判定コストが高い割に都合がいいファイルが ZIPファイルに入っている確率は高くなさそうですし、推測の精度もそれほど良くならないことが多そうです。

[143] 推奨される判定方法 :

  1. [145] 強制的な指定値がある場合、
    1. [223] その値を返し、ここで停止します。
  2. [224] 各ファイルに対し、
    1. [144] 拡張の mtime がある場合、
      1. [221] t を、 last mod file date / time - 拡張の mtime に設定します。
      2. [222] tを、 sign (t) (15 × 60) ⌊ |t| + 15 × 60 2 15 × 60 ⌋ に設定します。
      3. [146] |t| ≦ 24 × 60 × 60 の場合、
        1. [147] tを返し、ここで停止します。
  3. [148] ファイル名の文字コードから推定時差を1つに定められる場合、
    1. [149] その値を返します。
  4. [150] ファイル名の文字コードから推定時差を2つ (標準時と夏時刻) に定められる場合、
    1. [151] 地域を、その推定時差の地域に設定します。
    2. [152] ccTLD の国が null でなく、地域に属する場合、
      1. [153] ccTLD の国の代表の時間帯を返します。
    3. [154] それ以外の場合、
      1. [155] 地域の代表の時間帯を返します。
  5. [156] それ以外の場合、
    1. [157] ccTLD の国が null でない場合、
      1. [158] ccTLD の国の代表の時間帯を返します。
    2. [159] それ以外の場合、
      1. [160] 決定不能を返します。

利用例

[46] 実利用例:

  • [49] https://statistique.quebec.ca/en/fichier/rda-startup-kit.zip
    • [52] https://web.archive.org/web/20251231021855/https://statistique.quebec.ca/en/fichier/rda-startup-kit.zip
      • [53] 古いものは同じ URL でも別ファイル (日付構造も違う) なので注意。
    • [50] ディレクトリーは local header の 0x5455 に mtime, atime, ctime (flag もこれに一致) central directory に mtime (flag もこれに一致)
    • [51] 一般ファイルは central directory に mtime (flag もこれに一致)
  • [110] https://www.city.yokohama.lg.jp/kosodate-kyoiku/kyoiku/gakku-meibo/tsugakukuiki/bunnpuzu-gis.files/0019_20250910.zip
    • [111] 一般ファイルは central directory 0x5455 に mtime, last mod file date / time と時差を除き同じ値
  • [112] https://www.city.yokohama.lg.jp/business/bunyabetsu/kankyo-koen-gesui/kiseishido/kagaku/risukuhyoka.files/0043_20251201.zip
    • [113] 一般ファイルは central directory 0x5455 に mtime, last mod file date / time と時差を除き同じ値
  • [54] https://www.sio.gov.sa/assets/files/guide_files/Arabic.zip
    • [55] ディレクトリーは 0x5855 に central directory, local header の modtime, actime の計4つ同じ値。
      • [56] おそらく時差を除いて last mod file date / time とも同じ値。
    • [57] ファイルは 0x5855 に central directory のみ modtime, actime の2つが別の値。
      • [58] last mod file date / time と modtime が同じ値。
  • [97] https://web.archive.org/web/20110706022639/http://www.youngcreativechevrolet.eu/app/webroot/uploads/fonts_ycc.zip
    • [98] ディレクトリーは 0x5855 に central directory, local header の modtime, actime の計4つの値。
    • [99] ファイルは 0x5855 に central directory のみ modtime, actime の2つの値。
  • [106] https://catalog-data.city.kanazawa.ishikawa.jp/dataset/89d93f28-38b4-4971-9988-2ff2d3227f56/resource/50049b19-fe9f-4c1f-a9ea-9d0a24141644/download/172103_bus.zip
    • [107] 一般ファイルの central directory に NTFS の mtime, ctime, atime
      • [108] ctime, atime は 0
      • [109] mtime と last mod file date / time が時差を除き同じ値
  • [47] https://opendata.attica.gov.gr/content/genikh-dieythynsh-eswterikhs-leitoyrgias/d-nsh-dioikhtikwn-yphresiwn/155-diakhrykseis?fdl=WGNVMDZpUXBkL0VvczA4L0RHM1NMVWxCMkRQSUdMdWlDbjNFY1VGZTZSQXk2aEJoWGhoSkRGZWtSa0diR2c0MVltZ3ZNa3R1VTA1MlZUWnNSM0p6V21wWk5ERk5VVDA5
    • [48] ディレクトリー, 一般ファイルとも central directory に NTFS 時刻

[25] 人工的な利用例:

  • [24] https://bugs.python.org/file48724/t.zip
    • [26] ディレクトリーは 0x5455 に
      • [27] central directory では flag では mtime と atime が入っていることになっているが値は mtime だけ (仕様通り)
      • [28] local header では mtime と atime の両方が値もある
    • [29] 一般ファイルは 0x5455 に
      • [30] central directory では flag では mtime と atime が入っていることになっているが値は mtime だけ
      • [31] local header には 0x5455 が無し
  • [32] https://github.com/icsharpcode/SharpZipLib/files/2522058/UTF8_Filenames.zip
    • [33] >>24 と同じ構造
  • [161] https://github.com/rubyzip/rubyzip/raw/refs/heads/main/test/data/osx-archive.zip
    • [162] 一般ファイルは central directory の 0x5455 に atime, ctime, mtime
  • [39] https://github.com/user-attachments/files/16069900/default.zip
    • [40] central directory に NTFS タイムスタンプがあります。 3つの時刻のどれも last mod file date / time と微妙にずれています。丸めの差?
  • [41] https://github.com/thejoshwolfe/yauzl/files/1973376/default.zip
    • [42] ディレクトリーは 0x5855 に central directory, local header の modtime, actime の計4つ同じ値。
      • [43] おそらく時差を除いて last mod file date / time とも同じ値。
    • [44] ファイルは 0x5855 に central directory のみ modtime, actime の2つが別の値。
      • [45] last mod file date / time とは一致しないが、おそらく modtime と少し前後した時刻で丸めの差か。

メモ

[34] アーカイブファイルフォーマットのタイムスタンプまとめ, https://zenn.dev/sorairolake/articles/timestamp-of-archive-formats

[59] Git は commit に日付があり、ファイルには日付がありません。 他の多くの版管理システムでも同様です。

[163] Filesystem Timestamps: What Makes Them Tick?, https://www.sans.org/white-papers/36842

関連

システムの時間帯, 地方時

メモ

[172] FatFs - Configuration Options, , https://elm-chan.org/fsw/ff/doc/config.html#fs_nortc

[220] ファイルのタイムスタンプが変更されるタイミング, https://zenn.dev/megeton/articles/e58ea554ba5650