Metodologia di Calcolo degli Orari di Preghiera Islamici: Monografia Astronomica, Geodetica e Giuridica in 112 Passi

Full mathematical formulation and standalone 64-bit C# reference implementation covering two-part Julian chronometry, 195-term VSOP87D solar ephemeris, NGA EGM96 geoid undulation, Gladstone–Dale atmospheric refraction, sub-kilometer timezone polygons, and Hanafi/Shafi’i high-latitude jurisprudence.

✦ Open Scientific & Public-Benefit Declaration (Halal & Free Reuse)

All mathematical formulations, geodetic tables, timezone boundary polygons, and C# source files published on this page may be freely studied, audited, and integrated into your own software, mosque displays, and academic works without restriction or royalty. Should you identify an astronomical, statutory, or jurisprudential refinement, we warmly invite peer correspondence at [email protected].

1. Executive Abstract & Architectural Motivation

Accurate determination of the five daily obligatory prayers (Fajr/Imsak, Sunrise/Tulu, Dhuhr, Asr, Maghrib, and Isha) alongside Shar’i night divisions (Nisf al-Layl and Thuluth al-Akhir) is fundamentally an interdisciplinary problem spanning celestial mechanics, physical geodesy, atmospheric optics, statutory chronometry, and classical Islamic jurisprudence (Fiqh).

Conventional simplified implementations frequently introduce systematic errors ranging from 1 to 60 minutes due to single-precision floating-point drift, confusion between Android WGS84 ellipsoidal altitude and iOS Mean Sea Level (MSL), coarse bounding-box timezones along complex borders, outdated OS daylight-saving tables, or abrupt discontinuities in sub-polar White Night latitudes. The Quran Radiant engine eliminates all external library dependencies in favor of a deterministic, self-contained 64-bit IEEE-754 analytical pipeline.

2. Core Mathematical, Geodetic & Physical Formulations

2.1 Two-Part 64-Bit Julian Chronometry & IERS-2026 ΔT

Splitting the Julian Date into an integer/half-day epoch base and fractional day prevents IEEE-754 mantissa truncation (~21-bit loss in monolithic JD doubles), maintaining sub-millisecond stability across 1600–2174+ CE.

JD = JD_day + JD_frac, JDE = JD_UTC + ΔT(y) / 86400 T = ((JDN - 2451545) + f_day) / 36525.0

2.2 VSOP87D / NREL SPA Solar Ephemeris & Nutation

Apparent solar coordinates incorporate 195 periodic VSOP87D harmonic terms (±0.0003°), Earth–Moon Barycenter (EMB) & planetary perturbations, 63-term IAU 1980 nutation (Δψ, Δε), distance-scaled aberration, and 10th-degree Laskar obliquity.

λ_app = ☉_true + Δψ - (20.4898″ / R_AU) sin δ = sin ε · sin λ_app, α = atan2(cos ε · sin λ_app, cos λ_app)

2.3 WGS84 Ellipsoidal Altitude vs. Two-Layer NGA EGM96 Geoid

Android GNSS returns height (h) above the WGS84 ellipsoid whereas iOS CoreLocation returns Mean Sea Level (MSL). Applying a compressed 17.2 KB two-layer EGM96 grid (2°×2° global + 0.5°×0.5° regional Hermite blend) eliminates 30–38 m vertical bias.

H_MSL = h_WGS84 - N_EGM96(φ, λ), H ∈ [-450 m, +8850 m] Δα_dip = 0.0347° · √(max(0, H_MSL - H_0))

2.4 Gladstone–Dale Barometric Density & C¹ Refraction

Atmospheric refraction scales with barometric air column density ρ/ρ₀ (capturing the +4.2% denser air column in sub-sea-level basins such as the Dead Sea at -430 m) coupled with C¹-monotonic Sæmundsson/Bennett horizon profiles.

ρ / ρ₀ = (1 - 0.0065 · H / 288.15)^4.25588 R_ref(h_true) = (ρ / ρ₀) · (1.02′ / tan(h_true + 10.3 / (h_true + 5.11)))

2.5 Topocentric Hour Angle & Hanafi/Shafi’i Asr Geometry

Solar altitude is evaluated relative to the local geodetic plumb-line horizon (never improperly converted to geocentric latitude) with topocentric solar parallax π_☉ = 8.794″ / R_AU and shadow factor n ∈ {1, 2}.

cos H₀ = (cos θ_z - sin φ · sin δ) / (cos φ · cos δ), |cos φ · cos δ| ≥ 10⁻¹² h_Asr = acot(n + tan|φ - δ|), n = 1 (Asr al-Awwal) | n = 2 (Asr al-Thani)

2.6 High-Latitude Regimes (45°–90°) & Shar’i Night Divisions

During sub-polar White Nights when solar nadir fails to reach the target depression angle, 30-step Golden-Section nadir search and Hermite blending ensure smooth transitions without jumps, while Shar’i night spans pure physical Sunset-to-Fajr.

T_night = UTC_Fajr(d+1) - UTC_Maghrib(d) Nisf al-Layl = UTC_Maghrib + ½ T_night, Thuluth al-Akhir = UTC_Maghrib + ⅔ T_night

3. Comparative Matrix of Official Global Calculation Authorities

The engine automatically resolves coordinates to over 200 countries and territories via offline polygon trees, applying each jurisdiction’s official twilight depression angles, shadow ratios, precaution (Temkin) offsets, and minute-quantization rules:

Calculation Authority Primary Regions Fajr Angle Isha Criterion Default Asr Official Temkin / Rounding
Presidency of Religious Affairs (Diyanet / DİYK) TR, CY, AZ, Balkans, Europe -18.0° -17.0° (45°+: -16° / Takdir) Asr al-Awwal (+1) / Hanafi (+2 opt.) Sunrise -7m, Dhuhr +5m, Asr +4m, Maghrib +7m · Nearest :30s
Muslim World League (MWL) Europe, Far East, Global -18.0° -17.0° Shafi’i / Standard (+1) Standard astronomical + directional precaution
Umm al-Qura University (Makkah) SA, QA, BH, Arabian Peninsula -18.5° +90 min (+120 min in Ramadan) Standard (+1) Solar center transit · Nearest :30s
Egyptian General Authority of Survey EG, PS, Levant, Africa -19.5° -17.5° Standard (+1) Upper-limb horizon + precaution
Univ. of Islamic Sciences, Karachi PK, AF, IN, BD, Central Asia -18.0° -18.0° Hanafi Asr al-Thani (+2) Hanafi shadow & twilight standard
MABIMS (KEMENAG / JAKIM / MUIS) ID, MY, SG, BN -20.0° -18.0° Shafi’i (+1) +2 min Ihtiyat + Subuh ceiling quantization
Islamic Society of North America (ISNA) US, CA -15.0° -15.0° Standard (+1) / Hanafi (+2) North American moderate twilight

4. Open-Source Reference Implementation (7 Standalone C# Modules)

Zero external dependencies, zero network calls, 64-bit IEEE-754 precision. Select any module below to inspect, copy, or download the production C# source code directly.

YuksekHassasiyetAstronomiMotoru.cs — 64-Bit Two-Part Julian Date, IERS-2026 ΔT, 195-Term VSOP87D Solar Ephemeris, 63-Term IAU Nutation & 120-Term ELP-2000 Lunar Engine
⬇ Download .CS File
Loading C# module...

5. Complete 112-Step Open Technical Specification (Namaz_VH)

Every design decision, edge-case safeguard, common astronomical misconception, and reference C# formula documented step by step.

#01

1) Principio di Ambito Esclusivo Hanafita e Sciafeita e Quadro Giuridico-Islamico (Fiqh)

Nota sull'Ambito Giuridico (Solo Hanafita e Sciafeita): Tutti i calcoli degli orari di preghiera, i rapporti d'ombra, i limiti di karāha (tempi sconsigliati) e le regole di precauzione in questa applicazione sono strutturati unicamente secondo la metodologia delle scuole giuridiche Hanafita e Sciafeita; le altre scuole sono escluse dall'ambito.

I coefficienti d'ombra per la preghiera del Pomeriggio (ʿAṣr al-Awwal +1 ombra: Diyanet / al-Imāmayn Hanafiti / Sciafeita e ʿAṣr al-Thānī +2 ombre: Imam al-Aʿẓam Abū Ḥanīfa), gli angoli di Fajr al-Ṣādiq e del crepuscolo (shafaq), i limiti di karāha di istiwāʾ/ṭulūʿ/ghurūb e le regole di Niṣf al-Layl (mezzanotte sharʿī) sono stati modellati esclusivamente secondo il metodo giuridico di queste due scuole.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché l'utente deve poter vedere con chiarezza fin dall'inizio secondo quali principi giuridici vengono generati gli orari ed evitare confusioni concettuali tra scuole diverse.
ikindi_golge ∈ { 1f (ʿAṣr al-Awwal: Diyanet / al-Imāmayn / Sciafeita), 2f (ʿAṣr al-Thānī: Hanafita / Imam al-Aʿẓam) };
resmiTemkin + FikhiGuvenliSaatMetnineCevir(...) // Metodo di precauzione Hanafita e Sciafeita
#02

2) Blocco di Attesa ??:?? Orientato alla Privacy, Rifiuto di (0°, 0°) e Blocco della Santa Kaaba (277 m)

Se la posizione non è ancora stata selezionata, non viene assegnata alcuna capitale predefinita nascosta; le schede degli orari attendono mostrando ??:?? e il contatore ??:??:??. Al controllo di validità delle coordinate vengono respinti il punto zero del Golfo di Guinea (0°, 0°), i valori non definiti (NaN/Infinity) e gli input non validi al di fuori di [-90°, +90°]. Se l'utente conferma l'opzione della Santa Kaaba, si attivano le coordinate a 64 bit della Kaaba (21.422487°N, 39.826206°E, blocco di protezione ±1e-5°), 277 m di altitudine dell'Hijaz, codice paese SA (UTC+3) e l'autorità Umm al-Qura.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così per evitare che un utente che non concede il permesso GPS venga tratto in inganno inconsapevolmente con gli orari di un'altra città, e per preservare le coordinate esatte e i 277 m di altitudine alla scelta della Kaaba senza deriva in virgola mobile a 32 bit.
bool KoordinatGecerliMi(double lat, double lon): !IsNaN(lat) && !IsInfinity(lat) && !IsNaN(lon) && !IsInfinity(lon) && lat ∈ [-90.0, 90.0] && (|lat| ≥ 1e-4 || |Sarmala180(lon)| ≥ 1e-4);
if (!KonumAlma.IlkKonumKayitliMi()) → AktifVakitVerileriniTemizle(); // KAABA: 21.422487, 39.826206, 277m
#03

3) Trasferimento di Coordinate a Doppia Precisione a 64 Bit e Avvolgimento Semiaperto della Longitudine [-180°, +180°)

Le coordinate selezionate dalla mappa o dal database urbano offline sono archiviate come numeri a doppia precisione a 64 bit (decimali esatti senza arrotondamento); le coordinate a 32 bit provenienti dal GPS live (~1.1 m di quantizzazione terrestre ≈ 0.003 s di tempo) vengono promosse nello spazio a 64 bit al primo istante di lettura e sottoposte a verifica di validità. Negli spostamenti sulla mappa, le longitudini che superano il meridiano di cambio data ±180° vengono ricondotte tramite normalizzazione ciclica nell'intervallo semiaperto [-180.0°, +180.0°).

Motivo (Perché abbiamo fatto così): Abbiamo fatto così per impedire l'accumulo di rumore in virgola mobile a 32 bit lungo centinaia di passaggi trigonometrici delle effemeridi e per eliminare conflitti di confine dovuti alla doppia rappresentazione sulla giuntura dell'antimeridiano +180° e -180°.
double Sarmala180(double aci) { double m = (aci + 180.0) % 360.0; if (Math.Sign(m) == -1) m += 360.0; return m - 180.0; }
KonumAlma.AktifKoordinatlariDoubleAl(out double dEnlem, out double dBoylam);
#04

4) Età del Pacchetto GNSS al Millisecondo, Avanzamento del Sensore Live e Protezione al Risveglio da Background

I sistemi operativi mobili possono restituire un'ultima posizione nota obsoleta risalente a ore prima quando il servizio di localizzazione è stato appena attivato o l'app torna dal background. La soglia di freschezza confronta l'età del pacchetto con il tempo Unix al millisecondo; sui dispositivi con orologio di sistema sfasato verifica se il timestamp del sensore satellitare avanza in coerenza con l'orologio a muro (avanzamento del sensore positivo oltre 0.05 s e differenza tra avanzamento del sensore e dell'orologio di sistema ≤ 30.0 s) e azzera il riferimento di freschezza al rientro da una sospensione in background ≥ 30 s.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così per evitare che un utente appena sceso da un aereo o che riapre l'app dopo ore veda gli orari della città precedente a causa della cache GPS obsoleta nei primi 8 secondi.
bool GnssFixTazeMi(fixTs, sistemUnixSn, maksYasSn): (sistemUnixSn - fixTs) ≤ maksYasSn && (sistemUnixSn - fixTs) ≥ -600.0;
bool canliIlerlemeUyumlu = Math.Sign(gnssIlerlemeSn - 0.05) == 1 && Math.Abs(gnssIlerlemeSn - sistemIlerlemeSn) ≤ 30.0;
#05

5) Distinzione di Altitudine tra Android (Ellissoidica WGS84 h) e iOS (Livello Medio del Mare MSL)

Sull'asse verticale i due sistemi operativi mobili restituiscono superfici di riferimento diverse: il servizio di localizzazione Android fornisce l'altezza geometrica sull'ellissoide di riferimento WGS84 (h), mentre iOS restituisce direttamente l'altitudine sul livello medio del mare (MSL). Il convertitore di altitudine applica la sottrazione dell'ondulazione del geoide (N) unicamente all'altezza ellissoidica Android.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché sottrarre una seconda volta il geoide dall'altitudine MSL proveniente dai dispositivi iOS abbasserebbe artificialmente l'altitudine di 30–38 metri in Turchia, mentre non sottrarla su Android la sovrastimerebbe della stessa entità.
Errore comune / Nota di attenzione: Si ritiene spesso che l'altitudine GPS fornisca direttamente il livello del mare (MSL) su tutti gli smartphone; poiché invece Android restituisce l'altezza ellissoidica grezza (h) e iOS il livello MSL già depurato dal geoide, applicare la stessa formula a entrambe le piattaforme genera uno scarto di ~30–38 m in Turchia.
float jeoidN = androidElipsoidYuksekligiMi ? YaklasikJeoidOndulasyonuMetre(enlem, boylam) : 0f;
denizSeviyesiMetre = hamGnssRakimMetre - jeoidN;
#06

6) Ondulazione del Geoide NGA EGM96 a Due Livelli (2°x2° Globale + 0.5°x0.5° Regionale, ~17.2 KB)

Per convertire l'altezza ellissoidica Android (h) in altitudine sul livello del mare (H = h − N), si utilizza una griglia bilineare compressa a due livelli tratta dal modello NGA EGM96 (quantizzata in interi con segno da 1.0 m, 17,632 byte totali ≈ 17.2 KB): nel mondo opera la tabella globale 2°x2° (91x181 nodi), mentre nella fascia Turchia, Cipro e Vicino Oriente (30°N–43°N, 25°E–46°E) viene fusa con transizione ai bordi di Hermite di 1° una sottotabella 0.5°x0.5° (27x43 nodi) che segue il gradiente dell'altopiano anatolico (la quantizzazione geoidica di 1.0 m corrisponde a ~0.002° nell'angolo dell'orizzonte).

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché griglie grossolane 15°x15° sottostimano di 10–12 metri la cupola geoidica dell'altopiano anatolico; la griglia compressa a due livelli occupa solo ~17.2 KB in memoria e contiene lo scarto attorno a ~1 metro.
Errore comune / Nota di attenzione: Le tabelle geoidiche grossolane a passo 10°–15° usate nei codici elementari campionano vertici in Egitto, Mar Nero e Mar Caspio, scavalcando la cupola geoidica positiva locale dell'Anatolia (+27..+38 m) e lasciando ~11 m di errore a Kahta e in Anatolia Centrale.
sbyte[] kuresel = Egm96TabloCoz(ref _egm96Global2Deg, ...); // YaklasikJeoidOndulasyonuMetre(lat, lon)
if (lat ≥ 30.0 && lat ≤ 43.0 && lon ≥ 25.0 && lon ≤ 46.0) N = kureselN + (bolgeselN - kureselN) * wHermite;
#07

7) Limiti Fisici di Altitudine [-450 m Mar Morto .. 8850 m Everest] ed Effetto di Densità nelle Depressioni

Il controllo di validità dell'altitudine assume in tutti i moduli l'intervallo comune sul livello del mare (MSL) [-450 m, 8850 m]; in questo modo restano tutelati sia i bacini depressi sotto il livello del mare come le rive del Mar Morto / Lago di Lot (-430 m, Gerico/Valle del Giordano) e il Lago di Tiberiade (-210 m), sia tutti gli insediamenti fino alla vetta dell'Everest (8849 m). Nei bacini con altitudine negativa la colonna d'aria è più densa che al livello del mare, per cui il fattore di Gladstone–Dale sale naturalmente sopra 1.0 (al Mar Morto ρ/ρ₀ ≈ 1.042); la depressione ottica dell'orizzonte ΔH = max(0, H − H₀) evita invece radici negative.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché fissare a 0 m il limite inferiore cancellerebbe il dato reale di altitudine presso il Mar Morto e Gerico e trascurerebbe la rifrazione atmosferica ~4.2 % più densa in quella depressione.
Errore comune / Nota di attenzione: Scambiare l'altitudine negativa per un errore e azzerarla con max(0, H) è una trappola diffusa; sulle sponde di Gerico e del Mar Morto (-430 m) l'altitudine è effettivamente negativa e soltanto il dislivello ottico dell'orizzonte (ΔH ≥ 0) non può essere minore di zero, mentre la rifrazione da densità aumenta.
double gecerliRakim = Math.Clamp(rakimMetre, -450.0, 8850.0); // Mar Morto -430m → ρ/ρ₀ ≈ 1.0420
double deltaH = Math.Max(0.0, gecerliRakim - Math.Clamp(H0, -450.0, 8850.0));
#08

8) Orizzonte Geodetico a Filo a Piombo WGS84 e Protezione Polare del Denominatore [-90°, +90°] (|cos φ · cos δ| ≥ 1e-12)

La superficie delle acque ferme e il piano naturale dell'orizzonte terrestre sono perpendicolari alla direzione della gravità locale (filo a piombo / plumb-line), non al centro della Terra. Per questa ragione fisica, nel calcolo dell'orizzonte e dell'altezza solare si utilizza direttamente la latitudine geodetica WGS84 fornita dal GPS nell'intervallo [-90.0°, +90.0°] anziché la latitudine geocentrica; ai poli geografici esatti ±90.0° interviene la protezione |cos φ · cos δ| ≥ 1e-12 contro la divisione per zero quando cos(φ)·cos(δ) → 0.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché, a causa dello schiacciamento terrestre (~1/298.257), convertire la latitudine geodetica in geocentrica inclina artificialmente l'orizzonte locale a filo a piombo di ~11.5 primi d'arco a 45° di latitudine; la latitudine geodetica è coerente con l'orizzonte fisico.
Errore comune / Nota di attenzione: Poiché la Terra è schiacciata ai poli, si crede talvolta che convertire la latitudine GPS in geocentrica tramite atan((1 − f²)·tan φ) aumenti la precisione; in realtà la superficie di uno specchio d'acqua e l'orizzonte naturale sono perpendicolari al filo a piombo gravitazionale locale (latitudine geodetica), non al centro terrestre.
double guvenliEnlem = Math.Clamp(enlem, -90.0, 90.0);   double enlemRad = guvenliEnlem * (Math.PI / 180.0);
double cosHaSunrise = (Math.Abs(cosHaPayda) ≥ 1e-12) ? (cosZenit - sinPhi * sinDec) / cosHaPayda : ...;
#09

9) Isolamento di Altitudine e Paese Obsoleti nei Passaggi Città Salvata ↔ GPS Live e in Assenza di Rete

Quando l'utente torna alla modalità GPS live da una città salvata ad alta quota (per esempio Erzurum 1900 m o La Paz 3640 m), elimina la posizione salvata oppure riceve una nuova posizione GPS orizzontale in modalità aereo con accuratezza verticale non valida, vengono azzerati i campi in cache relativi all'altitudine locale, al nome località e al codice paese della città precedente; inoltre un errore di rete offline non blocca l'aggiornamento degli orari e la risoluzione dell'indirizzo viene completata in background a intervalli di 30 s.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché scendendo da una città di montagna al livello del mare, l'infiltrazione di una quota obsoleta di 1900 m o del vecchio codice paese nella nuova posizione falserebbe l'Orizzonte Ottico Personale e l'autorità automatica.
if (gpsRakimGecerli) { sonKayitliRakim = Clamp(currentAlt, -450f, 8850f); _sonGercekRakimBiliniyor = true; }
else if (mesafe ≥ 5.0 && _sonGercekRakimBiliniyor) { sonKayitliRakim = 0f; _sonGercekRakimBiliniyor = false; } // Blocco paese/altitudine in GuncelKonumuZorlaVeKaydet (Passo 110)
#10

10) Isteresi Sferica di Haversine (0.5 km / 10 km), Blocco Longitudinale Polare di 0.0045° e Aggiornamento di Confine

Per tutelare batteria e consumo di rete in movimento opera una doppia soglia sferica di Haversine: a uno spostamento orizzontale ≥ 0.5 km (500 m) viene rinnovata la tabella oraria offline; percorsi ≥ 10.0 km viene aggiornato il nome della città o del distretto. La convalida della cache controlla oltre alla distanza di 0.5 km anche il requisito di differenza normalizzata di longitudine ≤ 0.0045° per i punti prossimi ai poli dove convergono i meridiani; al passaggio di frontiera viene aggiornata la cache del fuso orario di sistema.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché ricalcolare la tabella ogni secondo a causa delle oscillazioni naturali indoor del GPS di 5–20 m affaticherebbe la CPU; vicino ai poli, invece, camminando per 200 m oltre il meridiano opposto il blocco longitudinale di 0.0045° rinnova subito la cache.
double boylamFarki = Math.Abs(NOAA_Verileri.Sarmala180((double)sonBoylam - (double)hesapBoylam));
bool koordUyumlu = Math.Sign(KureselMesafeKm(...) - 0.5) == -1 && boylamFarki ≤ 0.0045; // sotto 0.5 km
#11

11) Sensibilità della Cache dell'Orizzonte Ottico Personale (Soglia Angolare di 0.035°)

Poiché presso le autorità ufficiali di calendario urbano vale un orizzonte cittadino piatto (ΔH = 0), spostarsi tra i piani di un edificio non invalida inutilmente la cache. Quando invece nelle Impostazioni Personali è attiva la correzione dell'orizzonte ottico, non si guarda alla differenza grezza di √H, bensì al superamento della soglia di 0.035° nella differenza angolare della depressione netta dell'orizzonte depurata dall'altitudine base circostante (H₀) (soglia d'impatto ~8 s all'equatore, variazione di circa ±40 m al livello del mare).

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché in un altopiano con H₀ = 500 m, salendo da 501 m a un colle di 540 m il salto relativo ΔH = 0 → 40 m porta la depressione reale dell'orizzonte da 0° a 0.22°; misurare direttamente |Δα_net| coglie questa ascesa.
double EtkinUfukRakimiHesapla(double H) → Math.Max(0.0, clamp(H, -450, 8850) - clamp(H0, -450, 8850));
bool OptikUfukDegisimiAnlamliMi(eskiH, yeniH) → rakimUfukDuzeltmesiAktif && Math.Sign(|α_net(yeniH) - α_net(eskiH)| - 0.035) == 1;
#12

12) Scrittura Atomica al Primo Fotogramma (d-1 + i=0 + i=1), Lock di Concorrenza e Controllo di Completezza su 8 Giorni

Alla selezione di una nuova località o autorità viene arrestato qualsiasi flusso di calcolo precedente incompleto, ripulite le fasce obsolete dei giorni futuri e aggiornati atomicamente nello stesso fotogramma i giorni d-1 (ieri), oggi (i=0) e domani (i=1) insieme ai dati completi della notte sharʿī. Mentre i giorni successivi (d+2..d+7) proseguono nei fotogrammi successivi, un blocco di concorrenza previene collisioni con lo strato di scrittura e annulla il flusso a metà se cambiano le impostazioni.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così per evitare che nei cambi rapidi di autorità o scuola giuridica due flussi scrivano in parallelo sugli stessi slot della cache locale (corruzione parziale dei dati) e per garantire la lettura completa di domani (i=1) dopo ʿIshāʾ.
if (_aktifHesaplamaRutin != null) StopCoroutine(_aktifHesaplamaRutin);
MevcutTabloKullanilabilirMi(): true se i record d'archivio ieri/oggi/domani/7.º giorno + coordinate + firma v6 sono completi; // Nomi delle chiavi astratti al Passo 110
#13

13) Base in Tempo Universale Coordinato (UTC) e Risoluzione Iterativa del Fuso Orario Locale → UTC

Poiché l'orologio a muro locale salta in avanti o ripete la stessa ora nei passaggi tra ora legale e ora solare, il motore degli orari e il conto alla rovescia attingono all'asse temporale universale UTC e usano l'istante UTC univoco persino nelle ore gemelle d'autunno. Anche nella ricerca del fuso per un'ora locale di calendario si esegue una convergenza locale → UTC in 2 passaggi per evitare slittamenti nella notte di cambio.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché nella notte autunnale di ritorno dell'ora solare interrogare soltanto l'orologio a muro locale può ricadere nel fuso sbagliato nell'ora doppia 02:00..02:59; l'asse universale UTC scorre invece in modo monotono.
DateTime utcSimdi = DateTime.UtcNow;
DateTime konumSimdi = UtcAniniAktifKonumYerelZamaninaCevir(enlem, boylam, utcSimdi, out double aktifDilim);
#14

14) Fuso Orario Manuale a Passi di 15 Minuti (0.25 h) e Validazione per Paese del Fuso del Dispositivo (≤ 0.05 h)

La risoluzione del fuso orario si articola su tre livelli: (1) Per l'utente che vicino al confine si aggancia a una cella estera o che desidera fissare l'ora locale ufficiosa nello Xinjiang (UTC+6) oppure fusi al quarto d'ora come Nepal (+5.75) / Chatham (+12.75), si applica direttamente il Fuso Orario Manuale a passi di 0.25 h (15 min). (2) In modalità GPS live, il fuso di sistema del dispositivo viene utilizzato solo se gli offset con segno di gennaio e luglio coincidono con il poligono entro una tolleranza ≤ 0.05 h e risultano compatibili con l'identità DST specifica del paese (EG, IL, PS, LB, MA, IR, JO, SY).

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché se un utente ha impostato Atene (DST UE) sul telefono mentre si trova al Cairo (DST Egitto), pur essendo identici gli offset di gennaio e luglio (+2/+3), le 4 settimane di scarto nel cambio di aprile sposterebbero gli orari di 1 ora.
Errore comune / Nota di attenzione: Accettare come corretto il fuso del dispositivo guardando soltanto l'uguaglianza degli offset di gennaio (+2) e luglio (+3) è fuorviante; sebbene Atene, Il Cairo, Beirut e Gerusalemme abbiano lo stesso scarto in pieno inverno e piena estate, le settimane di passaggio primaverili differiscono.
bool ocakTemmuzEsit = |cihazOcak - koordOcak| ≤ 0.05 && |cihazTemmuz - koordTemmuz| ≤ 0.05;
bool kullan = ocakTemmuzEsit && CihazTimeZoneIdUlkeIleUyumluMu(TimeZoneInfo.Local.Id, hedefUlke);
#15

15) Tracia Turca (Karaağaç vs Malko Tarnovo / Kapitan Andreevo), Isole dell'Egeo e Poligoni Kaş–Castellorizo

Mentre la Turchia adotta UTC+3 permanente tutto l'anno, le vicine Bulgaria e Grecia usano UTC+2 d'inverno e UTC+3 d'estate. Affinché i villaggi di confine non sconfinino nel fuso vicino, poligoni dedicati separano Edirne Karaağaç / Pazarkule (TR) da Kastanies / Orestiada (GR), Kapitan Andreevo / Svilengrad e la rientranza di Malko Tarnovo nello Strandzha (BG), Gökçeada/Çeşme/Datça dalle isole di Chio/Lesbo/Kos/Simi/Rodi, e Kaş in Antalya (TR, UTC+3) dall'isola di Castellorizo / Meis a 2 km al largo (GR, UTC+2/+3).

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché tracciare riquadri rettangolari grossolani attorno a Kırklareli o Kaş assegnerebbe Malko Tarnovo alla Turchia oppure le coste di Kaş alla Grecia, generando un errore orario di 60 minuti in inverno.
if (lon ∈ [27.35, 27.85] && lat ∈ (41.955, 42.20]) return false; // Malko Tarnovo (BG, UTC+2/+3)
if (lat ≥ 36.12 && lat ≤ 36.165 && lon ≥ 29.56 && lon ≤ 29.615) return false; // Isola Meis / Castellorizo (GR) vs Kaş (TR +3)
#16

16) Isola di Cipro ([34.5°..35.72°N, 32.2°..34.65°E]) Ora Legale UE (+2/+3) e Abbinamento all'Autorità Diyanet

Sebbene l'isola di Cipro (RTNC e Repubblica di Cipro: Nicosia, Kyrenia/Girne, Famagosta, Pafo) si trovi alla latitudine di Hatay/Mersin, diversamente dall'UTC+3 permanente della Turchia adotta UTC+2 (EET) in inverno e UTC+3 (EEST — ultima domenica di marzo 01:00 UTC ↔ ultima domenica di ottobre 01:00 UTC) in estate; tuttavia, nell'autorità di calcolo automatica viene collegata agli stessi criteri ufficiali Diyanet (DİYK) della Turchia.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché lasciare Cipro dentro il riquadro principale della Turchia sposterebbe di 1 ora in avanti tutti gli orari di preghiera a Nicosia e Kyrenia nei mesi invernali; mantenere il fuso DST dell'UE (+2/+3) e l'autorità Diyanet rispecchia la prassi locale.
Errore comune / Nota di attenzione: L'uso dei criteri del calendario Diyanet a Cipro Nord induce nell'errore di supporre che anche il fuso orario sia UTC+3 tutto l'anno come in Turchia; al contrario, nei mesi invernali l'isola adotta l'orario UTC+2 (EET).
TZ: if (lat ≥ 34.50 && lat ≤ 35.72 && lon ≥ 32.20 && lon ≤ 34.65) return abYazSaati ? 3.0 : 2.0; // Cipro EET/EEST
Paese (lat ∈ [34.50, 35.75], lon ∈ [32.20, 34.65]) → "CY" → Otoriteler.Diyanet; // Conformità al calendario ufficiale RTNC / Cipro
#17

17) Flessioni del Confine Meridionale e Orientale Turco (Kesab, Aleppo, Kobane, Qamishli/Derik, Mosul, Nakhchivan, Bazargan)

Per la precisione del codice paese e del fuso orario ai confini meridionale e orientale della Turchia, rette oblique di frontiera separano Yayladağı dalla siriana Kesab (35.93°N, 35.98°E), Hatay/Kilis da Aleppo e Afrin, Suruç/Akçakale da Kobane, l'ansa del Tigri tra Nusaybin/Cizre e Qamishli/Derik, Habur/Derecik da Zakho/Mosul, nonché Iğdır/Dilucu e Gürbulak da Nakhchivan (Sadarak, UTC+4), Armenia (Ararat, UTC+4) e Iran (Bazargan/Maku/Serow, UTC+3.5).

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché nel corridoio di Iğdır Dilucu pochi chilometri a nord Nakhchivan/Armenia usano UTC+4 e a sud l'Iran usa UTC+3.5, mentre nelle sacche di confine sud-orientali il codice paese cambia direttamente l'autorità automatica di calcolo.
Esclusione Sadarak/Ararat (+4): nella fascia lat ∈ [39.65, 40.08], a est del confine lon 44.84 - (lat - 39.65) * 1.35 → fuori TR;
Esclusione Bazargan/Maku (+3.5): nella fascia lat ∈ [39.25, 39.65), a est del confine lon 44.38 + (lat - 39.25) * 1.10 → fuori TR;
#18

18) Baltico/Europa Orientale, Kaliningrad (+2), Bielorussia (+3) e gli 11 Fusi Orari della Russia (Samara–Kamchatka)

Nell'Europa orientale Estonia, Lettonia, Lituania, Finlandia, Ucraina, Romania e Moldavia ricevono UTC+2/+3 con ora legale UE; Polonia (inclusa Suwałki) UTC+1/+2; Kaliningrad UTC+2 permanente; Bielorussia UTC+3 permanente. All'interno della Federazione Russa vengono distinti tramite confini amministrativi Samara/Ul'janovsk/Saratov/Astrachan' (+4), Ekaterinburg/Perm'/Ufa (+5), Omsk (+6), Novosibirsk/Tomsk/Krasnojarsk (+7), Irkutsk (+8), Jakutsk/Čita/Blagoveščensk (+9), Vladivostok/Chabarovsk (+10), Magadan/Sachalin (+11) e Kamčatka/Čukotka (+12).

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché in Russia e nell'Europa orientale un semplice arrotondamento longitudine/15 produrrebbe errori di 1 ora in metropoli con fuso amministrativo spostato quali Samara, Omsk, Novosibirsk o Irkutsk.
Kaliningrad → +2.0; EE/LV/LT/FI/UA/RO/MD → UE DST (+2/+3); BY e Mosca → +3.0;
RusyaSaatDilimiBul(lat, lon) → Samara +4, Urali +5, Omsk +6, Novosibirsk/Krasnojarsk +7, Irkutsk +8 .. Kamčatka +12;
#19

19) Motore Ora Legale alle 01:00 UTC per Unione Europea, Regno Unito (Londra GMT+0/BST+1), Balcani, Azzorre e Canarie

Nel continente europeo l'ora legale inizia simultaneamente l'ultima domenica di marzo alle 01:00 UTC e termina l'ultima domenica di ottobre alle 01:00 UTC: Regno Unito, Irlanda, Portogallo e le Isole Canarie spagnole (27.5°..29.5°N, -18.5°..-13.2°O) adottano UTC+0 d'inverno e UTC+1 d'estate (Londra GMT/BST); Europa Centrale e Balcani Occidentali (Berlino, Parigi, Sarajevo, Skopje) UTC+1/+2; le Isole Azzorre (36.8°..39.8°N, -31.5°..-24.8°O) operano in UTC-1/UTC+0; l'Islanda adotta UTC+0 permanente tutto l'anno.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché sebbene Londra, le Canarie, le Azzorre e l'Europa continentale abbiano offset di base diversi, vincolare le transizioni allo stesso istante delle 01:00 UTC evita slittamenti nelle notti di confine.
bool AbYazSaatiUtcAktifMi(utcAn): utcAn ∈ [MartSonPazar_01Utc, EkimSonPazar_01Utc);
Islanda → 0.0; Azzorre → abDst ? 0.0 : -1.0; Regno Unito/Portogallo/Canarie → abDst ? +1.0 : 0.0; Europa Centrale → +1/+2;
#20

20) Motori DST Separati per Libano (Sabato 22:00/21:00 UTC) e Israele (Venerdì 00:00 UTC, Protetto ≥ 2034)

Nel Mediterraneo orientale il Libano (Asia/Beirut) avanza l'ultima domenica di marzo alle 00:00 locali (sabato 22:00 UTC) e arretra l'ultima domenica di ottobre alle 00:00 locali (sabato 21:00 UTC). Israele (Asia/Jerusalem) avanza il venerdì precedente l'ultima domenica di marzo alle 02:00 locali (00:00 UTC) e arretra l'ultima domenica di ottobre alle 02:00 (sabato 23:00 UTC); inoltre, poiché vecchie tabelle tzdata su sistemi mobili obsoleti tralasciano le regole dopo il 2037, negli anni ≥ 2034 la regola deterministica interviene sia nello strato delle coordinate sia in quello dell'ID di fuso del sistema.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché legare Beirut e Haifa alla regola standard UE della domenica alle 01:00 UTC sfalserebbe di 1 ora gli orari nel venerdì e sabato di fine marzo; la protezione ≥ 2034 tutela le interrogazioni di calendario future.
LubnanYazSaatiUtcAktifMi(utcAn): utcAn ∈ [MartSonCts_22Utc, EkimSonCts_21Utc);
IsrailYazSaatiUtcAktifMi(utcAn): utcAn ∈ [SonPazarÖncesiCuma_00Utc, EkimSonCts_23Utc); // Obbligatorio ≥ 2034
#21

21) Palestina (Gaza, Hebron, Gerico, Qalqilya) DST Sat≥24 + Rinvio di Ramadan e Abbinamento all'Autorità Egiziana

Il poligono della Palestina comprende la Striscia di Gaza e le località cisgiordane Qalqilya/Tulkarem (34.96°E), Jenin, Nablus, Ramallah, Gerusalemme Est, Gerico ed Hebron; esclude punti fuori confine come Ascalona, Be'er Sheva ed Ein Gedi. L'ora legale ufficiale palestinese (Asia/Gaza, Asia/Hebron) inizia alle 02:00 del sabato 24 marzo o successivo (Sat≥24); se tale data cade nel mese di Ramadan viene rinviata al primo sabato di Shawwāl e termina alle 02:00 del sabato ≥ 24 ottobre. Nell'autorità automatica il codice PS è associato allo standard dell'Autorità Generale Egiziana (-19.5°/-17.5°).

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché negli anni in cui marzo ha 31 giorni intercorre una differenza di 7 giorni tra l'ultimo sabato di marzo e la regola ufficiale IANA 'Sat≥24'; inoltre, non anticipare l'ora durante il Ramadan è prassi ufficiale palestinese.
Errore comune / Nota di attenzione: Codificare l'ora legale palestinese come 'l'ultimo sabato di marzo' produce negli anni con marzo di 31 giorni (scegliendo il 31 marzo anziché il 24 marzo) uno scarto esatto di 1 settimana rispetto alla regola ufficiale Sat≥24.
int cmtGun = AyinTarihSonrasiIlkHaftaGunu(gregYil, 3, 24, DayOfWeek.Saturday); // Sat≥24
if (TryHicriRamazanSinirlariniBul(martCmt, out _, out DateTime sevvalBir)) baslangic = sevvalSonrasiCts; // PS → Otoriteler.Misir_GenelOtorite
#22

22) Ora Legale in Egitto (Ultimo Venerdì di Aprile – Ultimo Giovedì di Ottobre) e Confine Obliquo del Sinai (Retta Taba–Rafah)

In virtù della Legge n. 24 del 2023, l'Egitto passa all'ora legale UTC+3 l'ultimo venerdì di aprile alle 00:00 locali (giovedì 22:00 UTC) e rientra all'ora solare UTC+2 l'ultimo giovedì di ottobre alle 24:00 (giovedì 21:00 UTC). Nella penisola del Sinai, la retta di confine obliqua tra Taba sul golfo di Aqaba (34.89°E) e Rafah sulla costa mediterranea (34.25°E) (34.905 − (lat − 29.49)·0.395) separa la cittadina egiziana di Al-Qusaymah da Mitzpe Ramon nel Negev.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché tracciare il confine del Sinai con una scatola verticale su 34.90°E includerebbe il deserto del Negev nel fuso orario egiziano, generando errori di 1 ora nelle differenti settimane di transizione DST di aprile e ottobre.
MisirYazSaatiUtcAktifMi(utcAn): utcAn ∈ [NisanSonPersembe_22Utc, EkimSonPersembe_21Utc);
double sinaDoguSinir = 34.905 - (lat - 29.49) * 0.395; // Taba/Al-Qusaymah (EG) vs Eilat/Mitzpe Ramon (IL)
#23

23) Protezione UTC+3 Permanente per Giordania (Asia/Amman) e Siria (Asia/Damascus) ≥ 28 Ottobre 2022

La Giordania (inclusi Amman, Aqaba e Petra / Wadi Araba) e la Siria (inclusi Damasco, Aleppo, Daraa, Bosra e As-Suwayda) non sono tornate all'ora solare a fine ottobre 2022, adottando UTC+3 permanente tutto l'anno. Poiché le tabelle dei fusi orari di vecchi dispositivi Android e iOS non aggiornati possono tuttora riportare questi due paesi a UTC+2 in inverno, lo strato di risoluzione degli ID di fuso restituisce direttamente +3.0 h mediante il blocco di data ≥ 28 ottobre 2022.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così per impedire che, quando su vecchi telefoni è registrato l'ID Asia/Amman o Asia/Damascus, gli orari di preghiera slittino indietro di 60 minuti nei mesi invernali.
if (UrdunSuriyeKaliciUtc3IdMi(temizId) && yerelTarih ≥ new DateTime(2022, 10, 28)) return +3.0;
// Poligoni Petra/Wadi Araba (JO) e Daraa/As-Suwayda (SY) in UTC+3 permanente tutto l'anno
#24

24) Ritorno Orario del Ramadan nel Regno del Marocco (Decreto 2.18.855, UTC+1 → UTC+0) e Calendario Hijri di Riserva 2080+

Nel Regno del Marocco, per le date precedenti a settembre 2026 vige UTC+1 tutto l'anno ai sensi del decreto 2.18.855; soltanto la domenica precedente il mese islamico di Ramadan alle 02:00 UTC gli orologi vengono portati indietro di 1 ora a UTC+0 e riportati a UTC+1 la prima domenica all'inizio di Shawwāl alle 02:00 UTC. Per le interrogazioni di date lontane nel futuro o nel passato che superano il limite supportato dalla classe standard del calendario Umm al-Qura si attiva automaticamente un motore di calendario Hijri di riserva per evitare errori di limite.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché le normali regole gregoriane DST non possono rappresentare il cambio inverso specifico del Ramadan e il motore del calendario non deve andare in errore nei test oltre il 2029/2077.
Errore comune / Nota di attenzione: Invocare direttamente il componente standard di calendario Umm al-Qura senza controllo dell'intervallo di date produce un'eccezione fuori intervallo negli anni futuri o passati non supportati; per questo la riserva generale di calendario Hijri è indispensabile.
FasRamazanGeriSaatUtcAktifMi(utcAn): utcAn ∈ [RamazanOncesiPazar_02Utc, SevvalIlkPazar_02Utc) → UTC+0.0 (altri giorni UTC+1.0);
// Negli anni oltre il limite del calendario Umm al-Qura interviene il calcolatore Hijri di riserva
#25

25) Decreto del Marocco 2.26.530 (GMT+0 Permanente ≥ 20 Settembre 2026), Ceuta/Melilla e Retta di Confine con l'Algeria

Con decreto del Regno del Marocco n. 2.26.530 del 25 giugno 2026, a partire da domenica 20 settembre 2026 alle 01:00 UTC il Marocco e il Sahara Occidentale sono passati all'ora permanente GMT (UTC+0). Sulla costa settentrionale le enclavi spagnole di Ceuta [35.87°..35.92°N, -5.39°..-5.27°O] e Melilla [35.26°..35.33°N, -3.00°..-2.91°O] restano separate con l'ora legale UE (ES, UTC+1/+2); a sud-est Figuig/Bouarfa (MA) vengono isolate da Béchar/Tindouf (DZ, UTC+1 permanente) con una retta di confine obliqua.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così sia per applicare correttamente sui vecchi telefoni la normativa marocchina del GMT+0 permanente da settembre 2026, sia per evitare confusioni di fuso di 1–2 ore su Ceuta/Melilla o al confine algerino di Béchar.
Errore comune / Nota di attenzione: I modelli addestrati su dati datati e i telefoni non aggiornati possono continuare a ritenere il Marocco su UTC+1 anche dopo settembre 2026; inoltre Ceuta e Melilla sulla costa marocchina, pur ricadendo nel riquadro geografico, seguono l'ora della Spagna (UTC+1/+2).
if (utcAn ≥ new DateTime(2026, 9, 20, 1, 0, 0, DateTimeKind.Utc)) return 0.0; // Decreto 2.26.530 GMT+0 permanente
Ceuta & Melilla → ES (abYazSaati ? +2.0 : +1.0); Algeria (Béchar/Tindouf) → DZ (+1.0 permanente);
#26

26) Legge Iraniana UTC+3:30 Permanente ≥ 22 Settembre 2022, Confine Sarakhs/Zabol e Distinzione del Golfo (+3 vs +4)

Poiché l'Iran ha abolito l'ora legale nel settembre 2022, Asia/Tehran e il poligono iraniano restituiscono UTC+3.5 permanente tutto l'anno. A est, Sarakhs nel Khorasan (61.16°E, +3.5) viene separata da Serahs in Turkmenistan (+5.0) e Zabol nel Sistan (61.50°E, +3.5) dall'Afghanistan (+4.5) e dal Belucistan pakistano (+5.0) mediante gradini longitudinali precisi. Nel Golfo vengono distinti il valico saudita di Salwa (+3, SA), Qatar (+3, QA) e Bahrein (+3, BH) rispetto a Emirati Arabi Uniti e Oman (inclusa Musandam, +4).

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché la tabella Asia/Tehran su vecchi dispositivi può spostare erroneamente l'ora a +4.5 in primavera, mentre al confine Iran–Turkmenistan presso Sarakhs vi è uno scarto netto di 90 minuti nello spazio di pochi chilometri.
if (IranKaliciUtc35IdMi(temizId) && yerelTarih ≥ new DateTime(2022, 9, 22)) return +3.5;
Iran (Sarakhs lon ≤ 61.22°, Zabol lon ≤ 61.88°) → +3.5; Qatar/Bahrein/Arabia Saudita → +3.0; EAU/Oman → +4.0;
#27

27) Fusi Orari Frazionari a Mezz'Ora e Quarto d'Ora dell'Asia Meridionale (Afghanistan +4:30, India +5:30, Nepal +5:45, Myanmar +6:30)

I paesi dell'Asia meridionale che non adottano fusi a ora intera sono modellati con i rispettivi offset meridiani nazionali: Afghanistan riceve +4.5 (UTC+4:30), Pakistan +5.0, India e Sri Lanka +5.5 (UTC+5:30), Nepal +5.75 (UTC+5:45 — fuso di tre quarti d'ora), Bangladesh e Bhutan +6.0, Myanmar (Birmania) e Isole Cocos +6.5 (UTC+6:30); gli stati nord-orientali dell'India (Assam, Arunachal) sono protetti dai riquadri di Bangladesh (+6) e Cina (+8).

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché arrotondare a ore intere in questa regione causerebbe uno scarto sistematico di 15–45 minuti a Katmandu e di 30 minuti a Nuova Delhi, Kabul e Yangon.
Afghanistan → +4.5; Pakistan → +5.0; India e Sri Lanka → +5.5;
Nepal [26.35..30.45°N, 80.05..88.20°E] → +5.75; Bangladesh/Bhutan → +6.0; Myanmar → +6.5;
#28

28) Kazakistan Unificato a UTC+5 (Decisione del 1° Marzo 2024) vs Kirghizistan UTC+6 e Poligoni della Valle di Fergana

Il 1° marzo 2024 il Kazakistan ha unificato tutto il paese — incluse Almaty, Astana e il Kazakistan Orientale (Öskemen/Semey) — in un unico fuso UTC+5; il motore risolve sia il passaggio di data prima (+6) e dopo (+5) marzo 2024 sia le identità Asia/Almaty e Asia/Qostanay nei vecchi telefoni restituendo UTC+5. A sud, la Valle di Fergana dove si intrecciano Kirghizistan (Biškek, Osh, Jalal-Abad: UTC+6) con Uzbekistan e Tagikistan (Tashkent, Namangan, Khujand, Dušanbe: UTC+5) è separata da poligoni dedicati.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché i telefoni non aggiornati restituiscono ancora UTC+6 per Almaty, mentre subito a sud di Almaty il Kirghizistan continua effettivamente a usare UTC+6.
Errore comune / Nota di attenzione: Sebbene Almaty (76.9°E) sia situata in longitudine a est di Biškek (74.6°E), dalla decisione di marzo 2024 Almaty usa UTC+5 mentre la più occidentale Biškek usa UTC+6; un semplice calcolo longitudine/15 darebbe qui il risultato opposto.
if (KazakistanBirlesikUtc5Mi(temizId) && yerelTarih ≥ new DateTime(2024, 3, 1)) return +5.0;
KazakistanPoligonundaMi(lat, lon) → (utcAn ≥ 2024-02-29T18:00Z ? +5.0 : +6.0); Kirghizistan → +6.0; UZ/TJ/TM → +5.0;
#29

29) Fuso Unico Ufficiale della Cina Occidentale/Orientale (UTC+8: Kashgar, Khorgos, Fuyuan) e Mongolia (+7 / +8)

Sebbene la Cina continentale si estenda su cinque fasce geografiche di longitudine, in tutto il paese — incluse Kashgar (75.99°E), Ürümqi, Bole, il valico di Khorgos, Altay, Lhasa, Manzhouli nella Mongolia Interna e l'estremità orientale Fuyuan/Heihe — si adotta l'ora ufficiale di Pechino (UTC+8); varcando il confine da Khorgos al Kazakistan il salto di 3 ore da +8 a +5 viene intercettato dal poligono. In Mongolia invece le province occidentali (Bayan-Ölgii, Uvs, Khovd) ricevono UTC+7, mentre Ulaanbaatar e l'est ricevono UTC+8.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché nello Xinjiang il Sole raggiunge il mezzogiorno attorno alle 15:00 mentre a Fuyuan d'estate Imsak entra alle 23:28 (prima di mezzanotte); a entrambe le estremità è indispensabile il corretto poligono di confine tra Cina e paesi vicini.
Xinjiang/Tibet/Mongolia Interna/Manciuria (Kashgar, a est di Khorgos 80.42°E, Altay, Lhasa, Heihe, Fuyuan) → CN (+8.0);
Mongolia: province occidentali (Bayan-Ölgii/Uvs/Khovd) → +7.0; Centro ed Est (Ulaanbaatar) → +8.0;
#30

30) Poligoni dello Stretto di Malacca (Sumatra +7 vs MY/SG +8) e Kalimantan Centrale in Borneo (WIB +7 vs WITA +8)

Nel Sud-est asiatico, Sumatra (Medan, Pekanbaru, Dumai: ID, WIB +7) viene separata dalla penisola malese e da Singapore (Kuala Lumpur, Penang, Johor: MY/SG, +8) tramite la retta obliqua dello Stretto di Malacca. Sull'isola del Borneo le province indonesiane del Kalimantan Occidentale (Pontianak) e del Kalimantan Centrale (Palangkaraya, Sampit, Pangkalan Bun, Muara Teweh) usano WIB (UTC+7), mentre il Kalimantan Meridionale/Orientale/Settentrionale (Banjarmasin, Balikpapan, Samarinda) con Sarawak/Sabah della Malesia e Brunei usano UTC+8.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché dividere l'isola del Borneo con un meridiano rettilineo assegnerebbe erroneamente Palangkaraya (113.9°E), capitale del Kalimantan Centrale, al fuso UTC+8 spostando gli orari di 1 ora in avanti.
EndonezyaSaatDilimiBul(lat, lon): WIB (+7.0) → lon ∈ (-180.0, 114.40) || (lat ∈ [-2.25, 0.80] && lon ∈ [114.40, 115.80) && (lat ≤ -1.40 || lon ∈ [114.40, 115.35)));
WITA (+8.0): lon ∈ [114.40, 124.80) || Sulawesi Settentrionale [0.80..1.85°N, ≤125.35°E] || Timor Ovest (lat ≤ -8.00, lon ∈ (-180.0, 125.10)); a est WIT (+9.0);
#31

31) Sulawesi Settentrionale (WITA +8), Molucche/Papua (WIT +9) e Timor Est + Exclave di Oecusse (TL UTC+9)

Nell'est dell'Indonesia, la penisola di Sulawesi Settentrionale (Manado, Bitung, Gorontalo: 124°–125.3°E), pur trovandosi più a est in longitudine, appartiene al fuso WITA (UTC+8); più a est le Molucche (Ambon, Ternate) e la Papua Occidentale (Jayapura, Merauke) ricevono WIT (UTC+9). Sull'isola di Timor, Timor Ovest indonesiano (Kupang, Atambua) usa UTC+8, mentre lo Stato indipendente di Timor Est (metà orientale principale con Dili ed exclave costiera di Oecusse dentro Timor Ovest) opera tutto l'anno su UTC+9 con l'autorità MWL.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché assegnare UTC+9 con un unico riquadro a est di 124°E anticiperebbe di 1 ora sia Sulawesi Settentrionale (Manado) sia Timor Ovest (Kupang); trascurare l'exclave di Oecusse genererebbe invece 1 ora di ritardo sulla costa di Timor Est.
Timor-Leste (TL, +9.0): (lat ∈ [-9.50, -8.13] && lon ∈ [124.95, 127.35] && (lat ≥ -9.05 || lon ≥ 125.08)) || Oecusse(lat ∈ [-9.38, -9.15], lon ∈ [124.18, 124.48]);
Sulawesi Settentrionale (lat ∈ [0.80, 1.85], lon ≤ 125.35) e Timor Ovest (Kupang) → ID (+8.0); Molucche e Papua → ID (+9.0);
#32

32) Fusi dell'Australia (Eucla +8:45, Broken Hill), Lord Howe (+10:30/+11:00) e Chatham (+12:45/+13:45)

In Australia vengono risolti distintamente Australia Occidentale (+8), la regione di confine di Eucla (+8.75), Territorio del Nord (+9.5, senza DST), Australia Meridionale insieme a Broken Hill nel NSW (+9.5 inverno / +10.5 estate), Queensland (+10, senza DST) e NSW/Victoria/Tasmania (+10/+11). L'Isola di Lord Howe (-31.9°..-31.4°S, 158.9°..159.3°E), unico luogo al mondo che avanza di soli 30 minuti in estate, riceve +10.5 in inverno e +11.0 in estate tramite una regola DST speciale di 30 min; accanto alla Nuova Zelanda (+12/+13), le Isole Chatham adottano +12.75 in inverno e +13.75 in estate.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché collegare lo scarto estivo di 30 minuti dell'Isola di Lord Howe alla funzione DST australiana standard da +1 ora sposterebbe tutti gli orari di 30 minuti avanti nei mesi estivi.
Lord Howe [-31.9..-31.4, 158.9..159.3] → LordHoweYazSaatiUtcAktifMi(safTarih) ? +11.0 : +10.5;
Eucla → +8.75; Broken Hill [-32.2..-31.7, lon ≤ 141.7] → AvustralyaDilimi(+9.5); Chatham → Nuova Zelanda +12.75/+13.75;
#33

33) Fusi Orari del Sud America: Brasile (-5/-4/-3/-2), Paraguay (≥ 6 Ott 2024 -3) e Aysén/Magallanes in Cile

In Sud America il Brasile è suddiviso in 4 fusi ufficiali: Acre e Amazonas Occidentale (Rio Branco, Cruzeiro do Sul, Tabatinga, Eirunepé: UTC-5), Centro-Ovest (Manaus, Cuiabá, Porto Velho, Boa Vista: UTC-4), Brasile Orientale (San Paolo, Brasilia, Rio, Belém: UTC-3) e Fernando de Noronha (-2). Il Paraguay è passato a UTC-3 permanente tutto l'anno con la legge del 6 ottobre 2024; in Cile Santiago usa -4 in inverno / -3 in estate, mentre le regioni meridionali di Aysén e Magallanes (Punta Arenas, lat ≤ -43.5°) adottano UTC-3 permanente tutto l'anno.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché considerare il Brasile tutto su UTC-3 produrrebbe 1 ora di errore a Manaus e 2 ore a Rio Branco e Tabatinga; inoltre la legge paraguaiana dell'ottobre 2024 può mancare nelle tabelle tzdata dei vecchi smartphone.
if (ParaguayKaliciUtc3IdMi(temizId) && yerelTarih ≥ new DateTime(2024, 10, 6)) return -3.0;
BrezilyaSaatDilimiBul(lat, lon) → Acre/AmazonasOcc -5, Manaus/Cuiabá -4, Brasilia -3; Cile Aysén/Magallanes → -3.0 permanente;
#34

34) Eccezioni del Nord America (Arizona vs Navajo, Sonora, Saskatchewan, Yukon, Terranova) e Groenlandia

In Nord America sono definite singolarmente le eccezioni statali e dei territori nativi: l'Arizona (Phoenix, Tucson) non applica l'ora legale rimanendo su UTC-7 tutto l'anno, mentre la Nazione Navajo a nord-est (Window Rock/Kayenta; eccetto l'enclave Hopi di Tuba City) passa a UTC-6 in estate. Vengono preservati Sonora e Quintana Roo in Messico (-5), Saskatchewan (-6 permanente), Yukon (-7 permanente), Idaho meridionale/Boise (-7/-6) e Terranova/Newfoundland (-3.5/-2.5) in Canada; in Groenlandia Nuuk (-2/-1), Pituffik (-4/-3) e Danmarkshavn (0) sono distinti dalla stazione canadese di Alert (-5/-4).

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché fasce longitudinali grossolane in Nord America produrrebbero in estate uno scarto di 1 ora a Phoenix, Regina e Whitehorse, di 30 minuti a Terranova e di 2 ore a Nuuk in Groenlandia.
Arizona → -7.0 permanente (eccetto Navajo [lat ≥ 35.45°N, lon ≥ -111.65°O; escl. Hopi [35.55..36.05°N, -110.85..-110.15°O]] → -7/-6); Saskatchewan → -6.0 permanente; Yukon → -7.0 permanente;
Terranova → -3.5/-2.5; Groenlandia Nuuk → -2/-1 (Pituffik -4/-3, Danmarkshavn 0.0) vs Alert (CA -5/-4);
#35

35) Aleutine Occ./Or. (Attu e Adak), Stretto di Bering (Čukotka vs St. Lawrence), Kiribati (+14) e Meridiano Oceanico

Lungo la Linea Internazionale del Cambio di Data, sia la parte delle Isole Aleutine nell'emisfero occidentale (-180°..-169.0°O, Adak) sia l'estremità occidentale di Attu che sporge a est di +180° (172°E..180°E) ricevono paese USA (US, ISNA) e ora legale Hawaii-Aleutine (-10/-9). Nello Stretto di Bering sono separate la Čukotka russa (Uelen/Provideniya: RU, +12 permanente) dall'isola statunitense di St. Lawrence (Gambell: US, Alaska -9/-8); Kiritimati riceve +14, Apia +13 e i punti in mare aperto vengono risolti col fuso astronomico [-12, +12].

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché pur trovandosi a longitudine +173°E, l'isola di Attu non segue l'ora russa (+12) ma quella statunitense (-10/-9), mentre Gambell proprio dirimpetto alla Čukotka usa l'ora dell'Alaska (-9/-8); sbagliare sponda causerebbe 21 ore di errore.
Errore comune / Nota di attenzione: Si ritiene comunemente che ogni punto nell'emisfero orientale (longitudine +) riceva un fuso UTC positivo; tuttavia le isole di Attu e Shemya a +173°E sono territorio statunitense e si trovano nel fuso negativo UTC-10/-9.
Aleutine: lat ∈ [51.0, 54.0] && (lon ∈ [172.0, 180.0] || lon ∈ [-180.0, -169.0)) → US (-10/-9); Čukotka → RU (+12) vs St. Lawrence → US (-9/-8);
Kiritimati → +14.0; Riserva Mare Aperto → Math.Clamp(Math.Round(Sarmala180(lon) / 15.0, AwayFromZero), -12.0, 12.0);
#36

36) Impronta Univoca UTC su 9 Giorni, Firma della Cache v6 e Verifica DST Sub-Minuto a 3 Parametri

Il generatore dell'impronta oraria su nove giorni campiona gli offset locali agli istanti 00:00 UTC e 12:00 UTC per i 9 giorni da d-1 a d+7 e li memorizza con la firma di cache v6. Ogni giorno viene risolto nel fuso di riferimento di mezzogiorno e poi i 6 orari vengono proiettati singolarmente da UTC → ora locale a muro; se un orario come 01:59:40 supera la soglia DST delle 02:00/03:00 per arrotondamento al minuto, il verificatore DST sub-minuto allinea il suo minuto e il fuso registrato al nuovo fuso subito prima della conversione in testo.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché nella notte del cambio primaverile, quando 01:59:40 CET sale alle 02:00 per arrotondamento a :30 o Ceiling, le 02:00 non esistono (passano direttamente alle 03:00 CEST); il controllo DST sub-minuto mantiene coerente anche questo istante di confine.
YuvarlanmisDstDilimiDogrula(cikisMi: imsakCikisYuvarla, ref d.netImsakDakika, ref d.imsakSaatDilimi); // Ciascuno dei 6 orari secondo la propria direzione
d.imsakStr = FikhiGuvenliSaatMetnineCevir(d.netImsakDakika, imsakTemkin, cikisVaktiMi: imsakCikisYuvarla);
#37

37) Albero Decisionale Automatico delle Autorità I: Diyanet (TR, CY, AZ, Balcani), Umm al-Qura (Golfo) e MABIMS

In modalità autorità automatica il codice paese ISO della posizione viene risolto dai poligoni offline e associato all'ente ufficiale locale: Turchia (TR), RTNC / Cipro (CY), Azerbaigian (AZ) e la fascia islamica balcanica (BA, AL, XK, MK, BG, ME) adottano il criterio Diyanet (DİYK); Arabia Saudita (SA), EAU (AE), Qatar (QA), Kuwait (KW), Bahrein (BH), Oman (OM) e Yemen (YE) adottano Umm al-Qura (La Mecca); Indonesia (ID), Malesia (MY), Singapore (SG) e Brunei (BN) adottano il criterio MABIMS (KEMENAG/JAKIM).

Motivo (Perché abbiamo fatto così): Abbiamo fatto così per consentire al viaggiatore di passare automaticamente all'istituzione ufficiale compatibile con gli adhān delle moschee locali del paese visitato senza dover cercare impostazioni tecniche.
TR, CY, AZ, BA, AL, XK, MK, BG, ME → Otoriteler.Diyanet;
SA, QA, BH, KW, AE, OM, YE → Otoriteler.Ummu_l_Kura;   ID, MY, SG, BN → Otoriteler.Kemenag_GuneydoguAsya;
#38

38) Albero Decisionale Automatico delle Autorità II: Karachi (Asia Centrale/Meridionale), Egitto (EG, PS, Levante), ISNA e MWL

Nel secondo ramo dell'albero decisionale, Pakistan (PK), Afghanistan (AF), Bangladesh (BD), India (IN), Nepal, Sri Lanka, Maldive e i paesi dell'Asia Centrale (UZ, KZ, KG, TJ, TM) si collegano all'Università di Scienze Islamiche di Karachi (-18°/-18°, ʿAṣr al-Thānī +2 ombre); Egitto (EG), Palestina (PS), Levante (SY, JO, LB) e la fascia Nord/Est Africa (LY, TN, DZ, SD, SS, NG, ET, ER, KE, UG, TZ, SO, DJ, ZA) all'Autorità Generale Egiziana (-19.5°/-17.5°); USA (US) e Canada (CA) a ISNA (-15°/-15°); Europa, Iraq (IQ — conformità alla fascia -18° del Diwān del Waqf Sunnita), Iran (IR), Maghreb Occidentale (MA, MR, SN), Asia Orientale e gli altri paesi a MWL (-18°/-17°).

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché in Asia Centrale/Meridionale prevale ʿAṣr al-Thānī (+2 ombre), nel Levante e nella fascia africana l'Autorità Egiziana, in Nord America ISNA, e in Europa, Iraq, Iran e Maghreb Occidentale MWL nella fascia di -18° concorda con lo standard più diffuso delle moschee.
PK, IN, BD, AF, LK, NP, MV, UZ, KZ, KG, TJ, TM → Otoriteler.Karaci_Hanefi; // ʿAṣr al-Thānī (+2 ombre)
EG, PS, SY, JO, LB, LY, TN, DZ, SD..ZA → Otoriteler.Misir_GenelOtorite;   US, CA → Otoriteler.ISNA_KuzeyAmerika;   IQ, IR e altri → Otoriteler.Musluman_Birlik;
#39

39) Matrice degli Angoli Crepuscolari e dei Margini di Precauzione/Tamkīn delle 7 Autorità Ufficiali (Incluso MABIMS Subuh -20° + 2 min)

Gli angoli crepuscolari e i minuti di precauzione (tamkīn) [Imsak, Sorgere, Mezzogiorno, Pomeriggio, Tramonto, Notte] delle autorità ufficiali sono:

• Diyanet (DİYK): Imsak -18°, ʿAṣr +1 (ʿAṣr al-Awwal), ʿIshāʾ -17° (-16° + stima estiva nella fascia |φ| ≥ 45°), Tamkīn [0, -7, +5, +4, +7, 0] min

• MWL: -18° / +1 / -17°, Tamkīn 0 min | ISNA: -15° / +1 / -15°, Tamkīn 0 min | Karachi: -18° / +2 (ʿAṣr al-Thānī) / -18°, Tamkīn 0 min

• Umm al-Qura (La Mecca): Imsak -18.5°, ʿAṣr +1, ʿIshāʾ +90 min (+120 min in Ramadan), Tamkīn 0 min

• Autorità Egiziana: -19.5° / +1 / -17.5°, Tamkīn 0 min | MABIMS (KEMENAG/JAKIM/MUIS): Subuh -20°, ʿAṣr +1, ʿIshāʾ -18°, Precauzione [+2, -2, +2, +2, +2, +2] min

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché i consigli giuridici e gli osservatori ufficiali nel mondo adottano angoli differenti tra -15° e -20° e precauzioni consolidate come +2 min per Subuh di MABIMS per differenze atmosferiche regionali e di ijtihād.
Otoriteler.Diyanet → (-18f, 1f, -17f, [0, -7, +5, +4, +7, 0]);   Otoriteler.Kemenag_GuneydoguAsya → (-20f, 1f, -18f, [+2, -2, +2, +2, +2, +2]);
Otoriteler.Ummu_l_Kura → (-18.5f, 1f, yatsiSabit: +90/+120 min);   Otoriteler.Misir_GenelOtorite → (-19.5f, 1f, -17.5f);   Otoriteler.Karaci_Hanefi → (-18f, 2f, -18f);
#40

40) Vincoli di Sicurezza nelle Impostazioni Personali e Protezione Discreta {1, 2} per l'Ombra

Nella modalità Impostazioni Personali tutti i parametri personalizzati vengono vincolati entro limiti fisici e giuridici sicuri contro valori locali corrotti o estremi (NaN, Infinity, valori fuori intervallo): gli angoli crepuscolari di Imsak e ʿIshāʾ sono mantenuti in [-25.0°, -5.0°], i minuti di tamkīn dei 6 orari in [-60, +60] min, l'altitudine base dell'ambiente H₀ in [-450 m, 8850 m]; mentre il coefficiente d'ombra di ʿAṣr assume unicamente valori discreti {1f (ʿAṣr al-Awwal), 2f (ʿAṣr al-Thānī)} conformemente al fiqh Hanafita e Sciafeita.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così per evitare che un dato corrotto nella cache produca NaN facendo fallire gli orari, o che si generino coefficienti decimali intermedi come 1.4 privi di riscontro nelle scuole Hanafita e Sciafeita.
imsak_derece = GuvenliPrefFloatAl(kisiselImsakAnahtari, -18f, -25f, -5f); // Il nome della chiave viene astratto al Passo 110
ikindi_golge = GuvenliPrefFloatAl(kisiselIkindiAnahtari, 1f, 1f, 2f) ≥ 1.5f ? 2f : 1f;
#41

41) Scelta tra ʿAṣr al-Awwal (+1 Ombra — Diyanet / al-Imāmayn / Sciafeita) e ʿAṣr al-Thānī (+2 Ombre — Hanafita / Imam al-Aʿẓam)

Tra le scuole supportate Hanafita e Sciafeita, l'inizio di ʿAṣr si distingue per il rapporto d'ombra: nella scuola Sciafeita e nell'opinione adottata (muftā bih) di al-Imāmayn Hanafiti (Imam Abū Yūsuf e Imam Muḥammad), inclusa la Presidenza Diyanet (ʿAṣr al-Awwal), ʿAṣr entra quando l'ombra supera fayʾ al-zawāl di 1 volta l'altezza (+1); nella sentenza adottata dell'Imam al-Aʿẓam Abū Ḥanīfa (ʿAṣr al-Thānī), entra quando raggiunge 2 volte (+2). La riga di ʿAṣr nel selettore offre tre posizioni nelle autorità ufficiali (predefinito dell'ente / +1 / +2) e selezione diretta +1 o +2 in modalità Personale.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così per evitare che il criterio ʿAṣr al-Awwal (+1 ombra) di Diyanet venga erroneamente ritenuto esclusivo della scuola Sciafeita, e per consentire a ogni utente di seguire l'ente locale per Fajr/Maghrib scegliendo il proprio ijtihād per ʿAṣr.
if (SeciliOtorite != Otoriteler.Kisisel) { if (ikindiMezhepModu == 1) ikindi_golge = 1f; else if (ikindiMezhepModu == 2) ikindi_golge = 2f; }
else → otorite_ayari.KisiselIkindiGolgeAyarla(hedefGolge); // In modalità Personale: 1f (ʿAṣr al-Awwal) ↔ 2f (ʿAṣr al-Thānī)
#42

42) Orizzonte Locale sugli Altipiani Interni (ΔH = 0) vs Orizzonte Ottico Personale sui Pendii Costieri (0.0347°·√ΔH)

Applicare direttamente la formula di depressione dell'orizzonte ricavata sul livello del mare (2.08'·√H ≈ 0.0347°·√H) alle città interne induce in errore: sugli altipiani come Erzurum (1900 m), Van (2400 m), Kahta (670 m), Denver (1609 m) o Quetta (1680 m), il terreno all'orizzonte si trova a una quota prossima a quella dell'osservatore (H ≈ H₀ → ΔH ≈ 0 m). Sui ripidi pendii costieri rivolti verso il mare (es. Uludağ o Babadağ), poiché H₀ = 0 m, si verifica invece una depressione dell'orizzonte pari al dislivello relativo ΔH = max(0, H − H₀).

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché usare la formula dell'orizzonte marino sugli altipiani interni assegnerebbe l'orario di Maghrib minuti dopo che il Sole è tramontato sotto l'orizzonte dell'altopiano; il modello relativo ΔH distingue correttamente la pianura in quota dal pendio costiero.
Errore comune / Nota di attenzione: Applicare direttamente la formula nautica 0.0347°·√H degli almanacchi ad altipiani interni come Erzurum (1900 m), Konya o Kahta è un errore frequente; poiché anche la piana circostante è elevata, l'ifṭār verrebbe indicato minuti dopo il tramonto reale.
double deltaH = rakimUfukDuzeltmesiAktif ? Math.Max(0.0, clamp(H, -450, 8850) - clamp(H0, -450, 8850)) : 0.0;
#43

43) Effetto di Valli, Crinali Montuosi e Alti Edifici sull'Orizzonte Reale Osservato

Nota di Trasparenza Topografica: Nelle valli delimitate a est e a ovest da alti crinali montuosi, l'ora locale apparente di sorgere/tramonto può discostarsi di diversi minuti dal calcolo su orizzonte piatto; per precauzione giuridica occorre osservare il margine locale.

L'equazione matematica dell'orizzonte (ΔH ≥ 0) modella un orizzonte aperto in cui l'osservatore domina i dintorni; viceversa, in una valle profonda, ai piedi dei monti o in insediamenti in cui l'orizzonte est/ovest è ostruito da alte creste o palazzi (es. valle del Çoruh ad Artvin, valli delle Alpi svizzere o tra grattacieli), l'orizzonte fisico locale sale sopra la linea degli 0°. In tali luoghi il Sole appare minuti più tardi o scompare prima dietro i monti; i calendari ufficiali adottano per l'intero distretto l'orizzonte aperto medio e il margine di precauzione.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché nessuna formula globale su smartphone può conoscere da sola la collina o l'edificio davanti alla finestra dell'utente; dichiarare apertamente questo limite topografico naturale e la saggezza del margine di precauzione è dovere di onestà scientifica.
// Presso le autorità ufficiali: rakimUfukDuzeltmesiAktif = false (ΔH = 0, orizzonte medio del distretto + precauzione ufficiale)
// Nelle valli strette e all'ombra dei monti, per l'ifṭār va osservato l'oscuramento dell'orizzonte / la precauzione del calendario locale
#44

44) Zenit d'Orizzonte Ufficiale (90°50') vs Rifrazione Barometrica all'Altitudine Base dell'Orizzonte (H₀ = H − ΔH) in Modalità Personale

Gli enti ufficiali assumono fisso l'angolo zenitale di 90°50' (90.833333°), somma della rifrazione standard al livello del mare (34') e del semidiametro solare medio (16'). Attivando invece l'Orizzonte Ottico Personale, il raggio solare tangente che giunge all'osservatore costiero in quota attraversa lo strato atmosferico più denso non sulla vetta (H), ma alla quota di base sfiorata dall'orizzonte (H₀ = H − ΔH); pertanto la rifrazione d'orizzonte viene scalata con la densità a H₀ e combinata con il semidiametro solare reale del giorno (s_☉) e con la parallasse orizzontale (π_☉).

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché per un osservatore che da un monte costiero di 2000 m guarda verso l'orizzonte marino a 0 m, il raggio tangente passa al livello del mare; ridurre la rifrazione con la pressione di 2000 m contraddirebbe il percorso fisico del raggio.
Errore comune / Nota di attenzione: A prima vista sembra corretto ridurre la rifrazione d'orizzonte usando la bassa pressione della vetta; tuttavia il raggio tangente all'orizzonte marino attraversa per intero lo strato atmosferico inferiore più denso (H₀ = 0 m).
ufukKirilmaDeg = barometrikUfukOlcekle ? (34.0 / 60.0) * BasincKirilmaCarpaniHesapla(max(-450, H - ΔH)) : (34.0 / 60.0);
ufukZenitDeg = barometrikUfukOlcekle ? (90.0 + gunesYaricapDeg + ufukKirilmaDeg - yatayParalaksDeg + ufukAlcalmaDeg) : 90.833333;
#45

45) Architettura di Minuti di Precauzione (Tamkīn / Iḥtiyāṭ) Direzionati Individualmente per i Sei Orari

Ciascun orario dispone di una propria componente indipendente di precauzione in base al verso giuridico di ingresso o uscita: per Diyanet si applica [Imsak 0, Sorgere -7, Mezzogiorno +5, Pomeriggio +4, Tramonto +7, Notte 0] min; nel sistema MABIMS (KEMENAG/JAKIM) [+2, -2, +2, +2, +2, +2] min; nelle autorità a precauzione zero [0, 0, 0, 0, 0, 0] min, mentre nelle Impostazioni Personali ogni orario è regolabile separatamente. La precauzione negativa al Sorgere del Sole (-7 min o -2 min) è una sicurezza di uscita anticipata per impedire che la preghiera di Fajr sconfini nel tempo sconsigliato (karāha) allo spuntare del Sole.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché l'orario di uscita costituito dal Sorgere del Sole e gli orari di ingresso costituiti da Mezzogiorno, Pomeriggio e Tramonto non possono ricevere precauzione nello stesso verso; definire un tamkīn indipendente nella propria direzione preserva la conformità ai calendari ufficiali.
double gunesTemkin = otorite_ayari.gunesVakitAyari; // Diyanet: -7 min, MABIMS: -2 min (precauzione di uscita anticipata)
double aksamTemkin = otorite_ayari.aksamVakitAyari; // Diyanet: +7 min, MABIMS: +2 min (precauzione di ingresso)
#46

46) Transizione Latitudinale Diyanet [44.5°..45.5°] (-17° → -16° ʿIshāʾ) e Rapporto Primavera/Estate ([δ_tam − 9.5°, δ_tam])

Nella fascia europeo centro-settentrionale (|φ| ≥ 45°; Berlino 52.52°N, Londra 51.51°N, Vienna, Parigi), il Consiglio Superiore degli Affari Religiosi (DİYK) applica tutto l'anno, inverno compreso, l'angolo crepuscolare -16.0° per ʿIshāʾ; per evitare salti nelle città sul parallelo 45° (Lione, Torino, Pola) viene eseguita una transizione di Hermite nella fascia [44.5°, 45.5°]. Affinché la stima estiva non scatti troppo presto in aprile restringendo gli orari di Berlino, ma operi appieno nelle notti bianche tra maggio e luglio, la soglia estiva piena è definita δ_tam = clamp(90° − |φ| − 18°, 6.0°, 20.5°) e la soglia iniziale max(0°, δ_tam − 9.5°).

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché attivare subito la stima estiva all'equinozio del 21 marzo (δ = 0°) anticiperebbe di 15–20 minuti gli orari di Imsak e ʿIshāʾ di Berlino e Londra in aprile rispetto al calendario ufficiale Diyanet.
etkinYatsiDerece = yatsi_derece + (-16.0 - yatsi_derece) * diyanetEnlemGecisOrani;   diyanetYazlikOran = diyanetEnlemGecisOrani * HermiteSmoothStep(δ_bas, δ_tam, yazDeklin);
#47

47) Durata della Stima Estiva Diyanet (Notte_netta − 10) · 0.25 ([20..80] min ʿIshāʾ, +10 min Imsak) e Miscela di Prossimità alla Radice

Nella stima estiva Diyanet per |φ| ≥ 45°, la durata non si ricava dalla notte astronomica grezza bensì come un quarto della notte netta compresa tra il Maghrib con precauzione di oggi e il Sorgere del Sole con precauzione di domani: l'intervallo di stima per ʿIshāʾ è clamp((Notte_netta − 10) · 0.25, 20, 80) min nella banda [20, 80] min, mentre l'intervallo per Imsak è esattamente +10 min maggiore, ossia [30, 90] min. Prima della perdita della radice astronomica viene applicata una miscelazione morbida di Hermite con pesi [obiettivo − 4.5°, obiettivo] sul minimo notturno e [obiettivo, obiettivo + 2.5°] nell'oscurità invernale.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché un rapporto grezzo come Notte/3 terrebbe ʿIshāʾ a 80 min in una breve notte estiva berlinese di 250 min, laddove la formula ufficiale DİYK (Notte_netta − 10)/4 produce 60 min per ʿIshāʾ e 70 min per Imsak, dividendo equilibratamente la notte.
geceGunesAksamSabitDk = Math.Clamp((yarinSabitDilimNetGunes - d.netAksamDakika) + 1440.0, 20.0, 1420.0);
diyanetTakdirYatsiAralikDk = Math.Clamp((geceGunesAksamSabitDk - 10.0) * 0.25, 20.0, 80.0);   diyanetTakdirImsakAralikDk = diyanetTakdirYatsiAralikDk + 10.0;
#48

48) Regola delle Tre Stagioni Diyanet nella Fascia Polare oltre 62° (Tromsø: Stagione Normale, Inverno ±150 min, Estate 19 h 45 min)

Nelle città della fascia |φ| ∈ (62.0°, 90.0°] (Tromsø 69.65°N, Reykjavík 64.15°N, Longyearbyen 78.22°N), il criterio DİYK opera in tre stagioni distinte: (1) Primavera e Autunno (durata del giorno 300..1173 min): viene conservata la latitudine reale e il Sole sorge e tramonta al proprio orizzonte effettivo. (2) Inverno Polare (notte polare o durata del giorno sotto 300 min = 5 ore): con transizione di Hermite in [294..300 min] si stimano Sorgere = Mezzogiorno − 150 min e Tramonto = Mezzogiorno + 150 min. (3) Sole di Mezzanotte (giorno oltre 1173..1185 min): ci si collega a mezzogiorno ± 592.5 min (durata massima 19 h 45 min) e alla proiezione Aqrab al-Bilād di ±62.0°.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché copiare una latitudine fissa di ±62° tutto l'anno anticiperebbe di ~30 minuti l'orario di Maghrib a Tromsø in aprile e settembre quando il Sole è ancora sopra l'orizzonte.
Errore comune / Nota di attenzione: Si pensa spesso che nella fascia polare sopra 62° vengano copiati gli orari di 62° per tutti i 365 giorni dell'anno; in realtà in primavera e in autunno il Sole sorge e tramonta normalmente e Tromsø usa il proprio orizzonte reale.
double wKis = kutupGecesi ? 1.0 : (1.0 - HermiteSmoothStep(294.0, 300.0, netAksam - netGunes));
netGunes = Lerp(netGunes, netOgle - 150.0, wKis);   netAksam = Lerp(netAksam, netOgle + 150.0, wKis);
#49

49) Ponte di Continuità Equinoziale Diyanet al Vertice Polare |φ| ∈ (84°, 90°] (Hermite [-7.5°, +6.5°])

Attorno al polo geografico esatto (|φ| ∈ (84°, 90°], es. 89.9°N o la Stazione del Polo Sud), poiché agli equinozi la durata del giorno può balzare in un solo giorno da 0 minuti a 24 ore, si verificherebbe un salto di ~7.3 ore in un giorno tra il regime invernale di 5 ore e quello estivo di 19 h 45 min. Con un peso latitudinale [84.0°, 86.5°] che non tocca minimamente gli insediamenti con |φ| ≤ 84° (Longyearbyen, Tromsø) e un ponte di declinazione [-7.5°, +6.5°], la transizione equinoziale si distende dolcemente su ~36 giorni.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così affinché nella tabella annuale di 365 giorni a 89.9° di latitudine non rimanga alcun salto di 7 ore agli equinozi di marzo e settembre, senza alterare in alcun modo i calendari delle città sotto 84°.
double wYuksekKutup = HermiteSmoothStep(84.0, 86.5, Math.Abs(dEnlem)); // DiyanetKutupGunduzSiniriAyarla
double sKutup = HermiteSmoothStep(-7.5, 6.5, (dEnlem ≥ 0.0 ? 1.0 : -1.0) * zevalDeclinDeg);
#50

50) Limite Polare Stagionale Fuori Diyanet e Risoluzione della Latitudine Effettiva Giorno per Giorno (d-1, d, d+1)

Nelle autorità diverse da Diyanet, il limite tangente del giorno polare e della notte polare invernale viene risolto separatamente per la declinazione propria di ogni giorno (d-1, d e d+1) mediante la declinazione traslata (sign(φ)·δ + angolo di correzione dell'orizzonte) e associato alla latitudine effettiva. Ai poli geografici esatti ±90.000000° convergono tutti i meridiani, portando l'orizzonte fisico Est/Ovest in singolarità; il motore preserva la continuità matematica, mentre sul piano giuridico (fiqh) gli orari al polo vanno stimati secondo la località normale più vicina.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché copiare la latitudine effettiva di oggi ai giorni d-1 e d+1 produrrebbe discontinuità artificiali nelle durate notturne del mattino e della sera nel giorno di ingresso nella tangenza polare; risolvere ogni giorno con la propria declinazione preserva la continuità intergiornaliera.
etkinEnlemDun = KutupEtkinEnlemCoz(dEnlem, ozetDun.sunDeclinDeg, ...); // d-1, d e d+1 risolti separatamente
etkinEnlemYarin = KutupEtkinEnlemCoz(dEnlem, ozetYarin.sunDeclinDeg, ...);
#51

51) Smussamento Iperbolico C∞ della Latitudine Effettiva nell'Alto Artico (75°..81°, Alert 82.5°N)

Mentre nelle località subpolari (Tromsø 69.65°N) l'arrotondamento del nucleo di latitudine effettiva è mantenuto a 0.12° e il margine di sicurezza a 0.30°, nelle stazioni dell'Alto Artico (Alert 82.50°N, Eureka), per ammorbidire la pendenza radente dell'equinozio, il peso di Hermite nella fascia [75.0°, 81.0°] porta il nucleo a 0.62° e il margine di sicurezza a 0.52°, trasformando il gomito brusco min(|φ|, latitudine limite) in una transizione iperbolica liscia C∞ con fattore 1.60·w.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché in punti dell'Alto Artico come Alert a 82.5°N un vincolo rigido produrrebbe un brusco cambio di pendenza nell'ora di sorgere/tramonto nel giorno tangente primaverile; la transizione iperbolica rende fluida la curva.
double wYuksekArktik = HermiteSmoothStep(75.0, 81.0, Math.Abs(dEnlem));   double yumusakK = 1.60 * wYuksekArktik;
farkEnlem = |φ| - sinirEnlem;   yumusakEtkin = Clamp(|φ| - 0.5 * (farkEnlem + Sqrt(farkEnlem² + yumusakK²)), 45.0, 89.8);
#52

52) Miscela Crepuscolare Anticipata [obiettivo − 8° .. obiettivo] nell'Estate Polare Fuori Diyanet (|φ| ∈ (65.5°, 90°])

Nella fascia polare sopra 68° (es. Alert 82.5°N o 86°N, MWL/ISNA), quando dopo l'equinozio di primavera l'altezza minima notturna si avvicina tangenzialmente al limite di -18°, la derivata d(arccos)/dδ diventa estremamente ripida, causando un crollo di ~90 min della radice astronomica pura di Fajr/ʿIshāʾ negli ultimi 3 giorni e un salto nella direzione opposta alla rottura della radice. Con un peso polare [65.5°, 68.5°] che non tocca le città sotto |φ| ≤ 65.5° (Londra, Berlino, Oslo, Reykjavík), si esegue una transizione morbida verso la ripartizione angolare notturna nella banda [obiettivo − 8°, obiettivo].

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché alle medie-alte latitudini europee (48°–65°) la radice astronomica reale deve restare intatta fino all'ultimo giorno, mentre nella fascia polare 70°–89° va impedito il collasso verticale della pendenza alla tangenza equinoziale.
double wKutup = HermiteSmoothStep(65.5, 68.5, Math.Abs(dEnlem));
double wErken = wKutup * HermiteSmoothStep(hedefAci - 8.0, hedefAci, geceMinYukseklikDeg);
#53

53) Rampe Inverse di Oscurità Profonda nell'Inverno Polare ([obiettivo, obiettivo + 2.0°] e [obiettivo, obiettivo + 4.0°] oltre 65.5°)

Nel profondo inverno polare, quando il Sole rimane anche a mezzogiorno nella fascia crepuscolare sotto l'orizzonte e la sua altezza massima diurna (α_zeval) si avvicina dall'alto all'angolo crepuscolare di Fajr o ʿIshāʾ (es. -18° o -15°), la radice astronomica si spezza stavolta sul lato del mezzogiorno. Per evitare salti improvvisi alle 00:00 o a mezzogiorno, α_zeval viene raccordata alla ripartizione angolare notturna tramite una rampa inversa di Hermite nella banda [obiettivo, obiettivo + 2.0°] per |φ| ≤ 65.5° e [obiettivo, obiettivo + 4.0°] nella fascia polare |φ| ∈ (65.5°, 90°].

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché la notte bianca estiva controlla soltanto l'altezza minima notturna (α_min), mentre nella notte polare invernale occorre una rampa inversa dedicata quando la culminazione di mezzogiorno (α_zeval) scende sotto l'angolo crepuscolare.
double ustBant = Math.Abs(dEnlem) ≤ 65.5 ? 2.0 : 4.0;
double karanlikOran = 1.0 - HermiteSmoothStep(hedefSafakAci, hedefSafakAci + ustBant, d.zevalYukseklikDeg);
#54

54) Conversione dal Calendario Gregoriano al Numero di Giorno Giuliano Intero a 64 Bit (JDN)

Le equazioni orbitali del Sole richiedono un contatore continuo dei giorni indipendente dalla durata dei mesi (28/29/30/31 giorni) e dalle regole degli anni bisestili. Mediante l'algoritmo intero di Fliegel–Van Flandern / Jean Meeus la data gregoriana (Anno, Mese, Giorno) viene convertita nel Numero di Giorno Giuliano (JDN) intero long a 64 bit.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché nelle conversioni di calendario basate su Math.Floor decimale possono insorgere derive frazionarie alle date limite; la divisione intera a 64 bit genera un indice di giorno stabile in tutti i secoli.
long jdn = gun + (153 * m + 2) / 5 + 365L * y + y / 4 - y / 100 + y / 400 - 32045;
#55

55) Sottrazione Intera (JDN − 2451545L) per Evitare Perdita di Mantissa IEEE-754 e Giorni d2000

Nei codici astronomici classici si costruisce prima un grande numero decimale come JD ≈ 2,461,357 e poi si sottrae 2451545.0; tale operazione spreca nella parte intera 21 dei 53 bit di mantissa di un double a 64 bit, degradando la precisione numerica. Nel nostro motore il giorno d'epoca J2000.0 (2451545L) viene sottratto già nella fase intera long a 64 bit e la frazione oraria UTC del giorno si somma direttamente a questa piccola differenza.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così per evitare il rumore di arrotondamento IEEE-754 generato dalla sottrazione di due grandi decimali ravvicinati e salvaguardare la stabilità numerica dell'asse temporale nelle iterazioni di ricerca binaria.
Errore comune / Nota di attenzione: Ritenere che il tipo double a 64 bit sia sempre sufficiente ed eseguire JD − 2451545.0 in virgola mobile spreca 21 bit di mantissa a causa della parte intera da 2.46 milioni; la sottrazione in intero (long) azzera tale perdita.
double d2000Gun = (jdnFarkiJ2000 - 0.5) + kesirliGun;
#56

56) Modello Continuo ΔT = TT − UT1, Natura Predittiva a Lungo Termine, Giorno delle Effemeridi (JDE) e Secolo (T)

Poiché la rotazione della Terra sul proprio asse rallenta in modo irregolare per l'attrito mareale e l'accoppiamento nucleo-mantello, tra il Tempo di Rotazione Terrestre (UT1/UTC) e il Tempo Atomico Dinamico (TT) usato dalle effemeridi planetarie si forma uno scarto ΔT. Per non introdurre salti a gradino a Capodanno, ΔT è calcolato in modo continuo dal numero d2000Gun (~69.2 s a metà 2026). Anche se nei decenni futuri l'accelerazione della rotazione può variare di qualche secondo, uno scarto di 5 s su ΔT produce nell'orbita solare un effetto inferiore a 0.2 secondi.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché omettere del tutto la correzione ΔT lascerebbe la longitudine eclittica del Sole indietro di ~70 secondi di moto orbitale (~2.8 secondi d'arco); il modello continuo corregge questa deriva ed evita discontinuità di inizio anno.
double ondalikYil = 2000.0 + (d2000Gun + 0.5) / 365.2425;   double deltaTSaniye = Math.Clamp(69.18 + 0.22 * (ondalikYil - 2026.0), 62.0, 180.0);
double jde2000Gun = d2000Gun + (deltaTSaniye / 86400.0);   double T = jde2000Gun / 36525.0;
#57

57) Longitudine Media Geometrica del Sole (L₀) e Protezione Mod Semiaperto IEEE-754 [0°, 360°)

L'angolo di longitudine eclittica in cui si troverebbe il Sole rispetto all'equinozio istantaneo se la Terra percorresse un'orbita circolare a velocità angolare costante (L₀) viene calcolato con il polinomio di secondo grado di Jean Meeus (Capitolo 25). Affinché per valori in virgola mobile negativi minuscoli (es. -1e-16) l'operazione a − b·Floor(a/b) non restituisca esattamente 360.0°, nella funzione Mod si applica il vincolo semiaperto [0.0, b).

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché sia la longitudine eclittica vera (☉_true) sia l'Equazione del Tempo (EoT) hanno come fase di riferimento principale la longitudine media L₀; Mod(360°) semiaperto impedisce traboccamenti sugli angoli di confine.
double Mod(double a, double b) { double r = a - b * Math.Floor(a / b); return (r ≥ b || Math.Sign(r) == -1) ? 0.0 : r; }
L0 = Mod(280.46646 + T * (36000.76983 + T * 0.0003032), 360.0);
#58

58) Anomalia Media Geometrica del Sole (M)

L'Anomalia Media Geometrica (M), ossia l'angolo medio spazzato sull'orbita ellittica terrestre a partire dal perielio (il punto più vicino al Sole, all'inizio di gennaio), viene calcolata sia in gradi sia in radianti.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché l'Equazione del Centro di Keplero, che determina l'accelerazione orbitale a gennaio e il rallentamento a luglio, opera direttamente sulla serie armonica di seni di questo angolo M.
M = Mod(357.52911 + T * (35999.05029 - 0.0001537 * T), 360.0);
#59

59) Eccentricità Secolare dell'Orbita Terrestre (e)

Il coefficiente di eccentricità (e ≈ 0.016708), che indica quanto l'orbita terrestre sia schiacciata rispetto a una circonferenza, decresce lievemente di secolo in secolo per l'attrazione gravitazionale a lungo periodo degli altri pianeti e viene aggiornato istantaneamente con il polinomio nel secolo giuliano (T).

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché seguire la variazione secolare anziché usare un coefficiente e fisso previene derive a lungo periodo sia nella distanza Terra–Sole (R_AU) sia nell'ampiezza dell'Equazione del Tempo.
e = 0.016708634 - T * (0.000042037 + 0.0000001267 * T);
#60

60) Equazione del Centro di Keplero (C) e Anomalia Vera del Sole (ν = M + C)

Secondo la legge delle aree di Keplero, la differenza tra la posizione angolare effettiva sull'orbita ellittica e il moto circolare medio (Equazione del Centro C, al massimo ±1.915°) viene risolta tramite le armoniche sin(M), sin(2M) e sin(3M), ricavando da essa l'angolo di anomalia vera ν = Mod(M + C, 360°).

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché la serie sviluppata fino al 3.º termine armonico (sin 3M) risolve l'equazione chiusa di Keplero senza iterazioni con un'approssimazione numerica di ~0.01 secondi d'arco.
C = sin(M)*(1.914602 - T*(0.004817 + 0.000014*T)) + sin(2M)*(0.019993 - 0.000101*T) + sin(3M)*0.000289;
sunTrueAnom = Mod(M + C, 360.0);
#61

61) Calcolo della Distanza Istantanea Terra–Sole (R_AU)

Dall'equazione orbitale polare dell'ellisse, utilizzando l'anomalia vera (ν) e l'eccentricità (e), si calcola la distanza istantanea tra i centri di Terra e Sole in Unità Astronomiche (R_AU ∈ [0.9833, 1.0167] AU; minima all'inizio di gennaio, massima all'inizio di luglio).

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché il semidiametro apparente del disco solare, l'angolo di parallasse orizzontale e l'aberrazione annua della luce variano in proporzione inversa diretta con questa distanza istantanea R_AU.
R_AU = (1.000001018 * (1.0 - e * e)) / (1.0 + e * Math.Cos(DereceyiRadyana(sunTrueAnom)));
#62

62) Semidiametro Variabile del Disco Solare (s_☉ = 959.63″ / R_AU) e Parallasse Orizzontale (π_☉ = 8.794″ / R_AU)

Il raggio angolare apparente del disco solare in cielo (~16′17″ a gennaio, ~15′45″ a luglio) e l'angolo di parallasse orizzontale (~8.79″ ≈ 0.00244°) di un osservatore sulla superficie terrestre rispetto al centro della Terra si calcolano dividendo le costanti standard IAU per la distanza istantanea R_AU.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché nell'Orizzonte Ottico Personale lo zenit di sorgere/tramonto del lembo superiore, la durata del transito del disco all'istiwāʾ e la conversione dello zenit geocentrico in zenit topocentrico dipendono direttamente da questi due angoli dinamici.
gunesYaricapDeg = (959.63 / 3600.0) / sunRadVectorAu;
yatayParalaksDeg = (8.794 / 3600.0) / sunRadVectorAu;
#63

63) Perturbazione Longitudinale del Baricentro Terra–Luna (EMB, Δλ_Ay)

Il punto che descrive l'ellisse di Keplero attorno al Sole non è il centro della Terra isolatamente, bensì il centro di massa comune Terra–Luna (EMB). Poiché ogni mese sinodico di 29.53 giorni il centro terrestre compie attorno a questo baricentro un'oscillazione con raggio di ~4670 km, alla longitudine solare viene aggiunta la correzione sin(D) con ampiezza di ±6.4 secondi d'arco (±0.00179°).

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché trascurare la perturbazione del baricentro lunare lascerebbe una deviazione periodica di ~6.4 secondi d'arco nella longitudine solare alle fasi di primo e ultimo quarto.
Errore comune / Nota di attenzione: Usare la costante di elongazione lunare 350.74° delle vecchie fonti insieme al secolo J2000 (T) mescola le epoche J1900 e J2000; l'angolo iniziale corretto all'epoca J2000.0 è 297.8502°.
ayUzamaD = Mod(297.8502 + 445267.1115 * T - 0.00163 * T * T, 360.0);
ayBarysentrikDeg = 0.00179 * Math.Sin(DereceyiRadyana(ayUzamaD));
#64

64) Perturbazioni J2000.0 di Venere, Giove e Lungo Periodo (E) per la Longitudine Vera del Sole (☉_true)

Le perturbazioni gravitazionali di Venere e Giove sull'orbita terrestre e la fase planetaria a lungo periodo di Newcomb vengono calcolate con gli angoli iniziali J1900 di Meeus (AFC Cap. 18: 153.23°, 216.57°, 312.69°, 231.19°) traslati esattamente all'epoca J2000.0 tramite la trasformazione T_1900 = T + 1 (A = 351.9841°, B = 254.0782°, C = 157.0477°, E = 231.19° + 20.20° = 251.39°), ottenendo ☉_true = Mod(L₀ + C + Δλ_gez + Δλ_Ay, 360°).

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché moltiplicare costanti di fase pubblicate per J1900 (JD 2415020.0), come 231.19°, direttamente per il secolo J2000.0 (T) produce uno sfasamento di 100 anni (+1 secolo); la traslazione T_1900 = T + 1 allinea tutti i termini sull'asse J2000.0.
Errore comune / Nota di attenzione: Occhi esperti o modelli abituati alle vecchie tabelle di Meeus (J1900) possono scambiare 231.19° per J2000 e credere che 251.39° sia un residuo J1900; in realtà avanzando di +1 secolo dal 1900 al 2000 si ha T_1900 = T + 1 e 231.19° + 20.20° = 251.39° fornisce l'esatta fase J2000.
Δλ_gez = 0.00134*cos(A) + 0.00154*cos(B) + 0.00200*cos(C) + 0.00178*sin(E); // J2000 (T_1900=T+1): E = Mod(251.39 + 20.20*T, 360)
sunTrueLong = Mod(L0 + sunEqOfCtr + Δλ_gez + ayBarysentrikDeg, 360.0);
#65

65) Nodo Lunare (Ω), Nutazione in Longitudine (Δψ), Aberrazione Scalata con la Distanza e Longitudine Apparente (λ)

Per passare dalla longitudine geometrica vera alla longitudine apparente (λ) vista dall'osservatore terrestre, si calcolano la longitudine del nodo ascendente lunare (Ω = Mod(125.04° − 1934.136°·T, 360°)) e la nutazione in longitudine (Δψ) col termine solare semestrale; inoltre si somma l'aberrazione annua scalata per la distanza (-20.4898″ / R_AU), dovuta alla combinazione della velocità orbitale terrestre e della velocità finita della luce, riconducendo il risultato in [0°, 360°).

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché il tempo di ~8.3 minuti impiegato dalla luce del Sole per raggiungere la Terra sposta la posizione apparente del Sole di ~20.5 secondi d'arco in direzione orbitale; scalare questo termine per R_AU al perielio e all'afelio coglie la differenza di velocità ellittica.
Errore comune / Nota di attenzione: Assumere l'aberrazione annua della luce costante a -20.4898″ tutto l'anno trascura la variazione di velocità dell'orbita ellittica; poiché al perielio di gennaio (R_AU ≈ 0.983) la Terra orbita più velocemente, l'aberrazione cresce in ragione inversa a R_AU.
Δψ = -0.004778 * sin(Ω) - 0.000367 * sin(2 * L0);   aberasyon = -(20.4898 / 3600.0) / R_AU;
sunAppLong = Mod(sunTrueLong + Δψ + aberasyon, 360.0);
#66

66) Obliquità Media dell'Eclittica di Laskar (ε₀) e Nutazione dell'Obliquità Vera (ε = ε₀ + Δε)

L'inclinazione dell'asse di rotazione terrestre rispetto al piano orbitale (~23.439°) si riduce lentamente nei secoli per le attrazioni planetarie e compie una nutazione in obliquità (Δε) di ±9.2 secondi d'arco legata al nodo lunare (Ω) e alla fase semestrale 2·L₀. Sommando Δε al polinomio dell'obliquità media ε₀ si ricava l'obliquità istantanea vera (ε).

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché la trasformazione dalle coordinate eclittiche alle coordinate equatoriali (declinazione δ e ascensione retta α) utilizza direttamente il seno e il coseno di questo angolo istantaneo ε.
ε0 = 23.0 + (26.0 + (21.448 - T*(46.815 + T*(0.00059 - T*0.001813))) / 60.0) / 60.0;
ε = ε0 + 0.002556 * cos(Ω) + 0.000158 * cos(2 * L0);
#67

67) Declinazione Solare (δ) e Ascensione Retta con Arcotangente ai Quattro Quadranti (α)

Dalla longitudine apparente (λ) e dall'obliquità vera dell'eclittica (ε) si calcolano la distanza angolare del Sole dall'equatore celeste (declinazione δ = asin(clamp(sin ε · sin λ, -1, 1))) e la sua ascensione retta misurata lungo l'equatore celeste dall'equinozio di primavera (α = Mod(atan2(cos ε · sin λ, cos λ), 360°)).

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché vincolare sin(δ) all'intervallo [-1, +1] scongiura il rischio di NaN nei traboccamenti in virgola mobile, mentre la funzione atan2 ai quattro quadranti risolve l'ascensione retta lungo 0°–360° senza ambiguità di quadrante.
sinDeclin = Math.Clamp(Math.Sin(ε_rad) * Math.Sin(λ_rad), -1.0, 1.0);   δ = RadyaniDereceye(Math.Asin(sinDeclin));
α = Mod(RadyaniDereceye(Math.Atan2(Math.Cos(ε_rad) * Math.Sin(λ_rad), Math.Cos(λ_rad))), 360.0);
#68

68) Equazione del Tempo Esatta di Meeus 28.1 (EoT) e Termine Ausiliario Classico di Obliquità (y = tan²(ε/2))

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché la serie troncata al secondo ordine di Smart lascia uno scarto di ~0.4–0.8 secondi nei termini misti di alta eccentricità/obliquità, mentre la formula diretta (L₀ − 0.0057183° − α + Δψ·cos ε)·4 trasferisce dentro l'EoT anche le perturbazioni planetarie e lunari.
Errore comune / Nota di attenzione: Vedendo al passo 65 che l'aberrazione viene divisa per R_AU, si potrebbe essere tentati di dividere per R_AU anche la costante 0.0057183° (-20.4898″) dentro EoT; tuttavia nella definizione Meeus 28.1 il Sole medio fittizio ha velocità costante e tale costante media di aberrazione non si divide.
eotDerece = Sarmala180(geomMeanLongSunDeg - 0.0057183 - sunRightAscensionDeg + deltaPsiDeg * Math.Cos(ε_rad));
eqOfTimeMinutes = eotDerece * 4.0;
#69

69) Tempo Solare Vero (TST) e Angolo Orario al Meridiano Locale (H = TST · 0.25 − 180°)

Combinando il minuto dell'orologio locale (t_dk), l'Equazione del Tempo (EoT), la conversione della longitudine a 4 minuti per grado (4·λ_long) e il fuso orario attivo (60·TZ), si ottiene il Tempo Solare Vero (TST ∈ [0, 1440) min); da esso si deriva l'Angolo Orario H = TST · 0.25 − 180° (negativo prima di mezzogiorno, positivo dopo), che esprime la distanza angolare del Sole dal meridiano locale.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché nel triangolo sferico di posizione l'angolo dipendente dal tempo nel teorema del coseno che unisce lo zenit dell'osservatore al Sole è direttamente questo angolo orario locale (H).
trueSolarTimeMin = Mod(gunIciToplamDakika + eqOfTimeMinutes + 4.0 * guvenliBoylam - 60.0 * temizSaatDilimi, 1440.0);
hourAngleDeg = trueSolarTimeMin * 0.25 - 180.0;
#70

70) Zenit Geocentrico (θ_z_jeo) e Altezza Geometrica Topocentrica Corretta per Parallasse (α_geom)

Con il teorema sferico del coseno si determina dapprima l'angolo zenitale geocentrico riferito al centro della Terra θ_z_jeo = acos(clamp(sin φ · sin δ + cos φ · cos δ · cos H, -1, 1)). Poiché l'osservatore si trova sulla superficie terrestre e non al centro del pianeta, il Sole appare ~8.79″ più basso all'orizzonte; aggiungendo π_☉ · sin(θ_z_jeo) e vincolando in [0°, 180°] si ottengono lo zenit topocentrico (θ_z) e l'altezza geometrica (α_geom = 90° − θ_z). Questo angolo topocentrico si applica direttamente nell'altezza solare istantanea, nei rapporti d'ombra di ʿAṣr (α_zeval, α_asr) e nelle radici del crepuscolo/ʿIshāʾ; nell'Orizzonte Ottico Personale, essendo il termine −π_☉ già compreso nell'angolo zenitale d'orizzonte (θ_ufuk), sia le radici normali (Passo 76) sia quelle di rasenza polare (Passo 77) applicano simmetricamente la parallasse d'orizzonte, mentre le 7 autorità ufficiali mantengono lo standard di 90°50' (90.833333°).

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché scalare la correzione di parallasse con sin(θ_z_jeo) elimina lo slittamento di ~8.79″ (~0.6 s) in altezza solare istantanea, angoli d'ombra di ʿAṣr, radici crepuscolari e Orizzonte Ottico Personale, salvaguardando al contempo lo standard di calendario 90°50' presso le autorità ufficiali.
θ_z_jeo = RadyaniDereceye(Math.Acos(Math.Clamp(sin(φ)*sin(δ) + cos(φ)*cos(δ)*cos(H), -1.0, 1.0)));
θ_z = Math.Clamp(θ_z_jeo + yatayParalaksDeg * Math.Sin(θ_z_jeo_rad), 0.0, 180.0);   α_geom = 90.0 - θ_z;
#71

71) Esponente di Densità dell'Aria di Gladstone–Dale (4.25588) e Fattore Barometrico di Rifrazione (ρ / ρ₀)

Poiché la rifrazione atmosferica è proporzionale alla refrattività (n − 1 ∝ ρ), decresce alle alte quote con la minore densità dell'aria e cresce nelle depressioni come il Mar Morto (-430 m). Nell'equazione troposferica dell'Atmosfera Standard Internazionale (ISA, T₀ = 288.15 K, L = 0.0065 K/m), al posto dell'esponente di pressione 5.25588 di P/P₀ si usa l'esponente esatto di densità (P/P₀)/(T/T₀) = (1 − 2.25577e-5 · H)^4.25588 nell'intervallo [-450 m, 11000 m].

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché il solo esponente di pressione (5.25588) trascura che l'aria salendo si raffredda e si addensa, sottostimando la rifrazione di ~5 % a 2000 m; l'esponente di densità 4.25588 rispecchia la legge fisica di Gladstone–Dale.
double BasincKirilmaCarpaniHesapla(double H) → Math.Pow(1.0 - 2.25577e-5 * Math.Clamp(H, -450.0, 11000.0), 4.25588);
#72

72) Rifrazione Atmosferica C¹-Monotona di Sæmundsson / Meeus 16.4 (+0.00192792 e Smorzamento [-3°, -1°])

Poiché la classica formula a tratti NOAA può generare una discontinuità di ~20.9 primi d'arco a h = -0.575°, nel calcolatore della rifrazione si adotta nell'intervallo (-3.0°, +90.0°) il modello differenziabile e monotono di Sæmundsson / Meeus 16.4. Per azzerare esattamente il termine negativo di tan(90.1083°) allo zenit (h = 90°) si aggiungono +0.00192792 primi d'arco, si applica smorzamento di Hermite nella fascia [-3.0°, -1.0°] e agli angoli crepuscolari h ≤ -3.0° la rifrazione restituisce esattamente 0.0°.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così per eliminare il gradino artificiale di 21 primi d'arco intorno all'orizzonte, assicurare la condizione R = 0° allo zenit (h = 90°) e proteggere le radici crepuscolari a -15°..-20° da code di rifrazione spurie.
Errore comune / Nota di attenzione: Aggiungere i 34′ di rifrazione d'orizzonte anche quando il Sole è a -18° sotto l'orizzonte è un errore frequente; a tale profondità nessun raggio diretto del disco solare raggiunge l'occhio, bensì diffusione dell'alta atmosfera, e tutti gli angoli crepuscolari sono definiti geometricamente senza rifrazione.
double rHamDakika = (1.02 / Math.Tan(DereceyiRadyana(h + 10.3 / (h + 5.11)))) + 0.00192792; // HesaplaSaemundssonKirilmaDeg
if (h ∈ [-3.0, -1.0)) { double u = (h + 3.0) * 0.5; rHamDakika *= u * u * (3.0 - 2.0 * u); }   R = (rHamDakika / 60.0) * basincCarpani;
#73

73) Scostamenti Naturali nell'Atmosfera Reale dovuti a Temperatura (-30 °C..+45 °C), Pressione, Umidità e Inversione (±15–40 s)

Nota di Umiltà Meteorologica: Fenomeni atmosferici locali quali temperatura istantanea dell'aria, basse pressioni di tempesta, umidità relativa e miraggi d'orizzonte possono influire sul tramonto apparente nell'ordine di secondi; per questo motivo i margini di precauzione giuridica sono importanti.

Come ogni motore astronomico e di calendario, questo calcolo poggia sull'ipotesi di Atmosfera Standard Internazionale (aria secca a 15 °C e 1013.25 hPa al livello del mare). Nel cielo reale, nella calura estiva di La Mecca o Baghdad (+45 °C) l'aria si espande riducendo la rifrazione all'orizzonte di ~2–3 primi d'arco, mentre nel gelo invernale di Erzurum o della Siberia (-25..-35 °C), con elevata umidità di vapore acqueo o inversione termica sul mare, la rifrazione aumenta; questo fenomeno fisico naturale può spostare il sorgere e il tramonto apparenti di ±15–40 secondi (±1 min ai minuti di confine).

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché un motore di calcolo offline non può misurare il profilo verticale istantaneo di temperatura e umidità lungo la linea dell'orizzonte; i margini di precauzione inseriti dai comitati ufficiali su Sorgere e Maghrib assorbono anche questa oscillazione meteorologica naturale.
// Riferimento standard: T₀ = 15 °C (288.15 K), P₀ = 1013.25 hPa → Rifrazione all'orizzonte R₀ ≈ 34 primi d'arco
// Caldo estremo (+45 °C) / freddo (-30 °C) / inversione → oscillazione naturale di ±15..40 s dell'orizzonte ottico
#74

74) Azimut Solare Meeus 13.5 ai Quattro Quadranti Protetto per l'Istiwāʾ al-Aʿẓam della Kaaba (θ_z → 0°)

L'angolo orizzontale del Sole misurato dal Nord in senso orario (Azimut) viene calcolato senza singolarità tramite Math.Atan2(sin H, cos H · sin φ − tan δ · cos φ) + 180°, invece della formula con arccos che contiene sin(θ_z) al denominatore e produce indeterminazione 0/0 quando il Sole è esattamente allo zenit (a mezzogiorno il 28 maggio e il 16 luglio alla Mecca durante l'Istiwāʾ al-Aʿẓam della Kaaba, quando θ_z → 0°).

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché nella fascia tropicale, quando il Sole passa esattamente allo zenit, il denominatore sin(θ_z) tende a zero; la formula Math.Atan2 non divide per l'angolo zenitale ed è stabile a ogni latitudine.
Errore comune / Nota di attenzione: La formula dell'azimut a una variabile con arccos riportata nei manuali non distingue da sola tra mattina e pomeriggio e inoltre diventa instabile sulla Kaaba quando il Sole è allo zenit (θ_z → 0°) poiché il denominatore si annulla.
azPay = sin(H);   azPayda = cos(H) * sin(φ) - tan(δ) * cos(φ);
guneydenBatiyaDeg = RadyaniDereceye(Math.Atan2(azPay, azPayda));   Azimut = Mod(guneydenBatiyaDeg + 180.0, 360.0);
#75

75) Convergenza del Mezzogiorno (Zawāl) in 4 Passi Protetta dalla Linea di Cambio Data (±180° IDL, Differenza Sarmala180)

Nel calcolo dell'istante di transito al meridiano a mezzogiorno (zawāl), poiché l'Equazione del Tempo (EoT) varia leggermente durante la giornata, si eseguono 4 iterazioni successive a punto fisso sulla stima dello zawāl. In località vicine a ±180° quali Kiritimati (UTC+14, -157.4°O), Samoa (UTC+13) e Chatham (+12:45), affinché lo zawāl non slitti al giorno precedente o successivo, la differenza (15°·TZ − longitudine) viene ripiegata direttamente con Sarmala180 nell'intervallo [-180°, +180°).

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché nei fusi insulari distanti più di 180° dal meridiano centrale 15°·TZ la formula grezza proietterebbe lo zawāl di ±1440 minuti oltre; la differenza di meridiano Sarmala180 mantiene lo zawāl a metà del giorno locale.
meridyenFarkiDeg = Sarmala180(temizSaatDilimi * 15.0 - guvenliBoylam);
solarNoonMin = 720.0 + 4.0 * meridyenFarkiDeg - eqOfTimeMinutes; // 4 iterazioni successive a punto fisso
#76

76) Convergenza a Punto Fisso in 8 Passi per Sorgere e Tramonto alle Latitudini Normali (|cos HA_zeval| ≤ 0.90)

Al sorgere e al tramonto del Sole, la declinazione (δ) e l'Equazione del Tempo (EoT) differiscono dai valori di mezzogiorno (agli equinozi δ varia di ~0.4° tra mattina e sera). Per questo alle latitudini normali con |cos HA_zeval| ≤ 0.90 e |φ| ∈ [0°, 88°), sia l'ora del sorgere sia quella del tramonto vengono risolte separatamente fino a 8 iterazioni (criterio di convergenza |Δt| ≤ 0.0001 min) con i rispettivi valori (δ(t_k), EoT(t_k)).

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché calcolare sorgere e tramonto in un solo passaggio con la declinazione del mezzogiorno lascerebbe alle medie e alte latitudini nei giorni equinoziali un errore di asimmetria di 1–2 minuti sull'ora del sorgere e del tramonto.
cosHa = (cos(ufukZenit) - sin(φ)*sin(δ_k)) / (cos(φ)*cos(δ_k));   t_{k+1} = zeval_k ∓ 4.0 * acos(cosHa);
#77

77) Estremo con Sezione Aurea e Radice d'Orizzonte in 28 Passi nella Fascia di Rasenza Polare (|cos HA| ∈ (0.90, 1] o |φ| ≥ 88°)

Presso il circolo polare e al vertice polare 88°–89.9°, poiché il Sole sfiora l'orizzonte quasi orizzontalmente e agli equinozi la variazione giornaliera della declinazione (~0.4°/giorno) supera l'oscillazione zenitale diurna, dopo la soglia di preselezione 2·(90° − |φ|) + 1.25° si individuano lo zawāl (±120 min per |φ| ≤ 85°, ±360 min per |φ| ∈ (85°, 88°), ±720 min per |φ| ≥ 88°) e i punti nadir mattutino/serale (±180 min per |φ| ≤ 85°, ±360 min sopra 85°) tramite ricerca con sezione aurea in 26 passi, eseguendo poi una ricerca binaria in 28 passi sulla differenza tra zenit geocentrico e zenit d'orizzonte (θ_z,jeo − θ_ufuk = 0). In modalità Orizzonte Ottico Personale, poiché la definizione θ_ufuk = 90° + s_☉ + R_ufuk − π_☉ + α_ufuk include direttamente al suo interno la parallasse orizzontale (−π_☉ ≈ −8.79″) (Passo 44), sia cos(θ_ufuk) del Passo 76 sia questa ricerca binaria applicano la stessa parallasse d'orizzonte senza generare discontinuità al confine |cos HA| = 0.90.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché sia nello standard ufficiale 90°50' sia nell'Orizzonte Ottico Personale (con l'angolo θ_ufuk comprensivo di −π_☉), l'arccos a 8 iterazioni e la ricerca binaria condividono esattamente lo stesso obiettivo θ_ufuk, mantenendo lo scalino di ramo sotto ~0.15 secondi al passaggio |cos HA| = 0.90 senza mancare il sorgere equinoziale a 89.9°N.
double ZenitFarki(double dk) → HesaplaTamDetay(..., dk, ...).jeosentrikZenitDeg - ufukZenitDeg; // In Orizzonte Personale ufukZenitDeg include -π_☉
AltinKesitEkstremumBul(zeval - ogleYaricap, zeval + ogleYaricap, maksimumAraniyor: false, out gercekZeval); // 26 passi + 28 passi bisection
#78

78) Notte Simmetrica (1440 − Giorno) vs Notti Consecutive Asimmetriche del Mattino (d-1 → d) e della Sera (d → d+1)

La durata simmetrica della notte si calcola direttamente come 1440 − Giorno (Giorno + Notte Simmetrica = 1440 min). Tuttavia alle alte latitudini in primavera e autunno, variando la durata del giorno di 6–12 minuti al giorno, la notte mattutina di Imsak (tramonto di ieri → sorgere di oggi) e la notte serale di ʿIshāʾ (tramonto di oggi → sorgere di domani) non coincidono con la notte simmetrica; il motore le calcola separatamente dalla rispettiva coppia di giorni.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché usare soltanto la differenza simmetrica (1440 − Giorno) nelle stime di Imsak e ʿIshāʾ falserebbe di alcuni minuti le durate notturne di mattino e sera nei rapidi cambi stagionali.
gunduzSuresiDk = gunBatis_d - gunDogus_d;   geceSuresiDk = Math.Clamp(1440.0 - gunduzSuresiDk, 10.0, 1430.0);
sabahAstronomikGeceDk = Math.Clamp((gunDogus_d + 1440.0) - gunBatis_{d-1}, 10.0, 1430.0);   aksamAstronomikGeceDk = Math.Clamp((gunDogus_{d+1} + 1440.0) - gunBatis_d, 10.0, 1430.0);
#79

79) Cercatore di Nadir a Sezione Aurea in 30 Passi con Finestra Adattiva (±95 / ±160 / ±300 min, Minimo Senza Rifrazione)

L'istante della minima altezza solare notturna (nadir) può scostarsi dal punto zawāl ± 720 min alle alte latitudini per via della rapida variazione della declinazione. La ricerca del minimo al meridiano inferiore individua il vero punto nadir con una ricerca a sezione aurea in 30 passi sull'altezza topocentrica senza rifrazione (senza margine di rifrazione) in una finestra adattiva (±95 min per |φ| ≤ 75°, ±160 min per (75°, 85°], ±300 min sopra 85°). Nelle modalità con ʿIshāʾ fisso a +90/+120 min come Umm al-Qura, il motore principale salta la ricerca del nadir serale; affinché la misura di riferimento nel rapporto non resti vuota, il nadir serale viene campionato separatamente sulla stessa finestra a soli fini diagnostici.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché gli angoli crepuscolari sono definiti su altezza geometrica priva di rifrazione e nella fascia polare 85°–89.9° l'istante del nadir può uscire da ±95 min; la ricerca a sezione aurea ±300 min mantiene la ricerca binaria sul ramo corretto.
Errore comune / Nota di attenzione: Si presume spesso che la minima altezza solare notturna avvenga sempre alle 00:00 o esattamente a zawāl ± 12 ore; agli equinozi polari la rapida variazione di declinazione può spostare di ore il minimo reale.
double altinYaricapDk = Math.Abs(enlem) ≤ 75.0 ? 95.0 : (Math.Abs(enlem) ≤ 85.0 ? 160.0 : 300.0);
AltinKesitMinimumBul(..., altSinirDakika, altinYaricapDk, false /* kirilmali: false */, out enDusukDakika, out enDusukYukseklikDeg);
#80

80) Ricerca Binaria in 28 Passi sui Rami Monotoni di Salita e Discesa (Risolutore di Radici Mattina / Sera)

Separati il minimo notturno (nadir) e il picco diurno (zawāl), l'altezza solare diventa una funzione a radice unica strettamente crescente sul ramo mattutino [t_nadir,mattina, t_zawāl] e strettamente decrescente sul ramo serale [t_zawāl, t_nadir,sera]. I risolutori delle radici di altezza mattutino e serale eseguono su tale intervallo una ricerca binaria in 28 passi (tale raffinamento riguarda unicamente la risoluzione numerica interna dell'equazione; nel cielo reale l'incertezza atmosferica e topografica è nell'ordine dei secondi).

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché una scansione lineare grossolana da 1 minuto effettua centinaia di chiamate superflue alle effemeridi e lascia scalini al limite d'arrotondamento al minuto; la ricerca binaria in 28 passi risolve l'equazione senza introdurre ulteriore errore numerico.
TrySabahYukseklikZamaniBul(..., sabahDipDk, zevalDk, imsakAci, kirilmaliYukseklikKullan: false, out hamImsak, out _, out _); // IkiliAramaYukselis (28 passi)
TryAksamYukseklikZamaniBul(..., zevalDk, aksamSinirDk, hedefAci, kirilmaliYukseklikKullan: false, out bulunanDk, out _, out _); // IkiliAramaAlcalis (28 passi)
#81

81) Durata Fisica Pura della Notte Sharʿī senza Tamkīn Ghurūb → Fajr (d → d+1 UTC)

Nel fiqh Hanafita e Sciafeita l'inizio della notte è il tramonto del Sole (ghurūb) e la fine è il sorgere dell'alba vera (ṭulūʿ al-fajr / Fajr al-Ṣādiq) del mattino seguente. Poiché la precauzione aggiunta alla preghiera del Tramonto o un salto DST di ora legale non modificano la lunghezza fisica della notte, la durata della notte sharʿī è calcolata direttamente dalla differenza tra l'istante UTC puro del tramonto odierno e l'istante UTC puro di Fajr di domani (d+1).

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché ricavare la durata notturna dagli orari a muro con precauzione mescolerebbe i margini di tamkīn nel calcolo della mezzanotte sharʿī e inoltre misurerebbe la notte sharʿī con 1 ora di errore nelle notti di cambio DST primaverili/autunnali.
Errore comune / Nota di attenzione: Calcolare la mezzanotte sharʿī dall'orario con precauzione di Maghrib sulla scheda e dall'Imsak dello stesso mattino mescola i margini nella notte, utilizza l'Imsak del giorno sbagliato e produce 30 min di errore nella notte di cambio DST.
seriGeceSuresiDakika = Math.Clamp((yarinHamFecrUtcDakika + 1440.0) - hamGunBatisUtcDakika, 6.0, 1434.0);
#82

82) Niṣf al-Layl (Mezzanotte Sharʿī) e Thuluth al-Ākhir (Ultimo Terzo della Notte) nel Fiqh Hanafita e Sciafeita

Nella scuola Sciafeita il tempo elettivo (ikhtiyārī) della preghiera di ʿIshāʾ, e nella scuola Hanafita il limite di esecuzione priva di riprovazione (senza karāha), giungono sino alla Mezzanotte Sharʿī (Niṣf al-Layl = Ghurūb + 1/2 · Notte Sharʿī); Thuluth al-Ākhir, il tempo virtuoso di tahajjud e suḥūr, inizia invece nell'ultimo terzo della notte (Ghurūb + 2/3 · Notte Sharʿī). Entrambi gli istanti vengono calcolati sull'asse puro UTC e proiettati sul proprio fuso orario locale istantaneo.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché la Mezzanotte Sharʿī non corrisponde alle 00:00 dell'orologio a muro, ma al punto medio reale tra Ghurūb e Fajr, che a seconda di stagione e longitudine varia tra le 22:30 e l'01:15.
seriGeceYarisiUtc = hamGunBatisUtcDakika + 0.5 * seriGeceSuresiDakika;
sonUcteBirGeceUtc = hamGunBatisUtcDakika + (2.0 / 3.0) * seriGeceSuresiDakika;
#83

83) 1.º Orario — Soluzione Astronomica della Radice di Imsak (Fajr al-Ṣādiq / Inizio dell'Alba)

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché l'istante del modello astronomico in cui compare il chiarore orizzontale all'orizzonte (Fajr al-Ṣādiq) è il valore radice sul ramo ascendente mattutino senza rifrazione per l'angolo crepuscolare dell'autorità prescelta.
bool imsakBulundu = TrySabahYukseklikZamaniBul(..., sabahDipDk, zeval, imsak_derece, kirilmaliYukseklikKullan: false, out hamImsak, out _, out _);
#84

84) Notte Bianca in Imsak (Hermite 1.50° / Stima Diyanet), Distinzione Inverno Polare e Imsak Netto

Motivo (Perché abbiamo fatto così): Abbiamo fatto così affinché nella prima notte estiva in cui si spezza la radice crepuscolare non si formi un divario di 35–45 minuti nell'orario, e nel profondo inverno polare l'equazione della notte bianca non scatti per errore.
if (d.diyanetYuksekEnlemAktif) { double takdirImsakNet = d.netGunesDakika - d.diyanetTakdirImsakAralikDk; /* + ponte Hermite */ }
#85

85) 2.º Orario — Sorgere del Sole (Ṭulūʿ), Termine di Fajr, Tamkīn Negativo e Nota di Karāha di Ishrāq

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché il Sorgere non è un orario d'ingresso bensì il limite di uscita della preghiera di Fajr; applicare la precauzione all'indietro e non in avanti tutela la conclusione della preghiera prima del momento di karāha.
#86

86) Karāha di Istiwāʾ, Durata di Transito del Disco Solare (4·s_☉ / cos δ) e Standard al Centro di Umm al-Qura

Motivo (Perché abbiamo fatto così): Abbiamo fatto così per evitare un doppio istiwāʾ in Diyanet/MABIMS, concordare alla Kaaba con l'orario ufficiale di Ẓuhr di Umm al-Qura e tutelare l'uscita dalla karāha nelle autorità a tamkīn zero.
Errore comune / Nota di attenzione: Si crede spesso che Ẓuhr entri subito all'istante dello zawāl; in realtà lo zawāl è il transito del centro solare e la karāha di istiwāʾ permane finché il bordo orientale non lascia il meridiano (~65 s).
bool resmiTemkin = otorite == Otoriteler.Diyanet || otorite == Otoriteler.Kemenag_GuneydoguAsya;
double fizikselIstivaDk = (resmiTemkin || otorite == Otoriteler.Ummu_l_Kura) ? 0.0 : (zevalYaricapDeg / Math.Cos(rad(zevalDeclinDeg))) * 4.0;
double zevalIstivaPayiDk = (!resmiTemkin && !yatsiSabitDakikaMi && Math.Sign(ogleTemkin) == -1) ? (fizikselIstivaDk - ogleTemkin) : fizikselIstivaDk;
#87

87) 3.º Orario — Mezzogiorno (Ẓuhr) e Monotonia del Tamkīn senza Zona Morta in Modalità Personale

L'orario di Ẓuhr si ottiene sommando al minuto dello zawāl astronomico il tamkīn di mezzogiorno dell'autorità selezionata e, ove necessario, il margine aggiuntivo di istiwāʾ per il transito del disco solare. Nella modalità Impostazioni Personali, finché il tamkīn di mezzogiorno è nullo o positivo, il margine aggiuntivo di istiwāʾ resta costante cosicché l'aumento inserito dall'utente (0 → +0.5 → +1.0 min) si riflette linearmente su Ẓuhr senza restare bloccato in una zona morta. Inserendo un tamkīn negativo entra invece il margine compensativo per mantenere Ẓuhr al di fuori della karāha di istiwāʾ.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché nella regione positiva la vecchia formula compensativa semplificava algebricamente e assorbiva l'input utente nella fascia 0..+1.13 min; questa struttura condizionale applica una soglia di sicurezza solo nella regione negativa preservando la monotonia positiva.
// Quando ogleTemkin è negativo (else if ogleTemkin minore di 0.0): zevalIstivaPayiDk = fizikselIstivaDk - ogleTemkin
double netOgleDakika = zevalDakika + ogleTemkin + zevalIstivaPayiDk;
#88

88) Ombra Fayʾ al-Zawāl (tan(90° − α_zeval)) e Continuità dell'Ombra Zero all'Istiwāʾ della Kaaba

La misura dell'orario di ʿAṣr è la lunghezza d'ombra aggiunta sopra l'ombra minima di ciascun oggetto a mezzogiorno (fayʾ al-zawāl). L'ombra allo zawāl di uno gnomone unitario (1.0 u) è calcolata con cot(α_zeval) = tan(90° − α_zeval); negli istanti in cui il Sole passa esattamente allo zenit (α_zeval → 90°, Istiwāʾ al-Aʿẓam della Kaaba alla Mecca), affinché l'ombra non diventi negativa, l'altezza allo zawāl è vincolata con continuità in [0.05°, 90.0°] (per α_zeval = 90°, fayʾ al-zawāl = 0.000000).

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché mantenere il limite superiore a 90.0° esatti invece che 89.999° genera fluidamente il valore fisico di ombra zero quando il Sole è esattamente allo zenit sulla Kaaba.
zevalYukseklikDeg = Math.Clamp(zevalHamYukseklikDeg, 0.05, 90.0);
zevalGolgeBoyu = Math.Tan(DereceyiRadyana(90.0 - zevalYukseklikDeg));
#89

89) 4.º Orario — Soluzione della Radice per l'Angolo Geometrico d'Ombra di ʿAṣr (ʿAṣr al-Awwal +1 / ʿAṣr al-Thānī +2, atan(1 / L_asr))

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché risolvere sia l'ombra dello zawāl sia l'altezza obiettivo di ʿAṣr sul piano angolare topocentrico senza rifrazione, ed eseguire la ricerca binaria in 28 passi con la declinazione pomeridiana reale, elimina la deriva da declinazione fissa.
Errore comune / Nota di attenzione: Calcolare l'ombra fayʾ al-zawāl senza rifrazione e poi aggiungere la rifrazione atmosferica all'altezza solare di ʿAṣr (o mantenere fissa la declinazione del mezzogiorno in ʿAṣr) pone i due rapporti d'ombra su piani differenti producendo uno slittamento sistematico.
hedefIkindiGolge = zevalGolgeBoyu + Math.Max(1.0, ikindi_golge);   hedefIkindiYukseklikDeg = RadyaniDereceye(Math.Atan(1.0 / hedefIkindiGolge));
TryAksamYukseklikZamaniBul(zevalDakika, gunBatisDakika, hedefIkindiYukseklikDeg, kirilmali: false, out bulunanIkindiDk);
#90

90) Rasenza Invernale dell'Orizzonte per ʿAṣr (Hermite [0.05°..soglia sup.], Rapporto Semidiurno 0.16 ʿAṣr al-Awwal / 0.24 ʿAṣr al-Thānī)

Motivo (Perché abbiamo fatto così): Abbiamo fatto così sia per non alterare la radice d'ombra reale in città a 65°–66.5° quali Rovaniemi/Oulu quando α_zeval ≥ 0.60°, sia per impedire un salto di ore in un solo giorno in ʿAṣr al confine della notte polare in alta quota.
ikindiYedekOrani = ikindi_golge ≥ 1.5 ? 0.24 : 0.16;   ikindiYedekDakika = zevalDakika + ikindiYedekOrani * yariGunduzDk;
double rampAsr = HermiteSmoothStep(0.05, ikindiKisUst, d.zevalYukseklikDeg);   hamIkindi = ikindiYedekDakika + rampAsr * (adayIkindiDk - ikindiYedekDakika);
#91

91) Miscela di ʿAṣr con Latitudine di Riferimento ±62° nell'Estate Polare ([1.2°..7.2°+] e Vertice Polare 84°..86.5°)

Nell'estate polare (sole di mezzanotte che non tramonta per 24 ore), per evitare la rottura della radice quando l'altezza minima del ramo serale (α_min,ikindi) si accosta tangenzialmente dal basso all'angolo obiettivo di ʿAṣr (α_asr), si risolve il vero orario di ʿAṣr della latitudine di riferimento ±62.0° nella stessa longitudine e giornata (t_62°); si applica una transizione morbida di Hermite sull'altezza di mezzogiorno ([1.2°, max(7.2°, soglia sup. + 2.0°)]) e una miscela sull'altezza minima ([α_asr − 2.0°, α_asr]). In modalità Diyanet sul vertice polare |φ| ∈ (84°, 90°] la transizione di alta latitudine ([84.0°, 86.5°]) tutela la continuità.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché usare la vera radice d'ombra della latitudine di riferimento ±62° anziché aggiungere un numero fisso di minuti conserva anche nell'estate polare la naturale differenza tra Sciafeita (+1) e Hanafita (+2).
kutupHedefIkindiDk = ikindiYedekDakika + wZevalRef * (refIkindiDk - ikindiYedekDakika);   wYazIkindi = HermiteSmoothStep(hedefAci - 2.0, hedefAci, ikindiMinYukseklikDeg);
#92

92) 5.º Orario — Tramonto (Maghrib / Ifṭār): Tramonto del Lembo Superiore e Precauzione Anti-Ifṭār Anticipato

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché rompere il digiuno qualche secondo prima che il Sole sia completamente sotto l'orizzonte metterebbe a rischio il digiuno; il tramonto del lembo superiore e l'arrotondamento per eccesso tutelano tale precauzione giuridica.
#93

93) 6.º Orario — Notte (ʿIshāʾ): Angolo Crepuscolare, Inverno Polare e Stima della Notte Bianca

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché l'orario di ʿIshāʾ deve seguire alle medie latitudini la reale scomparsa del crepuscolo e, entrando nelle notti bianche, raccordarsi senza salti alla durata stimata dall'istituzione.
#93B

93) 6.º Orario — Notte (ʿIshāʾ — Regola Fissa + min di Umm al-Qura e Calendario Hijri di Riserva)

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché nei calendari dell'Arabia Saudita e del Golfo vige ufficialmente in Ramadan la regola di +120 min per agevolare il tarāwīḥ e l'ifṭār, e non devono verificarsi eccezioni di calendario dopo il 2029.
hamYatsi = Math.Min(d.netAksamDakika + eklenecekDakika, d.yatsiUstSinirDakika);   netYatsi = hamYatsi + yatsiTemkin;
#94

94) Imsak di Domani (d+1) e Limite Superiore di ʿIshāʾ sull'Asse Solare Continuo

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché imporre un tetto fisso d'orologio a muro alle 23:55 taglierebbe artificialmente ʿIshāʾ prima di mezzanotte in città come Reykjavík od Oslo dove ʿIshāʾ entra naturalmente tra le 00:30 e l'01:30.
yarinSabitDilimNetImsakDakika = (yarinDetay.netImsakDakika - yarinDetay.imsakSaatDilimi * 60.0 + 1440.0) + saatDilimi * 60.0;
yatsiUstSinir = yatsiSabitDakikaMi ? Math.Max(d.netAksamDakika + 5.0, d.yarinSabitDilimNetImsakDakika - 10.0) : (Math.Max(d.netOgleDakika + 8.20, d.yarinSabitDilimNetImsakDakika) - 2.05);
#95

95) Protezione d'Ordine Monotono dei 6 Orari Prima della Proiezione UTC (Buffer 2.05 min) e Proiezione Singola UTC → Locale

Affinché con valori di tamkīn estremi di segno opposto inseriti in modalità Personale o al confine polare due orari consecutivi non si sovrappongano e le ore sulle schede restino strettamente crescenti anche dopo l'arrotondamento Ceiling/Floor, si applica sull'asse solare grezzo una protezione d'ordine con buffer di 2.05 min; subito dopo ogni orario viene proiettato singolarmente dall'asse del tempo universale (UTC) al proprio fuso orario locale istantaneo.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché una differenza grezza di 1.0 minuto può ricadere nello stesso minuto intero (es. 01:15 == 01:15) sotto la combinazione di Ceiling e Floor; il buffer di 2.05 min garantisce la disuguaglianza stretta delle schede per tutti i 365 giorni.
MonotonVakitSirasiniGarantiEt(ref netImsakDakika, ref netGunesDakika, ref netOgleDakika, ref netIkindiDakika, ref netAksamDakika, ref netYatsiDakika, yarinImsakDakika); // minAralikDk = 2.05
netVakitDakika = TekilVakitUtcDenYerelDakikayaCevir(enlem, boylam, utcGunTabani, yerelGunTabani, ogleSaatDilimi, netVakitDakika, out anlikDilim, ref dstFarkiBulundu);
#96

96) Motore Istituzionale di Arrotondamento al Minuto (:30 Diyanet e Umm al-Qura, Ceiling MABIMS Subuh, Floor/Ceiling Tamkīn Zero)

Lo strato di arrotondamento al minuto applica il metodo proprio del calendario di ogni istituzione: (1) Per Diyanet e Umm al-Qura gli orari sono arrotondati al minuto più vicino con la soglia simmetrica :30.00; (2) nello standard MABIMS (KEMENAG/JAKIM), i 5 orari di ingresso preghiera incluso Subuh (+2 min di precauzione) sono arrotondati per eccesso (Ceiling / Pembulatan ke Atas), e Syuruk (-2 min) per difetto (Floor); (3) nelle autorità ufficiali a tamkīn zero e in modalità Personale gli orari di uscita Imsak e Sorgere del Sole si arrotondano per difetto (Floor), mentre gli orari d'ingresso Mezzogiorno, Pomeriggio, Tramonto e Notte per eccesso (Ceiling) (solo per MABIMS Subuh si applica Ceiling).

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché il calendario stampato di ciascuna autorità è redatto con la sua regola d'arrotondamento; per esempio a Giacarta, poiché Subuh include +2 min di precauzione, applicare ufficialmente Pembulatan ke Atas (Ceiling) anziché Floor assicura la corrispondenza col calendario KEMENAG.
Errore comune / Nota di attenzione: Si pensa sovente che l'orario di Fajr/Imsak venga arrotondato per difetto (Floor) in tutte le istituzioni del mondo; al contrario nel sistema di Indonesia e Malesia (MABIMS/KEMENAG) Subuh è un orario d'ingresso di preghiera con +2 min di precauzione e viene arrotondato ufficialmente per eccesso (Ceiling).
bool imsakCikisYuvarla = (SeciliOtorite != Otoriteler.Kemenag_GuneydoguAsya); // MABIMS Subuh → Ceiling
FikhiGuvenliSaatMetnineCevir(netDakika, temkin, cikisVaktiMi);
#97

97) Scostamento Naturale di Quantizzazione di Calendario di ±1 Minuto ai Secondi di Confine (:29.9 / :30.1 e :00.1)

Trasparenza sulla Quantizzazione del Calendario: Nei giorni distanti pochi decimi o secondi dalla soglia di arrotondamento, riscontrare differenze di confine di ±1 minuto rispetto ai calendari stampati è un naturale effetto di quantizzazione.

Poiché le tabelle degli orari di preghiera celano i secondi mostrando minuti interi HH:mm, nei giorni di confine posti entro 0.1–0.5 secondi dalla soglia di arrotondamento (:30.00 s nel sistema simmetrico, :00.00 s nel sistema Ceiling/Floor), il numero di termini delle effemeridi tra due diversi osservatori o una differenza di coordinate di 0.5 metri può far ricadere valori quali 12:04:29.9 e 12:04:30.1 su due minuti adiacenti (12:04 contro 12:05).

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché il fatto che una differenza di 0.2 secondi appaia visivamente come 1 minuto intero appartiene alla natura matematica dell'arrotondamento al minuto; illustrare apertamente tale comportamento di confine elimina false impressioni di errore.
// Esempio soglia simmetrica: 12:04:29.9 → 12:04 | 12:04:30.1 → 12:05 (differenza fisica reale: 0.2 s, differenza visibile: 1 min)
// Esempio soglia per eccesso (Ceiling): 18:10:00.2 → 18:11 (arrotondamento al minuto intero superiore per evitare ifṭār anticipato)
#98

98) Troncamento dei Secondi per Difetto in Unico Stadio (Sub-Secondo) e Prevenzione del Doppio Arrotondamento

Se nel passare dal minuto decimale alla stringa oraria si arrotondasse al secondo più vicino (round), 29.50 secondi salirebbero prima a 30 secondi e poi nel risolutore delle schede verrebbero nuovamente arrotondati al minuto superiore, generando un errore di doppio arrotondamento (double-rounding). Il risolutore dei secondi tronca per difetto i sub-secondi in un solo passaggio con la formula ⌊min × 60 + 10⁻⁷⌋: 29.99 s → :29 (minuto inferiore), 30.00 s → :30 (minuto superiore).

Motivo (Perché abbiamo fatto così): Abbiamo fatto così per evitare che gli orari nella fascia 29.50–29.99 secondi subiscano un doppio arrotondamento scattando 1 minuto avanti rispetto al calendario ufficiale.
Errore comune / Nota di attenzione: Arrotondare prima il minuto decimale al secondo più vicino e poi convertirlo in minuti con la regola dei :30 s sposta orari di confine come 12:04:29.60 prima a :30 e poi a 12:05, generando un invisibile errore di doppio arrotondamento.
double toplamTamSaniye = Math.Floor(dakika * 60.0 + 1e-7); // DakikayiSaatMetnineCevir
TryDakikaBazliVakitCozumle: if (saniye ≥ 30) dakika++;   yuvarlanmisToplamSaniye = saat * 3600 + dakika * 60;
#99

99) Traslazione di -86,400 s dell'Orario di ʿIshāʾ di Ieri (d-1) e Continuità Oltre la Mezzanotte

Superate le 00:00 di notte, quando non è ancora entrato l'Imsak di oggi, l'orario vigente è quello di ʿIshāʾ di ieri (d-1). Per calcolare senza interruzioni la percentuale di riempimento dell'anello del conto alla rovescia (tempo trascorso / durata totale), gli orari di ʿAṣr, Maghrib e ʿIshāʾ di ieri vengono risolti sull'asse aperto del giorno d-1 e traslati sull'asse temporale odierno di -86,400 s.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così affinché allo scoccare delle 00:00:00 l'anello di ʿIshāʾ non si azzeri, ma mostri senza interruzioni l'effettivo avanzamento notturno fisico dalla sera fino all'alba.
int_dun_yatsi = dunAcikYatsi - 86400; // Riferimento iniziale attivo di ʿIshāʾ dopo le 00:00
#100

100) Asse Aperto dei Secondi [-86,400 s .. +172,800 s] Centrato su Ẓuhr e Sensibile a ΔTZ (Soglia -60 s)

In fusi orari manuali fortemente spostati a est o ovest (es. Imsak alle 06:30 a Kashgar UTC+8, alle 23:28 a Fuyuan, oppure slittamento di Ẓuhr vicino alla mezzanotte con scelte manuali inverse di TZ), per impedire che i 6 orari scorrano di giorno, il risolutore su asse aperto pone dapprima Ẓuhr al centro, riavvolge all'indietro Sorgere del Sole e Imsak, e porta avanti ʿAṣr, Maghrib e ʿIshāʾ mediante la differenza di fuso ΔTZ·3600 e la regola di svolgimento alla mezzanotte con soglia -60 s.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché la vecchia soglia di 12 ore (-43,200 s) faceva ricadere ʿIshāʾ al mattino nelle lunghe notti a 58°–65°, mentre svolgere in avanti da Imsak avrebbe potuto spostare l'intera giornata di +86,400 s con offset manuali estremi di TZ; l'ancoraggio su Ẓuhr protegge entrambe le estremità.
Errore comune / Nota di attenzione: Controllare se lo scarto sia inferiore a -12 ore (-43,200 s) per individuare lo sforamento oltre la mezzanotte sembra intuitivo, ma nella fascia 60°N, quando Maghrib è alle 15:30 e ʿIshāʾ alle 03:45 del mattino seguente (-11 h 45 min), fa ricadere erroneamente ʿIshāʾ al mattino.
while (sGunes ≥ (sOgle - tzFarkGO) + 61) sGunes -= 86400;   while (sImsak ≥ (sGunes - tzFarkIG) + 61) sImsak -= 86400;
sIkindi = GeceYarisiSarkmasiniAc(sOgle, sIkindi, tzOgle, tzIkindi); // fizikselFark ≤ -61 s → +86400
#101

101) Abbinamento di Imsak e Sorgere di Domani ai Margini Orientali di Fuso (Imsak alle 23:28 a Fuyuan, Ancora Solare ±64,800 s)

In località come Fuyuan (48.37°N, 134.28°E, UTC+8), all'estremità orientale della Cina, d'estate l'Imsak di domani entra alle 23:28 (prima delle 00:00). L'algoritmo di svolgimento di domani colloca dapprima il Sorgere di domani nella fascia di ±64,800 s attorno al secondo aperto di Sorgere di oggi, poi riavvolge l'Imsak di domani all'indietro rispetto al Sorgere considerando ΔTZ e aggiunge +86,400 s a entrambi.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché lasciare l'Imsak di domani delle 23:28 spostato a +86,400 s mostrerebbe 24 ore in più nel conto alla rovescia tra le 23:28 e le 00:00; l'ancora solare di riserva e il riavvolgimento all'indietro funzionano senza interruzioni in ogni fuso manuale.
while (cozulmusGunes - yedekGunesSn ≥ 64801) cozulmusGunes -= 86400;   while (yedekGunesSn - cozulmusGunes ≥ 64801) cozulmusGunes += 86400;
while (cozulmusImsak ≥ (cozulmusGunes - tzFark) + 61) cozulmusImsak -= 86400;   yarinImsakAcikSn = cozulmusImsak + 86400;
#102

102) Rinnovo Preventivo della Tabella al 6.º Giorno (d ≥ 6), Attesa Coroutine e Tempo Unico per Fotogramma

Il gestore di visualizzazione campiona un'unica volta all'inizio di ogni secondo l'ora locale e il fuso orario della località passando la stessa coppia temporale a tutti i sottomoduli. Quando l'app rimane aperta offline per più giorni, un giorno prima che si esaurisca l'ultimo giorno della tabella (se la differenza di giorni è ≥ 6 oppure mancano i record d'archivio locale di domani e del 7.º giorno e non vi è alcun calcolo in background in corso) ricostruisce la tabella e aggiorna subito l'indice del giorno attivo.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché attendere il 7.º giorno potrebbe provocare sforamenti d'indice leggendo le schede di domani (d+1 = 7) o d+2 nella serata del 6.º giorno; il rinnovo preventivo al 6.º giorno mantiene pronto il cuscinetto d+1 e d+2.
if (KonumAlma.IlkKonumKayitliMi() && _sonOtomatikYenilemeTarihi != konumSimdi.Date && (gunFarki ≤ -1 || gunFarki ≥ 6 || yarinVeSonGunDepoKaydiEksik))
{ bulucu.yerel_vakitleri_ayarla(); d = AktifTabloGunIndeksiniBul(konumSimdi, out gunFarki); }
#103

103) Allineamento Esatto al Minuto :00 tra Scheda–Contatore–Anello, Anelli Gemelli Mattutini e Transizione a Ẓuhr Dopo il Sorgere di Domani

Poiché le schede mostrano minuti interi HH:mm, anche il timer del conto alla rovescia (arrotondamento per eccesso ai secondi, tempo residuo − 10⁻⁹) e gli anelli circolari di avanzamento adottano gli stessi limiti esatti di minuto (:00); così a 0.4 secondi dalla scadenza il contatore non mostra prematuramente 00:00:00. Tra Imsak e Sorgere si riempiono gli anelli gemelli di Imsak e Sorgere; tra Sorgere e Ẓuhr gli anelli restano inattivi (-1) mentre il contatore punta a Ẓuhr (o l'etichetta di Jumuʿah al venerdì), e nei fusi molto orientali, se prima delle 00:00 è già trascorso anche il Sorgere di domani, conta verso il Ẓuhr di domani.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché mostrare 00:00:00 alle 19:03:59.6 mentre sulla scheda appare 19:04 darebbe la sensazione di azzeramento anticipato di mezzo secondo; l'arrotondamento per eccesso con soglia al millisecondo azzera il contatore esattamente sulla frontiera :00.0.
int kalanSaniye = Math.Max(0, (int)Math.Ceiling(kalanFizikselSn - 1e-9)); // Previene 00:00:00 anticipato
simUtc ∈ [imsakUtc, gunesUtc) → aktifIndeks = 0;   simUtc ∈ [gunesUtc, ogleUtc) → aktifIndeks = -1; // Anello inattivo, contatore su Ẓuhr
#104

104) Conto alla Rovescia Fisico in UTC e Stato Live nella Notte dell'Ora Doppia Autunnale 02:00..02:59

Nella notte d'autunno in cui gli orologi vengono riportati indietro dalle 03:00 alle 02:00, l'ora a muro 02:00–02:59 trascorre due volte (primo passaggio in ora legale, secondo passaggio in ora solare). Il risolutore di orario attivo e tempo rimanente basato su UTC riconduce tutti gli orari all'unico asse fisico dei secondi UTC sottraendo il rispettivo fuso orario; così nel salto indietro 02:59:59 → 02:00:00 il contatore non balza avanti di 1 ora, ma decresce monotonicamente secondo dopo secondo. Per esempio, la percentuale di avanzamento di ʿIshāʾ dopo mezzanotte è la frazione percorsa dell'intero intervallo fisico notturno tra l'istante di ʿIshāʾ traslato di ieri e l'istante di Imsak di oggi.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché i contatori che sottraggono semplicemente l'orario a muro sballano riavvolgendo il conto alla rovescia di 1 ora nella notte DST d'autunno appena l'orologio torna dalle 03:00 alle 02:00; sull'asse UTC il tempo scorre invece in un unico verso.
Errore comune / Nota di attenzione: I timer che calcolano il conto alla rovescia per differenza tra ore locali a muro traggono in inganno aumentando di colpo il tempo residuo di 1 ora nell'istante in cui d'autunno l'orologio arretra dalle 03:00 alle 02:00.
double kalanFizikselSn = (hedefGunIciSaniye - hedefTzSaat * 3600.0) - (suanGunIciSaniye - simdiTzSaat * 3600.0);
#105

105) Passaggio Individuale delle 6 Schede all'Orario di Domani al Superamento del Proprio Istante Fisico UTC

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché anziché mantenere su una scheda ormai passata l'orario concluso di oggi, mostrare la prossima occorrenza di domani agevola durante tutta la giornata la pianificazione del suḥūr, del mattino e del mezzogiorno.
kart_yapilandirma → KartiYapilandir(bugunVakitStr, bugunAcikHedefSaniye, bugunHedefTz, yarinVakitKey, ...);
DateTime hedefUtc = VakitUtcAniniHesapla(gunTabani, bugunAcikHedefSaniye, bugunHedefTz, enlem, boylam); // Se simdiUtc ≥ hedefUtc allora d+1 (all'occorrenza d+2)
#106

106) Integrità RichText da Destra a Sinistra (RTL: Arabo / Urdu), Protezione dei Simboli Unicode e Suddivisione a 1650 Caratteri

Mentre i testi del pannello esplicativo vengono mostrati con animazione a macchina da scrivere, lo strato di protezione dei tag di formattazione non spezza a metà in nessun fotogramma i tag di colore, grassetto o corsivo e chiude temporaneamente quelli aperti. Affinché il parser di tag del componente di testo RTL non scambi coppie di minore/maggiore per tag HTML, nei testi si utilizzano i simboli Unicode ≤, ≥, ∈, ↔, → anziché i segni nudi minore/maggiore, e i passi lunghi oltre il limite di 1650 caratteri vengono divisi in blocchi RTL consecutivi preservando i tag di formattazione.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché nelle lingue RTL un tag colore interrotto durante l'animazione o un conflitto di minore/maggiore può far trapelare codice di formattazione sullo schermo; la suddivisione bilanciata in più parti e i simboli Unicode assicurano un aspetto pulito in ogni lingua.
const int RTL_GUVENLI_PARCA_SINIRI = 1650; // I passi oltre il limite sono suddivisi con pila di tag RichText aperti in blocchi RTLTextMeshPro consecutivi
GuvenliDaktiloAltMetniAl(tamMetin, gorunurHarfSayisi);   GuvenliRtlParcalaraBol(metin, 1650);
#107

107) Protezione del Testo Offline a Tre Livelli e Progettazione del Parser Deterministico

Questo rapporto tecnico aperto in 112 passi è protetto su tre livelli indipendenti di riserva: (1) tabella dinamica di localizzazione, (2) flusso locale cifrato di backup dati e (3) riserva di ultima istanza incorporata direttamente nell'interfaccia. Grazie a un parser basato su macchina a stati deterministica priva di reflection, continua a funzionare offline su diverse architetture mobili senza risentire delle ottimizzazioni del compilatore.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così affinché lavorando offline o in caso di ritardi nel caricamento dei pacchetti il pannello esplicativo non resti mai vuoto e si apra con identica affidabilità su tutte le piattaforme mobili.
Tabella Principale → Flusso di Backup Locale Offline → Riserva Incorporata nell'Interfaccia;
AyiklaSafJsonYedek(safJsonMetin, hedefTablo); // Parser a macchina a stati deterministica senza reflection
#108

108) 77 Verifiche Indipendenti di Algoritmo, Geodesia, Fuso Orario, Continuità Polare e Scuola Giuridica

Le 77 verifiche indipendenti di convalida nell'ambiente di sviluppo collaudano i limiti IEEE-754 di JDN e Mod(360°), le effemeridi di Meeus e la continuità di rifrazione di Sæmundsson, il geoide EGM96 a due livelli, la distinzione di altitudine Android/iOS, la coerenza paese/autorità/fuso nel database offline di 8,023 località, i poligoni di confine di Mediterraneo Orientale/Marocco/Kazakistan/11 fusi della Russia/Brasile/Nord America/Pacifico, la continuità polare su 365 giorni, il conto alla rovescia UTC e l'ambito esclusivo Hanafita/Sciafeita.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché perfezionare un singolo poligono di confine o una transizione polare senza alterare una città di un altro continente è possibile solo tramite verifiche esaustive eseguite a ogni modifica.
// 77/77 verifiche indipendenti di convalida: Effemeridi + EGM96 + 8,023 Località + 365g Polare + Fiqh
#109

109) Dichiarazione di Umiltà Scientifica e Trasparenza: Limiti Naturali di Scostamento Atmosferico, Topografico e di Calendario

Nota di Umiltà Scientifica e Giuridica: I calcoli si basano su modelli di atmosfera standard e orizzonte urbano medio; nei secondi di confine è naturale riscontrare differenze di ±1 minuto rispetto ai calendari ufficiali, osservando quindi la dovuta cautela nel digiuno e nella preghiera.

Sebbene questo motore in 112 passi sia costruito con grande cura numerica, i modelli del cielo e della Terra restano per loro natura approssimazioni fisiche: (1) variazioni di temperatura (-30 °C..+45 °C), pressione, umidità e inversioni termiche possono alterare la rifrazione apparente all'orizzonte di ±15–40 s; (2) valli, creste montuose e ostacoli edilizi possono scostare sorgere/tramonto locali dall'orizzonte piatto del distretto; (3) la quantizzazione a 1 m del geoide EGM96, la stima di ΔT negli anni futuri e l'arrotondamento al minuto :30 / Ceiling / Floor possono generare nei secondi di confine uno scarto naturale di ±1 minuto rispetto ai calendari stampati. Negli atti di culto vige la precauzione sharʿī.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché condividere apertamente i limiti fisici della natura anziché presentare il calcolo astronomico come un righello meccanico immutabile è l'atteggiamento più consono tanto all'etica e umiltà islamica quanto all'onestà scientifica.
// Limiti naturali fisici e di calendario: Atmosfera (±15..40 s) + Ostacoli Locali d'Orizzonte + Quantizzazione al Minuto (±1 min)
#110

110) Trasparenza Aperta dell'Algoritmo Rispetto al Confine di Archiviazione Interna dell'Applicazione

Tutte le equazioni astronomiche, le costanti geodetiche, le regole decisionali di paese e fuso orario, i criteri giuridici di arrotondamento e i valori intermedi di telemetria live esposti in questo rapporto sono condivisi apertamente affinché utenti finali e ricercatori possano esaminarli direttamente. Per chiarezza di lettura, titoli e paragrafi esplicativi sono presentati con concetti tecnici chiari in italiano; per i lettori tecnici, i nomi dei metodi principali vengono riflessi unicamente nelle righe di Logica C# in esecuzione. Il formato interno di impacchettamento dei file dell'applicazione, i nomi locali di archiviazione chiave-valore e il layout di memoria cache interna sono espressi mediante concetti architetturali astratti sia per riservatezza sia per stabilità multipiattaforma.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché rendere trasparente il metodo di calcolo scientifico e giuridico si bilancia con l'astrazione dei dettagli interni di impacchettamento e archiviazione dati dell'app; per verificare il calcolo è sufficiente la sola logica matematica e giuridica.
Errore comune / Nota di attenzione: Mantenere riservate le chiavi interne di archiviazione locale o i nomi dei file di pacchetto non significa che il calcolo sia chiuso; tutte le formule solari, d'orizzonte e giuridiche sono fornite integralmente dall'inizio alla fine.
Strato Trasparente: Effemeridi Astronomiche + Regole Fuso Orario + Arrotondamento Giuridico + Telemetria Live;
Strato Astratto: Percorso Interno dei Pacchetti, Chiavi di Archiviazione Locale e Struttura della Memoria Interna;
#111

111) Proiezione dall'Asse UTC all'Orologio a Muro Locale e Scarto di Precisione di 0.0001 min (≈ 0.006 s)

Nel calcolo giornaliero gli orari grezzi trovati dapprima come minuti frazionari nel fuso continuo di riferimento di mezzogiorno (es. 1034.5015 min) vengono quindi proiettati singolarmente attraverso l'asse del tempo universale UTC nel fuso locale vigente per ciascun orario (incluse le transizioni DST). A causa dell'arrotondamento IEEE-754 in virgola mobile e millisecondi–tick nella conversione dal tempo universale al timestamp locale in tick, nell'output a 4 decimali del minuto netto nel rapporto può apparire una variazione dell'ultima cifra pari a 0.0001 min (circa 0.006 secondi = 1/160 di secondo); le schede orarie a minuto intero (:30 / Floor / Ceiling) non subiscono alcun effetto da tale margine di microproiezione.

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché nei giorni DST ciascun orario va trasferito dal proprio fuso UTC istantaneo all'orologio a muro reale; abbiamo documentato apertamente la sorgente fisica affinché il lettore non scambi questa oscillazione dell'ultima cifra di 0.0001 min per un errore di formula.
Errore comune / Nota di attenzione: Vedere 1034.5016 al posto di 1034.5015 nell'output a quattro decimali del minuto netto può sembrare una contraddizione di calcolo; in realtà la differenza è soltanto l'arrotondamento di proiezione temporale UTC↔locale di 0.006 secondi e non modifica l'ora di preghiera.
Orario Netto (min locale) = TekilVakitUtcDenYerelDakikayaCevir(enlem, boylam, utcGunTabani, yerelGunTabani, ogleSaatDilimi, netVakitDakika, out gercekDilim, ref dstFarkiBulundu); // ≤ 0.0001 min (≈ 0.006 s)
#112

112) Riepilogo di Verifica Finale dei 6 Orari di Oggi e Domani e Firma Cache v6

Motivo (Perché abbiamo fatto così): Abbiamo fatto così perché permettere all'utente e al revisore di confrontare a colpo d'occhio gli orari finali delle schede di oggi e di domani generati da tutte le grandezze astronomiche intermedie insieme alla firma della cache completa la trasparenza.