Date Time Converter — convert timestamps and time zones

Convert Date & Time Formats API

What it does

Date Time Converter turns a single timestamp into the formats developers actually use. Send an ISO 8601 value, a unix epoch, or now, optionally include an IANA timezone, and get back normalized UTC time, human-readable output, relative time, and localized details.

The response includes the original input, iso_utc, weekday, iso_week, relative, human_utc, day_of_year, epoch_millis, and epoch_seconds. When you pass tz, the localized object returns the timezone name, localized ISO string, localized human-readable string, and UTC offset. That makes it useful for log viewers, scheduling interfaces, analytics dashboards, and any system that needs to present the same moment in both machine-friendly and user-friendly forms.

Use Date Time Converter when you need to parse incoming event times, display timestamps in a user's timezone, or compare stored values across systems that disagree on time format. It is a straightforward way to convert one date-time value into multiple representations without rebuilding the logic in your application.

curl -X POST "http://localhost:8080/creightonnick0/convert-date-time" \ -H "apy-token: $APY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "tz": "America/New_York", "value": "2026-08-02T12:00:00Z" }'

What you'll get back

Returns a JSON object with fields for the converted date/time in UTC and the requested timezone, plus useful derived values like weekday, ISO week, relative time, and epoch timestamps.

Top-level fields include input (string), iso_utc (string), weekday (string), iso_week (integer), relative (string), human_utc (string), localized (object with tz, iso, human, and utc_offset), day_of_year (integer), epoch_millis (integer), and epoch_seconds (integer).

{
  "input": "2026-08-02T12:00:00Z",
  "iso_utc": "2026-08-02T12:00:00.000Z",
  "weekday": "Sunday",
  "iso_week": 31,
  "relative": "in 6 months",
  "human_utc": "Sun, 02 Aug 2026 12:00:00 GMT",
  "localized": {
    "tz": "America/New_York",
    "iso": "2026-08-02T08:00:00.000-04:00",
    "human": "Sun, 02 Aug 2026 08:00:00 GMT-4",
    "utc_offset": "-04:00"
  },
  "day_of_year": 215,
  "epoch_millis": 1785672000000,
  "epoch_seconds": 1785672000
}

About this endpoint

What it does

Converts a date/time input into multiple output formats, including UTC representations, relative time, localized time for a provided timezone, and epoch values. The request accepts a date/time value and an IANA timezone tz for localized output.

Request Body

Parameter	Type	Mandatory	Description
tz	String	No	IANA timezone for localized output.
value	String	No	Date/time input as an ISO 8601 string, Unix epoch, or `now`.

Response

Returns a JSON object with these fields: input string, iso_utc string, weekday string, iso_week integer, relative string, human_utc string, localized object, day_of_year integer, epoch_millis integer, and epoch_seconds integer. The localized object contains tz string, iso string, human string, and utc_offset string.

Parameter	Type	Mandatory	Description
input	String	No	Original input value as returned by the service.
iso_utc	String	No	UTC timestamp in ISO format.
weekday	String	No	Weekday name for the converted date/time.
iso_week	Integer	No	ISO week number.
relative	String	No	Relative time description.
human_utc	String	No	Human-readable UTC format.
localized	Object	No	Localized date/time details for the requested timezone.
day_of_year	Integer	No	Day number within the year.
epoch_millis	Integer	No	Unix epoch in milliseconds.
epoch_seconds	Integer	No	Unix epoch in seconds.

Body

Name

Type

Description

bodyOPTIONAL

object

—

Convert Date & Time Formats API

What it does

Quickstart

What you'll get back

About this endpoint

What it does

Request Body

Response

Body

Errors any endpoint can return