The %ICUDateTime%, %ICUDateTimePlus%, %ICUDateTimeMinus% and %ICUDateTimeFor% tokens return the a date formatted in a specific format. More details are provided in the Dates and Times article.

• %ICUDateTime%format% - the current date and time.
• %ICUDateTimeFor%NOW()+20%format% - the specified unixtime date.
• %ICUDateTimePlus%3+6%Hours%format% - the current time plus a specified number of the specified time units.
• %ICUDateTimeMinus%3+6%Hours%format% - the current time minus a specified number of the specified time units.

The available time units for %ICUDateTimePlus% and %ICUDateTimeMinus% are:

• Seconds
• Minutes
• Hours
• Days
• Weeks
• Months
• Years
• Sundays
• Mondays
• Tuesdays
• Wednesdays
• Thursdays
• Fridays
• Saturdays

• If the Time Unit is a day of the week (Sundays thru Saturdays)
  • If you use a Plus 0 (%ICUDateTimePlus%0%),
    it will return the next appropriate day for that day of week, possibly returning today if it is the same day of week as entered;
    • So if Today is Tuesday, and you use %ICUDateTimePlus%0%Tuesdays%, then it will return Today's date.
    • Whereas, if you use %ICUDateTimePlus%0%Wednesdays%, it will return tomorrow's date.
  • If you use Plus 1 (%ICUDateTimePlus%1%),
    it will return the next appropriate day, strictly after Today.

For example, if today is Tuesday, September 5, 2017, you would get these results:

Note how Plus 0 and Plus 1 are the same unless today is the same as the weekday. Also note that Plus 0 and Minus 0 is not the same (except when today is the same as the weekday).

The format is a specified with an ICU Date Time Format Specifier which allows you to produce the date in almost any format you desire.

Keep in mind that TIME is in GMT and the output of ICUDateTimeFor is in local time, so when doing this sort of thing it is best to use midday instead of midnight:

%ICUDateTimeFor% TIME(2015, 8, 23,12,0,0) %EEE, MMM d, yyyy%

which will generally work anywhere since at midday GMT, the entire world (almost) is on the same date. Otherwise, folks with negative GMT offsets (which includes all of the Americas for example) will get the wrong result.

Prior to Mojave, and after Keyboard Maestro 9.0, dates should be in your chosen language. Unfortunately Apple changed Mojave and later to make the system return dates only in the Keyboard Maestro localized language (ie, English), regardless of your chosen locale. Keyboard Maestro 9.0 works around this by claiming to be in all locales, even though it is really only localized for English itself.

To use a Variable instead of a number in a token, like the ICUDateTimePlus token, just enter the Variable name without any additional %, as in:

%ICUDateTimePlus%3%Days%yyyyMMdd%
%ICUDateTimePlus%YourVariableName%Days%yyyyMMdd%

For an example, see Generate File Named Based on Day of Week [Example]

• Set Variable to Text
• See all Actions

• DAY()
• DOW()
• GMTOFFSET()
• JD2TIME()
• MJD2TIME()
• NOW() (unixtime)
• TIME() (unixtime)
• TIME2JD()
• TIME2MJD()
• See all Functions

• %ICUDateTimeFor%
• %ICUDateTimeMinus%
• %ICUDateTimePlus%
• %LongDate% (local time)
• %LongTime% (local time)
• %NumberDate% (local time)
• %ShortDate% (local time)
• %ShortTime% (local time)
• See all Tokens

• Dates and Times
• JulianDate
• unixtime in GMT

• Adding minutes to current time
• If...then...condition to run only during date range
• Keyboard Maestro Forum topics about %ICUDateTime% token