|  Developer
Updated on December 2, 2022

isDate

  • Triggering periodically when the particular time, day or month has come. The Gregorian Calendar is used.

    • Daily event arises each day at a time that is within the array.
    • Weekly event arises each weekday that is set within the array in time that is set within the array. If the array is empty, the event will be during the whole weekday/day (available since ), otherwise it will arise at the specified points of time.
    • Monthly event arises each day that is set within the array in time that is set within the array.
    • Weeks and YearWeeks events arise each time when a week with a specified number begins in a month or year accordingly. Available since , updated in (see below).
Edit
Field Type Required Description
blockOptions.method.args.type string + Argument declaration of schedule type. The value should be in block with name . The possible values are , , , and . type requires presence of time array only. type requires presence of both time array and weekday array. type requires presence of both time array and day array. and types require presence of weeks array only.
blockOptions.method.args.time string + Argument declaration of time array. The value should be in block with name . The time array contains strings. The time format is “hh:mm” in 24-hour clock format. Type . See Item Value Type.
blockOptions.method.args.weekdays string – Argument declaration of weekday array. The value should be in block with name . The weekday array contains integer numbers. The possible values are 1..7 range. Type . See Item Value Type.
blockOptions.method.args.days string – Argument declaration of day array. The value should be in block with name . The day array contains integer numbers. The possible values are 1..31 range. If day is set to 31 then event works in each month where 31st day is present. Type . See Item Value Type.
blockOptions.method.args.weeks string – Argument declaration of weeks array. The value should be in block with name . The weeks array contains integer numbers. The possible values are in range [1..6, -1] for weeks of a month (for ), and [1..54, -1] for weeks of a year (for ). Week -1 means the last week of a period. Type . See Item Value Type.

In , the behavior for types and was changed. These types no longer use the array. The state of the condition is throughout the specified weeks. Other types remain unchanged – they arise only when the particular time point is reached and then immediately switch to .

Also, since this version, actions in blocks will be executed for events of the and types.

In , possible configurations for types and were extended. In previous versions, the array had to be non-empty. Now, if the array is empty, the event is durable and its state will be during the whole weekday/day. Configuration with specific time points is still available and its behavior wasn’t changed. Also, since this version, actions in blocks will be executed for durable events of the and types.

Edit
Edit 
				
					"when" : [{
    "blockOptions":{
        "method":{
            "args":{
                "type":"type",
                "time":"time"
            },
            "name":"isDate"
        }
    },
    "blockType":"when",
    "fields":[
        {
            "name": "type",
            "type": "string",
            "value": "daily"
        },
        {
            "name": "time",
            "type": "24_hours_time_array",
            "value": [ "10:20", "12:40", "13:32" ]
        }
    ]
}]
Edit 
				
					"when" : [{
    "blockOptions":{
        "method":{
            "args":{
                "type":"type",
                "time":"time",
                "weekdays":"weekdays"
            },
            "name":"isDate"
        }
    },
    "blockType":"when",
    "fields":[
        {
            "name": "type",
            "type": "string",
            "value": "weekly"
        },
        {
            "name": "time",
            "type": "24_hours_time_array",
            "value": [ "10:20", "12:40", "13:32" ]
        },
        {
            "name": "weekdays",
            "type": "int_array",
            "value": [ 1, 2, 7 ]
        }
    ]
}]
Edit 
				
					"when" : [{
    "blockOptions":{
        "method":{
            "args":{
                "type": "type",
                "time":"time",
                "days":"days"
            },
            "name":"isDate"
        }
    },
    "blockType":"when",
    "fields":[
        {
            "name": "type",
            "type": "string",
            "value": "monthly"
        },
        {
            "name": "time",
            "type": "24_hours_time_array",
            "value": [ "10:20", "12:40", "13:32" ]
        },
        {
            "name": "days",
            "type": "int_array",
            "value": [ 1, 5, 12 ]
        }
    ]
}]
Edit 
				
					{
    "blockOptions": {
        "method": {
        "args": {
            "type": "type",
            "weeks": "weeks"
        },
        "name": "isDate"
        }
    },
    "blockType": "when",
    "fields": [
        {
            "name": "type",
            "type": "string",
            "value": "weeks"
        },
        {
            "name": "weeks",
            "type": "int_array",
            "value": [1, 3, -1]
        }
    ]
}
Edit 
				
					{
    "blockOptions": {
        "method": {
            "args": {
                "type": "type",
                "weeks": "weeks"
            },
            "name": "isDate"
        }
    },
    "blockType": "when",
    "fields": [
        {
            "name": "type",
            "type": "string",
            "value": "yearWeeks"
        },
        {
            "name": "weeks",
            "type": "int_array",
            "value": [35, 36, -1]
        }
    ]
}