Date and Time Calculator

Available ActionsEach successful request consumes credits as outlined below.

time-until^5crtime-since^5cradd-days^5crsubtract-days^5cradd-hours^5crsubtract-hours^5cradd-minutes^5crsubtract-minutes^5crdays-between^5crbusiness-days-between^5crconvert-timezone^5crtimezone-offset^5crformat-duration^5crparse-duration^5crweek-number^5crquarter^5cris-leap-year^5crworking-hours-overlap^5crunix-to-iso^5crunix-to-date^5crdate-to-unix^5crseconds-to-human^5cr

Details

Time Tools is a date and time utility providing 18 operations across two categories: time calculations and format conversions. Time calculation operations handle date arithmetic and temporal analysis. These include calculating time remaining until a future date, calculating time elapsed since a past date, adding or subtracting days from a date, counting total days between two dates, counting business days (weekdays only) between two dates, converting datetimes between timezones, retrieving UTC offset for any timezone, formatting duration in seconds to human-readable text, parsing human-readable duration strings (such as "2h 30m") into seconds, getting ISO week number for a date, determining fiscal quarter (1–4), checking leap year status, checking if two time periods overlap, and converting Unix timestamps to ISO format. Conversion operations handle format transformations between Unix timestamps, formatted date strings, and human-readable durations. Unix timestamps can be converted to formatted dates with optional timezone specification, date strings can be converted to Unix timestamps using configurable format patterns, and raw seconds can be converted to compact human-readable format (such as "1d 2h 30m 15s"). Date parsing is flexible and accepts multiple input formats. All timezone operations use the pytz library and support standard timezone names.

Use Cases

Building countdown timers for events or deadlines, calculating project durations in business days excluding weekends, scheduling meetings across multiple timezones, converting API timestamps to human-readable formats, parsing user-entered durations like "2 hours 30 minutes" into seconds, determining fiscal quarters for financial reporting, validating date ranges for booking systems, checking working hours overlap between distributed teams, generating relative timestamps for activity feeds, calculating age or tenure from start dates, converting between Unix epoch and display formats for logs, determining week numbers for sprint planning, building time-tracking applications, validating leap years for date calculations, formatting elapsed time for dashboards and reports.

Connect Your Agent In 5 Min

Watch the setup guide for your platform

Or Install Locally

STDIO connector for Claude Code, Codex, Cursor, Zed, and other LLMs that require STDIO or custom connections. This lightweight connector routes requests to https://api.agentpmt.com/mcp. All tool execution happens in the cloud and the server cannot edit any files on your computer.

npm install -g @agentpmt/mcp-routeragentpmt-setup

curl -X POST "https://api.agentpmt.com/products/purchase" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ********" \
  -d '{
    "product_id": "69489f4eb54506f955d789ea",
    "parameters": {
      "action": "time-until",
      "target_date": "example_target_date"
    }
  }'

import requests
import json

url = "https://api.agentpmt.com/products/purchase"

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer ********"
}

data = {
    "product_id": "69489f4eb54506f955d789ea",
    "parameters": {
        "action": "time-until",
        "target_date": "example_target_date"
    }
}

response = requests.post(url, headers=headers, json=data)
print(response.status_code)
print(response.json())

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "69489f4eb54506f955d789ea",
  parameters: {
    "action": "time-until",
    "target_date": "example_target_date"
  }
};

fetch(url, {
  method: "POST",
  headers,
  body: JSON.stringify(data)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error("Error:", error));

const axios = require('axios');

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "69489f4eb54506f955d789ea",
  parameters: {
    "action": "time-until",
    "target_date": "example_target_date"
  }
};

axios.post(url, data, { headers })
  .then(response => {
    console.log(response.status);
    console.log(response.data);
  })
  .catch(error => {
    console.error("Error:", error.message);
  });

Login to view your API and budget keys. The example above uses placeholder values. Sign in to see personalized code with your bearer token.

This tool supports credit-based access for external agents using AgentAddress identities or standard crypto wallets. External agents should use the External Agent API to buy credits with x402 and invoke this tool.

1. Buy Credits

Purchase credits via x402 payment (500 credit minimum, 100 credits = $1).

# Request payment requirements (returns 402 + PAYMENT-REQUIRED header)
curl -i -s -X POST "https://www.agentpmt.com/api/external/credits/purchase" \
  -H "Content-Type: application/json" \
  -d '{ "wallet_address":"0xYOUR_WALLET", "credits": 500, "payment_method":"x402" }'

# Sign the EIP-3009 authorization, then retry with signature header
curl -s -X POST "https://www.agentpmt.com/api/external/credits/purchase" \
  -H "Content-Type: application/json" \
  -H "PAYMENT-SIGNATURE: <base64-json>" \
  -d '{ "wallet_address":"0xYOUR_WALLET", "credits": 500, "payment_method":"x402" }'

2. Create a Session Nonce (nonce used in signed balance/invoke)

curl -s -X POST "https://www.agentpmt.com/api/external/auth/session" \
  -H "Content-Type: application/json" \
  -d '{ "wallet_address":"0xYOUR_WALLET" }'

3. Invoke This Tool

Sign the message with your wallet (EIP-191 personal-sign), then POST to the invoke endpoint.

# Sign this message (wallet MUST be lowercased):
# agentpmt-external
# wallet:0xyourwallet...
# session:<session_nonce>
# request:<request_id>
# action:invoke
# product:69489f4eb54506f955d789ea
# payload:<sha256(canonical_json(parameters))>

curl -s -X POST "https://www.agentpmt.com/api/external/tools/69489f4eb54506f955d789ea/invoke" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_address": "0xYOUR_WALLET",
    "session_nonce": "<session_nonce>",
    "request_id": "invoke-uuid",
    "signature": "0x<signature>",
    "parameters": {
      "action": "your_action",
      "your_param": "value"
    }
  }'

Actions(22)

time-until^5cr1 param(1 required)

Calculate time remaining until a future date. Returns days, hours, minutes, seconds.

target_daterequiredstring

Target date in ISO format or any parseable format (e.g., '2026-12-31T23:59:59', 'December 31, 2026').

time-since^5cr1 param(1 required)

Calculate time elapsed since a past date. Returns days, hours, minutes, seconds.

past_daterequiredstring

Past date in ISO format or any parseable format.

add-days^5cr2 params(2 required)

Add a number of days to a date. Returns the resulting date in ISO format.

daterequiredstring

Starting date in ISO or parseable format.

daysrequiredinteger

Number of days to add.

subtract-days^5cr2 params(2 required)

Subtract a number of days from a date. Returns the resulting date in ISO format.

daterequiredstring

Starting date in ISO or parseable format.

daysrequiredinteger

Number of days to subtract.

add-hours^5cr2 params(2 required)

Add hours to a datetime. Returns the resulting datetime in ISO format.

daterequiredstring

Starting datetime in ISO or parseable format.

hoursrequirednumber

Number of hours to add (supports decimals, e.g., 5.5).

subtract-hours^5cr2 params(2 required)

Subtract hours from a datetime. Returns the resulting datetime in ISO format.

daterequiredstring

Starting datetime in ISO or parseable format.

hoursrequirednumber

Number of hours to subtract.

add-minutes^5cr2 params(2 required)

Add minutes to a datetime. Returns the resulting datetime in ISO format.

daterequiredstring

Starting datetime in ISO or parseable format.

minutesrequirednumber

Number of minutes to add.

subtract-minutes^5cr2 params(2 required)

Subtract minutes from a datetime. Returns the resulting datetime in ISO format.

daterequiredstring

Starting datetime in ISO or parseable format.

minutesrequirednumber

Number of minutes to subtract.

days-between^5cr2 params(2 required)

Calculate the number of calendar days between two dates.

start_daterequiredstring

Start date in ISO or parseable format.

end_daterequiredstring

End date in ISO or parseable format.

business-days-between^5cr2 params(2 required)

Calculate the number of business days (weekdays only, Mon-Fri) between two dates. Does not account for public holidays.

start_daterequiredstring

Start date in ISO or parseable format.

end_daterequiredstring

End date in ISO or parseable format.

convert-timezone^5cr3 params(3 required)

Convert a datetime from one timezone to another. Uses IANA timezone names.

date_stringrequiredstring

Datetime string to convert.

from_timezonerequiredstring

Source timezone (e.g., 'America/New_York').

to_timezonerequiredstring

Target timezone (e.g., 'Europe/London').

timezone-offset^5cr1 param(1 required)

Get the current UTC offset for a timezone.

timezonerequiredstring

Timezone name (e.g., 'America/New_York', 'UTC', 'Europe/London').

format-duration^5cr1 param(1 required)

Format a number of seconds into human-readable text (e.g., '2 days, 3 hours, 15 minutes').

secondsrequirednumber

Duration in seconds to format.

parse-duration^5cr1 param(1 required)

Parse a human-readable duration string into total seconds. Supports s/sec/seconds, m/min/minutes, h/hr/hours, d/day/days.

duration_strrequiredstring

Duration text to parse (e.g., '2h 30m 15s', '5 days 3 hours').

week-number^5cr1 param(1 required)

Get the ISO week number (1-53) for a date.

daterequiredstring

Date to check in ISO or parseable format.

quarter^5cr1 param(1 required)

Get the fiscal quarter (1-4) for a date.

daterequiredstring

Date to check in ISO or parseable format.

is-leap-year^5cr1 param(1 required)

Check whether a given year is a leap year.

yearrequiredinteger

Year to check.

Range: 1 - ...

working-hours-overlap^5cr4 params(4 required)

Check whether two time periods overlap. Useful for scheduling across time zones.

start1requiredstring

Start time of first period in HH:MM format (e.g., '09:00').

end1requiredstring

End time of first period in HH:MM format (e.g., '17:00').

start2requiredstring

Start time of second period in HH:MM format (e.g., '14:00').

end2requiredstring

End time of second period in HH:MM format (e.g., '22:00').

unix-to-iso^5cr1 param(1 required)

Convert a Unix timestamp to ISO 8601 format.

timestamprequirednumber

Unix timestamp in seconds since epoch.

unix-to-date^5cr2 params(1 required)

Convert a Unix timestamp to a formatted date string, optionally in a specific timezone.

timestamprequirednumber

Unix timestamp in seconds since epoch.

timezonestring

Timezone name (defaults to local time). Example: 'America/Chicago'.

date-to-unix^5cr2 params(1 required)

Convert a date string to a Unix timestamp.

date_stringrequiredstring

Date string to convert.

date_formatstring

Python strftime format string for parsing (default: '%Y-%m-%d %H:%M:%S'). If omitted, common formats are tried automatically.

Default: %Y-%m-%d %H:%M:%S

seconds-to-human^5cr1 param(1 required)

Convert seconds to compact human-readable format (e.g., '1d 2h 30m 15s').

secondsrequirednumber

Number of seconds to convert.

Usage Instructions

Usage guidance provided directly by the developer for this product.

Date and Time Calculator

Name: Date and Time Calculator
Brand: Apoth3osis
SKU: 69489f4eb54506f955d789ea
Price: 0.05 USD
Availability: InStock

Comprehensive date/time calculations, timezone conversions, and duration tools.

Actions

time-until

Calculate time remaining until a future date.

Required: target_date (string) - Target date in ISO or parseable format
Example: {"action": "time-until", "target_date": "2026-12-31T23:59:59"}

time-since

Calculate time elapsed since a past date.

Required: past_date (string) - Past date in ISO or parseable format
Example: {"action": "time-since", "past_date": "2024-01-01"}

add-days

Add a number of days to a date.

Required: date (string) - Starting date; days (integer) - Number of days to add
Example: {"action": "add-days", "date": "2026-03-10", "days": 30}

subtract-days

Subtract a number of days from a date.

Required: date (string) - Starting date; days (integer) - Number of days to subtract
Example: {"action": "subtract-days", "date": "2026-03-10", "days": 14}

add-hours

Add hours to a datetime.

Required: date (string) - Starting datetime; hours (number) - Hours to add
Example: {"action": "add-hours", "date": "2026-03-10T09:00:00", "hours": 5.5}

subtract-hours

Subtract hours from a datetime.

Required: date (string) - Starting datetime; hours (number) - Hours to subtract
Example: {"action": "subtract-hours", "date": "2026-03-10T17:00:00", "hours": 3}

add-minutes

Add minutes to a datetime.

Required: date (string) - Starting datetime; minutes (number) - Minutes to add
Example: {"action": "add-minutes", "date": "2026-03-10T09:00:00", "minutes": 45}

subtract-minutes

Subtract minutes from a datetime.

Required: date (string) - Starting datetime; minutes (number) - Minutes to subtract
Example: {"action": "subtract-minutes", "date": "2026-03-10T10:30:00", "minutes": 15}

days-between

Calculate the number of calendar days between two dates.

Required: start_date (string) - Start date; end_date (string) - End date
Example: {"action": "days-between", "start_date": "2026-01-01", "end_date": "2026-12-31"}

business-days-between

Calculate the number of business days (weekdays only, Mon-Fri) between two dates.

Required: start_date (string) - Start date; end_date (string) - End date
Example: {"action": "business-days-between", "start_date": "2026-03-01", "end_date": "2026-03-31"}

convert-timezone

Convert a datetime from one timezone to another.

Required: date_string (string) - Datetime to convert; from_timezone (string) - Source timezone; to_timezone (string) - Target timezone
Example: {"action": "convert-timezone", "date_string": "2026-03-10 09:00:00", "from_timezone": "America/New_York", "to_timezone": "Europe/London"}

timezone-offset

Get the current UTC offset for a timezone.

Required: timezone (string) - Timezone name (e.g., "America/New_York", "Europe/London", "Asia/Tokyo")
Example: {"action": "timezone-offset", "timezone": "America/Los_Angeles"}

format-duration

Format a number of seconds into human-readable text (e.g., "2 days, 3 hours, 15 minutes").

Required: seconds (number) - Duration in seconds
Example: {"action": "format-duration", "seconds": 90061}

parse-duration

Parse a human-readable duration string into total seconds. Supports units: s/sec/seconds, m/min/minutes, h/hr/hours, d/day/days.

Required: duration_str (string) - Duration text to parse
Example: {"action": "parse-duration", "duration_str": "2h 30m 15s"}

week-number

Get the ISO week number (1-53) for a date.

Required: date (string) - Date to check
Example: {"action": "week-number", "date": "2026-03-10"}

quarter

Get the fiscal quarter (1-4) for a date.

Required: date (string) - Date to check
Example: {"action": "quarter", "date": "2026-08-15"}

is-leap-year

Check whether a given year is a leap year.

Required: year (integer) - Year to check (minimum: 1)
Example: {"action": "is-leap-year", "year": 2028}

working-hours-overlap

Check whether two time periods overlap (useful for scheduling across time zones).

Required: start1 (string) - Start of first period (HH:MM); end1 (string) - End of first period (HH:MM); start2 (string) - Start of second period (HH:MM); end2 (string) - End of second period (HH:MM)
Example: {"action": "working-hours-overlap", "start1": "09:00", "end1": "17:00", "start2": "14:00", "end2": "22:00"}

unix-to-iso

Convert a Unix timestamp to ISO 8601 format.

Required: timestamp (number) - Unix timestamp in seconds
Example: {"action": "unix-to-iso", "timestamp": 1773331200}

unix-to-date

Convert a Unix timestamp to a formatted date string, optionally in a specific timezone.

Required: timestamp (number) - Unix timestamp in seconds
Optional: timezone (string) - Timezone name (defaults to local time)
Example: {"action": "unix-to-date", "timestamp": 1773331200, "timezone": "America/Chicago"}

date-to-unix

Convert a date string to a Unix timestamp.

Required: date_string (string) - Date string to convert
Optional: format (string) - Date format pattern (default: "%Y-%m-%d %H:%M:%S")
Example: {"action": "date-to-unix", "date_string": "2026-03-10 12:00:00"}

seconds-to-human

Convert seconds to a compact human-readable format (e.g., "1d 2h 30m 15s").

Required: seconds (number) - Number of seconds
Example: {"action": "seconds-to-human", "seconds": 95415}

Common Workflows

Project deadline countdown: Use time-until with the deadline date to show remaining time, then business-days-between to count working days left.

Meeting scheduling across time zones: Use convert-timezone to align meeting times, then working-hours-overlap to confirm both parties are within work hours.

Date arithmetic for invoicing: Use add-days to compute due dates (e.g., Net 30), or subtract-days to find a billing period start.

Log timestamp conversion: Use unix-to-iso or unix-to-date to convert raw timestamps into readable dates, or date-to-unix to convert back.

Important Notes

Dates accept ISO 8601 format or most common parseable formats (e.g., "March 10, 2026", "2026-03-10", "10/03/2026").
Timezone names use the IANA database (e.g., "America/New_York", "Europe/London", "Asia/Tokyo", "UTC").
business-days-between counts weekdays only (Monday through Friday) and does not account for public holidays.
format-duration produces verbose output ("2 days, 3 hours") while seconds-to-human produces compact output ("2d 3h").
parse-duration supports flexible input: "2h 30m", "5 days 3 hours", "90s", etc.

About The Developer

Apoth3osis

★15 stars

Joined Agent Payment: August 14, 2025

We build tools that enable AI agents to excel in the mathematical realm.

Our small team develops experimental and unique solutions in the AI arena, with a strong focus on modular computing for agentic applications and custom model deployment. We have handled projects for a variety of applications across many sectors, from algorithmic trading and financial analysis, to molecular simulations and predictions, to habitat and biodiversity monitoring and wildlife conservation.

Date and Time Calculator

Description