-
Notifications
You must be signed in to change notification settings - Fork 1
Built‐In Substitutions
These substitutions are built into the program. To use them, wrap the substitution target in double brackets in one of the supported fields, then run the script through the right-click (context) or Tools menu. For example, typing [[tTime]] in the description of a file will replace it with the time the file was created (ex. 14:22). Likewise, [[mFileName]] will be replaced with the name of the file it is typed in (such as IMG_1234.jpg).
In addition to these substitutions, Text Substitutions also provides a variety of Functional Substitutions that calculate values and perform complex behavior.
- Built-in substitutions cannot be overwritten by user-created substitutions.
- Built-in substitutions are all case-insensitive.
Substitutions for accessing the time and date the file was created. Can either grab the date from the EXIF or IPTC date created setting, based on the "Get Creation Date From" preference.
The file's creation date in YYYY-MM-DD format.
The file's creation date in the format Monthname, day, year. Ex. November 1st, 1999.
The file's creation date in the format Monthabbr, day, year. Ex. Nov. 1st, 1999.
The numerical day of the month the file was created.
The day of the week the file was created.
Due to ExtendScript limitations, this will print what day it was at the time the file was created in the timezone your computer is set to.
The numerical month the file was created.
The name of the month the file was created. Ex. November.
The abbreviation for the name of the month the file was created. Ex. Nov.
The year the file was created.
The last 2 digits of the year the file was created.
The 12-hour time the file was created. Ex. 4:37 pm.
The day half the file was created (am or pm).
The 24-hour time the file was created.
The name for the time of day the file was created.
- 0:00-5:59 = night
- 6:00-9:59 = morning
- 10-13:59 = day
- 14:00-16:59 = afternoon
- 17:00-19:59 = evening
- 20:00-23:59 = night
The hour the file was created.
The 12-hour time the file was created.
The minute the file was created. Includes a leading 0 for single-digit numbers.
The second the file was created. Includes a leading 0 for single-digit numbers.
The date and 24-hour time the file was created. Ex. 2024-11-23 14:21.
The date, time, and timezone the file was created in ISO 8601 format, taken from EXIF. Ex. 2024-10-05T11:06:49.12-07:00
The date, time, and timezone the file was created in ISO 8601 format, taken from IPTC. Ex. 2024-10-05T11:06:49.12-07:00
Substitutions for accessing other properties of the file.
The system name for the file this value is a property of. Includes the file extension. Ex. IMG_1234.jpg.
The file's extension, without a leading period. Ex. jpg.
The system name for the file this value is a property of. Does not include the file extension. Ex. IMG_1234.
The name of the folder the file is in.
The value in the IPTC Title property.
The value in the IPTC Headline property.
The value in the Dublin Core Description property.
The value in the IPTC Credit Line property.
The value in the IPTC Sublocation property.
The values in the Country, State/Province, and City IPTC properties. Ex. United States, California, San Francisco.
The value in the IPTC City property.
The value in the IPTC State/Province property.
The value in the IPTC Country property.
The numerical star rating (0-5) of the file.
Stars representing the rating of the file. Ex. *** for 3 stars.
The name of the label applied to the file.
The value in the Source property.
The value in the Description Writer property.
The value in the Copyright Notice property.
The value in the Rights Usage Terms property.
The value in the Job Identifier property.
The value in the Creator property.
The value in the Creator: Job Title property.
The value in the Creator: Address property.
The value in the Creator: City property.
The value in the Creator: State/Province property.
The value in the Creator: Country property.
The value in the Creator: Postal Code property.
The value in the Creator: Phone property.
The value in the Creator: Email property.
The value in the Creator: Website property.
Information about the image and the equipment used to take it.
The image's width.
The image's height.
The model name of the camera used to take the photo.
The serial number of the camera used to take the photo.
The model name of the lens used to take the photo.
The shutter speed the photo was taken at. Ex. 1/30
The aperture the photo was taken at. Ex. 2.8
The ISO the photo was taken at. Ex. 100
The focal length of the lens when the photo was taken. Ex. 50.0 mm
The 35mm-equivalent focal length of the lens. Format varies (or may not exist) based on the camera.
The exposure compensation used when taking the photo. Ex. -2.00
If an empty string (string of 0 length) is processed, an empty string will be returned. Ex. [[]] will return .