Overview
AbsTime resolves natural language time expressions for AI systems, built for agents, assistants, and workflows that need accurate time resolution.
import os
from abstime import AbsTime
client = AbsTime(api_key=os.environ["ABSTIME_API_KEY"])
result = client.resolve( text="the last Friday of this month at 2 pm", ref_time="2026-04-09T17:30:00Z", ref_timezone="America/Los_Angeles",)
print(result.time)print(result.view)# 2026-04-24T21:00:00Z# Apr 24, 2026 2 PMimport { AbsTime } from "@abstime/sdk";
const client = new AbsTime({ apiKey: process.env.ABSTIME_API_KEY });
const result = await client.resolve({ text: "the last Friday of this month at 2 pm", refTime: "2026-04-09T17:30:00Z", refTimezone: "America/Los_Angeles",});
console.log(result.time);console.log(result.view);// 2026-04-24T21:00:00Z// Apr 24, 2026 2 PMcurl https://api.abstime.ai/v1/resolve \ -H "Authorization: Bearer $ABSTIME_API_KEY" \ -H "Content-Type: application/json" \ -d '{"text":"the last Friday of this month at 2 pm","ref_time":"2026-04-09T17:30:00Z","ref_timezone":"America/Los_Angeles"}'Start building
Section titled “Start building”Make your first request
Make your first request and inspect the result.
SetupInstall and run the SDKs
Follow one runnable path: create a key, install the package, and make your first request.
Core conceptUnderstand the input
See the three fields that define a stable request: text, reference time, and timezone.
Core conceptUnderstand the output
Learn which response fields to store, display, and use for downstream systems.
GuideUse the Node.js SDK
Install the SDK and make your first request from JavaScript.
GuideUse the Python SDK
Install the SDK and make your first request from Python.
Resources
Section titled “Resources”Handling Errors
Review the exception model and the API status codes surfaced by both SDKs.
Request IDs
Find the request identifier on success or failure when you need to debug an integration.
Retries and Timeouts
Adjust retry and timeout behavior when you need tighter control in production.
Quickstart
Return to the shortest path from zero to a successful resolve request.