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 [2020/05/28 17:16] JMichaelTX [Using Variables with These Date/Time Tokens] Clarify use of Parameters |
token:ICUDateTime [2021/10/19 22:39] peternlewis |
||
---|---|---|---|
Line 3: | Line 3: | ||
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|Dates and Times]] article. | 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|Dates and Times]] article. | ||
- | ===== Fields & Format Used by These Tokens ===== | + | ===== Required Parameters for ICUDateTime Tokens ===== |
+ | The parameters are specified between `%` signs after the main ICDDateTime token. | ||
- | * //%ICUDateTime%**format**%// - the current date and time. | + | * %**ICUDateTime**%<color #22b14c>[output date format]</color>% |
- | * //%ICUDateTimeFor%NOW()+20%**format**%// - the specified [[:unixtime]] date. | + | * Returns the current date and time in the specified format. |
- | * //%ICUDateTimePlus%3+6%Hours%**format**%// - the current time plus a specified number of the specified time units. | + | * %**ICUDateTimeFor**%<color blue><Seconds in [[:unixtime|Unix Time]]></color>%<color #22b14c>[output date format]</color>% |
- | * //%ICUDateTimeMinus%3+6%Hours%**format**%// - the current time minus a specified number of the specified time units. | + | * Returns Date/Time specified by the [[:unixtime|Unix Time]], in the user's local time zone. |
+ | * %**ICUDateTimePlus**%<color blue><amount of time></color>%<color #22b14c>[unit of time]</color>%<color #22b14c>[output date format]</color>% | ||
+ | * Returns Date/Time calculated by the Current Date/Time PLUS the <color blue><amount of time></color> | ||
+ | * %**ICUDateTimeMinus**%<color blue><amount of time></color>%<color #22b14c>[unit of time]</color>%<color #22b14c>[output date format]</color>% | ||
+ | * Returns Date/Time calculated by the Current Date/Time MINUS the <color blue><amount of time></color> | ||
- | ===== Time Units ===== | + | |
+ | where \\ | ||
+ | * angle brackets <color blue>< ></color> denote a numeric parameter, may use a Variable and/or formula | ||
+ | * square brackets <color #22b14c>[ ]</color> denote a text-only parameter, cannot use a Variable | ||
+ | *The _text-only_ parameters must be plain text, and be a valid choice for that parameter. | ||
+ | * <color #22b14c>[output date format]</color> must conform to the [ICU Date/Time codes](https://www.keyboardmaestro.com/action/linkthru?icudatetimereference). | ||
+ | * <color blue><Seconds in [[:unixtime|Unix Time]]></color> is the total number of seconds since the start of 1970, GMT. | ||
+ | * <color blue><amount of time></color> is an integer in the units of what you specific in the <color #22b14c>[unit of time]</color> parameter. | ||
+ | * <color #22b14c>[unit of time]</color> must be a time unit from the below list. | ||
+ | |||
+ | |||
+ | ===== Unit of Time ===== | ||
The available time units for //%ICUDateTimePlus%// and //%ICUDateTimeMinus%// are: | The available time units for //%ICUDateTimePlus%// and //%ICUDateTimeMinus%// are: |