Keyboard Maestro Wiki

**This is an old revision of the document!**

The %ICUDateTime%, %ICUDateTimePlus%, %ICUDateTimeMinus% and %ICUDateTimeFor% tokens return the a date formatted in a specific format.

The variants format:

• %ICUDateTime%format% - the current date and time.
• %ICUDateTimeFor%NOW()+20%format% - the specified unixtime date.
• %ICUDateTimePlus%36%Hours%format% - the current time plus a specified number of the specified time units. * %ICUDateTimeMinus%36%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

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.

See Also

Actions

Functions

Tokens

Topics

Forum