API d'heure mondiale pour les développeurs
L'API JSON gratuite la plus simple pour obtenir l'heure actuelle, le fuseau horaire, les données d'heure d'été (DST) et la géolocalisation IP pour n'importe quel endroit sur Terre.
La gestion de la programmation de la date et de l’heure est difficile. La gestion des fuseaux horaires, des transitions DST et des recherches géo-IP nécessite de lourdes bibliothèques. Notre API World Time résout ce problème en effectuant le calcul sur nos serveurs et en renvoyant une réponse JSON propre et légère. Parfait pour les appareils IoT, les tableaux de bord, les miroirs intelligents et les applications Web.
- ✅ 100%% API d'heure mondiale gratuite pour les projets personnels et commerciaux.
- ✅ Aucune clé API requise : commencez simplement à récupérer.
- ✅ CORS activé – Accès directement depuis les frameworks JavaScript frontend (React, Vue, etc.).
- ✅ Heure atomique précise synchronisée en continu.
Besoin de l’heure mondiale dans un assistant IA ? Connectez-vous au Time.Now MCP server. Vous préférez travailler dans un terminal ? Installez la Time.Now CLI. Pour les agents OpenClaw, utilisez le Time.Now OpenClaw skill.
❤️ Soutenez cette API gratuite (obligatoire)
Nous fournissons ce service entièrement gratuitement. En échange, nous vous demandons de bien vouloir fournir un lien vers Time.Now dans le pied de page de votre site Web, dans le fichier README ou sur l'écran « À propos » de votre application.
Copiez cet extrait :
<a href="https://time.now">World Time API by Time.Now</a>
Vous souhaitez nous soutenir davantage ?
La maintenance des serveurs pour des millions de requêtes API coûte de l'argent. Si vous aimez cet outil, envisagez de devenir sponsor. Votre logo sera présenté ci-dessous et sur notre page Sponsors.
URL de base
Toutes les requêtes API doivent être effectuées via HTTPS vers :
https://time.now/developer/api
Points d'accès API
GET /time?timezone=:iana_name
Demander l'objet horaire actuel pour un fuseau horaire IANA spécifique. Le paramètre timezone est facultatif et sa valeur par défaut est UTC.
Exemple de requête :
GET https://time.now/developer/api/time?timezone=Europe%2FLondon
Chemin compatible avec l'héritage :
GET https://time.now/developer/api/timezone/Europe/London
Exemple de réponse 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
Obtén la hora actual basada en la dirección IP pública del solicitante. Esto es útil para detectar automáticamente la hora local del usuario sin solicitar permisos de ubicación.
Requête de détection automatique d'IP :
GET https://time.now/developer/api/ip
Requête de recherche d'IP spécifique :
GET https://time.now/developer/api/ip/8.8.8.8
GET /timezone
Devuelve una lista de todas las cadenas de fuso horario IANA válidas disponibles en formato JSON.
GET https://time.now/developer/api/timezone
GET /health
Renvoie la disponibilité actuelle et la version contractuelle de l'API. Utilisez ce point de terminaison pour la surveillance de la disponibilité et les contrôles de déploiement.
GET https://time.now/developer/api/health
{
"service": "Time.Now World Time API",
"status": "ok",
"version": "1"
}
Erreurs JSON
Les requêtes de fuseau horaire non valides renvoient HTTP 404 avec un corps JSON. Les clients doivent vérifier à la fois l'état HTTP et la valeur stable code.
{
"code": "timezone_not_found",
"error": "Unknown IANA timezone: Not/A_Zone"
}
Schéma de réponse JSON
L'API renvoie un objet JSON avec les champs suivants :
| Clé | Type | Description |
|---|---|---|
timezone |
Chaîne | El nombre de fuso horario IANA (por ejemplo, America/New_York). |
datetime |
Chaîne | Hora local actual en formato ISO8601 con desplazamiento. |
unixtime |
Entier | Segundos desde la Época Unix (UTC). |
utc_offset |
Chaîne | Le décalage par rapport à UTC sous forme de chaîne (par exemple, +05:30). |
abbreviation |
Chaîne | Nombre corto del huso horario (por ejemplo, EST, JST, CST). |
dst |
Booléen | Vrai si l'heure d'été est actuellement active. |
dst_offset |
Entier | Secondes ajoutées en raison de l'heure d'été (généralement 0 ou 3600). |
client_ip |
Chaîne | L'adresse IP utilisée pour la géolocalisation. |
Exemples de code
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)
Exemple de requête pour 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"