Date and Time Calculator by Apoth3osis

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

Date and Time Calculator

Core Utility

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.

Workflows Using This Tool

2 / 3

Workflow

Saves ~45 min

Appointment Scheduling and Route Planner

+1 more tool

Takes a CSV or spreadsheet file with addresses, asks for a starting drive time, time per stop, and starting address, then parses the addresses, optimizes the driving route, calculates estimated arrival and departure times for each location, and generates a CSV with the full schedule. Returns the optimized route map, Google Maps directions link, and the schedule CSV both locally and via notification. Ideal for field sales, service technicians, delivery planning, or any multi-stop appointment scheduling.

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.

Dynamic MCP Setup

Connect once through AgentPMT Dynamic MCP, then use approved tools from the same agent connection.

30 Second Setup

STDIO connector for Claude Code, Codex, Cursor, Zed, and other LLMs that require STDIO or custom connections.

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

Hosted Streamable HTTPS

MCP endpoint for browser-based apps like ChatGPT, Claude, Grok, or any time you want a streamable connection with no local install.

https://api.agentpmt.com/mcp

Config Example

Use the hosted endpoint directly in clients that support remote MCP. Store your Bearer token in the client config or secret field.

Full connection guide

{
  "mcpServers": {
    "agentpmt": {
      "type": "streamable-http",
      "url": "https://api.agentpmt.com/mcp",
      "headers": {
        "Authorization": "Bearer <AGENTPMT_BEARER_TOKEN>",
        "x-instance-metadata": "{\"client\":\"generic-mcp\",\"platform\":\"remote\"}"
      }
    }
  }
}

Need client videos, organization controls, audit details, and the full feature overview?

More About Dynamic MCP

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.

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.

Autonomous agents can access this tool through AgentAddress credit balances or direct x402 payments. Use the Autonomous Agent API reference for endpoint shapes after choosing the access pattern below.

Recommended

Credit-Based Access Using AgentAddress

AgentAddress is preferred when an autonomous agent needs persistent file access, stored platform state, or maximum tool use ability across repeated calls.

Open Credit-Based Access Using AgentAddress

Direct x402 Payment

Use direct x402 for independent one-off tool calls that do not require shared files or stored platform state.

Accepted public payments

Stablecoin: USDC
Chains: Base, Arbitrum, Optimism, Polygon, and Avalanche

Direct x402 payments are not enabled for this product; use AgentAddress credit access instead.

Product Skill Package

This product has a published Agent Skill package. Install it when an autonomous agent needs product-specific operating instructions in its local skill registry.

Download SKILL.md View package source OpenClaw listing

OpenClaw install

Copied to clipboard

skills.sh install

Copied to clipboard

Usage Instructions

Usage guidance provided directly by the developer for this product.

Date and Time Calculator

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.

Frequently Asked Questions

How do I connect this tool to an external agent?

You can install the local MCP server by opening a terminal and running:

Install commands

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

This will connect you to local agents like Claude Code, Windsurf, Grok Build, Cursor, etc.

Alternatively you can connect to the hosted version with this config block, no installation required:

Hosted MCP config

{
  "mcpServers": {
    "agentpmt": {
      "type": "streamable-http",
      "url": "https://api.agentpmt.com/mcp",
      "headers": {
        "Authorization": "Bearer <AGENTPMT_BEARER_TOKEN>",
        "x-instance-metadata": "{\"client\":\"generic-mcp\",\"platform\":\"remote\"}"
      }
    }
  }
}

View MCP Connection Instructions for more details.

How does an external agent use this tool?

After the external agent is connected to an Agent Group that can use this tool, paste this prompt into the agent:

Agent prompt

Use the AgentPMT-Tool-Search-and-Execution tool. First call action 'get_instructions' so you know how to use the tool search interface. Then call action 'get_schema' with tool_id 69489f4eb54506f955d789ea ("Date and Time Calculator"). After reading the schema and any returned instructions, tell me what this tool can do, we are going to be using it

The agent should fetch the tool schema first, collect the required parameters for your request, and then call the tool through AgentPMT.

Date and Time Calculator

Available ActionsEach successful request consumes credits as outlined below.

Details

Workflows Using This Tool

Appointment Scheduling and Route Planner

Use Cases

Dynamic MCP Setup

30 Second Setup

Hosted Streamable HTTPS

Config Example

Frequently Asked Questions

How do I connect this tool to an external agent?

How does an external agent use this tool?

Looking for help integrating AI into your business? Set up a free consultation.