ForHosting KIT · Outils pour développeurs

Durée du jour selon la date et la latitude

Ce calculateur estime le nombre d’heures pendant lesquelles le Soleil reste au-dessus de l’horizon conventionnel pour une date et une latitude précises.

● BetaGratuit · dans votre navigateur

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Il emploie uniquement les valeurs fournies, avec une formule standard de déclinaison solaire et d’angle horaire, sans consulter l’heure ni aucun service externe. Le résultat convient à la planification, aux comparaisons, à l’enseignement et au traitement de données lorsqu’une approximation reproductible importe davantage qu’un almanach astronomique local.

Saisissez une date exacte et la latitude géographique

Indiquez une date ISO stricte, avec quatre chiffres pour l’année puis deux pour le mois et le jour, par exemple 2026-06-21. Saisissez ensuite une latitude décimale de -90 à 90 : positive au nord de l’équateur, négative au sud. La longitude et le fuseau horaire sont inutiles, car le calcul porte sur la durée entre lever et coucher théoriques, et non sur leurs heures locales. Le calendrier grégorien et ses règles bissextiles sont contrôlés; les dates impossibles sont refusées. Le rang du jour est obtenu par arithmétique, donc une entrée identique donne toujours le même résultat. Choisissez une latitude représentative du lieu, sans confondre la précision des coordonnées avec celle d’une observation astronomique.

Comprenez l’approximation solaire

La date est d’abord convertie en jour de l’année afin d’estimer la déclinaison solaire, angle saisonnier du Soleil par rapport à l’équateur terrestre. La relation standard de l’angle horaire du lever est ensuite appliquée à la latitude. Le lever et le coucher utilisent une altitude de -0.833 degré, correction conventionnelle de la réfraction et du rayon apparent du Soleil. L’angle devient une durée sur 24 heures, arrondie à quatre décimales. Si le Soleil ne descend jamais sous cet horizon, le résultat vaut 24 heures et indique un jour polaire; s’il ne le dépasse jamais, il vaut zéro et indique une nuit polaire. Relief, bâtiments, pression, température et éphémérides complètes ne sont pas modélisés.

Interprétez correctement le résultat

Considérez daylight_hours comme une valeur cohérente de planification, et non comme une garantie d’ensoleillement visible. Les nuages ne changent pas la durée astronomique, tandis que le relief peut masquer le Soleil. Aux hautes latitudes, calculez chaque date plutôt que d’extrapoler. day_of_year précise la position calendaire et condition distingue les cas ordinaires des situations polaires. Sans longitude, aucune heure locale de lever ou coucher n’est fournie. Cette méthode déterministe sert aux automatisations, tests, cours et préparatifs. Conservez date et latitude avec le résultat. Pour la navigation, la sécurité, l’observance religieuse ou la science précise, consultez une éphéméride locale officielle.

Cas d’usage

Comparer la lumière saisonnière

Calculez plusieurs dates à la même latitude pour suivre l’évolution entre hiver et été.

Planifier des activités extérieures

Estimez la plage de lumière disponible pour voyager, photographier, jardiner ou travailler dehors.

Enrichir des données calendaires

Ajoutez une durée reproductible et un indicateur polaire à des relevés géographiques datés.

Questions fréquentes

Quel est le prix d’un calcul ?

Une requête API coûte $0.002. Le calculateur du navigateur exécute localement la même logique déterministe.

Pourquoi la longitude n’est-elle pas demandée ?

Elle modifie l’heure du lever et du coucher, mais pas leur intervalle approximatif pour une date et une latitude.

S’agit-il d’une éphéméride astronomique exacte ?

Non. Cette approximation standard ignore le relief, l’altitude, la météo et les éphémérides solaires complètes.

Comment les années bissextiles sont-elles traitées ?

Les règles grégoriennes s’appliquent : divisibilité par quatre, sauf les siècles non divisibles par 400.

Que signifient jour polaire et nuit polaire ?

La formule ne trouve alors aucun coucher ou lever conventionnel et renvoie 24 ou zéro heure de lumière.

Pour les développeurs — accès API

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

Endpoint

POSThttps://api.kit.forhosting.com/date/day-length-approx

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

Appeler depuis votre stack

curl -X POST https://api.kit.forhosting.com/date/day-length-approx \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-06-21","lat":51.5074}'

const res = await fetch("https://api.kit.forhosting.com/date/day-length-approx", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "date": "2026-06-21",
    "lat": 51.5074
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/day-length-approx",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2026-06-21",
    "lat": 51.5074
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/day-length-approx", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"date":"2026-06-21","lat":51.5074}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"date":"2026-06-21","lat":51.5074}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/day-length-approx", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemple de requête

{
  "date": "2026-06-21",
  "lat": 51.5074
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.day_length_approx",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

Tarifs

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →