Rob van der Woude's Scripting Pages

Help text for CaptureDate.cs

(view help text of CaptureDate.cs as plain text)

CaptureDate,  Version 1.05
Return the capture date and time for the specified image file

Usage:   CAPTUREDATE  image  [ options ]

Where:   image        specifies the image file(s) (wildcards allowed)

Options: /D:seconds   minimum Difference in seconds between current file
                      timestamp and capture date/time; if the difference
                      exceeds the specified number of seconds, the file
                      timestamp will be set to the capture date/time
                      (default: 3600 seconds = 1 hour; requires /S switch)
         /F           set capture date/time to current File timestamp
                      (requires /S and /X switches)
         /R           Recursive (include subdirectories); you probably want
                      to use wildcards for image with this option
         /S           Set the image file's timestamp to the capture date/time
         /T           return the timestamp without "-" and ":" delimiters,
                      e.g. 20221004T222328 instead of 2022-10-04 22:23:28.
         /X           use eXiftool by Phil Harvey (;
                      requires exiftool.exe in the current directory or in
                      a directory listed in the PATH)
         /Y           do not ask for confirmation before changing the image
                      file's timestamp (requires /S switch)

Notes:   Result will be displayed on screen, e.g. 2022-10-04 22:23:28.
         The date/time is extracted by searching for the earliest date/time
         in the first 1048576 bytes (1 MB) of the image file. If no
         capture date/time is found that way, and the /X switch is used,
         exiftool.exe is used to try and read the capture date/time from the
         image's EXIF data. If this also fails, you can use the /F switch to
         set a new capture date/time in EXIF equal to the file date/time.
         With /S switch used, the timestamp is changed only if the difference
         between the current timestamp and the capture time exceeds 1 hour or
         the threshold set with the /D switch.
         The program will ask for confirmation before changing the file's
         timestamp, unless the /Y switch is used.
         Return code ("errorlevel") is -1 in case of errors, or with /S it
         equals the number of files renamed, or 0 otherwise.

Written by Rob van der Woude

page last uploaded: 2022-10-05