Dates & Times
API actions for the Dates & Times integration.
Dates & Times
Get, format, and compare dates and times.
Add or subtract time
Shift a date by an amount and unit, like +3 days or -2 hours. Use a negative amount to go back in time. Handy for due dates, reminders, and expiry dates.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
date | string | Yes | The starting date, in ISO format, like 2026-06-30 or 2026-06-30 09:30. |
amount | number | Yes | How much to shift the date by. Use a negative number to subtract, like -2 to go back two units. |
unit | string | Yes | The unit of time to add or subtract. |
Response
{
"status": "success"
}Difference between dates
Measure the elapsed time between two dates in a chosen unit (days, hours, minutes, or seconds). The result is signed: positive when the end date is after the start date, negative when it's before. Unlike the Time until date action, which counts from now, this measures between two dates you provide.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
start | string | Yes | The date to measure from, in ISO format, like 2026-06-30 or 2026-06-30 09:30. |
end | string | Yes | The date to measure to, in ISO format, like 2026-06-30 or 2026-06-30 09:30. |
unit | string | Yes | The unit to measure the difference in. |
Response
{
"status": "success"
}Get date part
Pull a single component out of a date — the year, month, day of the month, day of the week, hour, or minute. Returns a number for every part except day of the week, which returns the weekday name like Monday. Use it for conditional logic on a date, such as acting only in December or only on the 1st.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
date | string | Yes | The date to read from, in ISO format, like 2026-06-30 or 2026-06-30 09:30. |
part | string | Yes | Which component of the date to extract. |
Response
{
"status": "success"
}Make date readable
Turn a date into a friendly format for emails, messages, or reports.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
date | string | Yes | The date to make readable, in ISO format, like 2026-06-30 or 2026-06-30 09:30. |
format | string | No | Which preset to display the date in — for example a long date and time, just the date, just the time, or an ISO 8601 timestamp. |
Response
{
"status": "success"
}Check business day
Check whether a date is a business day: a weekday that is not a public holiday.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
date | string | Yes | The date to check, like 2026-06-30. |
region | string | No | The region whose public holidays are excluded. US is currently the only supported region. |
Response
{
"status": "success"
}Check holiday
Check whether a date is a public holiday.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
date | string | Yes | The date to check, like 2026-06-30. |
region | string | No | The region to check for public holidays. US is currently the only supported region. |
Response
{
"status": "success"
}Check weekend
Check whether a date falls on a weekend (Saturday or Sunday).
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
date | string | Yes | The date to check, like 2026-06-30. |
Response
{
"status": "success"
}Current date and time
Get the current date and time.
Response
{
"status": "success"
}Time until date
Find out how many seconds remain until a date and time.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
date | string | Yes | The date and time to count down to, in ISO format, like 2026-06-30 or 2026-06-30 09:30. |
Response
{
"status": "success"
}Today's date
Get today's date.
Response
{
"status": "success"
}Tomorrow's date
Get tomorrow's date.
Response
{
"status": "success"
}Current Unix timestamp
Get the current time as a Unix timestamp — the number of seconds since January 1, 1970.
Response
{
"status": "success"
}Day of week
Get the weekday for a date, like Monday or Saturday.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
date | string | Yes | The date to look up, like 2026-06-30. |
Response
{
"status": "success"
}Yesterday's date
Get yesterday's date.
Response
{
"status": "success"
}