Skip to main content

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


overwrite delimiter string


do not convert existing datestamps to new format

-q, --quiet

do not output anything but just errors on console

-v, --verbose

enable verbose mode

-s, --dryrun

enable dryrun mode: just simulate what would happen, do not modify files or directories


display version and exit

Please read for further information and descriptions.

Project details

Download files

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

Source Distributions

No source distribution files available for this release. See tutorial on generating distribution archives.

Built Distribution

date2name-2021.11.25.2-py3-none-any.whl (19.8 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page