A simple python program for time stamping files in a directory.

timestamp.py

import os, sys
from datetime import datetime, timezone, timedelta

#this program uses the times the system gives. If the time is wrong, check your file properties before blaming the program (an example is that my system, not the program, is labelling an hour behind likely due to daylight savings). If those don't match after checking, or you find a bug then feel free to email me at [email protected]

#display help info.
if '-h' in sys.argv:
    print(
"""
About: timestamps all files in directory using last date modified.
Arguments:
-p <path>
    Sets the target path to the specified path.
-r
    Sets the program to recursive mode. this will make it recusively check directories for files and time stamp each file.
-z <offset integer>
    Sets the timezone to UTC+<offset integer> where the offset integer is between -24 and 24. If unspecified the local timezone is found with datetime.now
-h
    Ignore all other arguments, display program information, and do not run the program.
-c
    Use creation time instead of last modified time. This may not work on some unix systems, instead using modfied date regardless.
""")
    sys.exit(0)

path = os.getcwd() #default to current working directory

if "-p" in sys.argv: #is a path specified?
    try:
        path = sys.argv[sys.argv.index('-p') + 1]
    except IndexError:
        print("Please input path after -p") #no argument specified after -p
        sys.exit(-1)

    if not os.path.exists(path): #invalid path specified
        print("Invalid path entered: " + path)
        sys.exit(-1)
else: #this means that cwd is used, just want to confirm with the user this is what they want.
    confirm = input("Modifying all file names in current directory, continue? [Y/n]\n")
    if (len(confirm) > 0):
        if (confirm[0].lower() == 'n'):
            print("Cancelled.")
            sys.exit(-1)

#use creation dates?
creation = '-c' in sys.argv

#recursive mode?
recursive = '-r' in sys.argv

#get default timezone
tz = datetime.now().astimezone().tzinfo

if '-z' in sys.argv: #did the user specify timezone?
    try:
        offset = sys.argv[sys.argv.index('-z') + 1]
        tz = timezone(timedelta(hours=int(offset)))
    except ValueError: #offset is invalid, either not a number or not within -24 to 24
        print("Invalid time zone. Please input integer offset from UTC")
        sys.exit(-1)
    except IndexError: #no offset specified after -z
        print("Please input integer offset from UTC after -z")
        sys.exit(-1)

def stampPath(path): #main function, not run outside function due to possible need for recursion.
    length = len(os.listdir(path)) #This isn't strictly neccessary but it helps get info to the user

    for index, f in enumerate(os.listdir(path)):
        print('stamping [%d/%d]'%(index + 1, length))

        if os.path.isfile(path + '/' + f): #this is a file
            #get modfied time
            time = os.path.getmtime(path + '/' + f)
            if creation: #get creation time if -c was specified
                time = os.path.getctime(path + '/' + f)
            #convert the time to a human readable string
            #the current format used is <Month abbrevation> <Day (not 0-padded)> <year> <hour (not 0 padded)>:<minute>:<seconds (not 0 padded)>
            time = datetime.fromtimestamp(time, tz).strftime('%b %-d %Y %-H:%M:%-S')
            #seperate the filename from the extension if there is one
            #this is required to keep the file extensions the way they were before instead of appending to them.
            filename = f
            ext = ''

            if '.' in f:
                filename = "".join(f.split('.')[:-1])
                ext = f.split('.')[-1]

            finalName = '%s/%s (%s).%s'%(path, filename, str(time), ext)
            os.rename(path + '/' + f, finalName)
        elif recursive: #this is a directory and we are in recursive mode
            print("Directory found, stamping directory " + f)
            stampPath(os.path.join(path + '/' + f))
            print("Return from " + f)
        else: #this is a directory and we are not in recursive mode
            print("Directory found, skipping.")

#This program is not meant to be used as a module and as such the arguments are inaccessable to other programs importing this. I may make it usable as a module in the future.
#for now __name__ = "__main__" is just best practice to not run file modifying and or thread blocking code when imported.
if __name__ == "__main__":
    stampPath(path)
    sys.exit(0)