User Tools
token:ICUDateTime
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
|
token:ICUDateTime [2016/12/28 04:20] peternlewis |
token:ICUDateTime [2019/07/01 02:57] peternlewis |
||
|---|---|---|---|
| Line 10: | Line 10: | ||
| * //%ICUDateTimePlus%3+6%Hours%**format**%// - the current time plus a specified number of the specified time units. | * //%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. | * //%ICUDateTimeMinus%3+6%Hours%**format**%// - the current time minus a specified number of the specified time units. | ||
| - | |||
| ===== Time Units ===== | ===== Time Units ===== | ||
| Line 23: | Line 22: | ||
| * Months | * Months | ||
| * Years | * Years | ||
| + | * Sundays | ||
| + | * Mondays | ||
| + | * Tuesdays | ||
| + | * Wednesdays | ||
| + | * Thursdays | ||
| + | * Fridays | ||
| + | * Saturdays | ||
| + | |||
| + | ==== Using Plus 0 or 1 With Day of Week (v8+) ==== | ||
| + | |||
| + | * 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. | ||
| + | |||
| + | === Examples === | ||
| + | |||
| + | |||
| + | For example, if today is Tuesday, September 5, 2017, you would get these results: | ||
| + | |||
| + | ^Token^Result^ | ||
| + | | %ICUDateTimePlus%0%Tuesdays%EEE, MMM d, yyyy% \\ %ICUDateTimePlus%1%Tuesdays%EEE, MMM d, yyyy% \\ %ICUDateTimePlus%2%Tuesdays%EEE, MMM d, yyyy% \\ %ICUDateTimePlus%0%Wednesdays%EEE, MMM d, yyyy% \\ %ICUDateTimePlus%1%Wednesdays%EEE, MMM d, yyyy% \\ %ICUDateTimePlus%2%Wednesdays%EEE, MMM d, yyyy% \\ %ICUDateTimePlus%0%Mondays%EEE, MMM d, yyyy% \\ %ICUDateTimePlus%1%Mondays%EEE, MMM d, yyyy% \\ %ICUDateTimePlus%2%Mondays%EEE, MMM d, yyyy% \\ %ICUDateTimeMinus%0%Tuesdays%EEE, MMM d, yyyy% \\ %ICUDateTimeMinus%1%Tuesdays%EEE, MMM d, yyyy% \\ %ICUDateTimeMinus%2%Tuesdays%EEE, MMM d, yyyy% \\ %ICUDateTimeMinus%0%Wednesdays%EEE, MMM d, yyyy% \\ %ICUDateTimeMinus%1%Wednesdays%EEE, MMM d, yyyy% \\ %ICUDateTimeMinus%2%Wednesdays%EEE, MMM d, yyyy% \\ %ICUDateTimeMinus%0%Mondays%EEE, MMM d, yyyy% \\ %ICUDateTimeMinus%1%Mondays%EEE, MMM d, yyyy% \\ %ICUDateTimeMinus%2%Mondays%EEE, MMM d, yyyy% | Tue, Sep 5, 2017 \\ Tue, Sep 12, 2017 \\ Tue, Sep 19, 2017 \\ Wed, Sep 6, 2017 \\ Wed, Sep 6, 2017 \\ Wed, Sep 13, 2017 \\ Mon, Sep 11, 2017 \\ Mon, Sep 11, 2017 \\ Mon, Sep 18, 2017 \\ Tue, Sep 5, 2017 \\ Tue, Aug 29, 2017 \\ Tue, Aug 22, 2017 \\ Wed, Aug 30, 2017 \\ Wed, Aug 30, 2017 \\ Wed, Aug 23, 2017 \\ Mon, Sep 4, 2017 \\ Mon, Sep 4, 2017 \\ Mon, Aug 28, 2017 | | ||
| + | |||
| + | 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). | ||
| ===== Format Specification ===== | ===== Format Specification ===== | ||
| Line 47: | Line 73: | ||
| For an example, see [Generate File Named Based on Day of Week [Example]](https://forum.keyboardmaestro.com/t/dates-generate-file-named-based-on-day-of-week-example/4562) | For an example, see [Generate File Named Based on Day of Week [Example]](https://forum.keyboardmaestro.com/t/dates-generate-file-named-based-on-day-of-week-example/4562) | ||
| - | ===== See Also ===== | + | ===== Localization ===== |
| - | ---- | + | 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. |
| + | |||
| + | ===== See Also ===== | ||
| - | === Actions === | + | ==== Actions ==== |
| * [[action:Set Variable to Text|Set Variable to Text]] | * [[action:Set Variable to Text|Set Variable to Text]] | ||
| * [[:Actions|See all Actions]] | * [[:Actions|See all Actions]] | ||
| - | === Functions === | + | ==== Functions ==== |
| * [[function:DAY|DAY()]] | * [[function:DAY|DAY()]] | ||
| Line 69: | Line 97: | ||
| * [[:Functions|See all Functions]] | * [[:Functions|See all Functions]] | ||
| - | === Tokens === | + | ==== Tokens ==== |
| * [[token:ICUDateTimeFor|%ICUDateTimeFor%]] | * [[token:ICUDateTimeFor|%ICUDateTimeFor%]] | ||
| Line 81: | Line 109: | ||
| * [[:Tokens|See all Tokens]] | * [[:Tokens|See all Tokens]] | ||
| - | === Topics === | + | ==== Topics ==== |
| * [[:Dates and Times|Dates and Times]] | * [[:Dates and Times|Dates and Times]] | ||
| Line 87: | Line 115: | ||
| * [[:unixtime]] in GMT | * [[:unixtime]] in GMT | ||
| - | ---- | + | ===== Forum ===== |
| - | + | ||
| - | ==== Forum ==== | + | |
| - [[https://forum.keyboardmaestro.com/t/adding-minutes-to-current-time/3002/2|Adding minutes to current time]] | - [[https://forum.keyboardmaestro.com/t/adding-minutes-to-current-time/3002/2|Adding minutes to current time]] | ||
| - [[https://forum.keyboardmaestro.com/t/if-then-condition-to-run-only-during-date-range/4485/3|If...then...condition to run only during date range]] | - [[https://forum.keyboardmaestro.com/t/if-then-condition-to-run-only-during-date-range/4485/3|If...then...condition to run only during date range]] | ||
| - | - [[https://www.google.fr/search?q=site:forum.keyboardmaestro.com+ICUDateTime+token|Keyboard Maestro Forum topics about %ICUDateTime% token]] | + | - [[https://forum.keyboardmaestro.com/search?q=ICUDateTime|Keyboard Maestro Forum topics about %ICUDateTime% token]] |
token/ICUDateTime.txt · Last modified: 2023/01/03 00:19 by ccstone
Page Tools
