Relative Time Formatter API

const response = await fetch('https://api.apiverve.com/v1/relativetimeformatter?timestamp=1609459200&reference=2024-06-01T00%3A00%3A00Z&style=short', {
  method: 'GET',
  headers: {
    'X-API-Key': 'your_api_key_here',
    'Content-Type': 'application/json'
  }
});

const data = await response.json();
console.log(data);

import requests

headers = {
    'X-API-Key': 'your_api_key_here',
    'Content-Type': 'application/json'
}

response = requests.get('https://api.apiverve.com/v1/relativetimeformatter?timestamp=1609459200&reference=2024-06-01T00%3A00%3A00Z&style=short', headers=headers)

data = response.json()
print(data)

const https = require('https');
const url = require('url');

const options = {
  method: 'GET',
  headers: {
    'X-API-Key': 'your_api_key_here',
    'Content-Type': 'application/json'
  }
};

const req = https.request('https://api.apiverve.com/v1/relativetimeformatter?timestamp=1609459200&reference=2024-06-01T00%3A00%3A00Z&style=short', options, (res) => {
  let data = '';
  res.on('data', (chunk) => data += chunk);
  res.on('end', () => console.log(JSON.parse(data)));
});

req.end();

<?php

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'https://api.apiverve.com/v1/relativetimeformatter?timestamp=1609459200&reference=2024-06-01T00%3A00%3A00Z&style=short');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-API-Key: your_api_key_here',
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
print_r($data);

?>

package main

import (
    "fmt"
    "io"
    "net/http"

)

func main() {
    req, _ := http.NewRequest("GET", "https://api.apiverve.com/v1/relativetimeformatter?timestamp=1609459200&reference=2024-06-01T00%3A00%3A00Z&style=short", nil)

    req.Header.Set("X-API-Key", "your_api_key_here")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

require 'net/http'
require 'json'

uri = URI('https://api.apiverve.com/v1/relativetimeformatter?timestamp=1609459200&reference=2024-06-01T00%3A00%3A00Z&style=short')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request['X-API-Key'] = 'your_api_key_here'
request['Content-Type'] = 'application/json'

response = http.request(request)
puts JSON.pretty_generate(JSON.parse(response.body))

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        using var client = new HttpClient();
        client.DefaultRequestHeaders.Add("X-API-Key", "your_api_key_here");

        var response = await client.GetAsync("https://api.apiverve.com/v1/relativetimeformatter?timestamp=1609459200&reference=2024-06-01T00%3A00%3A00Z&style=short");
        response.EnsureSuccessStatusCode();

        var responseBody = await response.Content.ReadAsStringAsync();
        Console.WriteLine(responseBody);
    }
}

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>ok</status>
  <error xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
  <data>
    <target_date>2021-01-01T00:00:00Z</target_date>
    <reference_date>2025-12-16T22:28:24.459Z</reference_date>
    <relative_time>4 years ago</relative_time>
    <is_past>true</is_past>
    <is_future>false</is_future>
    <difference_ms>-156464904459</difference_ms>
    <primary_unit>year</primary_unit>
    <primary_value>4</primary_value>
    <all_units>
      <years>4</years>
      <months>59</months>
      <weeks>258</weeks>
      <days>1810</days>
      <hours>43462</hours>
      <minutes>2607748</minutes>
      <seconds>156464904</seconds>
      <milliseconds>156464904459</milliseconds>
    </all_units>
    <style>short</style>
  </data>
</response>

status: ok
error: null
data:
  target_date: '2021-01-01T00:00:00Z'
  reference_date: '2025-12-16T22:28:24.459Z'
  relative_time: 4 years ago
  is_past: true
  is_future: false
  difference_ms: -156464904459
  primary_unit: year
  primary_value: 4
  all_units:
    years: 4
    months: 59
    weeks: 258
    days: 1810
    hours: 43462
    minutes: 2607748
    seconds: 156464904
    milliseconds: 156464904459
  style: short