Date Helpers
A set of utility actions to help with common and useful date and time operations.
A set of utility actions to help with common and useful date and time operations.
Category: Workflow. Adds 3 actions to a care flow.
Actions
Date Helpers adds these 3 actions to a care flow. Add one to a step, then fill in its inputs.
Check Working Hours
Check if the current time is within working hours and calculate minutes to next working hours as well as the datetime of the next working hours if not
This action can be previewed in Studio before you publish.
| Input | Type | Required | Description |
|---|---|---|---|
| Working hours start | string | Yes | The start time of working hours in HH:MM format (e.g., "09:00"). Uses 24-hour format. |
| Working hours end | string | Yes | The end time of working hours in HH:MM format (e.g., "17:00"). Uses 24-hour format. |
| Timezone | string | No | The IANA timezone identifier to use for the working hours check (e.g., "America/New_York", "Europe/London", "Asia/Tokyo", "UTC"). If not specified, UTC will be used. |
Returns:
| Data point | Type |
|---|---|
isWithinWorkingHours | boolean |
minutesToNextWorkingHours | number |
nextWorkingHoursDatetime | date |
Get next date occurrence
Get the next occurrence of a given date.
This action can be previewed in Studio before you publish.
| Input | Type | Required | Description |
|---|---|---|---|
| Reference date | date | No | The date for which to calculate the next occurrence. If the year in the provided date is in the past, the next occurrence is computed in the upcoming year. If omitted, today’s date is used. |
Returns:
| Data point | Type |
|---|---|
nextDateOccurrence | date |
Get Next Workday
Get the next US Federal workday (Defaults to America/Chicago time zone)
This action can be previewed in Studio before you publish.
| Input | Type | Required | Description |
|---|---|---|---|
| Reference date | date | No | Set the reference date to calculate the next workday from. If not specified, the current date (today) will be used. |
| Include reference date | boolean | No | If this option is enabled and the reference date is a work day, that date will be returned. If it is disabled, the next work day after the reference date will be returned. |
| Timezone | string | No | The IANA timezone identifier to use for the next workday calculation (e.g., "America/New_York", "Europe/London", "America/Chicago", "UTC"). If not specified, America/Chicago will be used. |
Returns:
| Data point | Type |
|---|---|
nextWorkday | date |
referenceDateIsWeekday | boolean |
Returns the next workday (Monday to Friday) based on a reference date.
If the reference date is a weekday and "Include reference date" is enabled, the reference date is returned. If it's a weekend or "Include reference date" is disabled, the next weekday is returned instead.
Examples:
- Reference date: Thursday, April 17
- Include reference date enabled → returns Thursday, April 17
- Include reference date disabled → returns Friday, April 18
- Reference date: Sunday, April 20
- Include reference date enabled → returns Monday, April 21
- Include reference date disabled → returns Monday, April 21
✅ Include reference date enabled or disabled → returns Monday, April 21
This action does not account for holidays.
Setup and notes
A set of utility actions to help with common and useful date and time operations.
Where this page comes from
The settings, actions, inputs, outputs and webhooks above are generated from the
extension's own code, at @awell-health/awell-extensions v2.1.159. They match what the
platform actually does rather than a description of it.
Field-level detail also appears in Awell Studio when you configure the action. Something wrong or missing? Email support@awellhealth.com.