Déclinaison solaire par jour de l'année
Saisissez un jour de l'année et voyez de combien le Soleil s'écarte au nord ou au sud de l'équateur : le jour 172, proche du 21 juin, donne 23,45° avec un modèle saisonnier lissé. Gratuit dans votre navigateur.
- Gratuit
- Fonctionne dans votre navigateur
- Sans inscription
- Vos données restent sur votre appareil
Lancer gratuitement
Exemple résolu
- Jour
- 172
- Déclinaison (°)
- 23,45
- Obliquité (°)
- 23,45
La déclinaison solaire est la distance angulaire du Soleil au nord ou au sud de l'équateur céleste — la grandeur qui pilote la durée saisonnière du jour, l'altitude solaire à midi et les modèles simples d'irradiance utilisés en architecture, CVC HVAC et astronomie d'introduction. Avec seulement le jour de l'année comme entier de un à trois cent soixante-six, le modèle cosinus saisonnier standard renvoie une déclinaison approximative en degrés sans éphémérides, tables de secondes intercalaires ni appels réseau : δ vaut 23.45 degrés multipliés par le cosinus de deux pi sur trois cent soixante-cinq multiplié par le jour moins cent soixante-douze. Le jour cent soixante-douze se situe près du solstice d'été boréal, de sorte que le cosinus atteint un maximum proche de plus vingt-trois virgule quarante-cinq degrés ; les jours d'hiver produisent des valeurs négatives d'ampleur semblable.
Ce que signifie la déclinaison solaire et quelle valeur de jour envoyer
La déclinaison du Soleil est la latitude du point subsolaire : positive lorsque le Soleil est au nord de l'équateur, négative lorsqu'il est au sud. Sur une année tropique elle oscille approximativement entre plus et moins l'obliquité de l'écliptique, environ vingt-trois degrés et demi. Les réductions complètes utilisent la longitude vraie du Soleil, l'équation du centre et la nutation, mais l'ingénierie et la pratique de classe n'ont souvent besoin que d'une courbe saisonnière lisse.
Le modèle cosinus saisonnier fixe l'obliquité à vingt-trois virgule quarante-cinq degrés et place le pic au jour cent soixante-douze, approximant le vingt-et-un juin dans un calendrier non bissextile.
Cas d’usage
Esquisses de conception solaire et HVAC
Architectes et modeleurs énergétiques ont besoin d'un δ saisonnier rapide pour estimer grossièrement l'altitude à midi ou l'ombrage sans brancher une pile d'éphémérides dans les scripts de conception précoces.
Questions fréquentes
Que se passe-t-il si le jour est hors de 1–366 ?
Le jour de l'année doit être un entier entre 1 et 366 inclus ; des valeurs comme 0 ou 367 sont rejetées et ne sont pas facturées.
S'agit-il de la déclinaison astronomique vraie ?
Non. C'est l'approximation saisonnière cosinus standard avec obliquité fixe 23.45° et pic au jour 172. Elle convient à l'enseignement et à la conception solaire approximative, pas aux éphémérides de haute précision.
Pourquoi le jour 366 est-il autorisé si la formule utilise 365 ?
Les années bissextiles ont besoin du jour ordinal 366 pour le 31 décembre. La période du cosinus utilise encore 365 comme dans le modèle classique de manuel ; accepter 366 évite de rejeter des numéros de jour bissextiles valides.
Pourquoi le jour 355 donne-t-il une déclinaison négative ?
Le jour 355 tombe près du solstice d'hiver boréal, quand le Soleil se trouve au sud de l'équateur. Le cosinus du modèle y vaut presque -1, d'où un résultat proche de -23,45°, symétrique du jour 172.
Quel numéro de jour correspond au 1er février ?
Dans une année non bissextile, le 1er février est le jour 32, et le 1er janvier le jour 1. Ne comptez pas à partir de zéro, sinon toute la courbe saisonnière se décale d'un jour.
Outils associés
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
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/astro/solar-declination-day \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"day":172}'const res = await fetch("https://api.kit.forhosting.com/astro/solar-declination-day", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"day": 172
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/astro/solar-declination-day",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"day": 172
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/astro/solar-declination-day", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"day":172}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"day":172}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/astro/solar-declination-day", 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
{
"day": 172
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "astro.solar_declination_day",
"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
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. |
Notes techniques
Cette capacité évalue cette expression de façon déterministe, rejette les jours hors de un à trois cent soixante-six avec une erreur d'entrée invalide claire, et renvoie un JSON structuré que les correcteurs de devoirs, tableurs de conception solaire et pipelines légers d'astronomie peuvent figer en intégration continue.
Ce que signifie la déclinaison solaire et quelle valeur de jour envoyer
Envoyez le champ obligatoire day comme nombre JSON ou chaîne numérique représentant le jour ordinal de l'année : un pour le premier janvier, trente-deux pour le premier février hors année bissextile, cent soixante-douze près du solstice d'été, trois cent cinquante-cinq près du solstice d'hiver, et jusqu'à trois cent soixante-six lorsqu'un jour bissextile est présent. Les alias day_of_year, doy, n et N sont acceptés pour le même entier. Les non-entiers, valeurs non finies et jours hors de un à trois cent soixante-six échouent avec invalid_input car ce ne sont pas un index valide de jour de l'année pour ce modèle. Des entrées identiques produisent toujours le même JSON car le chemin est une arithmétique en virgule flottante pure, sans réseau, sans graine aléatoire et sans horloge murale.
Lire les champs de réponse et vérifier les repères du calendrier
Associez ce point d'accès à des outils d'altitude solaire ou de durée du jour lorsque la question suivante est la hauteur du Soleil à midi local pour une latitude donnée — en se souvenant que la déclinaison n'est qu'une entrée de ces formules. En cas de succès, la réponse répète day puis indique declination_deg comme déclinaison solaire approximative en degrés sous le modèle cosinus. Le champ obliquity_deg vaut toujours vingt-trois virgule quarante-cinq, l'inclinaison axiale fixe de la formule. Le champ formula est toujours la chaîne δ égale à 23.45 fois cos de 2π sur 365 fois parenthèse N moins 172, et method est toujours cosine_seasonal afin que le code aval puisse brancher sans deviner les formes. Près du jour cent soixante-douze vous devez voir une valeur très proche de plus vingt-trois virgule quarante-cinq degrés ; près du jour trois cent cinquante-cinq le cosinus est proche de moins un et la déclinaison proche de moins vingt-trois virgule quarante-cinq degrés ; autour des jours quatre-vingt-un et deux cent soixante-quatre le modèle croise près de zéro aux équinoxes. day manquant, non entier, zéro, trois cent soixante-sept et nombres non finis échouent avec invalid_input et ne sont pas facturés après le rejet du moteur. Utilisez declination_deg seul lorsqu'un tableau de bord n'a besoin que de l'angle ; conservez formula, method et obliquity_deg pour documenter l'étape physique pour les élèves ou journaliser quelle approximation a produit une esquisse de gain solaire.
Usage de l'API, tarification, flux de conception et limites pratiques
Appelez le calculateur gratuit de déclinaison solaire par jour de l'année dans le navigateur pour vérifier des devoirs, des démonstrations de cours et une conception solaire rapide sans installer SPICE, NOVAS ni une bibliothèque d'éphémérides complète. Les exemples typiques incluent le jour de plein été cent soixante-douze pour la déclinaison boréale maximale, le jour de plein hiver trois cent cinquante-cinq pour l'extrême austral, et des jours proches des équinoxes pour une déclinaison quasi nulle. Le modèle utilise trois cent soixante-cinq dans l'argument du cosinus même lorsque day vaut trois cent soixante-six — c'est la simplification classique des manuels et c'est intentionnel. Envoyez un corps JSON avec l'entier day obligatoire entre un et trois cent soixante-six inclus. Utilisez l'API prépayée lorsqu'une plateforme de tutorat, un bac à sable d'évaluation de code, un générateur de programme ou un pipeline d'énergie du bâtiment a besoin d'un contrat stable sous solde KIT à $0.002 par élément réussi ; les échecs de validation ne consomment jamais le solde après rejet. Les auteurs qui livrent des SDK peuvent mapper declination_deg vers des tables d'altitude de midi saisonnière ou d'irradiance de ciel clair, en montrant comment un seul cosinus lisse capture le signal annuel dominant avant des réductions astronomiques d'ordre supérieur.
Cas d'intégration
Vérification de devoirs et d'examens
Élèves et correcteurs calculent la déclinaison solaire approximative à partir du jour de l'année, la comparent aux repères de solstice et d'équinoxe du manuel, et obtiennent une erreur invalid_input claire si le jour sort de 1–366.
Tutorat et générateurs de programme
Les auteurs de leçons produisent des exemples résolus du modèle cosinus avec un JSON structuré pour fiches, feuilles d'étapes et exercices autoévalués qui enseignent l'astronomie saisonnière avant la mécanique orbitale complète.
Questions techniques
Comment calculer la déclinaison solaire à partir du jour de l'année ?
Envoyez un JSON avec day égal à un entier de 1 à 366 (par exemple 172 près du solstice d'été boréal). La réponse inclut declination_deg selon δ=23.45·cos(2π/365·(N−172)).
Le calculateur de déclinaison solaire est-il gratuit ?
L'outil navigateur s'exécute gratuitement sur votre appareil. Les appels API utilisent le solde KIT prépayé à $0.002 par élément réussi ; les échecs de validation ne sont pas facturés.