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.
- ✅ API de Hora Mundial 100% Gratis para proyectos personales y comerciales.
- ✅ 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.
â¤ï¸ 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 /timezone/:area/:location
Solicite el objeto de hora actual para una zona horaria IANA específica.
Ejemplo de solicitud:
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_offset": 3600,
"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
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). |
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/timezone/Asia/Tokyo')
data = response.json()
print(f"Current time in Tokyo: {data['datetime']}")
cURL
curl "https://time.now/developer/api/timezone/Europe/Paris"