Temporal Awareness

Claude's system prompt date may be stale or unavailable. Always verify temporal information using Unix commands before responding to date-sensitive queries.

Example Commands

GNU date (Linux) and BSD date (macOS, FreeBSD) have different syntax. You can check which is installed:

bash
1if date --version >/dev/null 2>&1 ; then
2    echo GNU date
3else
4    echo BSD date
5fi
6

Get current date/time

bash
1# Works on both GNU date and BSD date
2date                          # Full date and time
3date +%Y-%m-%d                # ISO format: 2025-01-15
4date +%A                      # Day of week: Wednesday
5date "+%B %d, %Y"             # January 15, 2025

Find day of week for any date

bash
1# GNU date
2date -d "2025-03-15" +%A              # From ISO date: Saturday
3date -d "March 15, 2025" +%A          # From natural language: Saturday
4date -d "next Friday" +%A             # Relative: Friday
5date -d "last Monday" +%A             # Relative: Monday
6
7# BSD date
8date -j -f "%Y-%m-%d" "2025-03-15" +%A       # From ISO date: Saturday
9date -j -f "%B %d, %Y" "March 15, 2025" +%A  # From natural language: Saturday
10date -v +fri +%A                             # Next Friday: Friday
11date -v -mon +%A                             # Last Monday: Monday

Date arithmetic

bash
1# GNU date
2date -d "+7 days" +%Y-%m-%d           # 7 days from now
3date -d "-2 weeks" +%A                # Day of week 2 weeks ago
4date -d "2025-06-01 +30 days" +%Y-%m-%d   # 30 days after June 1
5
6# BSD date
7date -v +7d +%Y-%m-%d                 # 7 days from now (-v: adjust)
8date -v -2w +%A                       # Day of week 2 weeks ago
9date -j -f "%Y-%m-%d" -v +30d "2025-06-01" +%Y-%m-%d   # 30 days after June 1

Days between dates

bash
1# GNU date
2echo $(( ($(date -d "2025-12-31" +%s) - $(date -d "2025-01-01" +%s)) / 86400 ))   # 364
3
4# BSD date
5echo $(( ($(date -j -f "%Y-%m-%d" "2025-12-31" +%s) - $(date -j -f "%Y-%m-%d" "2025-01-01" +%s)) / 86400 ))   # 364

When to Use

Run date first before answering the user or writing date-aware outputs:

• User asks what today's date or day is
• Use asks what day of the week a date falls on
• User needs to calculate deadlines or durations
• User asks about time until/since an event
• Output works with schedules, meetings, deadlines, or events
• Output needs any temporal context for the task

Example

User: "What day of the week is July 4th, 2026?"

bash
1#GNU Date
2date -d "July 4, 2026" +%A
3
4# BSD Date
5date -j -f "%B %d, %Y" "July 4, 2026" +%A
6
7# Output: Saturday

Then respond: "July 4th, 2026 falls on a Saturday."