Metodología de Cálculo de los Horarios de Oración Islámicos: Monografía Astronómica, Geodésica y Jurídica en 112 Pasos

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.

✦ Declaración de Ciencia Abierta y Uso Público Gratuito

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 de Alcance Exclusivo Hanafí y Shafi'í y Marco Jurídico-Islámico (Fiqh)

Nota sobre el Alcance Jurídico (Únicamente Hanafí y Shafi'í): Todos los cálculos de horarios de oración, proporciones de sombra, límites de karāha (tiempos desaconsejados) y reglas de precaución de esta aplicación están estructurados únicamente según la metodología de las escuelas jurídicas Hanafí y Shafi'í; las demás escuelas quedan fuera de alcance.

Los coeficientes de sombra de la oración de la Tarde (ʿAṣr al-Awwal +1 sombra: Diyanet / al-Imāmayn Hanafíes / Shafi'í y ʿAṣr al-Thānī +2 sombras: Imam al-Aʿẓam Abū Ḥanīfa), los ángulos de Fajr al-Ṣādiq y del crepúsculo (shafaq), los límites de karāha de istiwāʾ/ṭulūʿ/ghurūb y las reglas de Niṣf al-Layl (medianoche sharʿī) se han modelado exclusivamente conforme al método jurídico de estas dos escuelas.

Motivo (Por qué lo hicimos así): Lo hicimos así porque el usuario debe ver con total transparencia desde el primer momento bajo qué criterios jurídicos se generan los horarios y así evitar confusiones conceptuales entre escuelas.
ikindi_golge ∈ { 1f (ʿAṣr al-Awwal: Diyanet / al-Imāmayn / Shafi'í), 2f (ʿAṣr al-Thānī: Hanafí / Imam al-Aʿẓam) };
resmiTemkin + FikhiGuvenliSaatMetnineCevir(...) // Método de precaución Hanafí y Shafi'í
#02

2) Bloqueo de Espera ??:?? Orientado a la Privacidad, Rechazo de (0°, 0°) y Bloqueo de la Santa Kaaba (277 m)

Si aún no se ha seleccionado una ubicación, no se asigna ninguna capital predeterminada oculta; las tarjetas de horarios esperan mostrando ??:?? y el temporizador ??:??:??. En la puerta de validación de coordenadas se rechazan el punto nulo del Golfo de Guinea (0°, 0°), valores indefinidos (NaN/Infinity) y entradas erróneas fuera de [-90°, +90°]. Si el usuario confirma la opción de la Santa Kaaba, se activan las coordenadas de 64 bits de la Kaaba (21.422487°N, 39.826206°E, bloqueo de protección ±1e-5°), 277 m de altitud del Hiyaz, código de país SA (UTC+3) y la autoridad Umm al-Qura.

Motivo (Por qué lo hicimos así): Lo hicimos así para evitar que un usuario que no conceda permiso de GPS sea engañado inadvertidamente con los horarios de otra ciudad, y para preservar las coordenadas exactas y los 277 m de altitud al elegir la Kaaba sin deriva de coma flotante de 32 bits.
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) Transferencia de Coordenadas en Doble Precisión de 64 Bits y Envoltura Semiabierta [-180°, +180°)

Las coordenadas seleccionadas desde el mapa o la base de datos urbana sin conexión se almacenan como números de doble precisión de 64 bits (decimales exactos sin redondeo); las coordenadas de 32 bits procedentes del GPS en vivo (~1.1 m de cuantización terrestre ≈ 0.003 s de tiempo) se promueven al espacio de 64 bits en el primer instante de lectura y pasan por la comprobación de validez. Al desplazar el mapa, las longitudes que cruzan el meridiano ±180° de cambio de fecha se reducen mediante normalización cíclica al intervalo semiabierto [-180.0°, +180.0°).

Motivo (Por qué lo hicimos así): Lo hicimos así para impedir que se acumule ruido de coma flotante de 32 bits a lo largo de cientos de pasos trigonométricos de efemérides y para eliminar colisiones de frontera por doble representación en la costura del antimeridiano +180° y -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) Antigüedad del Paquete GNSS en Milisegundos, Avance del Sensor en Vivo y Protección al Despertar en Segundo Plano

Los sistemas operativos móviles pueden devolver una última ubicación conocida obsoleta de horas atrás cuando se acaba de activar el servicio de ubicación o cuando la app vuelve de segundo plano. La puerta de frescura compara la edad del paquete con el tiempo Unix en milisegundos; en dispositivos con reloj del sistema desfasado comprueba si la marca temporal del sensor satelital avanza en coherencia con el reloj de pared (avance del sensor positivo por encima de 0.05 s y diferencia entre el avance del sensor y el reloj del sistema ≤ 30.0 s) y reinicia la referencia de frescura al regresar de una suspensión en segundo plano ≥ 30 s.

Motivo (Por qué lo hicimos así): Lo hicimos así para evitar que un usuario que acaba de bajar de un avión o reabre la app horas después vea los horarios de su ciudad anterior debido a la caché GPS obsoleta de los primeros 8 segundos.
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) Distinción de Altitud entre Android (Elipsoidal WGS84 h) e iOS (Nivel Medio del Mar MSL)

En el eje vertical, los dos sistemas operativos móviles devuelven superficies de referencia distintas: el servicio de ubicación de Android entrega la altura geométrica sobre el elipsoide de referencia WGS84 (h), mientras que el de iOS devuelve directamente la altitud sobre el nivel medio del mar (MSL). El conversor de altitud aplica la resta de la ondulación del geoide (N) únicamente a la altura elipsoidal de Android.

Motivo (Por qué lo hicimos así): Lo hicimos así porque restar el geoide por segunda vez a la altitud MSL procedente de dispositivos iOS reduciría artificialmente la altitud en 30–38 metros en Turquía, mientras que no restarlo en Android la sobrestimaría en esa misma magnitud.
Error común / Nota de atención: Se suele creer que la altitud GPS devuelve directamente el nivel del mar (MSL) en todos los teléfonos; sin embargo, como Android entrega altura elipsoidal bruta (h) e iOS entrega MSL ya corregida por el geoide, aplicar la misma fórmula a ambas plataformas produce un desfase de ~30–38 m en Turquía.
float jeoidN = androidElipsoidYuksekligiMi ? YaklasikJeoidOndulasyonuMetre(enlem, boylam) : 0f;
denizSeviyesiMetre = hamGnssRakimMetre - jeoidN;
#06

6) Ondulación del Geoide NGA EGM96 de Dos Capas (2°x2° Global + 0.5°x0.5° Regional, ~17.2 KB)

Para convertir la altura elipsoidal de Android (h) en altitud sobre el nivel del mar (H = h − N), se utiliza una malla bilineal comprimida de dos capas derivada del modelo NGA EGM96 (cuantizada en enteros con signo de 1.0 m, 17,632 bytes en total ≈ 17.2 KB): en todo el mundo opera la tabla global de 2°x2° (91x181 nodos), mientras que en la franja de Turquía, Chipre y Oriente Próximo (30°N–43°N, 25°E–46°E) se mezcla con transición de borde de Hermite de 1° una subtabla de 0.5°x0.5° (27x43 nodos) que sigue el gradiente de la meseta anatolia (la cuantización geoidal de 1.0 m equivale a ~0.002° en el ángulo del horizonte).

Motivo (Por qué lo hicimos así): Lo hicimos así porque las mallas gruesas de 15°x15° subestiman en 10–12 metros la cúpula geoidal de la meseta anatolia; la malla comprimida de dos capas ocupa solo ~17.2 KB en memoria y acota la desviación en torno a ~1 metro.
Error común / Nota de atención: Las tablas geoidales gruesas de 10°–15° usadas en códigos simples muestrean esquinas de Egipto, el mar Negro y el Caspio, saltándose por encima la cúpula positiva local del geoide en Anatolia (+27..+38 m) y dejando ~11 m de error en Kahta y Anatolia Central.
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) Límites Físicos de Altitud [-450 m Mar Muerto .. 8850 m Everest] y Efecto de Densidad en Cuencas Hundidas

La puerta de validez de altitud toma como base el intervalo común sobre el nivel del mar (MSL) [-450 m, 8850 m] en todos los módulos; así se preservan tanto las depresiones bajo el nivel del mar como la orilla del Mar Muerto / Lago Lut (-430 m, Jericó/Valle del Jordán) y el Mar de Galilea (-210 m) como todos los asentamientos hasta la cima del Everest (8849 m). En depresiones con altitud negativa la columna de aire es más densa que al nivel del mar, por lo que el factor de Gladstone–Dale supera naturalmente 1.0 (en el Mar Muerto ρ/ρ₀ ≈ 1.042); en cambio, la depresión óptica del horizonte ΔH = max(0, H − H₀) evita raíces negativas.

Motivo (Por qué lo hicimos así): Lo hicimos así porque fijar el límite inferior en 0 m borraría la altitud real en localidades cercanas al Mar Muerto y Jericó y pasaría por alto la refracción atmosférica ~4.2 % más densa de esa cuenca.
Error común / Nota de atención: Tomar la altitud negativa por un error y anularla con max(0, H) es una trampa habitual; en la ribera de Jericó y el Mar Muerto (-430 m) la altitud es realmente negativa y únicamente la diferencia óptica del horizonte (ΔH ≥ 0) no puede ser menor que cero, mientras que la refracción por densidad aumenta.
double gecerliRakim = Math.Clamp(rakimMetre, -450.0, 8850.0); // Mar Muerto -430m → ρ/ρ₀ ≈ 1.0420
double deltaH = Math.Max(0.0, gecerliRakim - Math.Clamp(H0, -450.0, 8850.0));
#08

8) Horizonte de Plomada Geodésica WGS84 y Protección del Denominador Polar [-90°, +90°] (|cos φ · cos δ| ≥ 1e-12)

La superficie del agua y el plano natural del horizonte terrestre son perpendiculares a la dirección de la gravedad local (plomada / plumb-line), no al centro de la Tierra. Por esta razón física, en el cálculo del horizonte y la altura solar se emplea directamente la latitud geodésica WGS84 suministrada por el GPS en el rango [-90.0°, +90.0°] en lugar de la latitud geocéntrica; en los polos geográficos exactos ±90.0° actúa la protección |cos φ · cos δ| ≥ 1e-12 contra divisiones por cero cuando cos(φ)·cos(δ) → 0.

Motivo (Por qué lo hicimos así): Lo hicimos así porque debido al achatamiento terrestre (~1/298.257) convertir la latitud geodésica en geocéntrica inclina artificialmente el horizonte de plomada local ~11.5 minutos de arco a 45° de latitud; la latitud geodésica es coherente con el horizonte físico.
Error común / Nota de atención: Como la Tierra es achatada, suele creerse que convertir la latitud GPS a geocéntrica mediante atan((1 − f²)·tan φ) mejora la precisión; sin embargo, la superficie de un líquido en reposo y el horizonte natural son perpendiculares a la plomada gravitatoria local (latitud geodésica), no 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) Aislamiento de Altitud y País Obsoletos al Cambiar entre Ciudad Guardada ↔ GPS en Vivo y sin Conexión

Cuando el usuario vuelve al modo GPS en vivo desde una ciudad guardada de gran altitud (por ejemplo, Erzurum 1900 m o La Paz 3640 m), elimina la ubicación guardada o recibe una nueva posición GPS horizontal en modo avión con precisión vertical no válida, se restablecen los campos en caché de altitud local, nombre de ubicación y código de país de la ciudad anterior; además, un fallo de red sin conexión no bloquea la actualización de horarios y la consulta de dirección se completa en segundo plano en intervalos de 30 s.

Motivo (Por qué lo hicimos así): Lo hicimos así porque al descender de una ciudad de montaña a la costa, la filtración de una altitud obsoleta de 1900 m o del código de país anterior a la nueva ubicación falsearía el Horizonte Óptico Personal y la autoridad automática.
if (gpsRakimGecerli) { sonKayitliRakim = Clamp(currentAlt, -450f, 8850f); _sonGercekRakimBiliniyor = true; }
else if (mesafe ≥ 5.0 && _sonGercekRakimBiliniyor) { sonKayitliRakim = 0f; _sonGercekRakimBiliniyor = false; } // Bloqueo país/altitud en GuncelKonumuZorlaVeKaydet (Paso 110)
#10

10) Histéresis Esférica de Haversine (0.5 km / 10 km), Bloqueo Longitudinal Polar de 0.0045° y Refresco de Frontera

Para proteger la batería y el consumo de red en movimiento opera un umbral esférico de Haversine de dos niveles: al desplazarse horizontalmente ≥ 0.5 km (500 m) se renueva la tabla de horarios sin conexión; al recorrer ≥ 10.0 km se actualiza el nombre de ciudad o distrito. La validación de caché comprueba además de la distancia de 0.5 km que la diferencia normalizada de longitud sea ≤ 0.0045° para los puntos cercanos a los polos donde convergen los meridianos; al cruzar fronteras se refresca la caché de zona horaria del sistema.

Motivo (Por qué lo hicimos así): Lo hicimos así porque recalcular toda la tabla cada segundo ante oscilaciones naturales de 5–20 m del GPS en interiores agota la CPU; en cambio, si cerca de un polo se caminan 200 m cruzando hacia el meridiano opuesto, el bloqueo longitudinal de 0.0045° renueva la caché de inmediato.
double boylamFarki = Math.Abs(NOAA_Verileri.Sarmala180((double)sonBoylam - (double)hesapBoylam));
bool koordUyumlu = Math.Sign(KureselMesafeKm(...) - 0.5) == -1 && boylamFarki ≤ 0.0045; // menos de 0.5 km
#11

11) Sensibilidad de Caché del Horizonte Óptico Personal (Umbral Angular de 0.035°)

Dado que en las autoridades oficiales de calendario urbano rige un horizonte urbano plano (ΔH = 0), subir entre pisos de un edificio no invalida innecesariamente la caché. En cambio, cuando se activa la corrección de horizonte óptico en Ajustes Personales, no se evalúa la diferencia bruta de √H, sino si la diferencia angular de depresión neta del horizonte tras descontar la altitud base del entorno (H₀) supera el umbral de 0.035° (umbral de efecto ~8 s en el ecuador, variación aproximada de ±40 m de altitud al nivel del mar).

Motivo (Por qué lo hicimos así): Lo hicimos así porque en una llanura con H₀ = 500 m, al subir de 501 m a una colina de 540 m, el salto relativo ΔH = 0 → 40 m eleva la depresión real del horizonte de 0° a 0.22°; medir directamente |Δα_net| detecta este ascenso.
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) Escritura Atómica en el Primer Fotograma (d-1 + i=0 + i=1), Bloqueo de Carrera y Verificación de Integridad de 8 Días

Al seleccionar una nueva ubicación o autoridad se detiene cualquier flujo de cálculo previo inconcluso, se limpian los segmentos obsoletos de días futuros y se actualizan atómicamente en el mismo fotograma los días d-1 (ayer), hoy (i=0) y mañana (i=1) junto con los datos completos de la noche sharʿī. Mientras los días posteriores (d+2..d+7) continúan en fotogramas siguientes, un bloqueo de concurrencia evita colisiones con la capa de escritura y cancela el flujo a mitad si cambia la configuración.

Motivo (Por qué lo hicimos así): Lo hicimos así para evitar que durante cambios rápidos de autoridad o escuela jurídica dos flujos escriban en paralelo sobre las mismas ranuras de caché local (desgarro de datos) y para que después de ʿIshāʾ no falte la lectura de mañana (i=1).
if (_aktifHesaplamaRutin != null) StopCoroutine(_aktifHesaplamaRutin);
MevcutTabloKullanilabilirMi(): true si están completos los registros de almacén ayer/hoy/mañana/7.º día + coordenadas + firma v6; // Nombres de clave abstraídos en el Paso 110
#13

13) Base en Tiempo Universal Coordinado (UTC) y Resolución Iterativa de Zona Horaria Local → UTC

Dado que el reloj de pared local salta hacia adelante o repite la misma hora en los cambios de horario de verano/invierno, el motor de horarios y la cuenta regresiva se alimentan del eje temporal universal UTC y utilizan el instante UTC único incluso en las horas duplicadas de otoño. Al buscar la zona horaria para una hora de calendario local se ejecuta también una convergencia local → UTC en 2 pasos para evitar desfases en la noche de transición.

Motivo (Por qué lo hicimos así): Lo hicimos así porque en la noche de retraso otoñal del reloj, consultar solo la hora de pared local puede caer en el huso erróneo durante la hora duplicada 02:00..02:59; en cambio, el eje universal UTC fluye de manera monótona.
DateTime utcSimdi = DateTime.UtcNow;
DateTime konumSimdi = UtcAniniAktifKonumYerelZamaninaCevir(enlem, boylam, utcSimdi, out double aktifDilim);
#14

14) Zona Horaria Manual en Pasos de 15 Minutos (0.25 h) y Validación por País de la Zona del Dispositivo (≤ 0.05 h)

La resolución de zona horaria consta de tres capas: (1) Para el usuario conectado a una antena extranjera junto a la frontera o que desee fijar la hora local extraoficial en Xinjiang (UTC+6) o zonas de cuarto de hora como Nepal (+5.75) / Chatham (+12.75), se aplica directamente la Zona Horaria Manual en pasos de 0.25 h (15 min). (2) En modo GPS en vivo, la zona horaria del sistema del dispositivo solo se utiliza si sus desplazamientos con signo de enero y julio coinciden con el polígono dentro de una tolerancia ≤ 0.05 h y son compatibles con la identidad DST específica del país (EG, IL, PS, LB, MA, IR, JO, SY).

Motivo (Por qué lo hicimos así): Lo hicimos así porque si un usuario tiene seleccionada Atenas (DST de la UE) en su teléfono mientras está en El Cairo (DST de Egipto), aunque los desplazamientos de enero y julio sean idénticos (+2/+3), las 4 semanas de desfase en la transición de abril desplazarían los horarios 1 hora.
Error común / Nota de atención: Dar por buena la zona horaria del dispositivo mirando únicamente la igualdad de los desplazamientos de enero (+2) y julio (+3) resulta engañoso; aunque Atenas, El Cairo, Beirut y Jerusalén comparten el mismo huso en invierno y verano, sus semanas de transición primaveral difieren.
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), Islas del Egeo y Polígonos Kaş–Kastelórizo

Mientras Turquía mantiene UTC+3 permanente todo el año, sus vecinas Bulgaria y Grecia usan UTC+2 en invierno y UTC+3 en verano. Para que las localidades fronterizas no invadan el huso vecino, se separan mediante polígonos diferenciados Edirne Karaağaç / Pazarkule (TR) frente a Kastanies / Orestiada (GR), Kapitan Andreevo / Svilengrad y el entrante de Malko Tarnovo en Strandzha (BG), Gökçeada/Çeşme/Datça frente a las islas de Quíos/Lesbos/Kos/Simi/Rodas, y Kaş en Antalya (TR, UTC+3) frente a la isla de Kastelórizo / Meis a 2 km mar adentro (GR, UTC+2/+3).

Motivo (Por qué lo hicimos así): Lo hicimos así porque usar cajas rectangulares gruesas alrededor de Kırklareli o Kaş incluiría Malko Tarnovo en Turquía o la costa de Kaş en Grecia, produciendo un error horario de 60 minutos en invierno.
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; // Isla Meis / Kastelórizo (GR) vs Kaş (TR +3)
#16

16) Isla de Chipre ([34.5°..35.72°N, 32.2°..34.65°E]) Horario Verano/Invierno UE (+2/+3) y Autoridad Diyanet

Aunque la isla de Chipre (RTCN y República de Chipre: Nicosia, Kyrenia/Girne, Famagusta, Pafos) se halla a la misma latitud que Hatay/Mersin, a diferencia del UTC+3 permanente de Turquía utiliza UTC+2 (EET) en invierno y UTC+3 (EEST — último domingo de marzo 01:00 UTC ↔ último domingo de octubre 01:00 UTC) en verano; en cambio, en la autoridad de cálculo automática se vincula a los mismos criterios oficiales de Diyanet (DİYK) que Turquía.

Motivo (Por qué lo hicimos así): Lo hicimos así porque dejar Chipre dentro de la caja principal de Turquía adelantaría 1 hora todos los horarios de oración en Nicosia y Kyrenia en invierno; mantener la zona horaria DST de la UE (+2/+3) y la autoridad en Diyanet concuerda con la práctica local.
Error común / Nota de atención: El uso de los criterios de calendario de Diyanet en el Norte de Chipre induce el error de suponer que su zona horaria también es UTC+3 todo el año como en Turquía; sin embargo, la isla usa UTC+2 (EET) en los meses de invierno.
TZ: if (lat ≥ 34.50 && lat ≤ 35.72 && lon ≥ 32.20 && lon ≤ 34.65) return abYazSaati ? 3.0 : 2.0; // Chipre EET/EEST
País (lat ∈ [34.50, 35.75], lon ∈ [32.20, 34.65]) → "CY" → Otoriteler.Diyanet; // Coincidencia con calendario oficial RTNC / Chipre
#17

17) Curvas Fronterizas Sur y Este de Turquía (Kesab, Alepo, Kobane, Qamishli/Derik, Mosul, Najicheván, Bazargan)

Para asegurar la precisión del código de país y huso horario en las fronteras sur y este de Turquía, se trazan rectas fronterizas oblicuas que separan Yayladağı de la siria Kesab (35.93°N, 35.98°E), Hatay/Kilis de Alepo y Afrin, Suruç/Akçakale de Kobane, el meandro del Tigris entre Nusaybin/Cizre y Qamishli/Derik, Habur/Derecik de Zakho/Mosul, e Iğdır/Dilucu y Gürbulak de Najicheván (Sadarak, UTC+4), Armenia (Ararat, UTC+4) e Irán (Bazargan/Maku/Serow, UTC+3.5).

Motivo (Por qué lo hicimos así): Lo hicimos así porque en el corredor de Iğdır Dilucu, pocos kilómetros al norte Najicheván/Armenia usan UTC+4 y al sur Irán usa UTC+3.5, mientras que en los entrantes fronterizos del sureste el código de país cambia directamente la autoridad automática de cálculo.
Exclusión Sadarak/Ararat (+4): en la franja lat ∈ [39.65, 40.08], al este del límite lon 44.84 - (lat - 39.65) * 1.35 → fuera de TR;
Exclusión Bazargan/Maku (+3.5): en la franja lat ∈ [39.25, 39.65), al este del límite lon 44.38 + (lat - 39.25) * 1.10 → fuera de TR;
#18

18) Báltico/Europa del Este, Kaliningrado (+2), Bielorrusia (+3) y los 11 Husos Horarios de Rusia (Samara–Kamchatka)

En Europa del Este, Estonia, Letonia, Lituania, Finlandia, Ucrania, Rumanía y Moldavia toman UTC+2/+3 con horario de verano de la UE; Polonia (incluida Suwałki) toma UTC+1/+2; Kaliningrado UTC+2 permanente; y Bielorrusia UTC+3 permanente. Dentro de la Federación Rusa se distinguen por límites administrativos Samara/Uliánovsk/Sarátov/Astracán (+4), Ekaterimburgo/Perm/Ufá (+5), Omsk (+6), Novosibirsk/Tomsk/Krasnoyarsk (+7), Irkutsk (+8), Yakutsk/Chitá/Blagovéshchensk (+9), Vladivostok/Jabárovsk (+10), Magadán/Sajalín (+11) y Kamchatka/Chukotka (+12).

Motivo (Por qué lo hicimos así): Lo hicimos así porque en Rusia y Europa del Este redondear simplemente longitud/15 produciría errores de 1 hora en ciudades millonarias con husos administrativos desplazados como Samara, Omsk, Novosibirsk o Irkutsk.
Kaliningrado → +2.0; EE/LV/LT/FI/UA/RO/MD → UE DST (+2/+3); BY y Moscú → +3.0;
RusyaSaatDilimiBul(lat, lon) → Samara +4, Urales +5, Omsk +6, Novosibirsk/Krasnoyarsk +7, Irkutsk +8 .. Kamchatka +12;
#19

19) Motor de Horario de Verano a las 01:00 UTC para la UE, Reino Unido (Londres GMT+0/BST+1), Balcanes, Azores y Canarias

En el continente europeo el horario de verano comienza simultáneamente el último domingo de marzo a las 01:00 UTC y finaliza el último domingo de octubre a las 01:00 UTC: Reino Unido, Irlanda, Portugal y las Islas Canarias de España (27.5°..29.5°N, -18.5°..-13.2°O) usan UTC+0 en invierno y UTC+1 en verano (Londres GMT/BST); Europa Central y los Balcanes Occidentales (Berlín, París, Sarajevo, Skopie) usan UTC+1/+2; las Islas Azores (36.8°..39.8°N, -31.5°..-24.8°O) operan en UTC-1/UTC+0; Islandia usa UTC+0 permanente todo el año.

Motivo (Por qué lo hicimos así): Lo hicimos así porque aunque Londres, Canarias, Azores y Europa continental tengan desplazamientos base distintos, sincronizar sus transiciones en el mismo instante de 01:00 UTC evita desfases en las noches de frontera.
bool AbYazSaatiUtcAktifMi(utcAn): utcAn ∈ [MartSonPazar_01Utc, EkimSonPazar_01Utc);
Islandia → 0.0; Azores → abDst ? 0.0 : -1.0; Reino Unido/Portugal/Canarias → abDst ? +1.0 : 0.0; Europa Central → +1/+2;
#20

20) Motores DST Independientes de Líbano (Sábado 22:00/21:00 UTC) e Israel (Viernes 00:00 UTC, Protegido ≥ 2034)

En el Mediterráneo oriental, Líbano (Asia/Beirut) adelanta el reloj el último domingo de marzo a las 00:00 locales (sábado 22:00 UTC) y lo atrasa el último domingo de octubre a las 00:00 locales (sábado 21:00 UTC). Israel (Asia/Jerusalem) adelanta el viernes anterior al último domingo de marzo a las 02:00 locales (00:00 UTC) y atrasa el último domingo de octubre a las 02:00 (sábado 23:00 UTC); además, ante tablas tzdata de sistemas operativos móviles antiguos que omiten reglas posteriores a 2037, en años ≥ 2034 se activa la regla determinista tanto en la capa de coordenadas como en la de identificador de zona horaria del sistema.

Motivo (Por qué lo hicimos así): Lo hicimos así porque vincular Beirut y Haifa a la regla estándar de la UE del domingo a las 01:00 UTC desfasaría 1 hora los horarios el viernes y sábado de finales de marzo; la protección ≥ 2034 resguarda las consultas futuras.
LubnanYazSaatiUtcAktifMi(utcAn): utcAn ∈ [MartSonCts_22Utc, EkimSonCts_21Utc);
IsrailYazSaatiUtcAktifMi(utcAn): utcAn ∈ [SonPazarÖncesiCuma_00Utc, EkimSonCts_23Utc); // Obligatorio ≥ 2034
#21

21) Palestina (Gaza, Hebrón, Jericó, Qalqilya) DST Sat≥24 + Aplazamiento por Ramadán y Autoridad Egipcia

El polígono de Palestina abarca la Franja de Gaza y las localidades de Cisjordania Qalqilya/Tulkarem (34.96°E), Yenín, Nablus, Ramala, Jerusalén Este, Jericó y Hebrón; excluye puntos fuera de frontera como Ascalón, Beerseba y Ein Gedi. El horario de verano oficial palestino (Asia/Gaza, Asia/Hebron) comienza a las 02:00 del sábado igual o posterior al 24 de marzo (Sat≥24); si esa fecha cae en el mes de Ramadán, se pospone al primer sábado de Shawwāl y termina a las 02:00 del sábado ≥ 24 de octubre. En la autoridad automática, el código PS se vincula al estándar de la Autoridad General Egipcia (-19.5°/-17.5°).

Motivo (Por qué lo hicimos así): Lo hicimos así porque en los años en que marzo tiene 31 días existe una diferencia de 7 días entre el 'último sábado de marzo' y la regla oficial IANA 'Sat≥24'; además, no adelantar la hora durante Ramadán es práctica oficial palestina.
Error común / Nota de atención: Codificar el horario de verano palestino como 'el último sábado de marzo' produce en años con marzo de 31 días (eligiendo el 31 en lugar del 24 de marzo) una desviación exacta de 1 semana respecto a la regla oficial 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) Horario de Verano de Egipto (Último Viernes de Abril – Último Jueves de Octubre) y Frontera Oblicua del Sinaí (Taba–Rafah)

Conforme a la Ley n.º 24 de 2023, Egipto cambia a UTC+3 el último viernes de abril a las 00:00 locales (jueves 22:00 UTC) y regresa a UTC+2 el último jueves de octubre a las 24:00 (jueves 21:00 UTC). En la península del Sinaí, la recta fronteriza oblicua entre Taba en el golfo de Áqaba (34.89°E) y Rafah en la costa mediterránea (34.25°E) (34.905 − (lat − 29.49)·0.395) separa la localidad egipcia de Al-Qusaymah de Mitzpe Ramon en el Néguev.

Motivo (Por qué lo hicimos así): Lo hicimos así porque trazar la frontera del Sinaí con una caja vertical en 34.90°E metería el desierto del Néguev en el huso horario egipcio, generando errores de 1 hora durante las distintas semanas de transición DST de abril y octubre.
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) Protección de UTC+3 Permanente para Jordania (Asia/Amman) y Siria (Asia/Damascus) ≥ 28 de Octubre de 2022

Jordania (incluidos Amán, Áqaba y Petra / Wadi Araba) y Siria (incluidos Damasco, Alepo, Daraa, Bosra y Sueida) no volvieron al horario de invierno a finales de octubre de 2022, pasando a UTC+3 permanente todo el año. Como las tablas de zonas horarias de dispositivos Android e iOS antiguos sin actualizar aún pueden devolver UTC+2 en invierno para ambos países, la capa de resolución de identidad horaria devuelve directamente +3.0 h mediante el bloqueo de fecha ≥ 28 de octubre de 2022.

Motivo (Por qué lo hicimos así): Lo hicimos así para evitar que, cuando un teléfono antiguo tiene guardada la identidad Asia/Amman o Asia/Damascus, los horarios de oración se retrasen 60 minutos durante los meses de invierno.
if (UrdunSuriyeKaliciUtc3IdMi(temizId) && yerelTarih ≥ new DateTime(2022, 10, 28)) return +3.0;
// Polígonos de Petra/Wadi Araba (JO) y Daraa/Sueida (SY) en UTC+3 permanente todo el año
#24

24) Retroceso Horario en Ramadán del Reino de Marruecos (Decreto 2.18.855, UTC+1 → UTC+0) y Calendario Hijri de Respaldo 2080+

En el Reino de Marruecos, para fechas anteriores a septiembre de 2026 se aplica UTC+1 todo el año según el decreto 2.18.855; únicamente el domingo anterior al mes islámico de Ramadán a las 02:00 UTC los relojes se atrasan 1 hora a UTC+0 y vuelven a UTC+1 el primer domingo al inicio de Shawwāl a las 02:00 UTC. En consultas de fechas muy futuras o pasadas que excedan el límite de soporte de la clase estándar del calendario Umm al-Qura se activa automáticamente un motor de calendario Hijri de respaldo para evitar errores de desbordamiento.

Motivo (Por qué lo hicimos así): Lo hicimos así porque las reglas gregorianas estándar de DST no pueden representar el cambio inverso específico de Ramadán, y el motor de calendario no debe fallar en pruebas de fechas posteriores a 2029/2077.
Error común / Nota de atención: Invocar directamente el componente estándar de calendario Umm al-Qura sin comprobar el rango de fechas lanza una excepción fuera de rango en años futuros o pasados fuera de soporte; por ello es obligatorio contar con el respaldo general de calendario Hijri.
FasRamazanGeriSaatUtcAktifMi(utcAn): utcAn ∈ [RamazanOncesiPazar_02Utc, SevvalIlkPazar_02Utc) → UTC+0.0 (otros días UTC+1.0);
// En años fuera del límite del calendario Umm al-Qura interviene el calculador Hijri de respaldo
#25

25) Decreto de Marruecos 2.26.530 (GMT+0 Permanente ≥ 20 Sep 2026), Ceuta/Melilla y Línea Fronteriza de Argelia

Mediante el decreto del Reino de Marruecos n.º 2.26.530 del 25 de junio de 2026, a partir del domingo 20 de septiembre de 2026 a las 01:00 UTC Marruecos y el Sáhara Occidental pasan permanentemente a la hora GMT (UTC+0). En la costa norte, los enclaves españoles de Ceuta [35.87°..35.92°N, -5.39°..-5.27°O] y Melilla [35.26°..35.33°N, -3.00°..-2.91°O] se separan con el horario de verano de la UE (ES, UTC+1/+2); al sureste, Figuig/Bouarfa (MA) se aíslan de Béchar/Tindouf (DZ, UTC+1 permanente) mediante una recta fronteriza oblicua.

Motivo (Por qué lo hicimos así): Lo hicimos así tanto para aplicar correctamente en teléfonos antiguos la normativa marroquí de GMT+0 permanente desde septiembre de 2026 como para evitar confusiones de 1–2 horas en Ceuta/Melilla o la frontera argelina de Béchar.
Error común / Nota de atención: Los modelos entrenados con datos antiguos y los teléfonos sin actualizar pueden seguir creyendo que Marruecos usa UTC+1 después de septiembre de 2026; asimismo, aunque Ceuta y Melilla queden dentro de la caja geográfica costera de Marruecos, pertenecen al huso de España (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); Argelia (Béchar/Tindouf) → DZ (+1.0 permanente);
#26

26) Ley de Irán UTC+3:30 Permanente ≥ 22 Sep 2022, Frontera de Sarakhs/Zabol y Distinción del Golfo (+3 vs +4)

Dado que Irán suprimió el horario de verano en septiembre de 2022, Asia/Tehran y el polígono iraní devuelven UTC+3.5 permanente todo el año. Al este, Sarakhs en Jorasán (61.16°E, +3.5) se separa de Serahs en Turkmenistán (+5.0) y Zabol en Sistán (61.50°E, +3.5) de Afganistán (+4.5) y Baluchistán en Pakistán (+5.0) mediante escalones longitudinales precisos. En el Golfo se diferencian el paso fronterizo saudí de Salwa (+3, SA), Catar (+3, QA) y Baréin (+3, BH) frente a los EAU y Omán (incluido Musandam, +4).

Motivo (Por qué lo hicimos así): Lo hicimos así porque la tabla Asia/Tehran de dispositivos antiguos puede cambiar erróneamente la hora a +4.5 en primavera, y en la frontera Irán–Turkmenistán en Sarakhs existe un salto brusco de 90 minutos en apenas unos kilómetros.
if (IranKaliciUtc35IdMi(temizId) && yerelTarih ≥ new DateTime(2022, 9, 22)) return +3.5;
Irán (Sarakhs lon ≤ 61.22°, Zabol lon ≤ 61.88°) → +3.5; Catar/Baréin/Arabia Saudí → +3.0; EAU/Omán → +4.0;
#27

27) Husos de Media Hora y Cuarto de Hora del Sur de Asia (Afganistán +4:30, India +5:30, Nepal +5:45, Myanmar +6:30)

Los países del Sur de Asia que no usan husos de hora entera se modelan con sus desplazamientos meridianos nacionales: Afganistán recibe +4.5 (UTC+4:30), Pakistán +5.0, India y Sri Lanka +5.5 (UTC+5:30), Nepal +5.75 (UTC+5:45 — huso de tres cuartos de hora), Bangladés y Bután +6.0, y Myanmar (Birmania) e Islas Cocos +6.5 (UTC+6:30); los estados del noreste de la India (Assam, Arunachal) quedan protegidos de las cajas de Bangladés (+6) y China (+8).

Motivo (Por qué lo hicimos así): Lo hicimos así porque redondear a horas enteras en esta región provocaría desfases sistemáticos de 15–45 minutos en Katmandú y de 30 minutos en Nueva Delhi, Kabul y Rangún.
Afganistán → +4.5; Pakistán → +5.0; India y Sri Lanka → +5.5;
Nepal [26.35..30.45°N, 80.05..88.20°E] → +5.75; Bangladés/Bután → +6.0; Myanmar → +6.5;
#28

28) Kazajistán Unificado en UTC+5 (Decisión del 1 de Marzo de 2024) vs Kirguistán UTC+6 y Polígonos del Valle de Ferganá

El 1 de marzo de 2024 Kazajistán unificó todo el país —incluidas Almatý, Astaná y Kazajistán Oriental (Öskemen/Semey)— en un único huso UTC+5; el motor resuelve tanto la transición de fecha antes (+6) y después (+5) de marzo de 2024 como las identidades Asia/Almaty y Asia/Qostanay en teléfonos antiguos devolviendo UTC+5. Al sur, el Valle de Ferganá donde se entrelazan Kirguistán (Biskek, Osh, Jalal-Abad: UTC+6) con Uzbekistán y Tayikistán (Taskent, Namangán, Juyand, Dusambé: UTC+5) queda separado mediante polígonos.

Motivo (Por qué lo hicimos así): Lo hicimos así porque los teléfonos sin actualizar aún devuelven UTC+6 para Almatý, mientras que justo al sur de Almatý, Kirguistán sí continúa usando UTC+6.
Error común / Nota de atención: Aunque Almatý (76.9°E) está al este de Biskek (74.6°E) en longitud, desde la decisión de marzo de 2024 Almatý usa UTC+5 y la más occidental Biskek usa UTC+6; un simple cálculo de longitud/15 da aquí el resultado inverso.
if (KazakistanBirlesikUtc5Mi(temizId) && yerelTarih ≥ new DateTime(2024, 3, 1)) return +5.0;
KazakistanPoligonundaMi(lat, lon) → (utcAn ≥ 2024-02-29T18:00Z ? +5.0 : +6.0); Kirguistán → +6.0; UZ/TJ/TM → +5.0;
#29

29) Huso Único Oficial de China Occidental/Oriental (UTC+8: Kasgar, Khorgos, Fuyuan) y Mongolia (+7 / +8)

Aunque la China continental abarca cinco husos longitudinales geográficos, todo el país —incluidos Kasgar (75.99°E), Urumqi, Bole, el paso fronterizo de Khorgos, Altái, Lhasa, Manzhouli en Mongolia Interior y el extremo oriental de Fuyuan/Heihe— utiliza la hora oficial de Pekín (UTC+8); al cruzar de Khorgos a Kazajistán, el polígono captura el salto de 3 horas de +8 a +5. En Mongolia, las provincias occidentales (Bayan-Ölgii, Uvs, Jovd) reciben UTC+7, y Ulán Bator y el este reciben UTC+8.

Motivo (Por qué lo hicimos así): Lo hicimos así porque en Xinjiang el Sol alcanza el mediodía hacia las 15:00 mientras que en Fuyuan en verano Imsak entra a las 23:28 (antes de medianoche); en ambos extremos es indispensable contar con el polígono fronterizo exacto de China y sus vecinos.
Xinjiang/Tíbet/Mongolia Interior/Manchuria (Kasgar, al este de Khorgos 80.42°E, Altái, Lhasa, Heihe, Fuyuan) → CN (+8.0);
Mongolia: provincias occidentales (Bayan-Ölgii/Uvs/Jovd) → +7.0; Centro y Este (Ulán Bator) → +8.0;
#30

30) Polígonos del Estrecho de Malaca (Sumatra +7 vs MY/SG +8) y Kalimantan Central en Borneo (WIB +7 vs WITA +8)

En el Sudeste Asiático, Sumatra (Medan, Pekanbaru, Dumai: ID, WIB +7) se separa de la península de Malaca y Singapur (Kuala Lumpur, Penang, Johor: MY/SG, +8) mediante la recta oblicua del Estrecho de Malaca. En la isla de Borneo, las provincias indonesias de Kalimantan Occidental (Pontianak) y Kalimantan Central (Palangkaraya, Sampit, Pangkalan Bun, Muara Teweh) usan WIB (UTC+7), mientras que Kalimantan Meridional/Oriental/Septentrional (Banjarmasin, Balikpapan, Samarinda), junto con Sarawak/Sabah de Malasia y Brunéi, usan UTC+8.

Motivo (Por qué lo hicimos así): Lo hicimos así porque dividir la isla de Borneo con un meridiano recto asignaría erróneamente a Palangkaraya (113.9°E), capital de Kalimantan Central, el huso UTC+8, adelantando sus horarios 1 hora.
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) || Célebes Septentrional [0.80..1.85°N, ≤125.35°E] || Timor Occidental (lat ≤ -8.00, lon ∈ (-180.0, 125.10)); al este WIT (+9.0);
#31

31) Célebes Septentrional (WITA +8), Molucas/Papúa (WIT +9) y Timor Oriental + Enclave de Oecusse (TL UTC+9)

Al este de Indonesia, la prolongación de Célebes Septentrional (Manado, Bitung, Gorontalo: 124°–125.3°E), pese a quedar muy al este en longitud, pertenece al huso WITA (UTC+8); más al este, las Molucas (Ambon, Ternate) y Papúa Occidental (Jayapura, Merauke) reciben WIT (UTC+9). En la isla de Timor, Timor Occidental de Indonesia (Kupang, Atambua) utiliza UTC+8, mientras que el Estado independiente de Timor Oriental (la mitad oriental principal con Dili y el enclave costero de Oecusse dentro de Timor Occidental) opera todo el año con UTC+9 y la autoridad MWL.

Motivo (Por qué lo hicimos así): Lo hicimos así porque asignar UTC+9 con una sola caja al este de 124°E adelantaría 1 hora tanto Célebes Septentrional (Manado) como Timor Occidental (Kupang); omitir el enclave de Oecusse produciría un error de 1 hora hacia atrás en la costa de Timor Oriental.
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]);
Célebes Septentrional (lat ∈ [0.80, 1.85], lon ≤ 125.35) y Timor Occidental (Kupang) → ID (+8.0); Molucas y Papúa → ID (+9.0);
#32

32) Husos de Australia (Eucla +8:45, Broken Hill), Lord Howe (+10:30/+11:00) y Chatham (+12:45/+13:45)

En Australia se resuelven por separado Australia Occidental (+8), la región fronteriza de Eucla (+8.75), el Territorio del Norte (+9.5, sin DST), Australia Meridional junto con Broken Hill en NSW (+9.5 invierno / +10.5 verano), Queensland (+10, sin DST) y NSW/Victoria/Tasmania (+10/+11). La Isla Lord Howe (-31.9°..-31.4°S, 158.9°..159.3°E), único lugar del mundo que adelanta el reloj solo 30 minutos en verano, recibe +10.5 en invierno y +11.0 en verano mediante una regla DST especial de 30 min; junto a Nueva Zelanda (+12/+13), las Islas Chatham usan +12.75 en invierno y +13.75 en verano.

Motivo (Por qué lo hicimos así): Lo hicimos así porque conectar el salto de verano de 30 minutos de la Isla Lord Howe a la función DST estándar australiana de +1 hora adelantaría todos los horarios 30 minutos en verano.
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 → Nueva Zelanda +12.75/+13.75;
#33

33) Husos Horarios de Sudamérica: Brasil (-5/-4/-3/-2), Paraguay (≥ 6 Oct 2024 -3) y Aysén/Magallanes en Chile

En Sudamérica, Brasil se divide en 4 husos oficiales: Acre y Amazonas Occidental (Rio Branco, Cruzeiro do Sul, Tabatinga, Eirunepé: UTC-5), Centro-Oeste (Manaos, Cuiabá, Porto Velho, Boa Vista: UTC-4), Brasil Oriental (São Paulo, Brasilia, Río, Belém: UTC-3) y Fernando de Noronha (-2). Paraguay pasó a UTC-3 permanente todo el año mediante la ley del 6 de octubre de 2024; en Chile, Santiago usa -4 en invierno / -3 en verano mientras que las regiones australes de Aysén y Magallanes (Punta Arenas, lat ≤ -43.5°) mantienen UTC-3 permanente todo el año.

Motivo (Por qué lo hicimos así): Lo hicimos así porque asumir un único UTC-3 para Brasil produciría 1 hora de error en Manaos y 2 horas en Rio Branco y Tabatinga; y la ley paraguaya de octubre de 2024 puede no existir en las tablas tzdata de teléfonos antiguos.
if (ParaguayKaliciUtc3IdMi(temizId) && yerelTarih ≥ new DateTime(2024, 10, 6)) return -3.0;
BrezilyaSaatDilimiBul(lat, lon) → Acre/AmazonasOcc -5, Manaos/Cuiabá -4, Brasilia -3; Chile Aysén/Magallanes → -3.0 permanente;
#34

34) Excepciones de Norteamérica (Arizona vs Navajo, Sonora, Saskatchewan, Yukón, Terranova) y Groenlandia

En Norteamérica se definen individualmente las excepciones estatales y de territorios indígenas: Arizona (Phoenix, Tucson) no aplica horario de verano y permanece en UTC-7 todo el año, mientras que la Nación Navajo al noreste (Window Rock/Kayenta; salvo el enclave Hopi de Tuba City) pasa a UTC-6 en verano. Se preservan Sonora y Quintana Roo en México (-5), Saskatchewan (-6 permanente), Yukón (-7 permanente), el sur de Idaho/Boise (-7/-6) y Terranova (-3.5/-2.5) en Canadá; en Groenlandia se distinguen Nuuk (-2/-1), Pituffik (-4/-3) y Danmarkshavn (0) frente a la estación canadiense de Alert (-5/-4).

Motivo (Por qué lo hicimos así): Lo hicimos así porque usar franjas longitudinales gruesas en Norteamérica causaría en verano desfases de 1 hora en Phoenix, Regina y Whitehorse, de 30 minutos en Terranova y de 2 horas en Nuuk (Groenlandia).
Arizona → -7.0 permanente (salvo Navajo [lat ≥ 35.45°N, lon ≥ -111.65°O; exc. Hopi [35.55..36.05°N, -110.85..-110.15°O]] → -7/-6); Saskatchewan → -6.0 permanente; Yukón → -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) Aleutianas Occ./Or. (Attu y Adak), Estrecho de Bering (Chukotka vs St. Lawrence), Kiribati (+14) y Meridiano Oceánico

A lo largo de la Línea Internacional de Cambio de Fecha, tanto el tramo occidental de las Islas Aleutianas en el hemisferio oeste (-180°..-169.0°O, Adak) como el extremo occidental de Attu que rebasa los +180° hacia el este (172°E..180°E) reciben país EE. UU. (US, ISNA) y horario de verano Hawái-Aleutiano (-10/-9). En el Estrecho de Bering se separan Chukotka en Rusia (Uelen/Provideniya: RU, +12 permanente) y la Isla St. Lawrence de EE. UU. (Gambell: US, Alaska -9/-8); Kiritimati recibe +14, Apia +13 y los puntos en mar abierto se resuelven con el huso astronómico [-12, +12].

Motivo (Por qué lo hicimos así): Lo hicimos así porque aunque la isla Attu está en longitud +173°E no usa la hora de Rusia (+12) sino la de EE. UU. (-10/-9), mientras que Gambell justo frente a Chukotka usa la hora de Alaska (-9/-8); elegir el lado erróneo generaría un error de 21 horas.
Error común / Nota de atención: Se suele asumir que todo punto en el hemisferio oriental (longitud +) recibe una zona horaria UTC positiva; sin embargo, las islas Attu y Shemya a +173°E son territorio estadounidense y están en la zona negativa UTC-10/-9.
Aleutianas: lat ∈ [51.0, 54.0] && (lon ∈ [172.0, 180.0] || lon ∈ [-180.0, -169.0)) → US (-10/-9); Chukotka → RU (+12) vs St. Lawrence → US (-9/-8);
Kiritimati → +14.0; Respaldo Mar Abierto → Math.Clamp(Math.Round(Sarmala180(lon) / 15.0, AwayFromZero), -12.0, 12.0);
#36

36) Huella UTC Única de 9 Días, Firma de Caché v6 y Verificación DST Sub-Minuto de 3 Parámetros

El generador de huella horaria de nueve días muestrea los desplazamientos locales en los instantes 00:00 UTC y 12:00 UTC de los 9 días de d-1..d+7 y los guarda con la firma de caché v6. Cada día se resuelve en la zona horaria de referencia del mediodía y luego los 6 horarios se proyectan individualmente de UTC → hora de pared local; si un horario como 01:59:40 cruza al otro lado del umbral DST de las 02:00/03:00 al redondear al minuto, el verificador DST sub-minuto alinea su minuto y su zona registrada con la nueva zona justo antes de convertirlo a texto.

Motivo (Por qué lo hicimos así): Lo hicimos así porque en la noche del cambio primaveral, cuando las 01:59:40 CET suben a las 02:00 por redondeo a :30 o Ceiling, las 02:00 no existen (pasan directamente a las 03:00 CEST); la comprobación DST sub-minuto mantiene coherente incluso este instante límite.
YuvarlanmisDstDilimiDogrula(cikisMi: imsakCikisYuvarla, ref d.netImsakDakika, ref d.imsakSaatDilimi); // Cada uno de los 6 horarios según su dirección
d.imsakStr = FikhiGuvenliSaatMetnineCevir(d.netImsakDakika, imsakTemkin, cikisVaktiMi: imsakCikisYuvarla);
#37

37) Árbol de Decisión Automático de Autoridad I: Diyanet (TR, CY, AZ, Balcanes), Umm al-Qura (Golfo) y MABIMS

En el modo de autoridad automática se resuelve el código de país ISO de la ubicación a partir de polígonos sin conexión y se vincula a la institución oficial local: Turquía (TR), RTCN / Chipre (CY), Azerbaiyán (AZ) y la franja islámica balcánica (BA, AL, XK, MK, BG, ME) reciben el criterio de Diyanet (DİYK); Arabia Saudí (SA), EAU (AE), Catar (QA), Kuwait (KW), Baréin (BH), Omán (OM) y Yemen (YE) reciben Umm al-Qura (La Meca); Indonesia (ID), Malasia (MY), Singapur (SG) y Brunéi (BN) reciben el criterio MABIMS (KEMENAG/JAKIM).

Motivo (Por qué lo hicimos así): Lo hicimos así para facilitar que un usuario que viaja cambie automáticamente a la autoridad oficial compatible con las llamadas a la oración de las mezquitas locales del país al que llega, sin tener que buscar ajustes técnicos.
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) Árbol de Decisión Automático de Autoridad II: Karachi (Asia Central/Sur), Egipto (EG, PS, Levante), ISNA y MWL

En la segunda rama del árbol de decisión, Pakistán (PK), Afganistán (AF), Bangladés (BD), India (IN), Nepal, Sri Lanka, Maldivas y los países de Asia Central (UZ, KZ, KG, TJ, TM) se asignan a la Universidad de Ciencias Islámicas de Karachi (-18°/-18°, ʿAṣr al-Thānī +2 sombras); Egipto (EG), Palestina (PS), el Levante (SY, JO, LB) y la franja del Norte/Este de África (LY, TN, DZ, SD, SS, NG, ET, ER, KE, UG, TZ, SO, DJ, ZA) a la Autoridad General Egipcia (-19.5°/-17.5°); EE. UU. (US) y Canadá (CA) a ISNA (-15°/-15°); y Europa, Irak (IQ — compatibilidad con la banda de -18° del Diwán del Waqf Suní), Irán (IR), Magreb Occidental (MA, MR, SN), Asia Oriental y demás países a MWL (-18°/-17°).

Motivo (Por qué lo hicimos así): Lo hicimos así porque en Asia Central/Meridional domina ʿAṣr al-Thānī (+2 sombras), en el Levante y la franja africana la Autoridad Egipcia, en Norteamérica ISNA, y en Europa, Irak, Irán y el Magreb Occidental MWL en la banda de -18° concuerda con el estándar habitual de las mezquitas.
PK, IN, BD, AF, LK, NP, MV, UZ, KZ, KG, TJ, TM → Otoriteler.Karaci_Hanefi; // ʿAṣr al-Thānī (+2 sombras)
EG, PS, SY, JO, LB, LY, TN, DZ, SD..ZA → Otoriteler.Misir_GenelOtorite;   US, CA → Otoriteler.ISNA_KuzeyAmerika;   IQ, IR y demás → Otoriteler.Musluman_Birlik;
#39

39) Matriz de Ángulos Crepusculares y Precaución/Tamkīn de las 7 Autoridades Oficiales (Incluido MABIMS Subuh -20° + 2 min)

Los ángulos crepusculares y los minutos de precaución (tamkīn) [Imsak, Salida del Sol, Mediodía, Tarde, Ocaso, Noche] de las autoridades oficiales son:

• Diyanet (DİYK): Imsak -18°, ʿAṣr +1 (ʿAṣr al-Awwal), ʿIshāʾ -17° (-16° + estimación estival en la franja |φ| ≥ 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 Meca): Imsak -18.5°, ʿAṣr +1, ʿIshāʾ +90 min (+120 min en Ramadán), Tamkīn 0 min

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

Motivo (Por qué lo hicimos así): Lo hicimos así porque los consejos jurídicos y observatorios oficiales del mundo aplican ángulos distintos entre -15° y -20°, además de márgenes locales como +2 min en Subuh de MABIMS, por diferencias atmosféricas regionales y de 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) Acotamiento Seguro en Ajustes Personales y Protección Discreta {1, 2} para la Sombra

En el modo de Ajustes Personales, todos los parámetros propios quedan acotados dentro de límites físicos y jurídicos seguros frente a entradas locales corruptas o extremas (NaN, Infinity, valores fuera de rango): los ángulos crepusculares de Imsak y ʿIshāʾ se mantienen en [-25.0°, -5.0°], los minutos de tamkīn de los 6 horarios en [-60, +60] min y la altitud base del entorno H₀ en [-450 m, 8850 m]; mientras que el coeficiente de sombra de ʿAṣr solo adopta valores discretos {1f (ʿAṣr al-Awwal), 2f (ʿAṣr al-Thānī)} conforme al fiqh Hanafí y Shafi'í.

Motivo (Por qué lo hicimos así): Lo hicimos así para impedir que un dato corrupto en caché genere NaN y colapse los horarios, o que aparezcan coeficientes decimales intermedios como 1.4 sin respaldo en las escuelas Hanafí ni Shafi'í.
imsak_derece = GuvenliPrefFloatAl(kisiselImsakAnahtari, -18f, -25f, -5f); // El nombre de clave se abstrae en el Paso 110
ikindi_golge = GuvenliPrefFloatAl(kisiselIkindiAnahtari, 1f, 1f, 2f) ≥ 1.5f ? 2f : 1f;
#41

41) Selección de ʿAṣr al-Awwal (+1 Sombra — Diyanet / al-Imāmayn / Shafi'í) y ʿAṣr al-Thānī (+2 Sombras — Hanafí / Imam al-Aʿẓam)

Entre las escuelas soportadas Hanafí y Shafi'í, el inicio de ʿAṣr se distingue por la proporción de sombra: en la escuela Shafi'í y en la opinión adoptada (muftā bih) de al-Imāmayn Hanafíes (Imam Abū Yūsuf e Imam Muḥammad), incluida Diyanet de Turquía (ʿAṣr al-Awwal), ʿAṣr entra cuando la sombra equivale a 1 vez la altura sobre fayʾ al-zawāl (+1); en el dictamen adoptado del Imam al-Aʿẓam Abū Ḥanīfa (ʿAṣr al-Thānī), entra cuando alcanza 2 veces (+2). La fila de ʿAṣr en el selector ofrece tres posiciones en instituciones oficiales (predeterminado de institución / +1 / +2) y selección directa +1 o +2 en modo Personal.

Motivo (Por qué lo hicimos así): Lo hicimos así para evitar la falsa idea de que el criterio ʿAṣr al-Awwal (+1 sombra) de Diyanet sea exclusivo de la escuela Shafi'í, y para permitir que cada usuario siga la autoridad local en Fajr/Maghrib eligiendo su propio criterio jurídico en ʿAṣr.
if (SeciliOtorite != Otoriteler.Kisisel) { if (ikindiMezhepModu == 1) ikindi_golge = 1f; else if (ikindiMezhepModu == 2) ikindi_golge = 2f; }
else → otorite_ayari.KisiselIkindiGolgeAyarla(hedefGolge); // En modo Personal: 1f (ʿAṣr al-Awwal) ↔ 2f (ʿAṣr al-Thānī)
#42

42) Horizonte Local en Mesetas Interiores (ΔH = 0) vs Horizonte Óptico Personal en Laderas Costeras (0.0347°·√ΔH)

Aplicar directamente la fórmula de depresión del horizonte derivada respecto al nivel del mar (2.08'·√H ≈ 0.0347°·√H) a ciudades interiores induce error: en mesetas como Erzurum (1900 m), Van (2400 m), Kahta (670 m), Denver (1609 m) o Quetta (1680 m), el terreno del horizonte está casi a la misma elevación que el observador (H ≈ H₀ → ΔH ≈ 0 m). En laderas costeras abruptas frente al mar (como Uludağ o Babadağ), al ser H₀ = 0 m, sí se produce una depresión igual a la altura relativa ΔH = max(0, H − H₀).

Motivo (Por qué lo hicimos así): Lo hicimos así porque usar la fórmula del horizonte marino en altiplano interior fijaría el horario de Maghrib minutos después de que el Sol haya bajado tras el horizonte de la meseta; el modelo relativo ΔH distingue con precisión la llanura elevada de la ladera costera.
Error común / Nota de atención: Aplicar sin más la fórmula náutica 0.0347°·√H de los almanaques a mesetas interiores como Erzurum (1900 m), Konya o Kahta es un error frecuente; como la llanura circundante también está elevada, daría el ifṭār varios minutos después de ocultarse el Sol.
double deltaH = rakimUfukDuzeltmesiAktif ? Math.Max(0.0, clamp(H, -450, 8850) - clamp(H0, -450, 8850)) : 0.0;
#43

43) Efecto de Valles, Crestas Montañosas y Edificios Altos sobre el Horizonte Real Observado

Nota de Transparencia Topográfica: En valles flanqueados por altas crestas al este y al oeste, la hora local visible de salida/puesta puede diferir varios minutos del horizonte plano calculado; por precaución jurídica debe observarse el margen local.

La ecuación matemática del horizonte (ΔH ≥ 0) modela un horizonte abierto donde el observador domina el entorno; sin embargo, en un valle profundo, al pie de montañas o en zonas donde crestas altas o edificios tapan el horizonte este/oeste (como el valle del Çoruh en Artvin, valles de los Alpes suizos o entre rascacielos), el horizonte físico local queda por encima de la línea 0°. En esos lugares el Sol aparece minutos más tarde o se oculta antes detrás de la montaña; los calendarios oficiales toman el horizonte abierto medio del distrito junto con el margen de precaución.

Motivo (Por qué lo hicimos así): Lo hicimos así porque ninguna fórmula móvil global puede conocer por sí sola la colina o el edificio situado frente a la ventana del usuario; declarar abiertamente este límite topográfico natural y el sentido del margen de precaución es deber de honestidad científica.
// En autoridades oficiales: rakimUfukDuzeltmesiAktif = false (ΔH = 0, horizonte medio del distrito + precaución oficial)
// En valles estrechos y sombra de montaña, para el ifṭār debe observarse el oscurecimiento del horizonte / precaución del calendario local
#44

44) Cenit de Horizonte Oficial (90°50') vs Refracción Barométrica según la Altitud Base del Horizonte (H₀ = H − ΔH) en Modo Personal

Las instituciones oficiales adoptan fijo el ángulo cenital de 90°50' (90.833333°), suma de la refracción estándar al nivel del mar (34') y el semidiámetro solar medio (16'). Al activar el Horizonte Óptico Personal, el rayo solar tangente que llega al observador en lo alto de la costa atraviesa la capa atmosférica más densa no en la cima (H), sino a la altitud base que roza el horizonte (H₀ = H − ΔH); por ello la refracción horizontal se escala con la densidad en H₀ y se combina con el semidiámetro real del día (s_☉) y el paralaje horizontal (π_☉).

Motivo (Por qué lo hicimos así): Lo hicimos así porque para un observador que mira al horizonte marino a 0 m desde una montaña costera de 2000 m, el rayo tangente pasa por el nivel del mar; reducir la refracción según la presión a 2000 m contradiría la trayectoria física del rayo.
Error común / Nota de atención: A primera vista parece correcto reducir la refracción del horizonte usando la baja presión de la cima montañosa; sin embargo, el rayo tangente al horizonte marino atraviesa de extremo a extremo la capa atmosférica inferior más densa (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) Arquitectura de Minutos de Precaución (Tamkīn / Iḥtiyāṭ) con Sentido Propio para Cada Uno de los Seis Horarios

Cada horario posee su componente independiente de precaución según su sentido jurídico de entrada o salida: en Diyanet se aplica [Imsak 0, Salida del Sol -7, Mediodía +5, Tarde +4, Ocaso +7, Noche 0] min; en el sistema MABIMS (KEMENAG/JAKIM) [+2, -2, +2, +2, +2, +2] min; en las autoridades sin margen [0, 0, 0, 0, 0, 0] min, y en Ajustes Personales cada horario es configurable por separado. El margen negativo en la Salida del Sol (-7 min o -2 min) es una salvaguarda de salida anticipada para evitar que la oración del Alba (Fajr) invada el tiempo desaconsejado (karāha) al salir el Sol.

Motivo (Por qué lo hicimos así): Lo hicimos así porque el horario de salida que es la Salida del Sol y los horarios de entrada que son Mediodía, Tarde y Ocaso no pueden llevar precaución en la misma dirección; definir un tamkīn independiente en su propio sentido preserva la fidelidad con los calendarios oficiales.
double gunesTemkin = otorite_ayari.gunesVakitAyari; // Diyanet: -7 min, MABIMS: -2 min (precaución de salida anticipada)
double aksamTemkin = otorite_ayari.aksamVakitAyari; // Diyanet: +7 min, MABIMS: +2 min (precaución de entrada)
#46

46) Transición Latitudinal de Diyanet [44.5°..45.5°] (-17° → -16° ʿIshāʾ) y Proporción Primavera/Verano ([δ_tam − 9.5°, δ_tam])

En la franja medio-alta europea (|φ| ≥ 45°; Berlín 52.52°N, Londres 51.51°N, Viena, París), el Consejo Superior de Asuntos Religiosos (DİYK) aplica todo el año el ángulo de crepúsculo de -16.0° para ʿIshāʾ, incluido el invierno; para evitar saltos en ciudades cercanas a los 45° (Lyon, Turín, Pula) se aplica una transición de Hermite en la banda [44.5°, 45.5°]. A fin de que la estimación estival no se active demasiado pronto en abril reduciendo los horarios de Berlín, pero opere plenamente en las noches blancas de mayo a julio, el umbral estival pleno se define como δ_tam = clamp(90° − |φ| − 18°, 6.0°, 20.5°) y el umbral de inicio como max(0°, δ_tam − 9.5°).

Motivo (Por qué lo hicimos así): Lo hicimos así porque iniciar la estimación estival justo en el equinoccio del 21 de marzo (δ = 0°) adelantaría en 15–20 minutos los horarios de Imsak y ʿIshāʾ en Berlín y Londres durante abril respecto al calendario oficial de Diyanet.
etkinYatsiDerece = yatsi_derece + (-16.0 - yatsi_derece) * diyanetEnlemGecisOrani;   diyanetYazlikOran = diyanetEnlemGecisOrani * HermiteSmoothStep(δ_bas, δ_tam, yazDeklin);
#47

47) Duración de Estimación Estival de Diyanet (Noche_neta − 10) · 0.25 ([20..80] min ʿIshāʾ, +10 min Imsak) y Mezcla por Proximidad de Raíz

En la estimación estival de Diyanet para |φ| ≥ 45°, la duración no se deriva de la noche astronómica bruta sino como un cuarto de la noche neta entre el Maghrib con precaución de hoy y la Salida del Sol con precaución de mañana: el intervalo estimado para ʿIshāʾ es clamp((Noche_neta − 10) · 0.25, 20, 80) min en la banda [20, 80] min, y el intervalo para Imsak es exactamente +10 min mayor, [30, 90] min. Antes de romperse la raíz astronómica, se aplica una mezcla suave de Hermite con pesos [objetivo − 4.5°, objetivo] según la altura mínima nocturna y [objetivo, objetivo + 2.5°] en la oscuridad invernal.

Motivo (Por qué lo hicimos así): Lo hicimos así porque una regla tosca como Noche/3 dejaría ʿIshāʾ en 80 min durante una corta noche estival berlinesa de 250 min, mientras que la fórmula oficial (Noche_neta − 10)/4 produce 60 min para ʿIshāʾ y 70 min para Imsak, repartiendo la noche equilibradamente.
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) Regla de Tres Estaciones de Diyanet en la Franja Polar por Encima de 62° (Tromsø: Estación Normal, Invierno ±150 min, Verano 19 h 45 min)

En las ciudades de la franja |φ| ∈ (62.0°, 90.0°] (Tromsø 69.65°N, Reikiavik 64.15°N, Longyearbyen 78.22°N), el método DİYK funciona en tres estaciones distintas: (1) Primavera y Otoño (duración del día 300..1173 min): se conserva la latitud real y el Sol sale y se pone en su horizonte verdadero. (2) Invierno Polar (noche polar o día por debajo de 300 min = 5 horas): con transición de Hermite en [294..300 min] se estima Salida = Mediodía − 150 min y Ocaso = Mediodía + 150 min. (3) Sol de Medianoche (día por encima de 1173..1185 min): se vincula a mediodía ± 592.5 min (día máximo de 19 h 45 min) y proyección Aqrab al-Bilād de ±62.0°.

Motivo (Por qué lo hicimos así): Lo hicimos así porque copiar una latitud fija de ±62° todo el año adelantaría ~30 minutos el horario de Maghrib en Tromsø en abril y septiembre cuando el Sol aún está sobre el horizonte.
Error común / Nota de atención: Se suele pensar que por encima de 62° se copian los horarios de 62° los 365 días del año; sin embargo, en primavera y otoño el Sol sale y se pone normalmente y Tromsø utiliza su horizonte real.
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) Puente de Continuidad Equinoccial de Diyanet en la Cúspide Polar |φ| ∈ (84°, 90°] (Hermite [-7.5°, +6.5°])

Alrededor del polo geográfico exacto (|φ| ∈ (84°, 90°], p. ej., 89.9°N o la Estación del Polo Sur), como la duración del día en los equinoccios puede saltar en una sola jornada de 0 minutos a 24 horas, aparecería un salto brusco de ~7.3 horas en un día entre el régimen invernal de 5 horas y el estival de 19 h 45 min. Mediante un peso latitudinal [84.0°, 86.5°] que no toca en absoluto los asentamientos con |φ| ≤ 84° (Longyearbyen, Tromsø) y un puente de declinación [-7.5°, +6.5°], la transición equinoccial se distribuye suavemente a lo largo de ~36 días.

Motivo (Por qué lo hicimos así): Lo hicimos así para que en la tabla anual de 365 días a 89.9° de latitud no haya saltos de 7 horas en los equinoccios de marzo y septiembre, sin alterar ni un ápice los calendarios de ciudades por debajo de 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) Límite Polar Estacional Fuera de Diyanet y Resolución de Latitud Efectiva por Día (d-1, d, d+1)

En las autoridades distintas de Diyanet, el límite tangente del día polar y la noche polar invernal se resuelve independientemente para la declinación propia de cada día (d-1, d y d+1) mediante la declinación desplazada (sign(φ)·δ + ángulo de corrección del horizonte) y se vincula a la latitud efectiva. En los polos geográficos exactos ±90.000000° convergen todos los meridianos, por lo que el horizonte físico Este/Oeste entra en singularidad; el motor preserva la continuidad matemática, aunque el criterio jurídico (fiqh) establece estimar los horarios en el polo conforme a la localidad normal más cercana.

Motivo (Por qué lo hicimos así): Lo hicimos así porque copiar la latitud efectiva de hoy a los días d-1 y d+1 produciría quiebros artificiales en las duraciones nocturnas de mañana y tarde el día de entrada en la tangencia polar; resolver cada día con su propia declinación garantiza continuidad interdiaria.
etkinEnlemDun = KutupEtkinEnlemCoz(dEnlem, ozetDun.sunDeclinDeg, ...); // d-1, d y d+1 se resuelven por separado
etkinEnlemYarin = KutupEtkinEnlemCoz(dEnlem, ozetYarin.sunDeclinDeg, ...);
#51

51) Suavizado Hiperbólico C∞ de Latitud Efectiva en el Alto Ártico (75°..81°, Alert 82.5°N)

Mientras en las localidades subpolares (Tromsø 69.65°N) el redondeo del núcleo de latitud efectiva se mantiene en 0.12° y el margen de seguridad en 0.30°, en las estaciones del Alto Ártico (Alert 82.50°N, Eureka), para suavizar la pendiente rasante del equinoccio, el peso de Hermite en la banda [75.0°, 81.0°] eleva el núcleo a 0.62° y el margen de seguridad a 0.52°, transformando el quiebre brusco de min(|φ|, latitud límite) en una transición hiperbólica suave C∞ con factor 1.60·w.

Motivo (Por qué lo hicimos así): Lo hicimos así porque en puntos del Alto Ártico como Alert a 82.5°N un acotamiento rígido generaría un cambio brusco de pendiente en la hora de salida/puesta el día tangente primaveral; la transición hiperbólica suaviza 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) Mezcla Crepuscular Temprana [objetivo − 8° .. objetivo] en Verano Polar Fuera de Diyanet (|φ| ∈ (65.5°, 90°])

En la franja polar por encima de 68° (p. ej., Alert 82.5°N u 86°N, MWL/ISNA), cuando tras el equinoccio de primavera la altura mínima nocturna del Sol se acerca tangencialmente al límite de -18°, la derivada d(arccos)/dδ se vuelve extremadamente empinada, provocando que la raíz astronómica pura de Fajr/ʿIshāʾ se desplome ~90 min en los últimos 3 días y salte en dirección contraria al romperse la raíz. Con un peso polar [65.5°, 68.5°] que no afecta a las ciudades con |φ| ≤ 65.5° (Londres, Berlín, Oslo, Reikiavik), se realiza una transición suave hacia la división angular nocturna en la banda [objetivo − 8°, objetivo].

Motivo (Por qué lo hicimos así): Lo hicimos así porque en latitudes europeas medio-altas (48°–65°) la raíz astronómica real debe conservarse hasta el último día, mientras que en la zona polar 70°–89° debe evitarse el colapso vertical de la pendiente en la tangencia equinoccial.
double wKutup = HermiteSmoothStep(65.5, 68.5, Math.Abs(dEnlem));
double wErken = wKutup * HermiteSmoothStep(hedefAci - 8.0, hedefAci, geceMinYukseklikDeg);
#53

53) Rampas Inversas de Oscuridad Profunda en Invierno Polar ([objetivo, objetivo + 2.0°] y [objetivo, objetivo + 4.0°] sobre 65.5°)

En el invierno polar profundo, cuando el Sol permanece incluso al mediodía en la banda crepuscular bajo el horizonte y su altura máxima diurna (α_zeval) se aproxima desde arriba al ángulo de Fajr o ʿIshāʾ (p. ej., -18° o -15°), la raíz astronómica se rompe esta vez por el lado del mediodía. Para evitar un salto repentino a 00:00 o al mediodía, α_zeval se enlaza a la división angular nocturna mediante una rampa inversa de Hermite en la banda [objetivo, objetivo + 2.0°] para |φ| ≤ 65.5° y [objetivo, objetivo + 4.0°] para la franja polar |φ| ∈ (65.5°, 90°].

Motivo (Por qué lo hicimos así): Lo hicimos así porque la noche blanca estival solo vigila la altura mínima nocturna (α_min), mientras que en la noche polar invernal se requiere una rampa inversa específica cuando la altura culminante del mediodía (α_zeval) desciende por debajo del ángulo crepuscular.
double ustBant = Math.Abs(dEnlem) ≤ 65.5 ? 2.0 : 4.0;
double karanlikOran = 1.0 - HermiteSmoothStep(hedefSafakAci, hedefSafakAci + ustBant, d.zevalYukseklikDeg);
#54

54) Conversión del Calendario Gregoriano al Número de Día Juliano Entero de 64 Bits (JDN)

Las ecuaciones orbitales del Sol requieren un contador continuo de días independiente de la duración variable de los meses (28/29/30/31 días) y de las reglas de años bisiestos. Mediante el algoritmo entero de Fliegel–Van Flandern / Jean Meeus se convierte la fecha gregoriana (Año, Mes, Día) en el Número de Día Juliano (JDN) entero long de 64 bits.

Motivo (Por qué lo hicimos así): Lo hicimos así porque en conversiones basadas en Math.Floor decimal pueden aparecer derivas fraccionarias en fechas límite; la división entera de 64 bits produce un índice diario estable en todos los siglos.
long jdn = gun + (153 * m + 2) / 5 + 365L * y + y / 4 - y / 100 + y / 400 - 32045;
#55

55) Resta Entera (JDN − 2451545L) para Evitar Pérdida de Mantisa IEEE-754 y Días d2000

En códigos astronómicos clásicos se construye primero un número decimal grande como JD ≈ 2,461,357 y luego se resta 2451545.0; esta operación consume 21 de los 53 bits de mantisa de un double de 64 bits en la parte entera, degradando la precisión numérica. En nuestro motor el día de época J2000.0 (2451545L) se resta todavía en la etapa entera long de 64 bits y la fracción horaria UTC del día se suma directamente a esa pequeña diferencia.

Motivo (Por qué lo hicimos así): Lo hicimos así para evitar el ruido de redondeo IEEE-754 derivado de restar dos grandes decimales cercanos y preservar la estabilidad numérica del eje temporal en las iteraciones de búsqueda binaria.
Error común / Nota de atención: Suponer que el tipo double de 64 bits basta siempre y efectuar JD − 2451545.0 en coma flotante desperdicia 21 bits de mantisa por culpa de la parte entera de 2.46 millones; la resta en entero (long) elimina esa pérdida.
double d2000Gun = (jdnFarkiJ2000 - 0.5) + kesirliGun;
#56

56) Modelo Continuo ΔT = TT − UT1, Naturaleza Predictiva a Largo Plazo, Día de Efemérides (JDE) y Siglo (T)

Como la rotación de la Tierra sobre su eje se ralentiza de forma irregular por la fricción mareal y el acoplamiento núcleo-manto, existe una diferencia ΔT entre el Tiempo de Rotación Terrestre (UT1/UTC) y el Tiempo Atómico Dinámico (TT) usado en las efemérides planetarias. Para evitar saltos escalonados en Nochevieja, ΔT se calcula continuamente a partir de d2000Gun (~69.2 s a mediados de 2026). Aunque en décadas futuras la aceleración rotacional pueda variar unos segundos, una diferencia de 5 s en ΔT produce menos de 0.2 s de efecto en la órbita solar.

Motivo (Por qué lo hicimos así): Lo hicimos así porque omitir por completo la corrección ΔT dejaría la longitud eclíptica del Sol atrasada unos ~70 s de movimiento orbital (~2.8 segundos de arco); el modelo continuo corrige ese desfase y evita discontinuidades de año nuevo.
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) Longitud Media Geométrica del Sol (L₀) y Protección Mod Semiabierta IEEE-754 [0°, 360°)

El ángulo de longitud eclíptica en que se encontraría el Sol respecto al equinoccio instantáneo si la Tierra girara en órbita circular con velocidad angular constante (L₀) se calcula mediante el polinomio de segundo grado de Jean Meeus (Capítulo 25). Para que en valores negativos diminutos de coma flotante (p. ej., -1e-16) la operación a − b·Floor(a/b) no devuelva exactamente 360.0°, la función Mod aplica un acotamiento semiabierto [0.0, b).

Motivo (Por qué lo hicimos así): Lo hicimos así porque tanto la longitud eclíptica verdadera (☉_true) como la Ecuación del Tiempo (EoT) tienen como fase de referencia principal el ángulo de longitud media L₀; Mod(360°) semiabierto impide desbordamientos en los ángulos frontera.
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) Anomalía Media Geométrica del Sol (M)

La Anomalía Media Geométrica (M), es decir, el ángulo medio barrido en la órbita elíptica terrestre desde el perihelio (punto más cercano al Sol, a principios de enero), se calcula tanto en grados como en radianes.

Motivo (Por qué lo hicimos así): Lo hicimos así porque la Ecuación del Centro de Kepler, que determina el aumento de velocidad orbital en enero y su disminución en julio, opera directamente sobre la serie armónica de senos de este ángulo M.
M = Mod(357.52911 + T * (35999.05029 - 0.0001537 * T), 360.0);
#59

59) Excentricidad Secular de la Órbita Terrestre (e)

El coeficiente de excentricidad (e ≈ 0.016708), que indica cuánto se aparta de una circunferencia la órbita terrestre, disminuye ligeramente cada siglo por la perturbación gravitatoria a largo plazo de los demás planetas y se actualiza instantáneamente mediante el polinomio en el siglo juliano (T).

Motivo (Por qué lo hicimos así): Lo hicimos así porque seguir la variación secular en vez de usar un coeficiente e fijo evita derivas a largo plazo tanto en la distancia Tierra–Sol (R_AU) como en la amplitud de la Ecuación del Tiempo.
e = 0.016708634 - T * (0.000042037 + 0.0000001267 * T);
#60

60) Ecuación del Centro de Kepler (C) y Anomalía Verdadera del Sol (ν = M + C)

De acuerdo con la ley de las áreas de Kepler, la diferencia entre la posición angular real en la órbita elíptica y el movimiento circular medio (Ecuación del Centro C, máximo ±1.915°) se resuelve mediante los armónicos sin(M), sin(2M) y sin(3M), obteniéndose a partir de ella el ángulo de anomalía verdadera ν = Mod(M + C, 360°).

Motivo (Por qué lo hicimos así): Lo hicimos así porque la serie desarrollada hasta el 3.er término armónico (sin 3M) resuelve la ecuación cerrada de Kepler sin iteraciones con una aproximación numérica de ~0.01 segundos de 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) Cálculo de la Distancia Instantánea Tierra–Sol (R_AU)

A partir de la ecuación orbital polar de la elipse, utilizando la anomalía verdadera (ν) y la excentricidad (e), se calcula la distancia instantánea entre los centros de la Tierra y el Sol en Unidades Astronómicas (R_AU ∈ [0.9833, 1.0167] AU; mínima a principios de enero y máxima a principios de julio).

Motivo (Por qué lo hicimos así): Lo hicimos así porque el semidiámetro aparente del disco solar, el ángulo de paralaje horizontal y la aberración anual de la luz varían en razón inversa directa con esta distancia instantánea R_AU.
R_AU = (1.000001018 * (1.0 - e * e)) / (1.0 + e * Math.Cos(DereceyiRadyana(sunTrueAnom)));
#62

62) Semidiámetro Variable del Disco Solar (s_☉ = 959.63″ / R_AU) y Paralaje Horizontal (π_☉ = 8.794″ / R_AU)

El radio angular aparente del disco solar en el cielo (~16′17″ en enero, ~15′45″ en julio) y el ángulo de paralaje horizontal (~8.79″ ≈ 0.00244°) de un observador en la superficie terrestre respecto al centro de la Tierra se calculan dividiendo las constantes estándar de la UAI entre la distancia instantánea R_AU.

Motivo (Por qué lo hicimos así): Lo hicimos así porque en el Horizonte Óptico Personal el cenit de salida/puesta del limbo superior, la duración del tránsito solar en istiwāʾ y la conversión del cenit geocéntrico en cenit topocéntrico dependen directamente de estos dos ángulos dinámicos.
gunesYaricapDeg = (959.63 / 3600.0) / sunRadVectorAu;
yatayParalaksDeg = (8.794 / 3600.0) / sunRadVectorAu;
#63

63) Perturbación Longitudinal del Baricentro Tierra–Luna (EMB, Δλ_Ay)

El punto que traza la elipse de Kepler alrededor del Sol no es el centro de la Tierra por separado, sino el centro de masas común Tierra–Luna (EMB). Como el centro terrestre describe cada mes sinódico de 29.53 días un bamboleo de ~4670 km de radio alrededor de este centro común, se añade a la longitud solar la corrección sin(D) con amplitud de ±6.4 segundos de arco (±0.00179°).

Motivo (Por qué lo hicimos así): Lo hicimos así porque despreciar la perturbación del baricentro lunar dejaría una desviación periódica de ~6.4 segundos de arco en la longitud solar durante las fases de cuarto creciente y cuarto menguante.
Error común / Nota de atención: Usar la constante de elongación lunar 350.74° de fuentes antiguas junto con el siglo J2000 (T) mezcla las épocas J1900 y J2000; el ángulo inicial correcto en la época J2000.0 es 297.8502°.
ayUzamaD = Mod(297.8502 + 445267.1115 * T - 0.00163 * T * T, 360.0);
ayBarysentrikDeg = 0.00179 * Math.Sin(DereceyiRadyana(ayUzamaD));
#64

64) Perturbaciones J2000.0 de Venus, Júpiter y Largo Plazo (E) para la Longitud Verdadera del Sol (☉_true)

Las perturbaciones gravitatorias de Venus y Júpiter sobre la órbita terrestre y la fase planetaria de largo plazo de Newcomb se calculan con los ángulos iniciales J1900 de Meeus (AFC Cap. 18: 153.23°, 216.57°, 312.69°, 231.19°) trasladados exactamente a la época J2000.0 mediante T_1900 = T + 1 (A = 351.9841°, B = 254.0782°, C = 157.0477°, E = 231.19° + 20.20° = 251.39°), obteniéndose ☉_true = Mod(L₀ + C + Δλ_gez + Δλ_Ay, 360°).

Motivo (Por qué lo hicimos así): Lo hicimos así porque multiplicar constantes de fase publicadas para J1900 (JD 2415020.0), como 231.19°, directamente por el siglo J2000.0 (T) introduce un desfase de 100 años (+1 siglo); el desplazamiento T_1900 = T + 1 alinea todos los términos con el eje J2000.0.
Error común / Nota de atención: Quienes están habituados a las antiguas tablas de Meeus (J1900) o ciertos modelos pueden confundir 231.19° con J2000 y creer que 251.39° es un residuo de J1900; sin embargo, al avanzar +1 siglo de 1900 a 2000 resulta T_1900 = T + 1 y 231.19° + 20.20° = 251.39° da la fase exacta 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 Lunar (Ω), Nutación en Longitud (Δψ), Aberración Escalada por Distancia y Longitud Aparente (λ)

Para pasar de la longitud geométrica verdadera a la longitud aparente (λ) vista por el observador en la Tierra, se calculan la longitud del nodo ascendente lunar (Ω = Mod(125.04° − 1934.136°·T, 360°)) y la nutación en longitud (Δψ) con el término solar semestral; además se suma la aberración anual escalada por distancia (-20.4898″ / R_AU), fruto de combinar la velocidad orbital terrestre y la velocidad finita de la luz, reduciendo el resultado a [0°, 360°).

Motivo (Por qué lo hicimos así): Lo hicimos así porque el tiempo de ~8.3 minutos que tarda la luz del Sol en llegar a la Tierra desplaza la posición aparente del Sol ~20.5 segundos de arco en sentido orbital; escalar este término por R_AU en el perihelio y afelio captura la variación de velocidad elíptica.
Error común / Nota de atención: Tomar la aberración anual de la luz como una constante fija de -20.4898″ todo el año ignora la variación de velocidad de la órbita elíptica; como la Tierra se mueve más rápido en el perihelio de enero (R_AU ≈ 0.983), la aberración crece inversamente con 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) Oblicuidad Media de la Eclíptica de Laskar (ε₀) y Nutación en Oblicuidad Verdadera (ε = ε₀ + Δε)

La inclinación del eje de rotación terrestre respecto al plano orbital (~23.439°) disminuye lentamente a lo largo de los siglos por la atracción planetaria y experimenta una nutación en oblicuidad (Δε) de ±9.2 segundos de arco ligada al nodo lunar (Ω) y a la fase semestral 2·L₀. Sumando Δε al polinomio de oblicuidad media ε₀ se obtiene la oblicuidad instantánea verdadera (ε).

Motivo (Por qué lo hicimos así): Lo hicimos así porque la transformación de coordenadas eclípticas a coordenadas ecuatoriales (declinación δ y ascensión recta α) utiliza directamente el seno y el coseno de este ángulo instantáneo ε.
ε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) Declinación Solar (δ) y Ascensión Recta con Arcotangente de Cuatro Cuadrantes (α)

A partir de la longitud aparente (λ) y de la oblicuidad verdadera de la eclíptica (ε) se calculan la distancia angular del Sol al ecuador celeste (declinación δ = asin(clamp(sin ε · sin λ, -1, 1))) y su ascensión recta medida sobre el ecuador celeste desde el equinoccio vernal (α = Mod(atan2(cos ε · sin λ, cos λ), 360°)).

Motivo (Por qué lo hicimos así): Lo hicimos así porque acotar sin(δ) al intervalo [-1, +1] evita el riesgo de NaN ante desbordamientos de coma flotante, mientras que la función atan2 de cuatro cuadrantes resuelve la ascensión recta sin ambigüedad de cuadrante en todo el rango 0°–360°.
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) Ecuación del Tiempo Exacta de Meeus 28.1 (EoT) y Término Auxiliar Clásico de Oblicuidad (y = tan²(ε/2))

Motivo (Por qué lo hicimos así): Lo hicimos así porque la serie truncada de segundo orden de Smart deja desviaciones de ~0.4–0.8 segundos en términos cruzados de alta excentricidad/oblicuidad, mientras que la fórmula directa (L₀ − 0.0057183° − α + Δψ·cos ε)·4 incorpora también las perturbaciones planetarias y lunares en la EoT.
Error común / Nota de atención: Al ver en el paso 65 que la aberración se divide por R_AU, alguien podría querer dividir también entre R_AU la constante 0.0057183° (-20.4898″) dentro de EoT; sin embargo, en la definición de Meeus 28.1 el Sol medio ficticio tiene velocidad constante y dicha constante media de aberración no se divide.
eotDerece = Sarmala180(geomMeanLongSunDeg - 0.0057183 - sunRightAscensionDeg + deltaPsiDeg * Math.Cos(ε_rad));
eqOfTimeMinutes = eotDerece * 4.0;
#69

69) Tiempo Solar Verdadero (TST) y Ángulo Horario del Meridiano Local (H = TST · 0.25 − 180°)

Combinando el minuto de reloj local (t_dk), la Ecuación del Tiempo (EoT), la conversión de la longitud a razón de 4 minutos por grado (4·λ_long) y la zona horaria activa (60·TZ), se obtiene el Tiempo Solar Verdadero (TST ∈ [0, 1440) min); a partir de él se deduce el Ángulo Horario H = TST · 0.25 − 180° (negativo antes del mediodía, positivo después), que mide la distancia angular del Sol al meridiano local.

Motivo (Por qué lo hicimos así): Lo hicimos así porque en el triángulo esférico de posición el ángulo dependiente del tiempo en el teorema del coseno que une el cenit del observador con el Sol es directamente este ángulo horario local (H).
trueSolarTimeMin = Mod(gunIciToplamDakika + eqOfTimeMinutes + 4.0 * guvenliBoylam - 60.0 * temizSaatDilimi, 1440.0);
hourAngleDeg = trueSolarTimeMin * 0.25 - 180.0;
#70

70) Cenit Geocéntrico (θ_z_jeo) y Altura Geométrica Topocéntrica Corregida por Paralaje (α_geom)

Mediante el teorema esférico del coseno se halla primero el ángulo cenital geocéntrico respecto al centro de la Tierra θ_z_jeo = acos(clamp(sin φ · sin δ + cos φ · cos δ · cos H, -1, 1)). Al hallarse el observador sobre la superficie terrestre y no en el centro del planeta, el Sol se ve ~8.79″ más bajo en el horizonte; sumando π_☉ · sin(θ_z_jeo) y acotando a [0°, 180°] se obtienen el cenit topocéntrico (θ_z) y la altura geométrica (α_geom = 90° − θ_z). Este ángulo topocéntrico se aplica directamente en la altura solar instantánea, en las proporciones de sombra de ʿAṣr (α_zeval, α_asr) y en las raíces de crepúsculo/ʿIshāʾ; en el Horizonte Óptico Personal, como el término −π_☉ va incluido dentro del ángulo cenital del horizonte (θ_ufuk), tanto las raíces normales (Paso 76) como las de rasancia polar (Paso 77) aplican el paralaje horizontal simétricamente, mientras las 7 autoridades oficiales conservan el estándar de 90°50' (90.833333°).

Motivo (Por qué lo hicimos así): Lo hicimos así porque escalar la corrección por paralaje con sin(θ_z_jeo) elimina el desfase de ~8.79″ (~0.6 s) en altura solar instantánea, ángulos de sombra de ʿAṣr, raíces crepusculares y Horizonte Óptico Personal, preservando a la vez el estándar de calendario 90°50' en las autoridades oficiales.
θ_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) Exponente de Densidad del Aire de Gladstone–Dale (4.25588) y Factor Barométrico de Refracción (ρ / ρ₀)

Como la refracción atmosférica es proporcional a la refractividad (n − 1 ∝ ρ), disminuye a grandes altitudes con la menor densidad del aire y aumenta en depresiones como el Mar Muerto (-430 m). En la ecuación troposférica de la Atmósfera Estándar Internacional (ISA, T₀ = 288.15 K, L = 0.0065 K/m), en lugar del exponente de presión 5.25588 para P/P₀, se emplea el exponente exacto de densidad (P/P₀)/(T/T₀) = (1 − 2.25577e-5 · H)^4.25588 en el intervalo [-450 m, 11000 m].

Motivo (Por qué lo hicimos así): Lo hicimos así porque usar solo el exponente de presión (5.25588) omite que el aire se enfría y densifica al ganar altura y subestima la refracción en ~5 % a 2000 m de altitud; el exponente de densidad 4.25588 concuerda con la ley física de Gladstone–Dale.
double BasincKirilmaCarpaniHesapla(double H) → Math.Pow(1.0 - 2.25577e-5 * Math.Clamp(H, -450.0, 11000.0), 4.25588);
#72

72) Refracción Atmosférica C¹-Monótona de Sæmundsson / Meeus 16.4 (+0.00192792 y Atenuación [-3°, -1°])

Debido a que la fórmula clásica por tramos de NOAA puede generar una discontinuidad de ~20.9 minutos de arco en h = -0.575°, dentro del calculador de refracción se utiliza el modelo diferenciable y monótono de Sæmundsson / Meeus 16.4 en el rango (-3.0°, +90.0°). Para anular exactamente el término negativo de tan(90.1083°) en el cenit (h = 90°) se suman +0.00192792 minutos de arco, se aplica atenuación de Hermite en la banda [-3.0°, -1.0°] y para ángulos crepusculares h ≤ -3.0° la refracción devuelve exactamente 0.0°.

Motivo (Por qué lo hicimos así): Lo hicimos así para eliminar el escalón artificial de 21 minutos de arco cerca del horizonte, garantizar la condición R = 0° en el cenit (h = 90°) y proteger las raíces crepusculares de -15°..-20° frente a colas de refracción espurias.
Error común / Nota de atención: Añadir también los 34′ de refracción horizontal cuando el Sol está a -18° bajo el horizonte es un error frecuente; a esa profundidad ningún rayo directo del disco solar alcanza el ojo, sino dispersión atmosférica superior, y todos los ángulos crepusculares se definen geométricamente sin refracción.
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) Desviaciones Naturales en la Atmósfera Real por Temperatura (-30 °C..+45 °C), Presión, Humedad e Inversión (±15–40 s)

Nota de Humildad Meteorológica: Fenómenos atmosféricos locales como la temperatura del aire instantánea, bajas presiones de tormenta, humedad relativa y espejismo de horizonte pueden influir en el ocaso aparente en orden de segundos; por ello son esenciales los márgenes de precaución jurídica.

Como todo motor astronómico y de calendario, este cálculo se basa en la Atmósfera Estándar Internacional (aire seco a 15 °C y 1013.25 hPa al nivel del mar). En el cielo real, bajo el calor estival de La Meca o Bagdad (+45 °C) el aire se dilata reduciendo la refracción horizontal en ~2–3 minutos de arco, mientras que en las heladas invernales de Erzurum o Siberia (-25..-35 °C), con alta humedad de vapor de agua o inversión térmica sobre el mar, la refracción aumenta; este fenómeno físico natural puede desplazar la salida y puesta aparentes en ±15–40 segundos (±1 min en minutos fronterizos).

Motivo (Por qué lo hicimos así): Lo hicimos así porque un motor de cálculo sin conexión no puede medir el perfil vertical instantáneo de temperatura y humedad a lo largo de la línea del horizonte; los márgenes de precaución que los comités oficiales añaden a los horarios de Salida y Maghrib absorben también esta variación meteorológica natural.
// Referencia estándar: T₀ = 15 °C (288.15 K), P₀ = 1013.25 hPa → Refracción horizontal R₀ ≈ 34 minutos de arco
// Calor extremo (+45 °C) / frío (-30 °C) / inversión → variación natural de ±15..40 s en el horizonte óptico
#74

74) Acimut Solar Meeus 13.5 de Cuatro Cuadrantes Protegido para el Istiwāʾ al-Aʿẓam de la Kaaba (θ_z → 0°)

El ángulo horizontal del Sol medido desde el Norte en sentido horario (Acimut) se calcula sin singularidades mediante Math.Atan2(sin H, cos H · sin φ − tan δ · cos φ) + 180°, en lugar de la fórmula arccos que lleva sin(θ_z) en el denominador y produce indeterminación 0/0 cuando el Sol pasa exactamente por el cenit (en los mediodías del 28 de mayo y 16 de julio en La Meca durante el Istiwāʾ al-Aʿẓam de la Kaaba, cuando θ_z → 0°).

Motivo (Por qué lo hicimos así): Lo hicimos así porque en la franja tropical, al pasar el Sol directamente por el cenit, el denominador sin(θ_z) tiende a cero; la fórmula Math.Atan2 no divide por el ángulo cenital y es estable en todas las latitudes.
Error común / Nota de atención: La fórmula de acimut con arccos de una sola variable que aparece en libros de texto no distingue por sí sola entre mañana y tarde y además se vuelve inestable sobre la Kaaba cuando el Sol está en el cenit (θ_z → 0°) porque su denominador se anula.
azPay = sin(H);   azPayda = cos(H) * sin(φ) - tan(δ) * cos(φ);
guneydenBatiyaDeg = RadyaniDereceye(Math.Atan2(azPay, azPayda));   Azimut = Mod(guneydenBatiyaDeg + 180.0, 360.0);
#75

75) Convergencia del Mediodía (Zawāl) en 4 Rondas Protegida frente a la Línea de Cambio de Fecha (±180° IDL, Diferencia Sarmala180)

Al calcular el instante de tránsito por el meridiano al mediodía (zawāl), como la Ecuación del Tiempo (EoT) varía ligeramente a lo largo del día, se ejecutan 4 iteraciones sucesivas de punto fijo sobre la estimación del zawāl. En lugares vecinos a ±180° como Kiritimati (UTC+14, -157.4°O), Samoa (UTC+13) y Chatham (+12:45), para evitar que el zawāl se proyecte al día anterior o siguiente, la diferencia (15°·TZ − longitud) se envuelve directamente mediante Sarmala180 al rango [-180°, +180°).

Motivo (Por qué lo hicimos así): Lo hicimos así porque en husos horarios insulares situados a más de 180° del meridiano central 15°·TZ la fórmula bruta desplaza el zawāl ±1440 minutos; la diferencia de meridiano Sarmala180 mantiene el zawāl en mitad del día local.
meridyenFarkiDeg = Sarmala180(temizSaatDilimi * 15.0 - guvenliBoylam);
solarNoonMin = 720.0 + 4.0 * meridyenFarkiDeg - eqOfTimeMinutes; // 4 iteraciones sucesivas de punto fijo
#76

76) Convergencia de Punto Fijo en 8 Rondas para Salida y Puesta del Sol en Latitudes Normales (|cos HA_zeval| ≤ 0.90)

Al salir y ponerse el Sol, su declinación (δ) y Ecuación del Tiempo (EoT) difieren de los valores del mediodía (en los equinoccios δ varía ~0.4° entre la mañana y la tarde). Por eso, en latitudes normales que cumplen |cos HA_zeval| ≤ 0.90 y |φ| ∈ [0°, 88°), tanto la hora de salida como la de puesta se resuelven por separado hasta en 8 rondas (con criterio de convergencia |Δt| ≤ 0.0001 min) usando sus propios valores (δ(t_k), EoT(t_k)).

Motivo (Por qué lo hicimos así): Lo hicimos así porque calcular la salida y la puesta en un solo paso con la declinación del mediodía dejaría en latitudes medias y altas durante los equinoccios un error de asimetría de 1–2 minutos en las horas de salida y puesta.
cosHa = (cos(ufukZenit) - sin(φ)*sin(δ_k)) / (cos(φ)*cos(δ_k));   t_{k+1} = zeval_k ∓ 4.0 * acos(cosHa);
#77

77) Extremo por Sección Áurea y Raíz de Horizonte en 28 Pasos en la Franja de Rasancia Polar (|cos HA| ∈ (0.90, 1] o |φ| ≥ 88°)

Cerca del círculo polar y en el vértice polar de 88°–89.9°, como el Sol roza el horizonte muy horizontalmente y en los equinoccios la variación intradiaria de la declinación (~0.4°/día) supera la oscilación cenital diaria, tras la puerta de preselección 2·(90° − |φ|) + 1.25° se buscan el zawāl (±120 min para |φ| ≤ 85°, ±360 min para |φ| ∈ (85°, 88°), ±720 min para |φ| ≥ 88°) y los puntos nadir de mañana/tarde (±180 min para |φ| ≤ 85°, ±360 min por encima de 85°) mediante una búsqueda por sección áurea de 26 pasos, y se ejecuta una búsqueda binaria de 28 pasos sobre la diferencia entre el cenit geocéntrico y el cenit del horizonte (θ_z,jeo − θ_ufuk = 0). En el modo Horizonte Óptico Personal, como la definición θ_ufuk = 90° + s_☉ + R_ufuk − π_☉ + α_ufuk incluye directamente el paralaje horizontal (−π_☉ ≈ −8.79″) en su interior (Paso 44), tanto cos(θ_ufuk) del Paso 76 como la búsqueda binaria aquí aplican el mismo paralaje de horizonte sin crear discontinuidad en el límite |cos HA| = 0.90.

Motivo (Por qué lo hicimos así): Lo hicimos así porque tanto en el estándar oficial 90°50' como en el Horizonte Óptico Personal (con el ángulo θ_ufuk que incluye −π_☉), el arccos de 8 rondas y la búsqueda binaria comparten exactamente el mismo objetivo θ_ufuk, manteniendo el escalón de rama por debajo de ~0.15 segundos en la transición |cos HA| = 0.90 y sin perder la salida equinoccial a 89.9°N.
double ZenitFarki(double dk) → HesaplaTamDetay(..., dk, ...).jeosentrikZenitDeg - ufukZenitDeg; // En Horizonte Personal ufukZenitDeg incluye -π_☉
AltinKesitEkstremumBul(zeval - ogleYaricap, zeval + ogleYaricap, maksimumAraniyor: false, out gercekZeval); // 26 pasos + 28 pasos bisection
#78

78) Noche Simétrica (1440 − Día) Frente a Noches Consecutivas Asimétricas de Mañana (d-1 → d) y Tarde (d → d+1)

La duración de la noche simétrica se calcula directamente como 1440 − Día (Día + Noche Simétrica = 1440 min). Sin embargo, en latitudes altas durante la primavera y el otoño, como la duración del día cambia de 6 a 12 minutos diarios, la noche matutina de Imsak (puesta de ayer → salida de hoy) y la noche vespertina de ʿIshāʾ (puesta de hoy → salida de mañana) no son iguales a la noche simétrica; el motor las calcula por separado a partir de su propio par de días.

Motivo (Por qué lo hicimos así): Lo hicimos así porque usar solo la diferencia simétrica (1440 − Día) en las estimaciones de Imsak y ʿIshāʾ desviaría varios minutos las duraciones nocturnas de mañana y tarde durante los cambios rápidos de estación.
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) Buscador de Nadir por Sección Áurea en 30 Pasos con Ventana Adaptativa (±95 / ±160 / ±300 min, Mínimo Sin Refracción)

El instante de mínima altura solar nocturna (nadir) puede desplazarse del punto zawāl ± 720 min en latitudes altas debido a la rápida variación de la declinación. La búsqueda del mínimo en el meridiano inferior halla el punto nadir real mediante una búsqueda por sección áurea de 30 pasos sobre la altura topocéntrica sin refracción (sin margen de refracción) dentro de una ventana adaptativa (±95 min para |φ| ≤ 75°, ±160 min para (75°, 85°], ±300 min por encima de 85°). En modos de ʿIshāʾ fijo de +90/+120 min como Umm al-Qura, el motor principal omite la búsqueda del nadir vespertino; para que la medición de referencia en el informe no quede vacía, el nadir vespertino se muestrea aparte exclusivamente con fines diagnósticos en la misma ventana.

Motivo (Por qué lo hicimos así): Lo hicimos así porque los ángulos crepusculares se definen mediante altura geométrica sin refracción y en la franja polar de 85°–89.9° el instante del nadir puede salirse de ±95 min; la búsqueda por sección áurea de ±300 min mantiene la búsqueda binaria en la rama correcta.
Error común / Nota de atención: Se suele creer que la menor altura solar nocturna ocurre siempre a las 00:00 o exactamente a zawāl ± 12 horas; en los equinoccios polares la rápida variación de la declinación puede desplazar horas el verdadero mínimo.
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) Búsqueda Binaria en 28 Pasos en las Ramas Monótonas de Ascenso y Descenso (Solucionador de Raíces Mañana / Tarde)

Una vez separados el mínimo nocturno (nadir) y el máximo diurno (zawāl), la altura solar se convierte en una función de raíz única estrictamente creciente a lo largo de la rama matutina [t_nadir,mañana, t_zawāl] y estrictamente decreciente a lo largo de la rama vespertina [t_zawāl, t_nadir,tarde]. Los solucionadores de raíces de altura matutina y vespertina ejecutan en ese intervalo una búsqueda binaria de 28 pasos (este refinamiento es únicamente la resolución numérica interna de la ecuación; en el cielo real la incertidumbre atmosférica y topográfica es del orden de segundos).

Motivo (Por qué lo hicimos así): Lo hicimos así porque un barrido lineal grueso de 1 minuto realiza cientos de llamadas innecesarias a efemérides y deja escalones en el límite de redondeo al minuto; la búsqueda binaria de 28 pasos resuelve la ecuación sin añadir error numérico adicional.
TrySabahYukseklikZamaniBul(..., sabahDipDk, zevalDk, imsakAci, kirilmaliYukseklikKullan: false, out hamImsak, out _, out _); // IkiliAramaYukselis (28 pasos)
TryAksamYukseklikZamaniBul(..., zevalDk, aksamSinirDk, hedefAci, kirilmaliYukseklikKullan: false, out bulunanDk, out _, out _); // IkiliAramaAlcalis (28 pasos)
#81

81) Duración Física Pura de la Noche Sharʿī sin Tamkīn Ghurūb → Fajr (d → d+1 UTC)

En el fiqh Hanafí y Shafi'í, el comienzo de la noche es la puesta del Sol (ghurūb) y su final es el alba verdadera (ṭulūʿ al-fajr / Fajr al-Ṣādiq) de la mañana siguiente. Como el margen de precaución añadido a la oración de Maghrib o un salto de horario de verano/invierno (DST) no alteran la duración física de la noche, la duración de la noche sharʿī se calcula directamente a partir de la diferencia entre el instante UTC puro de la puesta de hoy y el instante UTC puro de Fajr de mañana (d+1).

Motivo (Por qué lo hicimos así): Lo hicimos así porque extraer la duración nocturna a partir de las horas de pared con precaución mezclaría los márgenes de tamkīn en la medianoche sharʿī y además mediría la noche sharʿī con 1 hora de error en las noches de cambio DST de primavera/otoño.
Error común / Nota de atención: Calcular la medianoche sharʿī a partir del horario de Maghrib con precaución de la tarjeta y del horario de Imsak de la mañana del mismo día mezcla los márgenes en la noche, usa el Imsak del día equivocado y produce 30 min de error en la noche de cambio DST.
seriGeceSuresiDakika = Math.Clamp((yarinHamFecrUtcDakika + 1440.0) - hamGunBatisUtcDakika, 6.0, 1434.0);
#82

82) Niṣf al-Layl (Medianoche Sharʿī) y Thuluth al-Ākhir (Último Tercio de la Noche) en el Fiqh Hanafí y Shafi'í

En la escuela Shafi'í el tiempo electivo (ikhtiyārī) de la oración de ʿIshāʾ, y en la escuela Hanafí el límite de cumplimiento sin desaprobación (sin karāha), llegan hasta la Medianoche Sharʿī (Niṣf al-Layl = Ghurūb + 1/2 · Noche Sharʿī); por su parte, Thuluth al-Ākhir, el tiempo virtuoso del tahajjud y del suḥūr, comienza en el último tercio de la noche (Ghurūb + 2/3 · Noche Sharʿī). Ambos instantes se calculan en el eje puro UTC y se proyectan a su propia zona horaria local instantánea.

Motivo (Por qué lo hicimos así): Lo hicimos así porque la Medianoche Sharʿī no son las 00:00 del reloj de pared, sino el punto medio real entre el ocaso y el alba, que según la estación y la longitud varía entre las 22:30 y la 01:15.
seriGeceYarisiUtc = hamGunBatisUtcDakika + 0.5 * seriGeceSuresiDakika;
sonUcteBirGeceUtc = hamGunBatisUtcDakika + (2.0 / 3.0) * seriGeceSuresiDakika;
#83

83) 1.er Horario — Solución Astronómica de Raíz de Imsak (Fajr al-Ṣādiq / Inicio del Alba)

Motivo (Por qué lo hicimos así): Lo hicimos así porque el instante del modelo astronómico en que aparece la blancura horizontal en el horizonte (Fajr al-Ṣādiq) es el valor raíz en la rama ascendente matutina sin refracción para el ángulo crepuscular de la autoridad elegida.
bool imsakBulundu = TrySabahYukseklikZamaniBul(..., sabahDipDk, zeval, imsak_derece, kirilmaliYukseklikKullan: false, out hamImsak, out _, out _);
#84

84) Noche Blanca en Imsak (Hermite 1.50° / Estimación Diyanet), Distinción de Invierno Polar e Imsak Neto

Motivo (Por qué lo hicimos así): Lo hicimos así para que la primera noche estival en que se rompe la raíz crepuscular no produzca un abismo de 35–45 minutos en el horario, y para que la ecuación de noche blanca no se active por error en pleno invierno polar.
if (d.diyanetYuksekEnlemAktif) { double takdirImsakNet = d.netGunesDakika - d.diyanetTakdirImsakAralikDk; /* + puente Hermite */ }
#85

85) 2.º Horario — Salida del Sol (Ṭulūʿ), Fin del Tiempo de Fajr, Tamkīn Negativo y Nota de Karāha de Ishrāq

Motivo (Por qué lo hicimos así): Lo hicimos así porque la Salida del Sol no es un horario de entrada sino el límite de salida de la oración de Fajr; aplicar la precaución hacia atrás y no hacia adelante protege que la oración concluya antes del instante de karāha.
#86

86) Karāha de Istiwāʾ, Duración del Tránsito del Disco Solar (4·s_☉ / cos δ) y Estándar Central de Umm al-Qura

Motivo (Por qué lo hicimos así): Lo hicimos así para evitar un doble istiwāʾ en Diyanet/MABIMS, coincidir en la Kaaba con el horario oficial de Ẓuhr de Umm al-Qura y resguardar el fin de la karāha en autoridades de tamkīn cero.
Error común / Nota de atención: Se suele creer que Ẓuhr entra de inmediato en el instante del zawāl; sin embargo, el zawāl es el tránsito del centro solar y la karāha de istiwāʾ dura hasta que el borde oriental abandona el 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.er Horario — Mediodía (Ẓuhr) y Monotonicidad del Tamkīn sin Zona Muerta en Modo Personal

El horario de Ẓuhr se calcula sumando al minuto del zawāl astronómico el tamkīn de mediodía de la autoridad elegida y, si corresponde, el margen adicional de istiwāʾ para el tránsito del disco solar. En el modo de Ajustes Personales, cuando el tamkīn de mediodía es cero o positivo, el margen adicional de istiwāʾ permanece constante, de modo que el incremento introducido por el usuario (0 → +0.5 → +1.0 min) se refleja linealmente en Ẓuhr sin quedar atrapado en una zona muerta. Cuando se introduce un tamkīn negativo de mediodía entra en acción el margen compensatorio para mantener Ẓuhr fuera de la karāha de istiwāʾ.

Motivo (Por qué lo hicimos así): Lo hicimos así porque en la zona positiva la antigua fórmula compensatoria simplificaba algebraicamente la entrada del usuario entre 0..+1.13 min absorbiéndola; esta estructura condicional aplica un piso de seguridad solo en la zona negativa preservando la monotonicidad positiva.
// Cuando ogleTemkin es negativo (else if ogleTemkin menor que 0.0): zevalIstivaPayiDk = fizikselIstivaDk - ogleTemkin
double netOgleDakika = zevalDakika + ogleTemkin + zevalIstivaPayiDk;
#88

88) Sombra Fayʾ al-Zawāl (tan(90° − α_zeval)) y Continuidad de Sombra Cero en el Istiwāʾ de la Kaaba

La medida del horario de ʿAṣr es la longitud de sombra añadida sobre la sombra mínima de cada objeto al mediodía (fayʾ al-zawāl). La sombra al zawāl de un gnomon unitario (1.0 u) se calcula con cot(α_zeval) = tan(90° − α_zeval); en los instantes en que el Sol pasa directamente por el cenit (α_zeval → 90°, Istiwāʾ al-Aʿẓam de la Kaaba en La Meca), para evitar que la longitud de la sombra resulte negativa, la altura del zawāl se acota de forma continua en [0.05°, 90.0°] (cuando α_zeval = 90°, fayʾ al-zawāl = 0.000000).

Motivo (Por qué lo hicimos así): Lo hicimos así porque mantener el límite superior en 90.0° exactos en lugar de 89.999° produce de manera fluida el valor físico de sombra cero cuando el Sol está exactamente sobre la vertical en la Kaaba.
zevalYukseklikDeg = Math.Clamp(zevalHamYukseklikDeg, 0.05, 90.0);
zevalGolgeBoyu = Math.Tan(DereceyiRadyana(90.0 - zevalYukseklikDeg));
#89

89) 4.º Horario — Solución de Raíz del Ángulo Geométrico de Sombra de ʿAṣr (ʿAṣr al-Awwal +1 / ʿAṣr al-Thānī +2, atan(1 / L_asr))

Motivo (Por qué lo hicimos así): Lo hicimos así porque resolver tanto la sombra del zawāl como la altura objetivo de ʿAṣr en el plano angular topocéntrico sin refracción, y ejecutar la búsqueda binaria de 28 pasos con la declinación real de la tarde, elimina la deriva de declinación constante.
Error común / Nota de atención: Calcular la sombra fayʾ al-zawāl sin refracción y añadir refracción atmosférica a la altura solar de ʿAṣr (o mantener fija la declinación del mediodía en ʿAṣr) sitúa ambas proporciones de sombra en planos distintos generando un desfase sistemático.
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) Rasancia Invernal del Horizonte en ʿAṣr (Hermite [0.05°..umbral superior], Proporción Semidiurna 0.16 en ʿAṣr al-Awwal / 0.24 en ʿAṣr al-Thānī)

Motivo (Por qué lo hicimos así): Lo hicimos así tanto para no alterar la raíz real de sombra en ciudades de 65°–66.5° como Rovaniemi/Oulu cuando α_zeval ≥ 0.60°, como para evitar un salto de horas en ʿAṣr en un solo día en el límite de la noche polar a gran altitud.
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) Mezcla de ʿAṣr con Latitud de Referencia ±62° en Verano Polar ([1.2°..7.2°+] y Cúspide Polar 84°..86.5°)

En el verano polar (sol de medianoche que no se pone en 24 horas), para evitar la ruptura de la raíz cuando la altura mínima de la rama vespertina (α_min,ikindi) se aproxima tangencialmente desde abajo al ángulo objetivo de ʿAṣr (α_asr), se resuelve el horario real de ʿAṣr de la latitud de referencia ±62.0° para la misma longitud y día (t_62°); se aplica una transición suave de Hermite con la altura del mediodía ([1.2°, max(7.2°, umbral superior + 2.0°)]) y mezcla de altura mínima ([α_asr − 2.0°, α_asr]). En modo Diyanet, en la cúspide polar |φ| ∈ (84°, 90°] la transición de latitud alta ([84.0°, 86.5°]) preserva la continuidad.

Motivo (Por qué lo hicimos así): Lo hicimos así porque utilizar la raíz real de sombra de la latitud de referencia ±62° en lugar de sumar un número fijo de minutos conserva incluso en el verano polar la diferencia natural entre Shafi'í (+1) y Hanafí (+2).
kutupHedefIkindiDk = ikindiYedekDakika + wZevalRef * (refIkindiDk - ikindiYedekDakika);   wYazIkindi = HermiteSmoothStep(hedefAci - 2.0, hedefAci, ikindiMinYukseklikDeg);
#92

92) 5.º Horario — Ocaso (Maghrib / Ifṭār): Puesta del Limbo Superior y Precaución contra Ifṭār Anticipado

Motivo (Por qué lo hicimos así): Lo hicimos así porque romper el ayuno unos segundos antes de que el Sol haya quedado completamente bajo el horizonte pone en riesgo el ayuno; la puesta del limbo superior y el redondeo por exceso protegen esta precaución jurídica.
#93

93) 6.º Horario — Noche (ʿIshāʾ): Ángulo Crepuscular, Invierno Polar y Estimación de Noche Blanca

Motivo (Por qué lo hicimos así): Lo hicimos así porque el horario de ʿIshāʾ debe seguir en latitudes medias la desaparición real del crepúsculo y, al entrar en noches blancas, enlazarse sin saltos con la duración estimada de la institución.
#93B

93) 6.º Horario — Noche (ʿIshāʾ — Regla Fija + min de Umm al-Qura y Calendario Hijri de Respaldo)

Motivo (Por qué lo hicimos así): Lo hicimos así porque en los calendarios de Arabia Saudí y del Golfo se aplica oficialmente en Ramadán la regla de +120 min para facilitar el tarāwīḥ y el ifṭār, y no deben producirse excepciones de calendario en fechas posteriores a 2029.
hamYatsi = Math.Min(d.netAksamDakika + eklenecekDakika, d.yatsiUstSinirDakika);   netYatsi = hamYatsi + yatsiTemkin;
#94

94) Imsak de Mañana (d+1) y Límite Superior de ʿIshāʾ en el Eje Solar Continuo

Motivo (Por qué lo hicimos así): Lo hicimos así porque imponer un techo fijo de reloj de pared a las 23:55 recortaría artificialmente ʿIshāʾ antes de medianoche en ciudades como Reikiavik u Oslo donde ʿIshāʾ entra naturalmente entre las 00:30 y la 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) Protección de Orden Monótono de los 6 Horarios Antes de Proyección UTC (Búfer de 2.05 min) y Proyección Individual UTC → Local

Para que en valores de tamkīn extremos opuestos introducidos en modo Personal o en la frontera polar dos horarios consecutivos no se superpongan y las horas de las tarjetas sigan siendo estrictamente crecientes incluso tras el redondeo Ceiling/Floor, se aplica una protección de orden con un búfer de 2.05 min sobre el eje solar bruto; inmediatamente después, cada horario se proyecta individualmente desde el eje de tiempo universal (UTC) a su propia zona horaria local instantánea.

Motivo (Por qué lo hicimos así): Lo hicimos así porque una diferencia bruta de 1.0 minuto puede caer en el mismo minuto entero (p. ej., 01:15 == 01:15) al combinar Ceiling y Floor; el búfer de 2.05 min garantiza la desigualdad estricta en las tarjetas durante los 365 días.
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) Motor Institucional de Redondeo al Minuto (:30 en Diyanet y Umm al-Qura, Ceiling en Subuh MABIMS, Floor/Ceiling en Tamkīn Cero)

La capa de redondeo al minuto aplica el método de calendario propio de cada institución: (1) En Diyanet y Umm al-Qura los horarios se redondean al minuto más cercano con el umbral simétrico :30.00; (2) en el estándar MABIMS (KEMENAG/JAKIM), los 5 horarios de entrada de oración incluido Subuh (+2 min de precaución) se redondean por exceso (Ceiling / Pembulatan ke Atas), y Syuruk (-2 min) por defecto (Floor); (3) en autoridades oficiales de tamkīn cero y modo Personal, los horarios de salida Imsak y Salida del Sol se redondean por defecto (Floor), y los horarios de entrada Mediodía, Tarde, Ocaso y Noche por exceso (Ceiling) (solo en MABIMS Subuh se aplica Ceiling).

Motivo (Por qué lo hicimos así): Lo hicimos así porque el calendario impreso de cada autoridad se elabora con su propia regla de redondeo; por ejemplo, en Yakarta, al llevar Subuh +2 min de precaución, aplicar oficialmente Pembulatan ke Atas (Ceiling) en vez de Floor asegura la concordancia con el calendario de KEMENAG.
Error común / Nota de atención: Se suele pensar que el horario de Fajr/Imsak se redondea siempre por defecto (Floor) en todas las instituciones del mundo; sin embargo, en el sistema de Indonesia y Malasia (MABIMS/KEMENAG) Subuh es un horario de entrada de oración con +2 min de precaución y se redondea oficialmente por exceso (Ceiling).
bool imsakCikisYuvarla = (SeciliOtorite != Otoriteler.Kemenag_GuneydoguAsya); // MABIMS Subuh → Ceiling
FikhiGuvenliSaatMetnineCevir(netDakika, temkin, cikisVaktiMi);
#97

97) Diferencia Natural de Cuantización de Calendario de ±1 Minuto en Segundos Fronterizos (:29.9 / :30.1 y :00.1)

Transparencia en la Cuantización del Calendario: En días situados a pocas décimas o segundos del umbral de redondeo, observar diferencias fronterizas de ±1 minuto frente a calendarios impresos es el comportamiento natural de la cuantización.

Como las tablas de horarios de oración ocultan los segundos y muestran minutos enteros HH:mm, en días límite situados a 0.1–0.5 segundos del umbral de redondeo (:30.00 s en el sistema simétrico, :00.00 s en el sistema Ceiling/Floor), el número de términos de efemérides entre dos observatorios distintos o una diferencia de coordenadas de 0.5 metros puede situar valores como 12:04:29.9 y 12:04:30.1 en dos minutos contiguos (12:04 frente a 12:05).

Motivo (Por qué lo hicimos así): Lo hicimos así porque el hecho de que una diferencia de 0.2 segundos se perciba visualmente como 1 minuto entero es inherente a la matemática del redondeo al minuto; explicar con transparencia este comportamiento fronterizo disipa falsas percepciones de error.
// Ejemplo umbral simétrico: 12:04:29.9 → 12:04 | 12:04:30.1 → 12:05 (diferencia física real: 0.2 s, diferencia visible: 1 min)
// Ejemplo umbral por exceso (Ceiling): 18:10:00.2 → 18:11 (redondeo al minuto entero superior para evitar ifṭār anticipado)
#98

98) Truncamiento de Segundos por Defecto en Una Sola Etapa (Sub-Segundo) y Prevención del Doble Redondeo

Si al pasar de minuto decimal a texto de hora se usara redondeo al segundo más cercano (round), 29.50 segundos pasaría primero a 30 segundos y luego en el analizador de tarjetas volvería a redondearse al minuto superior, provocando un error de doble redondeo (double-rounding). El solucionador de segundos trunca por defecto en una sola etapa mediante ⌊min × 60 + 10⁻⁷⌋: 29.99 s → :29 (minuto inferior), 30.00 s → :30 (minuto superior).

Motivo (Por qué lo hicimos así): Lo hicimos así para impedir que los horarios en la banda 29.50–29.99 segundos se redondeen dos veces y salten 1 minuto por delante del calendario oficial.
Error común / Nota de atención: Redondear primero el minuto decimal al segundo más cercano y luego convertirlo a minutos con la regla de :30 s traslada horarios fronterizos como 12:04:29.60 primero a :30 y después a 12:05, generando un error invisible de doble redondeo.
double toplamTamSaniye = Math.Floor(dakika * 60.0 + 1e-7); // DakikayiSaatMetnineCevir
TryDakikaBazliVakitCozumle: if (saniye ≥ 30) dakika++;   yuvarlanmisToplamSaniye = saat * 3600 + dakika * 60;
#99

99) Desplazamiento de -86,400 s del Horario de ʿIshāʾ de Ayer (d-1) y Continuidad Tras la Medianoche

Cuando pasan las 00:00 de la noche y aún no ha entrado el Imsak de hoy, el horario vigente es el ʿIshāʾ de ayer (d-1). Para calcular sin interrupciones la proporción de llenado del anillo de cuenta regresiva (tiempo transcurrido / duración total), los horarios de ʿAṣr, Maghrib y ʿIshāʾ de ayer se resuelven en el eje abierto propio del día d-1 y se trasladan al eje temporal de hoy desplazados -86,400 s.

Motivo (Por qué lo hicimos así): Lo hicimos así para que al llegar las 00:00:00 el anillo de ʿIshāʾ no se reinicie, sino que muestre sin saltos el progreso nocturno físico real desde la noche hasta el alba.
int_dun_yatsi = dunAcikYatsi - 86400; // Referencia inicial activa de ʿIshāʾ después de las 00:00
#100

100) Eje de Segundos Abierto [-86,400 s .. +172,800 s] Centrado en Ẓuhr y Sensible a ΔTZ (Umbral de -60 s)

En zonas horarias manuales muy desplazadas al este o al oeste (p. ej., Imsak a las 06:30 en Kasgar UTC+8, 23:28 en Fuyuan, o deslizamiento de Ẓuhr cerca de la medianoche en elecciones manuales inversas de TZ), para evitar que los 6 horarios salten de día, el solucionador de eje abierto toma primero Ẓuhr como centro, desenrolla Salida del Sol e Imsak hacia atrás, y traslada ʿAṣr, Maghrib y ʿIshāʾ hacia adelante usando la diferencia horaria ΔTZ·3600 y la regla de despliegue de medianoche con umbral -60 s.

Motivo (Por qué lo hicimos así): Lo hicimos así porque el antiguo umbral de 12 horas (-43,200 s) hacía caer ʿIshāʾ en la mañana durante las noches largas de 58°–65°, mientras que desplegar hacia adelante desde Imsak podía desplazar todo el día +86,400 s en desfases manuales extremos de TZ; anclarse en Ẓuhr protege ambos extremos.
Error común / Nota de atención: Comprobar si la diferencia es menor que -12 horas (-43,200 s) para detectar el cruce de medianoche parece intuitivo, pero en la franja de 60°N, cuando Maghrib es a las 15:30 y ʿIshāʾ a las 03:45 de la madrugada (-11 h 45 min), hace caer erróneamente ʿIshāʾ en la mañana.
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) Emparejamiento de Imsak y Salida del Sol de Mañana en Extremos Orientales de Huso (Imsak a las 23:28 en Fuyuan, Ancla Solar ±64,800 s)

En lugares como Fuyuan (48.37°N, 134.28°E, UTC+8), el punto más oriental de China, en verano el Imsak de mañana entra a las 23:28 (antes de las 00:00). El algoritmo de despliegue de mañana sitúa primero la Salida del Sol de mañana dentro de la banda de ±64,800 s alrededor del segundo abierto de Salida del Sol de hoy, luego desenrolla el Imsak de mañana hacia atrás respecto a la Salida del Sol considerando ΔTZ y suma +86,400 s a ambos.

Motivo (Por qué lo hicimos así): Lo hicimos así porque dejar el Imsak de mañana que entra a las 23:28 desplazado en +86,400 s mostraría 24 horas de más en la cuenta regresiva entre las 23:28 y las 00:00; el ancla solar de respaldo y el desenrollado hacia atrás funcionan sin cortes en cualquier zona horaria manual.
while (cozulmusGunes - yedekGunesSn ≥ 64801) cozulmusGunes -= 86400;   while (yedekGunesSn - cozulmusGunes ≥ 64801) cozulmusGunes += 86400;
while (cozulmusImsak ≥ (cozulmusGunes - tzFark) + 61) cozulmusImsak -= 86400;   yarinImsakAcikSn = cozulmusImsak + 86400;
#102

102) Renovación Preventiva de la Tabla en el Día 6 (d ≥ 6), Espera de Corrutina y Tiempo Único por Fotograma

El controlador de visualización muestrea una sola vez al principio de cada segundo la hora local y la zona horaria de la ubicación y pasa ese mismo par temporal a todos los submódulos. Cuando la app permanece abierta sin conexión durante varios días, un día antes de agotarse el último día de la tabla (si la diferencia de días es 6 o mayor, o si faltan registros de almacenamiento local de mañana y del 7.º día y no hay un cálculo en segundo plano en curso) reconstruye la tabla y refresca de inmediato el índice del día activo.

Motivo (Por qué lo hicimos así): Lo hicimos así porque esperar hasta el 7.º día podría causar desbordamientos de índice al leer las tarjetas de mañana (d+1 = 7) o d+2 durante la noche del 6.º día; la renovación preventiva en el 6.º día mantiene listo el colchón d+1 y d+2.
if (KonumAlma.IlkKonumKayitliMi() && _sonOtomatikYenilemeTarihi != konumSimdi.Date && (gunFarki ≤ -1 || gunFarki ≥ 6 || yarinVeSonGunDepoKaydiEksik))
{ bulucu.yerel_vakitleri_ayarla(); d = AktifTabloGunIndeksiniBul(konumSimdi, out gunFarki); }
#103

103) Alineación Exacta al Minuto :00 entre Tarjeta–Contador–Anillo, Anillos Gemelos Matutinos y Transición a Ẓuhr Tras la Salida de Mañana

Dado que las tarjetas muestran minutos enteros HH:mm, el temporizador de cuenta regresiva (redondeo por exceso en segundos, tiempo restante − 10⁻⁹) y los anillos circulares de progreso también toman como base esos mismos límites de minuto entero (:00); así, cuando faltan 0.4 segundos, el contador no muestra prematuramente 00:00:00. Entre Imsak y Salida del Sol se llenan los anillos gemelos de Imsak y Salida; entre Salida del Sol y Ẓuhr los anillos permanecen inactivos (-1) y la cuenta apunta a Ẓuhr (o la etiqueta de Jumuʿah en viernes), y en husos muy orientales, si ya pasó también la Salida de mañana antes de las 00:00, cuenta hacia el Ẓuhr de mañana.

Motivo (Por qué lo hicimos así): Lo hicimos así porque mostrar 00:00:00 a las 19:03:59.6 mientras la tarjeta marca 19:04 daría sensación de reinicio medio segundo antes de tiempo; el redondeo por exceso con umbral de milisegundos pone a cero el contador exactamente en el límite :00.0.
int kalanSaniye = Math.Max(0, (int)Math.Ceiling(kalanFizikselSn - 1e-9)); // Evita 00:00:00 prematuro
simUtc ∈ [imsakUtc, gunesUtc) → aktifIndeks = 0;   simUtc ∈ [gunesUtc, ogleUtc) → aktifIndeks = -1; // Anillo inactivo, contador a Ẓuhr
#104

104) Cuenta Regresiva Física en UTC y Estado en Vivo en la Noche de Hora Duplicada 02:00..02:59 de Otoño

En la noche de otoño en que los relojes se atrasan de las 03:00 a las 02:00, la hora de pared 02:00–02:59 transcurre dos veces (primer paso en horario de verano, segundo paso en horario de invierno). El solucionador de horario activo y tiempo restante basado en UTC reduce todos los horarios al eje físico único de segundos UTC restando su respectiva zona horaria; de este modo, en el salto hacia atrás 02:59:59 → 02:00:00 el contador no salta 1 hora hacia adelante, sino que decrece monótonamente segundo a segundo. Por ejemplo, el porcentaje de avance de ʿIshāʾ tras la medianoche es la proporción recorrida del intervalo físico nocturno total entre el instante de ʿIshāʾ desplazado de ayer y el instante de Imsak de hoy.

Motivo (Por qué lo hicimos así): Lo hicimos así porque los contadores que simplemente restan horas de reloj de pared se rompen retrocediendo 1 hora en la noche DST de otoño en cuanto el reloj vuelve de las 03:00 a las 02:00; en el eje UTC, en cambio, el tiempo fluye en un solo sentido.
Error común / Nota de atención: Los temporizadores que calculan la cuenta regresiva restando horas locales de reloj de pared engañan al usuario aumentando de golpe el tiempo restante en 1 hora en el instante en que el reloj retrocede de las 03:00 a las 02:00 en otoño.
double kalanFizikselSn = (hedefGunIciSaniye - hedefTzSaat * 3600.0) - (suanGunIciSaniye - simdiTzSaat * 3600.0);
#105

105) Cambio Individual de las 6 Tarjetas a la Hora de Mañana Cuando Pasa su Propio Instante Físico UTC

Motivo (Por qué lo hicimos así): Lo hicimos así porque en lugar de dejar en una tarjeta ya vencida la hora terminada de hoy, mostrar la hora de mañana en que volverá a producirse ese horario facilita durante todo el día la planificación del suḥūr, la mañana y el mediodía.
kart_yapilandirma → KartiYapilandir(bugunVakitStr, bugunAcikHedefSaniye, bugunHedefTz, yarinVakitKey, ...);
DateTime hedefUtc = VakitUtcAniniHesapla(gunTabani, bugunAcikHedefSaniye, bugunHedefTz, enlem, boylam); // Si simdiUtc ≥ hedefUtc entonces d+1 (o d+2 si es preciso)
#106

106) Integridad de Texto Enriquecido de Derecha a Izquierda (RTL: Árabe / Urdu), Protección de Símbolos Unicode y Divisor de 1650 Caracteres

Mientras los textos del panel explicativo se escriben con animación de máquina de escribir, la capa protectora de etiquetas de formato no parte por la mitad ninguna etiqueta de color, negrita o cursiva en ningún fotograma y cierra temporalmente las etiquetas abiertas. Para que el analizador de etiquetas del componente de texto RTL no confunda pares de menor-que/mayor-que con etiquetas HTML, en los textos se emplean símbolos Unicode ≤, ≥, ∈, ↔, → en lugar de signos sueltos menor/mayor, y los pasos largos que superan el límite de 1650 caracteres se dividen en segmentos RTL consecutivos conservando las etiquetas de formato.

Motivo (Por qué lo hicimos así): Lo hicimos así porque en idiomas RTL una etiqueta de color partida durante la animación o un conflicto de signos menor/mayor puede filtrar código de formato en pantalla; la división equilibrada en múltiples fragmentos y los símbolos Unicode garantizan una presentación limpia en todos los idiomas.
const int RTL_GUVENLI_PARCA_SINIRI = 1650; // Los pasos que superan el límite se dividen con pila de etiquetas RichText abiertas en bloques RTLTextMeshPro consecutivos
GuvenliDaktiloAltMetniAl(tamMetin, gorunurHarfSayisi);   GuvenliRtlParcalaraBol(metin, 1650);
#107

107) Protección de Texto sin Conexión en Tres Capas y Diseño de Analizador Determinista

Este informe técnico abierto de 112 pasos está protegido en tres capas independientes de respaldo: (1) tabla dinámica de localización, (2) flujo local cifrado de respaldo de datos y (3) respaldo de último recurso incrustado directamente en la interfaz. Gracias a un analizador basado en máquina de estados determinista que no requiere reflexión (reflection), sigue operando sin conexión en distintas arquitecturas móviles sin verse afectado por optimizaciones del compilador.

Motivo (Por qué lo hicimos así): Lo hicimos así para que el panel explicativo nunca quede vacío al trabajar sin conexión o ante demoras de carga de paquetes, y se abra con la misma estabilidad en todas las plataformas móviles.
Tabla Principal → Flujo de Respaldo Local sin Conexión → Respaldo Incrustado en Interfaz;
AyiklaSafJsonYedek(safJsonMetin, hedefTablo); // Analizador de máquina de estados determinista sin reflexión
#108

108) 77 Verificaciones Independientes de Algoritmo, Geodesia, Zona Horaria, Continuidad Polar y Escuela Jurídica

Las 77 comprobaciones independientes de validación en el entorno de desarrollo prueban los límites IEEE-754 de JDN y Mod(360°), las efemérides de Meeus y la continuidad de refracción de Sæmundsson, el geoide EGM96 de dos capas, la distinción de altitud Android/iOS, la coherencia país/autoridad/zona horaria en la base de datos sin conexión de 8,023 localidades, los polígonos fronterizos del Mediterráneo Oriental/Marruecos/Kazajistán/11 husos de Rusia/Brasil/Norteamérica/Pacífico, la continuidad polar de 365 días, la cuenta regresiva UTC y el alcance exclusivo Hanafí/Shafi'í.

Motivo (Por qué lo hicimos así): Lo hicimos así porque mejorar un solo polígono fronterizo o una transición polar sin alterar ninguna ciudad de otro continente solo es posible mediante baterías exhaustivas de validación ejecutadas tras cada cambio.
// 77/77 comprobaciones independientes de validación: Efemérides + EGM96 + 8,023 Localidades + 365d Polar + Fiqh
#109

109) Declaración de Humildad Científica y Transparencia: Límites Naturales de Desviación Atmosférica, Topográfica y de Calendario

Nota de Humildad Científica y Jurídica: Los cálculos se basan en modelos de atmósfera estándar y horizonte urbano medio; en segundos fronterizos es natural observar diferencias de ±1 minuto frente a calendarios oficiales, debiendo observarse precaución en el ayuno y la oración.

Aunque este motor de 112 pasos se ha construido con gran rigor numérico, los modelos del cielo y la Tierra son por naturaleza aproximaciones físicas: (1) variaciones de temperatura (-30 °C..+45 °C), presión, humedad e inversión térmica pueden modificar la refracción horizontal aparente en ±15–40 s; (2) valles, crestas montañosas y obstáculos de edificios pueden diferenciar la salida/puesta local del horizonte plano del distrito; (3) la cuantización del geoide EGM96 de 1 m, la estimación de ΔT en años futuros y el redondeo al minuto :30 / Ceiling / Floor pueden generar diferencias naturales de ±1 minuto en segundos fronterizos frente a calendarios impresos. En los actos de adoración rige la precaución sharʿī.

Motivo (Por qué lo hicimos así): Lo hicimos así porque compartir abiertamente los límites físicos de la naturaleza en vez de presentar el cálculo astronómico como una regla mecánica inmutable es el enfoque más acorde tanto con el decoro y la humildad islámica como con la honestidad científica.
// Límites naturales físicos y de calendario: Atmósfera (±15..40 s) + Obstáculos Locales de Horizonte + Cuantización al Minuto (±1 min)
#110

110) Transparencia Abierta del Algoritmo Frente al Límite de Almacenamiento Interno de la Aplicación

Todas las ecuaciones astronómicas, constantes geodésicas, reglas de decisión de país y zona horaria, principios jurídicos de redondeo y valores intermedios de telemetría en vivo presentados en este informe se comparten abiertamente para que usuarios finales e investigadores puedan examinarlos directamente. Para mayor legibilidad, los títulos y párrafos explicativos se presentan con conceptos técnicos claros en español; para lectores técnicos, los nombres de los métodos centrales se reflejan únicamente en las líneas de Lógica C# en ejecución. El formato interno de empaquetado de archivos de la aplicación, los nombres locales de almacenamiento clave-valor y la disposición de memoria caché interna se expresan con conceptos arquitectónicos abstraídos tanto por privacidad como por estabilidad entre plataformas.

Motivo (Por qué lo hicimos así): Lo hicimos así porque exponer con transparencia el método de cálculo científico y jurídico se equilibra con abstraer los detalles internos de empaquetado y almacenamiento de datos de la app; para auditar el cálculo basta la lógica matemática y jurídica.
Error común / Nota de atención: Mantener en reserva las claves internas de almacenamiento local o los nombres de archivos empaquetados no significa que el cálculo sea cerrado; todas las fórmulas solares, de horizonte y jurídicas están expuestas íntegramente de principio a fin.
Capa Transparente: Efemérides Astronómicas + Reglas de Zona Horaria + Redondeo Jurídico + Telemetría en Vivo;
Capa Abstraída: Ruta Interna de Paquetes, Claves de Almacenamiento Local y Disposición de Memoria Interna;
#111

111) Proyección desde el Eje UTC al Reloj de Pared Local y Diferencia de Precisión de 0.0001 min (≈ 0.006 s)

En el cálculo diario, los horarios brutos hallados primero como minutos fraccionarios en la zona horaria de referencia continua del mediodía (p. ej., 1034.5015 min) se proyectan luego uno a uno a través del eje de tiempo universal UTC hacia la zona horaria local vigente para cada horario (incluidas las transiciones DST). Debido al redondeo de coma flotante IEEE-754 y de milisegundos–ticks al convertir del tiempo universal a la marca temporal local de ticks, en la salida de minuto neto de 4 decimales del informe puede observarse una diferencia de última cifra del orden de 0.0001 min (aproximadamente 0.006 segundos = 1/160 de segundo); las tarjetas de horarios en minutos enteros (:30 / Floor / Ceiling) no se ven afectadas por este margen de microproyección.

Motivo (Por qué lo hicimos así): Lo hicimos así porque en días con DST cada horario debe trasladarse desde su propia zona horaria UTC instantánea al reloj de pared real; documentamos abiertamente su origen físico para que el lector no confunda esta oscilación del último dígito de 0.0001 min con un error de fórmula.
Error común / Nota de atención: Ver 1034.5016 en lugar de 1034.5015 en la salida de minuto neto de cuatro decimales podría parecer una contradicción de cálculo; sin embargo, la diferencia es únicamente un redondeo de proyección temporal UTC↔local de 0.006 segundos y no altera la hora del horario de oración.
Horario Neto (min local) = TekilVakitUtcDenYerelDakikayaCevir(enlem, boylam, utcGunTabani, yerelGunTabani, ogleSaatDilimi, netVakitDakika, out gercekDilim, ref dstFarkiBulundu); // ≤ 0.0001 min (≈ 0.006 s)
#112

112) Resumen de Auditoría Final de los 6 Horarios de Hoy y Mañana y Firma de Caché v6

Motivo (Por qué lo hicimos así): Lo hicimos así porque permitir que el usuario y el auditor comparen de un solo vistazo las horas finales de las tarjetas de hoy y mañana generadas con todas las magnitudes astronómicas intermedias y la firma de caché completa la transparencia.