← All skills

Date Calculator

Free

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

Time

Computes date differences, adds or subtracts durations from dates, returns weekdays, and counts business days between two dates with optional holiday exclusions. Runs locally with no charge.

Use when

You need exact date arithmetic the model should not count by hand.

Not for

Timezone conversion or current time (use timezone), or calendar holidays lookups (use holidays).

What you can do

  • Compute the difference between two dates or timestamps.
  • Add or subtract a duration (years, months, weeks, days, hours, minutes, seconds) from a date.
  • Return the weekday of a date.
  • Count business days between two dates, optionally excluding a country's public holidays.

What you get back

information

Run it

Skills run through one gateway with your Faro token. Hand it an intent in plain language; Faro routes to the right sub-skill, runs it, and bills per call.

curl -X POST "https://skill.askfaro.com/skills/datetime/run" \
  -H "Authorization: Bearer $FARO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"intent":{"prompt":"How many days between January 1 2024 and March 15 2025?"}}'

Example requests

  • How many days between January 1 2024 and March 15 2025?
  • What day of the week is July 4 2026?
  • How many business days are there between today and December 31?