Rate this page:

Time of Day Routing for TaskRouter

TaskRouter supports time of day expressions that can be used in the Workflow in both Filter and Target Worker Expressions. When evaluating the expressions TaskRouter will fill in the attributes with appropriate values and continues to evaluate the entire expression.

The supported time of day expressions are as follows:


This attribute contains current time as an integer in HHMM format with the time represented in 24hr clock in UTC.

Use the following expression to check if the current time is between 8 AM UTC to 6:30 PM UTC,

taskrouter.currentTime > 0800 AND taskrouter.currentTime < 1830


This attribute contains current hour as string in HH formt with hour represented in 24hr clock in UTC.

Use the following expression to check if the current hour is between 8 AM UTC to 6 PM UTC,

taskrouter.currentHour > 8 AND taskrouter.currentHour < 18


This attribute contains current minute with time represented in UTC format.

taskrouter.currentMin > 10 AND taskrouter.currentMin < 50


This attribute contains the day of the week as string in time represented in UTC format.

Day of the Week taskrouter.dayOfWeek
Monday Mon
Tuesday Tue
Wednesday Wed
Thursday Thu
Friday Fri
Saturday Sat
Sunday Sun


In this example we are checking for different open and closing hours based on day of the week and if place tasks into appropriate queues

    "task_routing": {
        "filters": [
                "targets": [
                        "queue": "WQ57cab415732dec475f600c75eab44cc9"
                "filter_friendly_name": "MyFilterName",
                "expression": "(taskrouter.dayOfWeek IN ['Mon', 'Tue', 'THU'] 
                                AND taskrouter.currentTime > 800 
                                AND taskrouter.currentTime < 1730) 
                                (taskrouter.dayOfWeek IN ['Wed', 'Fri'] 
                                AND taskrouter.currentTime > 900 
                                AND taskrouter.currentTime < 1830) 
                                (taskrouter.dayOfWeek = 'Sat' 
                                AND taskrouter.currentTime > 1100 
                                AND taskrouter.currentTime < 1530)"
        "default_filter": {
            "queue": "WQ78e472fe73068cf03c533099dbaa453b"
Rate this page:

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.

Loading Code Sample...

        Thank you for your feedback!

        Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

        Sending your feedback...
        🎉 Thank you for your feedback!
        Something went wrong. Please try again.

        Thanks for your feedback!