Argument Formatting

Some types of arguments are common amongst the different directives. This section discusses the appropriate formatting options available to them.

Delay Formats

Various directives allow for a delay= argument to be applied. This argument specifies a delay period between the event trigger time and when an item is released. In essence, the format is [number][unit specifier], where number is a numeric value and the unit specifier is m , h , d or w for minute, hour, day or week respectively.

Example Description
20m 20 Minutes
2.5h 2.5 Hours
1d 1 Day
2.25w 2.25 Weeks

Source \ Destination Formats

Some directives can take a subset of tasks as an argument. As tasks can be either source tasks or destination tasks, the s: or d: prefix can be used to explicitly specify what type of tasks where applicable. Without this prefix, it will default assuming the argument relates to source tasks.

Source \ Destination Format Examples

Example Description
s:A/1/1 Source Tasks
d:A/1/1 Destination Tasks
A/1/1 Source Tasks; because no prefix is specified, source tasks are assumed

Dates

Various directives allow for a on= , start= , end= argument to be applied. This argument specifies a date at which a particular event should occur.

Internally, the script calls the C# method System.DateTime.Parse, so theoretically any string accepted by that method should be valid.

The behaviour of this parse method also depends on the region/locale settings of the host Operating System. Different locales can produce different results for the same literal string. For instance, the string 1/12/2023 will represent the date 1st December 2023 in an Australian locale. In a US locale, this will represent the date 12 January 2023.

Date Examples

Example Description
1/1/2023 1/1/2023 12:00 AM (Midnight)
5/7/2023 2:37 PM 5/7/2023 2:37 PM
5/7/2023 2:37 AM 5/7/2023 2:37 AM
5/7/2023 2:37 5/7/2023 2:37 AM
5/7/2023 14:37 5/7/2023 2:37 PM