Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Handling time-stamps and date-stamps in file names

Project Description

This Python script adds, removes, and manages date- and time-stamps in file names.

2013-05-09 a file name with ISO date stamp in name – tag1.jpg

2013-05-09T16.17 file name with time stamp – tag3.csv

date2name [options] file …

Per default, date2name gets the modification time of matching files and directories and adds a datestamp in standard ISO 8601+ format YYYY-MM-DD ( at the beginning of the file- or directoryname. If an existing timestamp is found, its style will be converted to the selected ISO datestamp format but the numbers stays the same. Executed with an examplefilename “file” this results e.g. in “2008-12-31_file”. Note: Other that defined in ISO 8601+ the delimiter between hours, minutes, and seconds is not a colon but a dot. Colons are causing several problems on different file systems and are there fore replaced with the (older) DIN 5008 version with dots.

Run date2name –help for usage hints

-h, --help show this help message and exit
-d, --directories
 modify only directory names
-f, --files modify only file names
-C, --compact use compact datestamp (YYYYMMDD)
-M, --month use datestamp with year and month (YYYY-MM)
-w, --withtime use datestamp including seconds (
-m, --mtime take modification time for datestamp [default]
-c, --ctime take creation time for datestamp
-q, --quiet do not output anything but just errors on console
-v, --verbose enable verbose mode
 do not convert existing datestamps to new format
-s, --dryrun enable dryrun mode: just simulate what would happen, do not modify files or directories
--version display version and exit

Please read for further information and descriptions.

Release History

This version
History Node


History Node


History Node


History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(8.8 kB) Copy SHA256 Hash SHA256
Wheel py3 Feb 3, 2018

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers