Exact Time API

API simples que retorna a hora exata em qualquer fuso horário IANA. Feita para ser chamada por IAs (Claude, GPT, Gemini, etc.) como uma tool/function, resolvendo o problema de LLMs não terem relógio interno.

Como funciona

O servidor usa o relógio do sistema operacional onde ele estiver hospedado. Esse relógio é sincronizado automaticamente via NTP (Network Time Protocol) por qualquer provedor de nuvem sério — você não precisa implementar sincronização de tempo, isso já vem pronto no SO.

Rodando localmente

npm install
node server.js

Servidor sobe em http://localhost:3000.

Endpoint

GET /time?tz=<fuso_IANA>

• tz é opcional. Se omitido, retorna UTC.
• Use identificadores IANA: America/Sao_Paulo, Europe/Lisbon, Asia/Tokyo, etc. Lista completa: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

Exemplo de resposta

{
  "timezone": "America/Sao_Paulo",
  "iso8601": "2026-08-04T11:16:10-03:00",
  "unix_timestamp": 1785852970,
  "unix_timestamp_ms": 1785852970127,
  "human_readable": "04/08/2026 11:16:10",
  "utc_offset": "-03:00"
}

Deploy (para ficar acessível publicamente)

Qualquer host serverless funciona bem, porque a API é leve e sem estado. Opções gratuitas testadas pela comunidade:

• Render (render.com) — deploy direto do GitHub, plano free.
• Railway (railway.app) — idem.
• Vercel — requer adaptar para Serverless Function (formato api/time.js), mas funciona.
• Cloudflare Workers — reescrita leve, mas resposta mais rápida globalmente.

Depois do deploy, você terá uma URL pública, ex: https://sua-api.onrender.com/time?tz=America/Sao_Paulo

Como conectar isso a uma IA (function calling)

A maioria das plataformas de IA com suporte a "tools" aceita um schema assim. Exemplo no formato usado pela API da Anthropic (Claude):

{
  "name": "get_current_time",
  "description": "Retorna a hora exata atual em um fuso horário específico.",
  "input_schema": {
    "type": "object",
    "properties": {
      "timezone": {
        "type": "string",
        "description": "Fuso horário IANA, ex: America/Sao_Paulo"
      }
    },
    "required": ["timezone"]
  }
}

Quando o modelo chamar essa tool, seu backend faz a requisição HTTP para GET /time?tz={timezone} e devolve o JSON como resultado da tool call. Isso funciona da mesma forma em OpenAI (function calling), Gemini (function declarations) e qualquer outro provedor com suporte a tools — o conceito é idêntico, só muda o formato do schema.

Limitação importante (honestidade sobre o que isso resolve)

Isso resolve o problema para qualquer sistema que você controle e que consiga chamar essa API como tool — ex: seu próprio app, um agente que você construir, ou uma IA que aceite tools customizadas.

Isso não muda automaticamente o comportamento de um Claude.ai, ChatGPT ou Gemini genérico que você acessa pelo site/app deles — a menos que a plataforma permita conectar tools externas (ex: MCP na Anthropic, GPTs customizados na OpenAI, etc.), e você configure essa API lá.