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.

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.

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.

Connect Your Agent In 5 Min

Use hosted MCP first, or install the local STDIO fallback when your client requires a command

Hosted Streamable HTTPS

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

Endpoint: https://api.agentpmt.com/mcp
Authorization: Bearer <AGENTPMT_BEARER_TOKEN>

Full connection guide

Local STDIO Fallback

Use the local router for Claude Code, Codex, Cursor, Zed, and other clients that require a command-based MCP server. The router forwards requests to the hosted endpoint and does not execute tools locally.

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.

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

Call the AgentPMT-Tool-Search-and-Execution tool with action 'get_schema' and tool_id 69489f4eb54506f955d789ea ("Date and Time Calculator"). Then call the same tool with action 'call_tool', tool_id 69489f4eb54506f955d789ea, and the parameters needed for my request.

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