Faro
Tools/datetime
Date & Time Math

Date & Time Math

Active

Models slip on date math, weekdays, and business days; this computes them exactly, holidays included.

4 tools

Date and time arithmetic: duration between two dates, add or subtract intervals, day-of-week and calendar facts, and business-day counts (optionally excluding a country's public holidays). Dates default to today, and all of it is computed locally.

Timedatetimedatedurationbusiness-dayscalendarage

Tools (4)

▶diff

Duration between two dates or datetimes, as totals and a calendar breakdown.

Free

Example prompts

  • “How many days between 2026-01-01 and 2026-12-25?”
  • “How old is someone born on 1990-03-15?”
  • “How long until 2027-01-01?”
  • “Time between 2026-06-06T09:00 and 2026-06-06T17:30”

Parameters

endstringoptional

End date or datetime (YYYY-MM-DD or ISO 8601). Defaults to today.

startstringrequired

Start date or datetime (YYYY-MM-DD or ISO 8601).

API Usage

curl -X POST "https://skill.askfaro.com/skills/datetime/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "How many days between 2026-01-01 and 2026-12-25?"
  }
}'

CLI Usage

askfaro describe datetime/datetime.diff

Install pip install askfaro-cli, then askfaro auth login.

▶weekday

Day of week, ISO week number, day of year, quarter, and weekend flag for a date.

Free

Example prompts

  • “What day of the week is 2026-12-25?”
  • “Is 2026-07-04 a weekend?”
  • “What ISO week number is 2026-06-06?”
  • “What quarter is 2026-08-01 in?”

Parameters

datestringoptional

Date or datetime (YYYY-MM-DD or ISO 8601). Defaults to today.

API Usage

curl -X POST "https://skill.askfaro.com/skills/datetime/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "What day of the week is 2026-12-25?"
  }
}'

CLI Usage

askfaro describe datetime/datetime.weekday

Install pip install askfaro-cli, then askfaro auth login.

▶business_days

Count business days between two dates, optionally excluding a country's public holidays.

Free

Example prompts

  • “How many business days between 2026-06-01 and 2026-06-30?”
  • “Working days in July 2026 excluding US holidays”
  • “Business days from 2026-12-20 to 2027-01-05 in Germany”

Parameters

endstringoptional

End date (YYYY-MM-DD or ISO 8601). Defaults to today.

startstringrequired

Start date (YYYY-MM-DD or ISO 8601).

countrystringoptional

Optional ISO 3166-1 alpha-2 country code to exclude public holidays (e.g. US, DE).

subdivisionstringoptional

Optional ISO 3166-2 subdivision code for regional holidays (e.g. CA, NSW).

API Usage

curl -X POST "https://skill.askfaro.com/skills/datetime/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "How many business days between 2026-06-01 and 2026-06-30?"
  }
}'

CLI Usage

askfaro describe datetime/datetime.business_days

Install pip install askfaro-cli, then askfaro auth login.

▶add

Add or subtract years, months, weeks, days, hours, minutes, or seconds to a date.

Free

Example prompts

  • “What date is 90 days from today?”
  • “Add 3 months to 2026-01-31”
  • “What was the date 2 weeks ago?”
  • “18 months after 2026-06-06”

Parameters

datestringoptional

Base date or datetime (YYYY-MM-DD or ISO 8601). Defaults to today.

daysintegeroptional

Days to add (negative to subtract).

hoursintegeroptional

Hours to add (negative to subtract).

weeksintegeroptional

Weeks to add (negative to subtract).

yearsintegeroptional

Years to add (negative to subtract).

monthsintegeroptional

Months to add (negative to subtract).

minutesintegeroptional

Minutes to add (negative to subtract).

secondsintegeroptional

Seconds to add (negative to subtract).

API Usage

curl -X POST "https://skill.askfaro.com/skills/datetime/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "What date is 90 days from today?"
  }
}'

CLI Usage

askfaro describe datetime/datetime.add

Install pip install askfaro-cli, then askfaro auth login.