API de Hora Mundial para Desarrolladores
La API JSON gratuita más sencilla para obtener la hora actual, zona horaria, datos de horario de verano (DST) y geolocalización por IP para cualquier lugar en la Tierra.
Manejar programación de fechas y horas es difícil. Tratar con zonas horarias, transiciones de horario de verano y búsquedas geo-IP requiere bibliotecas pesadas. Nuestra API de Tiempo Mundial resuelve esto haciendo los cálculos en nuestros servidores y devolviendo una respuesta JSON limpia y ligera. Perfecta para dispositivos IoT, paneles de control, espejos inteligentes y aplicaciones web.
- ✅ 100%% Free World Time API for personal and commercial projects.
- ✅ No se requiere clave API – solo comience a obtener datos.
- ✅ CORS habilitado – Acceda directamente desde frameworks de JavaScript frontend (React, Vue, etc.).
- ✅ Hora atómica precisa sincronizada continuamente.
Need world time in an AI assistant? Connect to the Time.Now MCP server. Prefer working in a terminal? Install the Time.Now CLI. For OpenClaw agents, use the Time.Now OpenClaw skill.
â¤ï¸ Apoye esta API gratuita (Requerido)
Proporcionamos este servicio completamente gratis. A cambio, le pedimos amablemente que incluya un enlace a Time.Now en el pie de página de su sitio web, README o pantalla de 'Acerca de' de su aplicación.
Copie este fragmento:
<a href="https://time.now">World Time API by Time.Now</a>
¿Quiere apoyarnos más?
Mantener los servidores para millones de solicitudes de API cuesta dinero. Si le gusta esta herramienta, considere convertirse en patrocinador. Su logo aparecerá abajo y en nuestra página de Patrocinadores.
URL base
Todas las solicitudes a la API deben realizarse a través de HTTPS a:
https://time.now/developer/api
Endpoints de la API
GET /time?timezone=:iana_name
Request the current time object for a specific IANA timezone. The timezone parameter is optional and defaults to UTC.
Ejemplo de solicitud:
GET https://time.now/developer/api/time?timezone=Europe%2FLondon
Legacy-compatible path:
GET https://time.now/developer/api/timezone/Europe/London
Ejemplo de respuesta JSON:
{
"abbreviation": "BST",
"datetime": "2023-10-05T14:30:00.123456+01:00",
"day_of_week": 4,
"day_of_year": 278,
"dst": true,
"dst_from": null,
"dst_offset": 3600,
"dst_until": null,
"raw_offset": 0,
"timezone": "Europe/London",
"unixtime": 1696512600,
"utc_datetime": "2023-10-05T13:30:00.123456Z",
"utc_offset": "+01:00",
"week_number": 40
}
GET /ip
Obtenga la hora actual basada en la dirección IP pública del solicitante. Esto es útil para detectar automáticamente la hora local de un usuario sin solicitar permisos de ubicación.
Solicitud de detección automática de IP:
GET https://time.now/developer/api/ip
Solicitud de búsqueda de IP específica:
GET https://time.now/developer/api/ip/8.8.8.8
GET /timezone
Devuelve una lista de todas las cadenas de zona horaria IANA válidas disponibles en un array JSON.
GET https://time.now/developer/api/timezone
GET /health
Returns the current availability and contract version of the API. Use this endpoint for uptime monitoring and deployment checks.
GET https://time.now/developer/api/health
{
"service": "Time.Now World Time API",
"status": "ok",
"version": "1"
}
JSON Errors
Invalid timezone requests return HTTP 404 with a JSON body. Clients should check both the HTTP status and the stable code value.
{
"code": "timezone_not_found",
"error": "Unknown IANA timezone: Not/A_Zone"
}
Esquema de respuesta JSON
La API devuelve un objeto JSON con los siguientes campos:
| Clave | Tipo | Descripción |
|---|---|---|
timezone |
Cadena | El nombre de zona horaria IANA (por ejemplo, America/New_York). |
datetime |
Cadena | Hora local actual en formato ISO8601 con desplazamiento. |
unixtime |
Entero | Segundos desde la Época Unix (UTC). |
utc_offset |
Cadena | El desplazamiento desde UTC como cadena (ej., +05:30)."/es/timezones/utc/">UTC como cadena (ej., +05:30)."/es/timezones/utc/">UTC como cadena (ej., +05:30). |
abbreviation |
Cadena | Nombre corto de la zona horaria (por ejemplo, EST, JST, CST). |
dst |
Booleano | Verdadero si el horario de verano está actualmente activo. |
dst_offset |
Entero | Segundos añadidos por el horario de verano (normalmente 0 o 3600). |
client_ip |
Cadena | La dirección IP utilizada para la geolocalización. |
Ejemplos de código
JavaScript (Fetch)
fetch('https://time.now/developer/api/ip')
.then(response => response.json())
.then(data => {
console.log('Current time:', data.datetime);
console.log('Timezone:', data.timezone);
});
Python (Requests)
Ejemplo de solicitud para Asia/Tokyo:
import requests
response = requests.get(
'https://time.now/developer/api/time',
params={'timezone': 'Asia/Tokyo'},
)
data = response.json()
print(f"Current time in Tokyo: {data['datetime']}")
cURL
curl "https://time.now/developer/api/time?timezone=Europe%2FParis"
