AgentPMT - The Agentic Economy

Date calculator and timestamp tool set

Core Utility
$0.05/requestMin Purchase: 20Min Purchase Price: $1

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.

Parameters

(required properties listed first)

action*required
Type:string
Description:Use 'get_instructions' to retrieve documentation. The time operation to perform. Available actions: Time Calculations (time-until, time-since, add-days, subtract-days, days-between, business-days-between, convert-timezone, timezone-offset, format-duration, parse-duration, week-number, quarter, is-leap-year, working-hours-overlap, unix-to-iso), Conversions (unix-to-date, date-to-unix, seconds-to-human)
Allowed values:
get_instructionstime-untiltime-sinceadd-dayssubtract-daysdays-betweenbusiness-days-betweenconvert-timezonetimezone-offsetformat-durationparse-durationweek-numberquarteris-leap-yearworking-hours-overlapunix-to-isounix-to-datedate-to-unixseconds-to-human
date
Type:string
Description:Date string in ISO format or any parseable date format. Required for: add-days, subtract-days, week-number, quarter
target_date
Type:string
Description:Target date for calculating time until. Required for: time-until
past_date
Type:string
Description:Past date for calculating time since. Required for: time-since
start_date
Type:string
Description:Start date for date range calculations. Required for: days-between, business-days-between
end_date
Type:string
Description:End date for date range calculations. Required for: days-between, business-days-between
date_string
Type:string
Description:Date string for timezone conversion or Unix conversion. Required for: convert-timezone, date-to-unix
days
Type:integer
Description:Number of days to add or subtract. Required for: add-days, subtract-days
seconds
Type:number
Description:Number of seconds for duration formatting or conversion. Required for: format-duration, seconds-to-human
timestamp
Type:number
Description:Unix timestamp (seconds since epoch). Required for: unix-to-iso, unix-to-date
year
Type:integer
Description:Year to check for leap year. Required for: is-leap-year
Minimum:1
timezone
Type:string
Description:Timezone name (e.g., 'America/New_York', 'UTC', 'Europe/London'). Required for: timezone-offset. Optional for: unix-to-date
from_timezone
Type:string
Description:Source timezone for conversion (e.g., 'America/New_York'). Required for: convert-timezone
to_timezone
Type:string
Description:Target timezone for conversion (e.g., 'Europe/London'). Required for: convert-timezone
duration_str
Type:string
Description:Human-readable duration string (e.g., '2h 30m', '5 days 3 hours'). Required for: parse-duration
format
Type:string
Description:Date format string for parsing dates (default: '%Y-%m-%d %H:%M:%S'). Optional for: date-to-unix
Default:%Y-%m-%d %H:%M:%S
start1
Type:string
Description:Start time of first period in HH:MM format (e.g., '09:00'). Required for: working-hours-overlap
end1
Type:string
Description:End time of first period in HH:MM format (e.g., '17:00'). Required for: working-hours-overlap
start2
Type:string
Description:Start time of second period in HH:MM format (e.g., '14:00'). Required for: working-hours-overlap
end2
Type:string
Description:End time of second period in HH:MM format (e.g., '18:00'). Required for: working-hours-overlap

API Example

curl -X POST "https://api.agentpmt.com/products/purchase" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key-here" \
  -H "X-Budget-Key: your-budget-key-here" \
  -d '{
    "product_id": "69489f4eb54506f955d789ea",
    "parameters": {
      "action": "get_instructions",
      "format": "%Y-%m-%d %H:%M:%S"
    }
  }'

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

About The Developer

Apoth3osis logo

Apoth3osis

13 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.