Dates
{{date}} is today, in the format you chose in Settings. {{date:MMMM yyyy}} is today in a format
of its own, for that one use. This page covers both, the letters a format is made of, and the two
places a date comes from something other than the clock.
Today, in your format
{{date}} produces today's date and {{year}} the four-digit year. Both are built in, so a template
never asks for them: the deploy prompt shows them already filled.
The format is a setting, Date format under General in Settings. Pick one of the five examples or type a format of your own, and the line underneath shows what today would look like. Changing it changes what the next deploy writes, and nothing already on disk.
| Setting | {{date}} produces |
|---|---|
yyyy-MM-dd (default) | 2026-01-15 |
dd/MM/yyyy | 15/01/2026 |
MM/dd/yyyy | 01/15/2026 |
MMMM d, yyyy | January 15, 2026 |
d MMM yyyy | 15 Jan 2026 |
A format for one use
Name the format after a colon: {{date:MMMM yyyy}} gives January 2026 whatever the setting says.
It works wherever a placeholder does - folder and file names, file contents, Word and Excel
documents, a command - and inside a watched folder's rename and subfolder patterns.
A template can carry several. A folder named {{date:yyyy}} with a folder named {{date:MMMM}}
inside it files by year and month, while a README.md in the same template opens with
{{date:EEEE d MMMM yyyy}} and is dated Thursday 15 January 2026.
Time is the same letters: {{date:yyyy-MM-dd HH-mm}} stamps a folder to the minute, and
{{date:HH:mm}} in a file's contents writes 14:31.
The format is required. {{date:}} is not a date and is left as written.
Days before and after
Put an offset between date and the colon to count from today: {{date+1y:yyyy}} is next year,
{{date+3m:MMMM}} the month three on, {{date-1d:yyyy-MM-dd}} yesterday. A fiscal year that runs
calendar years is {{date:yyyy}} - {{date+1y:yyyy}}, written 2026 - 2027.
| Unit | Meaning |
|---|---|
y | Years |
q | Quarters - three months |
m | Months |
w | Weeks |
d | Days |
The units are lowercase, so the month m is never mistaken for the M in a format. Each takes a
whole number, and they chain, applied left to right: {{date+1y-1d:d MMMM yyyy}} is the day before
this date next year - the last day of a twelve-month period. With no format after it,
{{date+2w}} is a fortnight from today in your format from Settings.
A month or year that has no such day ends on its last one: 31 January +1m is the last day of February, and 29
February +1y is 28 February. That is why the order of a chain matters at the end of a month -
+1m+1d from 31 January is 1 March.
A fiscal year that starts in April is two offsets: {{date-3m:yyyy}}-{{date+9m:yy}} is 2026-27
from April 2026 to March 2027. Counting back three months finds the year the period started in, and
on nine finds the one it ends in.
With a Date column, {{date+1y:yyyy}} counts from that row's date, the same as {{date:yyyy}}
does. In a watched folder's rename and subfolder patterns it counts from the moment the file arrives.
Nothing else goes inside the braces. {{date + 1y}} with spaces, {{date+1.5y}} or {{date+1M}}
is not a date and is left as written, where you will see it.
The letters
The format is a standard date pattern. The letters used most often:
| Letters | Meaning | Example |
|---|---|---|
yyyy | Four-digit year | 2026 |
yy | Two-digit year | 26 |
MM | Two-digit month | 01 |
MMM | Short month name | Jan |
MMMM | Full month name | January |
d | Day of the month | 5 |
dd | Two-digit day | 05 |
EEE | Short weekday name | Thu |
EEEE | Full weekday name | Thursday |
HH | Hour, 24-hour clock | 14 |
h | Hour, 12-hour clock | 2 |
a | AM or PM | PM |
mm | Minute | 31 |
ss | Second | 05 |
QQQ | Quarter | Q1 |
The letters are case sensitive: MM is the month and mm the minute, which is the mistake behind
most "wrong" dates. Anything that is not a letter - a hyphen, a space, a comma, a full stop - is
written as it is. Month and weekday names come out in your MacPC's language.
In a folder or file name
In a folder or file name a : becomes -, as does /: a slash would nest, and a colon is not a
character a file name can safely carry. So {{date:HH:mm}} names a file 14-31 and dates a line
inside it 14:31.
The move to subfolder rule in a watched folder is the exception, because there a slash is meant.
{{date:yyyy}}/{{date:MM}} files things two deep. See
Rule reference.
Always the moment it is used
A formatted date is worked out each time it is used, never stored. At deploy that makes no
difference: {{date}} and {{date:yyyy-MM-dd}} say the same thing.
In a watched folder they part company. The folder's bare {{date}} is frozen with the rest of its
values on the day it was deployed, as the rules are.
{{date:yyyy-MM}} in a rename rule is the month the file arrived. A rule that files by month wants
the formatted one.
The same holds in reverse. A deploy that supplies its own values - a deploy link, a script, an
agent - can give {{date}} whatever it likes, and that value is written as given. The formatted form
takes no value and is always now.
The one exception is a spreadsheet. A row with a Date column is
that day all the way through - {{date}}, {{year}} and every formatted date - because that is
what a date in a spreadsheet means.
A date you are asked for
A placeholder whose type is Date is one the deploy prompt asks for, like any other.
In the prompt it is a date field rather than text. Tab to it, then the up and down arrows change whichever of the day, month or year is highlighted, and left and right move between them.Click it, or press Enter with it focused, and pick the day from a calendar. Beside it, Prefab shows the date exactly as it will be written.
It is written in the placeholder's own format, set under Format when you edit the placeholder -
type one, or pick from Examples. Leave it empty and it follows your Settings format. The letters
are the same as everywhere else, so a Shoot Date placeholder can write 260314 while
{{date}} stays 2026-03-14.
Its default can be Today, which is worked out on the day the template is used, not the day the default was chosen. See Defining a placeholder.
Dates of files in a watched folder
Two more placeholders are dates, and neither is today. In a rename rule, {{captured}} is when a
photo was taken, from its EXIF data, and {{file_date}} is when the file was created. Both take a
format the same way: {{captured:yyyy-MM}}. See Rule reference.