# Date Calculator

> Skill `datetime` on Faro. Free. 0 sub-skills.

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.

**Category:** Time  
**Tags:** datetime, date, duration, business-days, calendar, age  
**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).  
**Returns:** information

## How to run
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. Raw tools are internal plumbing and are not directly callable.

```
POST https://skill.askfaro.com/skills/datetime/run
Authorization: Bearer faro_<your_key>
Content-Type: application/json

{"intent":{"prompt":"How many days between January 1 2024 and March 15 2025?"}}
```

Or from the CLI:

```bash
pip install askfaro-cli && askfaro auth login
askfaro run datetime "How many days between January 1 2024 and March 15 2025?"
```

Full run reference: https://askfaro.com/llms/run.md — Agent recipe: https://askfaro.com/llms/skill.md

## 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?

## What it 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.

---
On the web: https://askfaro.com/search/datetime