Approx. déclinaison solaire
Le jour 172, près du solstice d’été boréal, la déclinaison du Soleil atteint 23,45°, le point le plus haut de ce modèle en cosinus ; les jours d’hiver donnent des valeurs négatives de taille voisine. Seul le numéro du jour est nécessaire. 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
- Inclinaison axiale (°)
- 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, en CVC (HVAC) et en trigonométrie et astronomie d'introduction. Avec seulement le jour de l'année comme entier de un à trois cent soixante-six, le modèle cosinus de l'inclinaison axiale de la Terre 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 fois 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 culmine près de plus vingt-trois virgule quarante-cinq degrés ; les jours d'hiver produisent des valeurs négatives de magnitude 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 environ entre plus et moins l'obliquité de l'écliptique, soit 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 salle de classe n'ont souvent besoin que d'une courbe saisonnière lisse fondée sur la trigonométrie élémentaire.
Le modèle cosinus d'inclinaison axiale fixe l'obliquité à vingt-trois point quarante-cinq degrés et place le pic au jour cent soixante-douze, approximant le vingt-et-un juin dans un calendrier non bissextile. Cette reproductibilité est essentielle lorsque les tuteurs figent des goldens, lorsque les scripts de conception relancent des lots saisonniers et lorsque les évaluations de code doivent noter le même nombre à chaque fois.
Cas d’usage
Esquisses de conception solaire et CVC
Architectes et modeleurs énergétiques ont besoin d'un δ saisonnier rapide pour des estimations grossières d'altitude à midi ou d'ombrage sans brancher une pile d'éphémérides dans les scripts de conception précoce.
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 ; les valeurs telles que 0 ou 367 sont rejetées et ne sont pas facturées.
S'agit-il d'une éphéméride astronomique de haute précision ?
Non. C'est une approximation cosinus d'obliquité fixe de l'inclinaison axiale terrestre pour la salle de classe et l'ingénierie. Elle n'inclut ni nutation, ni équation du centre, ni longitude solaire vraie.
Quelle est la déclinaison solaire le jour 172 ?
Environ 23,45 degrés, la valeur la plus haute de ce modèle. Le jour 172 correspond à peu près au 21 juin d’une année non bissextile, près du solstice d’été boréal, quand le Soleil est le plus au nord de l’équateur.
Que signifie une déclinaison solaire négative ?
Elle signifie que le Soleil se trouve au sud de l’équateur céleste. Dans ce modèle, les jours de l’hiver boréal donnent des valeurs négatives d’une taille proche du maximum estival de 23,45 degrés.
Comment trouver le numéro du jour dans l’année ?
Comptez à partir du 1er janvier, qui est le jour 1. Le jour 172 tombe vers le 21 juin d’une année non bissextile, et le compte peut aller jusqu’à 366 lorsque l’année comporte un jour bissextile.
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/trig/declination-approx \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"day":172}'const res = await fetch("https://api.kit.forhosting.com/trig/declination-approx", {
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/trig/declination-approx",
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/trig/declination-approx", 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/trig/declination-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
{
"day": 172
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "trig.declination_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
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 invalid_input claire et renvoie un JSON structuré que les correcteurs de devoirs, feuilles de calcul de conception solaire et pipelines légers 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 en année non 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 de l'arithmétique 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
Près du jour cent soixante-douze vous devriez voir une valeur très proche de plus vingt-trois point 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 point 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. En cas de succès, la réponse renvoie day puis déclare declination_deg comme déclinaison solaire approximative en degrés selon le modèle cosinus d'inclinaison axiale. Le champ axial_tilt_deg vaut toujours vingt-trois point quarante-cinq, l'obliquité terrestre 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_axial_tilt afin que le code aval puisse brancher sans sniffer les formes. Un day manquant, non entier, zéro, trois cent soixante-sept ou non fini échoue avec invalid_input et n'est pas facturé 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 axial_tilt_deg pour documenter l'étape trigonométrique aux étudiants ou journaliser quelle approximation a produit une esquisse de gain solaire. Associez cet endpoint à 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 rappelant que la déclinaison n'est qu'une entrée de ces formules et que la latitude et l'angle horaire complètent l'identité d'altitude.
Usage de l'API, tarification, flux de conception et limites pratiques
Appelez le calculateur gratuit d'approximation de la déclinaison solaire dans le navigateur pour les contrôles de devoirs, les démonstrations de cours et la vérification rapide de conception solaire sans installer SPICE, NOVAS ni une bibliothèque d'éphémérides complète. Exemples typiques : jour cent soixante-douze en plein été pour la déclinaison boréale maximale, jour trois cent cinquante-cinq en plein hiver pour l'extrême austral, et jours voisins 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 standard 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 curriculum 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 de SDK peuvent mapper declination_deg vers des tables d'altitude de midi saisonnière ou des estimations d'irradiance de ciel clair, en montrant comment un seul cosinus lisse de l'inclinaison axiale capture le signal annuel dominant avant de passer à des réductions astronomiques d'ordre supérieur. Gardez les requêtes petites, documentez le champ formula à côté des graphiques et traitez invalid_input comme une vérification de plage côté client plutôt qu'une panne serveur réessayable.
Cas d'intégration
Vérification des devoirs et examens
Étudiants et correcteurs calculent la déclinaison solaire approximative à partir du jour de l'année, la comparent aux solstices et équinoxes du manuel et obtiennent une erreur invalid_input claire si le jour tombe hors de 1–366.
Tutorat et générateurs de curriculum
Les concepteurs de leçons produisent des exemples travaillés du modèle cosinus d'inclinaison axiale avec du JSON structuré pour des fiches, des feuilles d'étapes et des exercices auto-notés qui enseignent la trigonométrie saisonnière avant la mécanique orbitale complète.
Questions techniques
Comment approximer 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)).
Que signifie axial_tilt_deg dans la réponse ?
C'est l'obliquité constante utilisée par le modèle, toujours 23.45 degrés. Sous cette approximation la déclinaison oscille à peu près entre plus et moins cette valeur sur l'année.
Combien coûte l'API ?
Les appels réussis coûtent $0.002 par élément. Le widget navigateur est gratuit sur votre appareil. Les échecs de validation qui lèvent invalid_input ne consomment pas le solde.