이슬람 예배 시간 계산 방법론: 천문학·측지학·이슬람 법학 기반 112단계 기술 모노그래프

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

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

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

1. Executive Abstract & Architectural Motivation

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

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

2. Core Mathematical, Geodetic & Physical Formulations

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

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

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

2.2 VSOP87D / NREL SPA Solar Ephemeris & Nutation

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

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

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

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

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

2.4 Gladstone–Dale Barometric Density & C¹ Refraction

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

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

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

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

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

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

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

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

3. Comparative Matrix of Official Global Calculation Authorities

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

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

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

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

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

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

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

#01

1) 하나피·샤피이 법학파 한정 원칙 및 피크흐(이슬람 법학) 체계

법학파 적용 범위 안내(하나피 및 샤피이 법학파 한정): 이 애플리케이션의 모든 예배 시간 계산, 그림자 비율, 카라하(예배 자제·금지) 시간대 경계 및 이흐티야트(신중 보정) 규칙은 오직 하나피 법학파와 샤피이 법학파의 원칙에 따라 구성되었으며, 그 외 법학파는 적용 대상에서 제외되었습니다.

아스르(오후 예배) 그림자 계수(아스르 알 아우왈 +1배 그림자: Diyanet / 하나피 이마마인 / 샤피이 및 아스르 앗 싸니 +2배 그림자: 하나피 이맘 알 아잠), 진여명(파즈르 앗 사디크) 및 박명(샤파크) 각도, 이스티와(정오 남중)·툴루(일출)·구룹(일몰)의 카라하 경계, 그리고 니스프 알 라일(샤리아 기준 한밤중) 규칙은 모두 오직 이 두 법학파의 피크흐 원리에 따라 모델링되었습니다.

이유(이렇게 설계한 까닭): 어떤 법학파의 기준에 따라 예배 시간이 산출되는지 사용자가 처음부터 투명하게 확인할 수 있도록 하고, 법학파 간 개념 혼동을 방지하기 위함입니다.
ikindi_golge ∈ { 1f (아스르 알 아우왈: Diyanet / 이마마인 / 샤피이), 2f (아스르 앗 싸니: 하나피 / 이맘 알 아잠) };
resmiTemkin + FikhiGuvenliSaatMetnineCevir(...) // 하나피·샤피이 신중 보정 방식
#02

2) 개인정보 보호 중심 ??:?? 대기 잠금, (0°, 0°) 거부 및 카바 성전(해발 277 m) 잠금

위치가 아직 선택되지 않은 경우 숨겨진 수도 좌표 등의 대체값이 자동 할당되지 않으며, 시간 카드는 ??:?? 상태로, 카운트다운은 ??:??:?? 상태로 대기합니다. (0°, 0°) 기니만 원점, 미정의 숫자(NaN/Infinity) 및 [-90°, +90°] 범위를 벗어난 잘못된 입력은 좌표 유효성 검사 게이트에서 차단됩니다. 사용자가 카바 성전 선택을 확정하면 64비트 배정밀도 카바 좌표(북위 21.422487°, 동경 39.826206°, ±1e-5° 보호 잠금), 히자즈 고도 277 m, 국가 코드 SA(UTC+3) 및 움 알 쿠라 계산 기관이 활성화됩니다.

이유(이렇게 설계한 까닭): GPS 권한을 허용하지 않은 사용자가 본인도 모르게 다른 도시의 예배 시간으로 혼동하는 일을 막고, 카바 성전을 선택했을 때 32비트 부동소수점 오차 없이 정밀한 좌표와 고도 277 m를 보존하기 위함입니다.
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(); // 카바 성전: 21.422487, 39.826206, 277m
#03

3) 64비트 배정밀도 좌표 전달 및 반개구간 [-180°, +180°) 경도 래핑

지도나 오프라인 도시 데이터베이스에서 선택한 좌표는 64비트 배정밀도(반올림 없는 완전 소수) 숫자로 저장됩니다. 실시간 GPS에서 전달된 32비트 좌표(지표 약 1.1 m 양자화 ≈ 시간 약 0.003초) 역시 읽는 즉시 64비트 공간으로 승격되어 유효성 검증을 거칩니다. 지도 스크롤 등으로 ±180° 날짜변경선을 넘는 경도는 순환 정규화를 통해 반개구간 [-180.0°, +180.0°)으로 환원됩니다.

이유(이렇게 설계한 까닭): 수백 회에 달하는 삼각함수 천체력(에페메리스) 계산 단계에서 32비트 부동소수점 노이즈가 누적되는 것을 막고, +180°와 -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) 밀리초 단위 GNSS 패킷 경과 시간, 실시간 센서 진행 검증 및 백그라운드 복귀 보호

모바일 운영체제는 위치 서비스를 새로 켜거나 앱이 백그라운드에서 복귀할 때 수 시간 전의 오래된 마지막 위치 캐시를 반환할 수 있습니다. 위치 신선도 게이트는 패킷의 경과 시간을 밀리초 단위 Unix 시간과 대조하며, 시스템 시계가 어긋난 기기에서는 위성 센서 타임스탬프가 벽시계와 일치하여 진행하는지(센서 진행량이 양수 0.05초 초과이며 센서–시스템 시계 진행 차 ≤ 30.0초)를 검사하고 30초 이상 백그라운드 절전 후 복귀 시 신선도 기준점을 초기화합니다.

이유(이렇게 설계한 까닭): 비행기에서 막 내렸거나 수 시간 만에 앱을 다시 연 사용자가 초기 8초 동안 오래된 GPS 캐시 때문에 이전 도시의 예배 시간을 보는 상황을 방지하기 위함입니다.
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) Android(WGS84 타원체고 h)와 iOS(평균 해수면 고도 MSL)의 고도 기준면 분리

수직 축에서 두 모바일 운영체제는 서로 다른 기준면을 반환합니다. Android 위치 서비스는 WGS84 기준 타원체 위의 기하학적 높이(타원체고 h)를 제공하는 반면, iOS 위치 서비스는 평균 해수면 고도(MSL)를 직접 반환합니다. 고도 변환기는 지오이드 고도(지오이드 기복 N) 차감을 오직 Android 타원체고에만 적용합니다.

이유(이렇게 설계한 까닭): iOS 기기에서 받은 해수면 고도에서 지오이드를 이중으로 차감하면 튀르키예 등에서 고도가 인위적으로 30~38 m 낮아지고, 반대로 Android에서 차감하지 않으면 같은 크기만큼 과다 측정되기 때문입니다.
흔한 오해 및 주의사항: GPS 고도가 모든 스마트폰에서 직접 해수면 고도(MSL)를 준다고 오해하기 쉽지만, Android는 원시 타원체고(h)를, iOS는 지오이드가 반영된 MSL을 반환하므로 두 플랫폼에 동일한 공식을 쓰면 튀르키예 기준 약 30~38 m 고도 편차가 발생합니다.
float jeoidN = androidElipsoidYuksekligiMi ? YaklasikJeoidOndulasyonuMetre(enlem, boylam) : 0f;
denizSeviyesiMetre = hamGnssRakimMetre - jeoidN;
#06

6) 이중 계층(2°x2° 전 세계 + 0.5°x0.5° 지역 고밀도) NGA EGM96 지오이드 고도(약 17.2 KB)

Android 타원체고(h)를 해수면 고도(H = h − N)로 변환하기 위해 NGA EGM96 모델에서 압축된 이중 계층(1.0 m 부호 있는 정수 양자화, 총 17,632바이트 ≈ 17.2 KB) 쌍선형 보간 격자를 사용합니다. 전 세계에는 2°x2°(91x181 격자점) 전역 테이블이 동작하고, 튀르키예·키프로스·근동 대역(북위 30°~43°, 동경 25°~46°)에서는 아나톨리아 고원의 구배를 추종하는 0.5°x0.5°(27x43 격자점) 하위 테이블이 1° 에르미트 경계 블렌딩으로 결합됩니다(1.0 m 지오이드 양자화는 지평선 각도 기준 약 0.002° 수준입니다).

이유(이렇게 설계한 까닭): 성긴 15°x15° 격자는 아나톨리아 고원의 지오이드 융기를 10~12 m 낮게 측정하기 때문이며, 압축된 이중 계층 격자는 메모리 점유를 약 17.2 KB로 유지하면서도 오차를 약 1 m 내외로 제한합니다.
흔한 오해 및 주의사항: 단순 구현에서 쓰는 10°~15° 간격의 성긴 지오이드 표는 이집트·흑해·카스피해 모서리에서 표본을 취해 아나톨리아 고원의 국지적 양(+)의 지오이드 돔(+27..+38 m)을 건너뛰어 카흐타 및 중앙 아나톨리아에서 약 11 m의 오차를 남깁니다.
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) 물리적 고도 한계 [-450 m 사해 .. 8850 m 에베레스트] 및 저지대 분지 대기 밀도 효과

고도 유효성 게이트는 모든 모듈에서 공통으로 [-450 m, 8850 m] 해수면 고도(MSL) 범위를 기준으로 삼습니다. 이를 통해 사해 연안(-430 m, 예리코/요르단 계곡)과 갈릴리 호수(-210 m) 같은 해수면 아래 저지대 분지부터 에베레스트 정상(8849 m)까지의 모든 거주 지역이 보존됩니다. 음(-)의 고도를 지닌 저지대에서는 공기 기둥이 해수면보다 더 조밀하므로 글래드스톤-데일 굴절 배수가 자연스럽게 1.0을 초과하며(사해에서 ρ/ρ₀ ≈ 1.042), 광학 지평선 복각은 ΔH = max(0, H − H₀)로 음수 제곱근을 취하지 않습니다.

이유(이렇게 설계한 까닭): 하한선을 0 m로 잡으면 사해와 예리코 일대 거주지의 실제 고도 정보가 지워질 뿐 아니라, 저지대 분지의 약 4.2% 더 높은 대기 밀도 굴절 효과를 놓치게 되기 때문입니다.
흔한 오해 및 주의사항: 음수 고도를 오류로 보고 max(0, H)로 0에 고정하는 경우가 많으나, 예리코와 사해(-430 m) 연안의 고도는 실제로 음수이며 0보다 작아질 수 없는 것은 오직 광학 지평선 고도 차(ΔH ≥ 0)뿐이고 대기 밀도 굴절은 오히려 커집니다.
double gecerliRakim = Math.Clamp(rakimMetre, -450.0, 8850.0); // 사해 -430m → ρ/ρ₀ ≈ 1.0420
double deltaH = Math.Max(0.0, gecerliRakim - Math.Clamp(H0, -450.0, 8850.0));
#08

8) WGS84 측지 수직선 지평선 및 [-90°, +90°] 극점 분모 가드(|cos φ · cos δ| ≥ 1e-12)

지표면의 수면과 자연 지평면은 지구 중심이 아니라 국지적 중력(연직선 / plumb-line) 방향에 수직입니다. 이러한 물리적 이유로 지평선 및 태양 고도 계산에는 지심 위도 대신 GPS가 제공하는 WGS84 측지 위도를 [-90.0°, +90.0°] 범위에서 그대로 사용하며, 정확한 ±90.0° 지리 극점에서 cos(φ)·cos(δ) → 0으로 인한 0 나누기 위험에 대비해 |cos φ · cos δ| ≥ 1e-12 보호 장치가 작동합니다.

이유(이렇게 설계한 까닭): 지구의 편평률(약 1/298.257) 때문에 측지 위도를 지심 위도로 변환하면 위도 45°에서 국지 연직 지평선이 인위적으로 약 11.5분각 기울어지기 때문이며, 측지 위도가 물리적 지평선과 일치하기 때문입니다.
흔한 오해 및 주의사항: 지구가 타원체이므로 GPS 위도를 atan((1 − f²)·tan φ)로 지심 위도로 바꾸면 정확도가 높아진다고 오해하기 쉽지만, 정지된 수면과 자연 지평선은 지구 중심이 아니라 국지 중력 연직선(측지 위도)에 수직입니다.
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) 등록 도시 ↔ 실시간 GPS 전환 및 오프라인 위치에서의 오래된 고도·국가 코드 격리

사용자가 고지대 등록 도시(예: 에르주룸 1900 m 또는 라파스 3640 m)에서 실시간 GPS 모드로 전환하거나, 등록된 위치를 삭제하거나, 비행기 모드 등에서 수직 정확도가 무효인 상태로 새로운 수평 GPS 좌표를 수신할 때 이전 도시에서 남은 지역 고도, 위치 이름 및 국가 코드 캐시 필드가 초기화됩니다. 또한 오프라인 네트워크 오류가 예배 시간 갱신을 차단하지 않으며, 주소 조회는 30초 간격으로 백그라운드에서 완료됩니다.

이유(이렇게 설계한 까닭): 이전 산악 도시에서 해안으로 이동했을 때 오래된 1900 m 고도나 이전 국가 코드가 새 위치로 스며들면 사용자 맞춤 광학 지평선과 자동 계산 기관 판별이 왜곡될 수 있기 때문입니다.
if (gpsRakimGecerli) { sonKayitliRakim = Clamp(currentAlt, -450f, 8850f); _sonGercekRakimBiliniyor = true; }
else if (mesafe ≥ 5.0 && _sonGercekRakimBiliniyor) { sonKayitliRakim = 0f; _sonGercekRakimBiliniyor = false; } // GuncelKonumuZorlaVeKaydet 국가/고도 잠금(단계 110)
#10

10) 구면 하버사인 히스테리시스(0.5 km / 10 km), 극지방 0.0045° 경도 잠금 및 경계 갱신

이동 중 배터리와 네트워크 소모를 절약하기 위해 2단계 구면 하버사인 임계값이 동작합니다. 수평으로 0.5 km(500 m) 이상 이동하면 오프라인 예배 시간 테이블을 갱신하고, 10.0 km 이상 이동하면 도시/행정구역명을 갱신합니다. 캐시 검증은 0.5 km 거리 외에 극지방 근처 자오선 수렴 지점을 위해 정규화 경도 차 ≤ 0.0045° 조건도 함께 검사하며, 경계 통과 시 시스템 시간대 캐시를 새로 고칩니다.

이유(이렇게 설계한 까닭): 실내의 5~20 m 자연 GPS 흔들림마다 매초 테이블을 재계산하면 프로세서 부하가 커지는 반면, 극지방 근처에서 200 m 걸어 반대편 자오선으로 넘어갔을 때는 0.0045° 경도 잠금이 캐시를 즉시 갱신해 주기 때문입니다.
double boylamFarki = Math.Abs(NOAA_Verileri.Sarmala180((double)sonBoylam - (double)hesapBoylam));
bool koordUyumlu = Math.Sign(KureselMesafeKm(...) - 0.5) == -1 && boylamFarki ≤ 0.0045; // 0.5 km 미만
#11

11) 사용자 맞춤 광학 지평선 캐시 민감도(0.035° 각도 임계값)

공식 도시 달력 기관에서는 평탄한 도시 지평선(ΔH = 0)이 기준이므로 아파트 층수를 오르내려도 캐시를 불필요하게 무효화하지 않습니다. 사용자 맞춤 설정 모드에서 광학 지평선 보정이 활성화되면 원시 √H 차이가 아니라, 주변 기준 고도(H₀)를 뺀 순수 지평선 복각 차이가 0.035° 임계값(적도 기준 약 8초 영향 임계값, 해수면 기준 약 ±40 m 고도 변화)을 넘는지 확인합니다.

이유(이렇게 설계한 까닭): 기준 고도 H₀ = 500 m인 평야에서 501 m에서 540 m 언덕으로 올라가면 상대 고도 차 ΔH = 0 → 40 m 도약으로 실제 지평선 복각이 0°에서 0.22°로 급변하므로, |Δα_net|을 직접 측정해야 이 등반 변화를 포착할 수 있기 때문입니다.
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) 첫 프레임 원자적 기록(d-1 + i=0 + i=1), 경합 잠금 및 8일 완결성 검증

새 위치나 계산 기관이 선택되면 진행 중이던 이전 계산 흐름을 중단하고, 오래된 미래 날짜 슬롯을 정리한 뒤 어제(d-1), 오늘(i=0), 내일(i=1)을 완전한 샤리아 밤 데이터와 함께 같은 프레임에서 원자적으로 갱신합니다. 이후 날짜(d+2..d+7)가 백그라운드 프레임에서 이어지는 동안에도 동시 실행 잠금이 출력 계층과의 충돌을 막고 설정이 바뀌면 스스로를 취소합니다.

이유(이렇게 설계한 까닭): 계산 기관이나 법학파를 빠르게 전환할 때 두 흐름이 같은 로컬 캐시 영역에 병렬 기록(데이터 손상)을 하거나 이샤 이후 내일(i=1) 데이터가 누락되어 읽히는 문제를 막기 위함입니다.
if (_aktifHesaplamaRutin != null) StopCoroutine(_aktifHesaplamaRutin);
MevcutTabloKullanilabilirMi(): 어제/오늘/내일/7일차 저장 기록 + 좌표 + v6 서명이 모두 있으면 true; // 키 이름은 단계 110에서 추상화
#13

13) 협정 세계시(UTC) 기반 및 반복적 현지 시각 → UTC 시간대 해석

현지 벽시계는 서머타임(일광절약시간) 전환 시 건너뛰거나 같은 시각이 두 번 반복되므로, 예배 시간 엔진과 카운트다운 타이머는 협정 세계시(UTC) 축을 기반으로 동작하며 가을철 중복 1시간 구간에서도 유일한 UTC 시점을 사용합니다. 현지 달력 시각에 해당하는 시간대를 찾을 때도 2단계 현지 → UTC 수렴 계산을 수행하여 전환 야간의 시간 밀림을 방지합니다.

이유(이렇게 설계한 까닭): 가을철 시계를 1시간 뒤로 돌리는 밤에는 현지 벽시계만으로 조회할 경우 02:00..02:59 중복 시간대에서 잘못된 시간대에 빠질 수 있는 반면, UTC 시간축은 단조롭게 흐르기 때문입니다.
DateTime utcSimdi = DateTime.UtcNow;
DateTime konumSimdi = UtcAniniAktifKonumYerelZamaninaCevir(enlem, boylam, utcSimdi, out double aktifDilim);
#14

14) 15분(0.25시간) 단위 수동 시간대 및 기기 시간대 국가 검증(≤ 0.05시간)

시간대 결정에는 세 계층이 존재합니다. (1) 국경 지대에서 인접국 기지국에 연결되거나 신장의 비공식 현지시(UTC+6) 혹은 네팔(+5.75)·채텀(+12.75) 같은 15분 단위 시간대를 고정하려는 사용자를 위해 0.25시간(15분) 단위의 수동 시간대가 직접 적용됩니다. (2) 실시간 GPS 모드에서는 기기의 시스템 시간대가 1월과 7월의 부호 포함 오프셋 모두 폴리곤과 ≤ 0.05시간 허용 오차로 일치하고 국가별 DST 식별 규칙(EG, IL, PS, LB, MA, IR, JO, SY)과도 부합할 때만 채택됩니다.

이유(이렇게 설계한 까닭): 스마트폰에 아테네(EU DST)가 설정된 사용자가 카이로(이집트 DST)에 머물 경우 1월과 7월 오프셋이 동일(+2/+3)하더라도 4월의 4주간 전환 시차 때문에 예배 시간이 1시간 어긋날 수 있기 때문입니다.
흔한 오해 및 주의사항: 단순히 1월(+2)과 7월(+3) 오프셋이 같다는 이유만으로 기기 시간대를 맞다고 간주하면 오산입니다. 아테네·카이로·베이루트·예루살렘은 겨울과 여름 오프셋이 같아도 봄·가을 전환 주간이 서로 다릅니다.
bool ocakTemmuzEsit = |cihazOcak - koordOcak| ≤ 0.05 && |cihazTemmuz - koordTemmuz| ≤ 0.05;
bool kullan = ocakTemmuzEsit && CihazTimeZoneIdUlkeIleUyumluMu(TimeZoneInfo.Local.Id, hedefUlke);
#15

15) 튀르키예 트라키아(카라아아치 vs 말코 타르노보 / 카피탄 안드레예보), 에게해 제도 및 카슈–메이스 섬 폴리곤

튀르키예가 연중 영구 UTC+3을 사용하는 반면, 인접한 불가리아와 그리스는 겨울철 UTC+2, 여름철 UTC+3을 사용합니다. 국경 마을들이 인접국 시간대로 넘어가지 않도록 에디르네 카라아아치/파자르쿨레(TR)와 카스타니에스/오레스티아다(GR), 카피탄 안드레예보/스빌렌그라드 및 이스트란자의 말코 타르노보 돌출부(BG), 괵체아다/체슈메/닷차와 히오스/레스보스/코스/시미/로도스 섬, 그리고 안탈리아 카슈(TR, UTC+3)와 2 km 앞바다의 메이스 섬(카스텔로리조, GR, UTC+2/+3)을 별도 폴리곤으로 정밀 분리했습니다.

이유(이렇게 설계한 까닭): 크르클라렐리나 카슈 일대에 성긴 직사각형 경계를 쓰면 말코 타르노보를 튀르키예에 포함하거나 카슈 해안을 그리스에 포함하여 겨울철 60분의 예배 시간 오차를 낳기 때문입니다.
if (lon ∈ [27.35, 27.85] && lat ∈ (41.955, 42.20]) return false; // 말코 타르노보 (BG, UTC+2/+3)
if (lat ≥ 36.12 && lat ≤ 36.165 && lon ≥ 29.56 && lon ≤ 29.615) return false; // 메이스 섬 (GR) vs 카슈 (TR +3)
#16

16) 키프로스 섬([북위34.5°..35.72°, 동경32.2°..34.65°]) EU 서머타임(+2/+3) 및 Diyanet 계산 기관 연동

키프로스 섬(북키프로스 및 남키프로스: 니코시아/레프코샤, 키레니아/기르네, 파마구스타/가지마우사, 파포스/바프)은 위도상 하타이/메르신과 같은 선상에 있으나, 연중 UTC+3을 쓰는 튀르키예와 달리 겨울에는 UTC+2(EET), 여름에는 UTC+3(EEST — 3월 마지막 일요일 01:00 UTC ↔ 10월 마지막 일요일 01:00 UTC) 시간대를 사용합니다. 반면 자동 계산 기관에서는 튀르키예와 동일한 Diyanet(DİYK) 달력 기준에 연결됩니다.

이유(이렇게 설계한 까닭): 키프로스를 튀르키예 본토 사각형 안에 두면 겨울철 레프코샤와 기르네의 모든 예배 시간이 1시간 뒤로 밀리기 때문이며, 시간대는 EU DST(+2/+3)로 유지하되 계산 기관을 Diyanet으로 두는 것이 현지 관행과 일치하기 때문입니다.
흔한 오해 및 주의사항: 북키프로스와 키프로스에서 Diyanet 예배 시간표 기준을 사용한다는 이유로 시간대도 튀르키예처럼 연중 UTC+3일 것이라 오해하기 쉽지만, 섬 전체는 겨울철에 UTC+2(EET)를 사용합니다.
TZ: if (lat ≥ 34.50 && lat ≤ 35.72 && lon ≥ 32.20 && lon ≤ 34.65) return abYazSaati ? 3.0 : 2.0; // 키프로스 EET/EEST
국가 (lat ∈ [34.50, 35.75], lon ∈ [32.20, 34.65]) → "CY" → Otoriteler.Diyanet; // 북키프로스·키프로스 공식 시간표 준거
#17

17) 튀르키예 남부·동부 국경 굴곡선(케사브, 알레포, 코바니, 카미슐리/데리크, 모술, 나히체반, 바자르간)

남부와 동부 국경에서 국가 코드와 시간대 정확도를 확보하기 위해 야일라다으와 시리아 케사브(북위35.93°, 동경35.98°), 하타이/킬리스와 알레포·아프린, 수루치/악차칼레와 코바니, 누사이빈/지즈레와 카미슐리·데리크 티그리스 강 굴곡부, 하부르/데레지크와 자호/모술, 이으드르/딜루주 및 귀르불라크와 나히체반(세데레크, UTC+4), 아르메니아(아라라트, UTC+4), 이란(바자르간/마쿠/세로우, UTC+3.5)을 사선 경계 직선으로 분리했습니다.

이유(이렇게 설계한 까닭): 이으드르 딜루주 회랑에서는 불과 수 킬로미터 북쪽의 나히체반/아르메니아가 UTC+4를, 남쪽의 이란이 UTC+3.5를 사용하며, 동남부 국경 포켓에서는 국가 코드가 자동 계산 기관을 직접 변경하기 때문입니다.
세데레크/아라라트 (+4) 제외: lat ∈ [39.65, 40.08] 대역에서 lon 경계 44.84 - (lat - 39.65) * 1.35 동쪽 → TR 외;
바자르간/마쿠 (+3.5) 제외: lat ∈ [39.25, 39.65) 대역에서 lon 경계 44.38 + (lat - 39.25) * 1.10 동쪽 → TR 외;
#18

18) 발트/동유럽, 칼리닌그라드(+2), 벨라루스(+3) 및 러시아 11개 시간대(사마라–캄차카)

동유럽에서는 에스토니아, 라트비아, 리투아니아, 핀란드, 우크라이나, 루마니아, 몰도바가 EU 서머타임(UTC+2/+3), 폴란드(수바우키 포함)가 UTC+1/+2, 칼리닌그라드가 영구 UTC+2, 벨라루스가 영구 UTC+3을 사용합니다. 러시아 연방 내부에서는 사마라/울리야놉스크/사라토프/아스트라한(+4), 예카테린부르크/페름/우파(+5), 옴스크(+6), 노보시비르스크/톰스크/크라스노야르스크(+7), 이르쿠츠크(+8), 야쿠츠크/치타/블라고베셴스크(+9), 블라디보스토크/하바롭스크(+10), 마가단/사할린(+11), 캄차카/축치(+12)를 행정 경계로 구분합니다.

이유(이렇게 설계한 까닭): 러시아와 동유럽에서 단순히 경도/15 반올림을 적용하면 사마라·옴스크·노보시비르스크·이르쿠츠크처럼 행정적으로 표준시가 이동된 백만 대도시에서 1시간의 예배 시간 오류가 발생하기 때문입니다.
칼리닌그라드 → +2.0; EE/LV/LT/FI/UA/RO/MD → EU DST (+2/+3); BY & 모스크바 → +3.0;
RusyaSaatDilimiBul(lat, lon) → 사마라 +4, 우랄 +5, 옴스크 +6, 노보시비르스크/크라스노야르스크 +7, 이르쿠츠크 +8 .. 캄차카 +12;
#19

19) 유럽연합, 영국(런던 GMT+0/BST+1), 발칸, 아소르스 및 카나리아 01:00 UTC 서머타임 엔진

유럽 대륙의 서머타임은 3월 마지막 일요일 01:00 UTC에 동시에 시작하여 10월 마지막 일요일 01:00 UTC에 종료됩니다. 영국, 아일랜드, 포르투갈 및 스페인령 카나리아 제도(북위27.5°..29.5°, 서경18.5°..13.2°)는 겨울 UTC+0·여름 UTC+1(런던 GMT/BST), 중부 유럽과 서발칸(베를린, 파리, 사라예보, 스코페)은 UTC+1/+2, 아소르스 제도(북위36.8°..39.8°, 서경31.5°..24.8°)는 UTC-1/UTC+0로 동작하며 아이슬란드는 연중 영구 UTC+0을 사용합니다.

이유(이렇게 설계한 까닭): 런던·카나리아 제도·아소르스 제도와 대륙 유럽은 기본 오프셋이 서로 다르더라도 전환 시점을 동일한 01:00 UTC에 고정함으로써 전환 야간의 시차 어긋남을 방지할 수 있기 때문입니다.
bool AbYazSaatiUtcAktifMi(utcAn): utcAn ∈ [MartSonPazar_01Utc, EkimSonPazar_01Utc);
아이슬란드 → 0.0; 아소르스 → abDst ? 0.0 : -1.0; 영국/포르투갈/카나리아 → abDst ? +1.0 : 0.0; 중부 유럽 → +1/+2;
#20

20) 레바논(토요일 22:00/21:00 UTC) 및 이스라엘(금요일 00:00 UTC, 2034년 이후 보호) 독립 DST 엔진

동지중해에서 레바논(Asia/Beirut)은 3월 마지막 일요일 현지 00:00(토요일 22:00 UTC)에 앞으로 돌리고, 10월 마지막 일요일 현지 00:00(토요일 21:00 UTC)에 되돌립니다. 이스라엘(Asia/Jerusalem)은 3월 마지막 일요일 직전 금요일 현지 02:00(00:00 UTC)에 시작하여 10월 마지막 일요일 02:00(토요일 23:00 UTC)에 종료합니다. 또한 구형 모바일 OS의 tzdata 테이블이 2037년 이후 규칙을 누락하는 문제에 대비해 ≥ 2034년에서는 좌표 계층과 시스템 시간대 ID 계층 모두에서 결정론적 규칙이 작동합니다.

이유(이렇게 설계한 까닭): 베이루트와 하이파를 표준 EU 일요일 01:00 UTC 규칙에 묶으면 3월 말 금요일과 토요일에 예배 시간이 1시간 틀어지기 때문이며, ≥ 2034 보호는 미래 날짜 달력 조회를 지켜 줍니다.
LubnanYazSaatiUtcAktifMi(utcAn): utcAn ∈ [MartSonCts_22Utc, EkimSonCts_21Utc);
IsrailYazSaatiUtcAktifMi(utcAn): utcAn ∈ [SonPazarÖncesiCuma_00Utc, EkimSonCts_23Utc); // ≥ 2034 필수
#21

21) 팔레스타인(가자, 헤브론, 예리코, 칼킬리야) Sat≥24 + 라마단 연기 DST 및 계산 기관 연동

팔레스타인 폴리곤은 가자 지구와 서안 지구의 칼킬리야/툴카름(동경34.96°), 제닌, 나블루스, 라말라, 동예루살렘, 예리코, 헤브론(알할릴)을 포함하고 아슈켈론, 브엘세바, 엔게디 등 경계 밖 지점을 제외합니다. 공식 팔레스타인 서머타임(Asia/Gaza, Asia/Hebron)은 3월 24일 이후 첫 토요일(Sat≥24) 02:00에 시작하며, 이 날짜가 라마단에 겹치면 샤우왈 첫 토요일로 연기되고 10월 Sat≥24 02:00에 종료됩니다. 자동 계산 기관에서는 PS 코드가 이집트 측량청(-19.5°/-17.5°) 기준에 연결됩니다.

이유(이렇게 설계한 까닭): 3월이 31일까지 있는 해에는 ‘3월 마지막 토요일’과 공식 IANA ‘Sat≥24’ 규칙 사이에 7일 차이가 발생하며, 라마단 중에는 서머타임을 앞당겨 시행하지 않는 것이 팔레스타인 공식 관행이기 때문입니다.
흔한 오해 및 주의사항: 팔레스타인 서머타임을 ‘3월 마지막 토요일’로 구현하면 31일짜리 3월(예: 3월 24일 대신 3월 31일 선택)에서 공식 Sat≥24 규칙과 정확히 1주일 어긋납니다.
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) 이집트 서머타임(4월 마지막 금요일 ~ 10월 마지막 목요일) 및 사선 시나이 국경(타바–라파 직선)

이집트는 2023년 법률 제24호에 따라 4월 마지막 금요일 현지 00:00(목요일 22:00 UTC)에 UTC+3 서머타임으로 전환하고 10월 마지막 목요일 24:00(목요일 21:00 UTC)에 UTC+2 겨울 시간으로 복귀합니다. 시나이 반도에서는 아카바만 연안 타바(동경34.89°)와 지중해 연안 라파(동경34.25°) 사이의 사선 경계 직선(34.905 − (lat − 29.49)·0.395)으로 이집트 마을 알쿠사이마와 네게브 측 미츠페 라몬을 분리합니다.

이유(이렇게 설계한 까닭): 시나이 국경을 동경 34.90° 수직 직사각형으로 그리면 네게브 사막이 이집트 시간대에 포함되어 4월과 10월의 서로 다른 DST 전환 주간에 1시간 오차를 만들기 때문입니다.
MisirYazSaatiUtcAktifMi(utcAn): utcAn ∈ [NisanSonPersembe_22Utc, EkimSonPersembe_21Utc);
double sinaDoguSinir = 34.905 - (lat - 29.49) * 0.395; // 타바/알쿠사이마 (EG) vs 에일라트/미츠페 라몬 (IL)
#23

23) 요르단(Asia/Amman) 및 시리아(Asia/Damascus) 2022년 10월 28일 이후 영구 UTC+3 보호

요르단(암만, 아카바, 페트라/와디 아라바 포함)과 시리아(다마스쿠스, 알레포, 데라, 보스라, 수웨이다 포함)는 2022년 10월 말 겨울 시간으로 복귀하지 않고 연중 영구 UTC+3 체제로 전환했습니다. 업데이트되지 않은 구형 Android 및 iOS 기기의 시스템 시간대 표는 겨울철에도 두 나라를 여전히 UTC+2로 끌어내릴 수 있으므로, 시간대 ID 해석 계층에서 ≥ 2022년 10월 28일 날짜 잠금을 통해 직접 +3.0시간을 반환합니다.

이유(이렇게 설계한 까닭): 구형 스마트폰에 저장된 Asia/Amman 또는 Asia/Damascus ID가 사용될 때 겨울철 예배 시간이 60분 뒤로 밀리는 현상을 방지하기 위함입니다.
if (UrdunSuriyeKaliciUtc3IdMi(temizId) && yerelTarih ≥ new DateTime(2022, 10, 28)) return +3.0;
// 페트라/와디 아라바 (JO) 및 데라/수웨이다 (SY) 폴리곤은 연중 영구 UTC+3
#24

24) 모로코 왕국 칙령 2.18.855 라마단 역전 시간(UTC+1 → UTC+0) 및 2080년 대체 히즈라력

모로코 왕국에서는 2026년 9월 이전 날짜에 대해 칙령 제2.18.855호에 따라 연중 UTC+1이 적용되며, 히즈라력 라마단 월 직전 일요일 02:00 UTC에 시계를 1시간 뒤로 돌려 UTC+0으로 바꾸고 샤우왈 시작 일요일 02:00 UTC에 다시 UTC+1로 복귀합니다. 표준 움 알 쿠라 달력 클래스의 지원 상한 연도를 넘는 미래 또는 과거 날짜 조회에서도 범위 초과 오류가 나지 않도록 자동 대체 히즈라력 엔진이 동작합니다.

이유(이렇게 설계한 까닭): 라마단에 한정된 역전 시간 전환은 일반 그레고리력 DST 규칙으로 표현할 수 없으며, 2029/2077년 이후 날짜 테스트에서도 달력 클래스가 중단되지 않아야 하기 때문입니다.
흔한 오해 및 주의사항: 표준 움 알 쿠라 달력 컴포넌트를 날짜 범위 검사 없이 직접 호출하면 지원 범위 밖의 미래·과거 연도에서 범위 초과 런타임 예외가 발생하므로, 범용 히즈라력 대체 구현이 필수입니다.
FasRamazanGeriSaatUtcAktifMi(utcAn): utcAn ∈ [RamazanOncesiPazar_02Utc, SevvalIlkPazar_02Utc) → UTC+0.0 (그 외 날짜는 UTC+1.0);
// 움 알 쿠라 달력 범위 밖 연도에서는 대체 히즈라력 계산기가 자동 가동
#25

25) 모로코 칙령 2.26.530(2026년 9월 20일 이후 영구 GMT+0), 세우타/멜리야 및 알제리 국경 직선

2026년 6월 25일자 모로코 왕국 칙령 제2.26.530호에 따라 2026년 9월 20일 일요일 01:00 UTC부터 모로코와 서사하라는 영구 GMT(UTC+0) 시간으로 전환되었습니다. 북부 해안의 스페인 월경지 세우타 [35.87°..35.92°N, -5.39°..-5.27°W] 및 멜리야 [35.26°..35.33°N, -3.00°..-2.91°W]는 EU 서머타임(ES, UTC+1/+2)으로 분리되며, 남동부의 피기그/부아르파(MA)와 베샤르/틴두프(DZ, 영구 UTC+1)도 사선 국경 직선으로 격리됩니다.

이유(이렇게 설계한 까닭): 모로코의 2026년 9월 영구 GMT+0 법령을 구형 스마트폰에서도 정확히 반영하고, 세우타/멜리야 및 알제리 베샤르 국경에서의 1~2시간 시간대 혼선을 막기 위함입니다.
흔한 오해 및 주의사항: 과거 데이터로 학습된 모델과 미갱신 스마트폰은 2026년 9월 이후에도 모로코를 UTC+1로 착각할 수 있으며, 모로코 해안의 세우타와 멜리야는 지리적 사각형 안에 들어 있어도 스페인 시간(UTC+1/+2)을 따릅니다.
if (utcAn ≥ new DateTime(2026, 9, 20, 1, 0, 0, DateTimeKind.Utc)) return 0.0; // 칙령 2.26.530 영구 GMT+0
세우타 & 멜리야 → ES (abYazSaati ? +2.0 : +1.0); 알제리 (베샤르/틴두프) → DZ (영구 +1.0);
#26

26) 이란 ≥ 2022년 9월 22일 영구 UTC+3:30 법령, 사락스/자볼 국경 및 걸프(+3 vs +4) 구분

이란은 2022년 9월 서머타임을 폐지했으므로 Asia/Tehran과 이란 폴리곤은 연중 영구 UTC+3.5를 반환합니다. 동쪽에서는 호라산 사락스(동경61.16°, +3.5)와 투르크메니스탄 사락스(+5.0), 그리고 시스탄 자볼(동경61.50°, +3.5)과 아프가니스탄(+4.5)·파키스탄 발루치스탄(+5.0)이 정밀 경도 계단으로 분리됩니다. 걸프 지역에서는 사우디아라비아 살와 국경 검문소(+3, SA), 카타르(+3, QA), 바레인(+3, BH)이 UAE 및 오만(무산담 포함 +4)과 구분됩니다.

이유(이렇게 설계한 까닭): 구형 기기의 Asia/Tehran 표가 봄철에 실수로 시계를 +4.5로 당길 수 있으며, 이란–투르크메니스탄 사락스 국경에서는 불과 수 킬로미터 사이에 90분의 급격한 시차가 존재하기 때문입니다.
if (IranKaliciUtc35IdMi(temizId) && yerelTarih ≥ new DateTime(2022, 9, 22)) return +3.5;
이란 (사락스 lon ≤ 61.22°, 자볼 lon ≤ 61.88°) → +3.5; 카타르/바레인/사우디 → +3.0; UAE/오만 → +4.0;
#27

27) 남아시아 30분·15분 단위 시간대(아프가니스탄 +4:30, 인도 +5:30, 네팔 +5:45, 미얀마 +6:30)

정시 시간대를 사용하지 않는 남아시아 국가들은 각자의 국가 기준 자오선 오프셋으로 모델링되었습니다. 아프가니스탄 +4.5(UTC+4:30), 파키스탄 +5.0, 인도 및 스리랑카 +5.5(UTC+5:30), 네팔 +5.75(UTC+5:45 — 45분 15분 단위 시간대), 방글라데시 및 부탄 +6.0, 미얀마(버마) 및 코코스 제도는 +6.5(UTC+6:30)를 적용하며, 인도 북동부 주(아삼, 아루나찰)는 방글라데시(+6)와 중국(+8) 경계 상자로부터 보호됩니다.

이유(이렇게 설계한 까닭): 이 지역에서 정시 반올림을 적용하면 카트만두에서 15~45분, 뉴델리·카불·양곤에서 30분의 체계적인 예배 시간 편차가 발생하기 때문입니다.
아프가니스탄 → +4.5; 파키스탄 → +5.0; 인도 & 스리랑카 → +5.5;
네팔 [26.35..30.45°N, 80.05..88.20°E] → +5.75; 방글라데시/부탄 → +6.0; 미얀마 → +6.5;
#28

28) 카자흐스탄 단일 UTC+5(2024년 3월 1일 결정) vs 키르기스스탄 UTC+6 및 페르가나 계곡 폴리곤

카자흐스탄은 2024년 3월 1일 알마티, 아스타나, 동카자흐스탄(외스케멘/세메이)을 포함한 전국을 단일 UTC+5 시간대로 통합했습니다. 엔진은 2024년 3월 이전(+6)/이후(+5) 날짜 전환과 구형 스마트폰의 Asia/Almaty 및 Asia/Qostanay ID도 UTC+5로 해석합니다. 남쪽의 키르기스스탄(비슈케크, 오시, 잘랄아바트: UTC+6)과 우즈베키스탄·타지키스탄(타슈켄트, 나망간, 후잔트, 두샨베: UTC+5)이 맞물린 페르가나 계곡 역시 폴리곤으로 분리되어 있습니다.

이유(이렇게 설계한 까닭): 업데이트되지 않은 기기들은 알마티를 여전히 UTC+6으로 반환하는 반면, 알마티 바로 남쪽의 키르기스스탄은 실제로 계속 UTC+6을 사용하고 있기 때문입니다.
흔한 오해 및 주의사항: 알마티(동경76.9°)는 경도상 비슈케크(동경74.6°)보다 동쪽에 있지만 2024년 3월 결정 이후 알마티는 UTC+5를, 더 서쪽의 비슈케크는 UTC+6을 사용하므로 단순 경도/15 계산은 정반대 결과를 냅니다.
if (KazakistanBirlesikUtc5Mi(temizId) && yerelTarih ≥ new DateTime(2024, 3, 1)) return +5.0;
KazakistanPoligonundaMi(lat, lon) → (utcAn ≥ 2024-02-29T18:00Z ? +5.0 : +6.0); 키르기스스탄 → +6.0; UZ/TJ/TM → +5.0;
#29

29) 서·동 중국 공식 단일 표준시(UTC+8: 카슈가르, 호르고스, 푸위안) 및 몽골(+7 / +8)

중국 본토는 5개 지리적 경도대에 걸쳐 있으나 카슈가르(동경75.99°), 우루무치, 보러, 호르고스 국경 검문소, 알타이, 라싸, 내몽골 만저우리 및 최동단 푸위안/헤이허를 포함한 전 지역에서 공식 베이징 시간(UTC+8)을 사용합니다. 호르고스에서 카자흐스탄으로 넘는 순간 +8에서 +5로의 3시간 도약이 폴리곤으로 포착됩니다. 몽골에서는 서부 주(바양울기, 우브스, 호브드)가 UTC+7, 울란바토르 및 동부가 UTC+8을 받습니다.

이유(이렇게 설계한 까닭): 신장에서는 태양이 정오 15:00 무렵에 남중하는 반면 푸위안에서는 여름철 임사크가 23:28(자정 전)에 시작하므로, 동서 양단 모두에서 정확한 중국/인접국 경계 폴리곤이 필수이기 때문입니다.
신장/티베트/내몽골/만주 (카슈가르, 호르고스 80.42°E 동쪽, 알타이, 라싸, 헤이허, 푸위안) → CN (+8.0);
몽골: 서부 주 (바양울기/우브스/호브드) → +7.0; 중부 & 동부 (울란바토르) → +8.0;
#30

30) 말라카 해협(수마트라 +7 vs MY/SG +8) 및 보르네오 중부 칼리만탄(WIB +7 vs WITA +8) 폴리곤

동남아시아에서는 수마트라(메단, 페칸바루, 두마이: ID, WIB +7)와 말레이 반도·싱가포르(쿠알라룸푸르, 페낭, 조호르: MY/SG, +8)가 사선 말라카 해협 직선으로 나뉩니다. 보르네오 섬에서는 인도네시아의 서칼리만탄(폰티아낙)과 중부 칼리만탄(팔랑카라야, 삼피트, 팡칼란 분, 무아라 테웨) 주가 WIB(UTC+7)를 쓰는 반면, 남·동·북 칼리만탄(반자르마신, 발릭파판, 사마린다)과 말레이시아 사라왁/사바 및 브루나이는 UTC+8을 사용합니다.

이유(이렇게 설계한 까닭): 보르네오 섬을 단순 수직 경도선으로 분할하면 중부 칼리만탄의 주도 팔랑카라야(동경113.9°) 일대를 잘못하여 UTC+8 시간대로 분류해 예배 시간을 1시간 앞당겨 버리기 때문입니다.
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) || 북술라웨시 [0.80..1.85°N, ≤125.35°E] || 서티모르 (lat ≤ -8.00, lon ∈ (-180.0, 125.10)); 그 동쪽은 WIT (+9.0);
#31

31) 북술라웨시(WITA +8), 말루쿠/파푸아(WIT +9) 및 동티모르 + 오에쿠시 월경지(TL UTC+9)

인도네시아 동부에서 북술라웨시 반도(마나도, 비퉁, 고론탈로: 동경124°~125.3°)는 경도상 동쪽에 치우쳐 있음에도 WITA(UTC+8) 시간대에 속하며, 그 동쪽의 말루쿠(암본, 테르나테)와 서파푸아(자야푸라, 메라우케)가 WIT(UTC+9)를 적용받습니다. 티모르 섬에서는 인도네시아 서티모르(쿠팡, 아탐부아)가 UTC+8을 쓰는 반면, 독립국 동티모르(딜리가 속한 동부 본토와 서티모르 내부의 해안 월경지 오에쿠시)는 연중 UTC+9와 MWL 계산 기관으로 동작합니다.

이유(이렇게 설계한 까닭): 동경124° 동쪽을 단일 상자로 UTC+9로 묶으면 북술라웨시(마나도)와 서티모르(쿠팡)가 모두 1시간 빨라지고, 오에쿠시 월경지를 빠뜨리면 동티모르 해안에서 1시간 느린 오차가 생기기 때문입니다.
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]);
북술라웨시 (lat ∈ [0.80, 1.85], lon ≤ 125.35) & 서티모르 (쿠팡) → ID (+8.0); 말루쿠 & 파푸아 → ID (+9.0);
#32

32) 호주 시간대(유클라 +8:45, 브로큰힐), 로드하우 섬(+10:30/+11:00) 및 채텀 제도(+12:45/+13:45)

호주에서는 서호주(+8), 유클라 접경 지대(+8.75), 노던 준주(+9.5, DST 없음), 남호주 및 NSW 내 브로큰힐(겨울 +9.5 / 여름 +10.5), 퀸즐랜드(+10, DST 없음), NSW/빅토리아/태즈메이니아(+10/+11)를 각각 분리해 판별합니다. 전 세계에서 여름에 유일하게 30분만 앞당기는 로드하우 섬(-31.9°..-31.4°S, 158.9°..159.3°E)은 전용 30분 서머타임 규칙으로 겨울 +10.5, 여름 +11.0을 적용받으며, 뉴질랜드(+12/+13) 옆 채텀 제도는 겨울 +12.75, 여름 +13.75를 사용합니다.

이유(이렇게 설계한 까닭): 로드하우 섬의 30분짜리 서머타임 시차를 일반 +1시간 호주 DST 함수에 연결하면 여름철 모든 예배 시간이 30분씩 앞당겨지기 때문입니다.
Lord Howe [-31.9..-31.4, 158.9..159.3] → LordHoweYazSaatiUtcAktifMi(safTarih) ? +11.0 : +10.5;
유클라 → +8.75; 브로큰힐 [-32.2..-31.7, lon ≤ 141.7] → AvustralyaDilimi(+9.5); 채텀 → 뉴질랜드 +12.75/+13.75;
#33

33) 남미 시간대: 브라질(-5/-4/-3/-2), 파라과이(≥ 2024년 10월 6일 -3) 및 칠레 마가야네스/아이센

남미에서 브라질은 4개 공식 시간대로 나뉩니다: 아크리 주 및 서부 아마조나스(히우브랑쿠, 크루제이루두술, 타바팅가, 에이루네페: UTC-5), 중서부(마나우스, 쿠이아바, 포르투벨류, 보아비스타: UTC-4), 동부 브라질(상파울루, 브라질리아, 리우, 벨렝: UTC-3), 페르난두지노로냐(-2). 파라과이는 2024년 10월 6일 법령으로 연중 영구 UTC-3으로 전환했으며, 칠레에서는 산티아고가 겨울 -4 / 여름 -3을 쓰는 반면 최남단 아이센 주와 마가야네스 주(푼타아레나스, lat ≤ -43.5°)는 연중 영구 UTC-3을 사용합니다.

이유(이렇게 설계한 까닭): 브라질을 단일 UTC-3으로 간주하면 마나우스에서 1시간, 히우브랑쿠와 타바팅가에서 2시간 오차가 생기며, 파라과이의 2024년 10월 법령은 구형 폰의 tzdata 표에 누락되어 있을 수 있기 때문입니다.
if (ParaguayKaliciUtc3IdMi(temizId) && yerelTarih ≥ new DateTime(2024, 10, 6)) return -3.0;
BrezilyaSaatDilimiBul(lat, lon) → 아크리/서아마조나스 -5, 마나우스/쿠이아바 -4, 브라질리아 -3; 칠레 아이센/마가야네스 → 영구 -3.0;
#34

34) 북미 예외 지역(애리조나 vs 나바호, 소노라, 서스캐처원, 유콘, 뉴펀들랜드) 및 그린란드

북미에서는 주와 원주민 자치령 예외가 개별 정의되어 있습니다. 애리조나(피닉스, 투손)는 서머타임 없이 연중 UTC-7을 유지하는 반면, 북동부의 나바호 자치령(윈도 록/카옌타, 호피족 월경지 투바 시티 제외)은 여름에 UTC-6으로 전환합니다. 멕시코 소노라와 킨타나로오(-5), 캐나다 서스캐처원(영구 -6)과 유콘(영구 -7), 남부 아이다호/보이시(-7/-6) 및 뉴펀들랜드(-3.5/-2.5)가 보존되며, 그린란드의 누크(-2/-1), 피투피크(-4/-3), 단마르크스하운(0)은 캐나다 얼러트(-5/-4) 기지와 분리됩니다.

이유(이렇게 설계한 까닭): 북미에서 성긴 경도 띠를 사용하면 여름철 피닉스·리자이나·화이트호스에서 1시간, 뉴펀들랜드에서 30분, 그린란드 누크에서는 2시간의 예배 시간 오차가 발생하기 때문입니다.
애리조나 → 영구 -7.0 (나바호 [lat ≥ 35.45°N, lon ≥ -111.65°W; 호피 [35.55..36.05°N, -110.85..-110.15°W] 제외] → -7/-6); 서스캐처원 → 영구 -6.0; 유콘 → 영구 -7.0;
뉴펀들랜드 → -3.5/-2.5; 그린란드 누크 → -2/-1 (피투피크 -4/-3, 단마르크스하운 0.0) vs 얼러트 (CA -5/-4);
#35

35) 동·서 알류샨(애투 및 에이댁), 베링 해협(축치 vs 세인트로렌스), 키리바시(+14) 및 대양 자오선

날짜변경선을 따라 알류샨 열도의 서반구(-180°..-169.0°W, 에이댁)뿐 아니라 +180° 동쪽으로 넘어가는 서단 애투 섬(172°E..180°E) 역시 미국(US, ISNA)과 하와이–알류샨 서머타임(-10/-9)을 받습니다. 베링 해협에서는 러시아 축치(우엘렌/프로비데니야: RU, 영구 +12)와 미국 세인트로렌스 섬(갬벨: US, 알래스카 -9/-8)이 분리되며, 키리티마티 +14, 아피아 +13, 공해 지점은 [-12, +12] 천문 시간대로 처리됩니다.

이유(이렇게 설계한 까닭): 애투 섬은 동경 +173°에 위치하면서도 러시아(+12)가 아닌 미국(-10/-9) 시간을, 갬벨은 축치 바로 맞은편에 있으면서도 알래스카(-9/-8) 시간을 사용하므로 잘못된 쪽을 선택하면 21시간의 오차가 발생하기 때문입니다.
흔한 오해 및 주의사항: 동반구(양의 경도)의 모든 지점이 양(+)의 UTC 시간대를 갖는다고 생각하기 쉽지만, 동경 +173°의 애투와 셰미야 섬은 미국 영토로서 음(-)의 UTC-10/-9 시간대에 속합니다.
알류샨: lat ∈ [51.0, 54.0] && (lon ∈ [172.0, 180.0] || lon ∈ [-180.0, -169.0)) → US (-10/-9); 축치 → RU (+12) vs 세인트로렌스 → US (-9/-8);
키리티마티 → +14.0; 공해 대체 → Math.Clamp(Math.Round(Sarmala180(lon) / 15.0, AwayFromZero), -12.0, 12.0);
#36

36) 9일 고유 UTC 지문, v6 캐시 서명 및 3-매개변수 분 미만 DST 검증

9일 시간대 지문 생성기는 d-1..d+7에 걸쳐 9일간 매일 00:00 UTC와 12:00 UTC 시점의 현지 오프셋을 표본 추출하여 v6 캐시 서명과 함께 저장합니다. 각 날짜는 정오 기준 시간대에서 계산된 뒤 6개 예배 시간이 각각 개별적으로 UTC → 현지 벽시계로 투영되며, 01:59:40 같은 시각이 분 반올림으로 02:00/03:00 DST 경계 반대편으로 넘어가면 분 미만 DST 검증기가 문자열 변환 직전에 해당 시각의 분과 기록 시간대를 새 시간대에 정렬합니다.

이유(이렇게 설계한 까닭): 봄철 전환 야간에 01:59:40 CET 시각이 :30 반올림 또는 올림(Ceiling)으로 02:00이 될 때 벽시계에는 02:00이 존재하지 않으므로(곧바로 03:00 CEST가 됨), 분 미만 DST 검사가 이 경계 시각도 일관되게 유지해 주기 때문입니다.
YuvarlanmisDstDilimiDogrula(cikisMi: imsakCikisYuvarla, ref d.netImsakDakika, ref d.imsakSaatDilimi); // 6개 시각 각자 방향으로 검증
d.imsakStr = FikhiGuvenliSaatMetnineCevir(d.netImsakDakika, imsakTemkin, cikisVaktiMi: imsakCikisYuvarla);
#37

37) 자동 계산 기관 결정 트리 I: Diyanet(TR, CY, AZ, 발칸), 움 알 쿠라(걸프) 및 MABIMS

자동 계산 기관 모드에서는 위치의 ISO 국가 코드를 오프라인 폴리곤에서 판별하여 현지 공식 기관에 연결합니다. 튀르키예(TR), 북키프로스/키프로스(CY), 아제르바이잔(AZ) 및 발칸 이슬람 공동체 권역(BA, AL, XK, MK, BG, ME)은 튀르키예 종교청(Diyanet / DİYK) 기준을, 사우디아라비아(SA), UAE(AE), 카타르(QA), 쿠웨이트(KW), 바레인(BH), 오만(OM), 예멘(YE)은 움 알 쿠라(메카) 기준을, 인도네시아(ID), 말레이시아(MY), 싱가포르(SG), 브루나이(BN)는 MABIMS(KEMENAG/JAKIM) 기준을 부여받습니다.

이유(이렇게 설계한 까닭): 여행 중인 사용자가 방문한 국가에서 별도 기술 설정을 찾지 않고도 현지 모스크의 아잔에 맞는 공식 계산 기관으로 자연스럽게 전환되도록 편의를 제공하기 위함입니다.
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) 자동 계산 기관 결정 트리 II: 카라치(중앙·남아시아), 이집트(EG, PS, 레반트), ISNA 및 MWL

결정 트리의 두 번째 분기에서는 파키스탄(PK), 아프가니스탄(AF), 방글라데시(BD), 인도(IN), 네팔, 스리랑카, 몰디브 및 중앙아시아 국가들(UZ, KZ, KG, TJ, TM)을 카라치 이슬람과학대학교(-18°/-18°, 아스르 앗 싸니 +2배 그림자) 기준에, 이집트(EG), 팔레스타인(PS), 레반트(SY, JO, LB) 및 북·동아프리카 권역(LY, TN, DZ, SD, SS, NG, ET, ER, KE, UG, TZ, SO, DJ, ZA)을 이집트 측량청(-19.5°/-17.5°) 기준에, 미국(US)과 캐나다(CA)를 ISNA(-15°/-15°) 기준에, 유럽·이라크(IQ — 수니파 와크프청 -18° 대역 호환)·이란(IR)·서부 마그립(MA, MR, SN)·동아시아 및 기타 국가를 MWL(-18°/-17°) 기준에 연결합니다.

이유(이렇게 설계한 까닭): 중앙·남아시아에서는 아스르 앗 싸니(+2배 그림자), 레반트와 아프리카 권역에서는 이집트 측량청, 북미에서는 ISNA, 유럽·이라크·이란·서부 마그립에서는 -18° 대역의 MWL이 보편적 모스크 표준과 일치하기 때문입니다.
PK, IN, BD, AF, LK, NP, MV, UZ, KZ, KG, TJ, TM → Otoriteler.Karaci_Hanefi; // 아스르 앗 싸니 (+2배 그림자)
EG, PS, SY, JO, LB, LY, TN, DZ, SD..ZA → Otoriteler.Misir_GenelOtorite;   US, CA → Otoriteler.ISNA_KuzeyAmerika;   IQ, IR 및 기타 → Otoriteler.Musluman_Birlik;
#39

39) 7개 공식 계산 기관의 박명 각도 및 탐킨/이흐티야트 행렬(MABIMS 수부흐 -20° + 2분 포함)

공식 기관들의 박명 각도와 [임사크, 일출, 주흐르, 아스르, 마그립, 이샤] 탐킨/이흐티야트(신중 보정) 분수는 다음과 같습니다:

• Diyanet(DİYK): 임사크 -18°, 아스르 +1(아스르 알 아우왈), 이샤 -17°(|φ| ≥ 45° 대역에서는 -16° + 여름 추정), 탐킨 [0, -7, +5, +4, +7, 0]분

• MWL: -18° / +1 / -17°, 탐킨 0분 | ISNA: -15° / +1 / -15°, 탐킨 0분 | 카라치: -18° / +2(아스르 앗 싸니) / -18°, 탐킨 0분

• 움 알 쿠라(메카): 임사크 -18.5°, 아스르 +1, 이샤 +90분(라마단 +120분), 탐킨 0분

• 이집트 측량청: -19.5° / +1 / -17.5°, 탐킨 0분 | MABIMS(KEMENAG/JAKIM/MUIS): 수부흐(Subuh) -20°, 아스르 +1, 이샤 -18°, 이흐티야트 [+2, -2, +2, +2, +2, +2]분

이유(이렇게 설계한 까닭): 전 세계 공식 피크흐 및 천문대 위원회들이 지역 대기와 법학 해석(이즈티하드)의 차이에 따라 -15°~-20° 사이의 서로 다른 각도와 MABIMS 수부흐 +2분 같은 정착된 신중 보정치를 적용하기 때문입니다.
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 dk);   Otoriteler.Misir_GenelOtorite → (-19.5f, 1f, -17.5f);   Otoriteler.Karaci_Hanefi → (-18f, 2f, -18f);
#40

40) 사용자 맞춤 설정 안전 경계 클램핑 및 이산 {1, 2} 그림자 비율 보호

사용자 맞춤 설정 모드에서는 손상되거나 극단적인 로컬 설정 입력(NaN, Infinity, 범위 이탈 값)에 대비해 모든 사용자 매개변수를 안전 경계 클램프로 물리적·법학적 한계 내에 고정합니다. 임사크 및 이샤 박명 각도는 [-25.0°, -5.0°] 범위로, 6개 예배 탐킨 분수는 [-60, +60]분 범위로, 주변 기준 고도 H₀는 [-450 m, 8850 m] 범위로 유지되며, 아스르 그림자 계수는 하나피·샤피이 법학에 따라 오직 이산 값 {1f (아스르 알 아우왈), 2f (아스르 앗 싸니)}만을 취합니다.

이유(이렇게 설계한 까닭): 손상된 캐시 데이터가 NaN을 발생시켜 예배 시간 계산을 중단시키거나, 1.4처럼 하나피 및 샤피이 법학에 근거가 없는 중간 소수 그림자 계수가 생성되는 것을 막기 위함입니다.
imsak_derece = GuvenliPrefFloatAl(kisiselImsakAnahtari, -18f, -25f, -5f); // 키 이름은 단계 110 범위에서 추상화
ikindi_golge = GuvenliPrefFloatAl(kisiselIkindiAnahtari, 1f, 1f, 2f) ≥ 1.5f ? 2f : 1f;
#41

41) 아스르 알 아우왈(+1배 그림자 — Diyanet / 이마마인 / 샤피이)과 아스르 앗 싸니(+2배 그림자 — 하나피 / 이맘 알 아잠) 선택

지원되는 하나피 법학파와 샤피이 법학파 사이에서는 아스르(오후 예배) 시작 시점이 그림자 비율로 나뉩니다. 튀르키예 종교청(Diyanet)을 포함한 샤피이 법학파 및 하나피 이마마인(이맘 아부 유수프와 이맘 무함마드)의 파트와 채택 견해(무프타 비히)인 아스르 알 아우왈에서는 정오 최소 그림자(파이 알 자왈) 위에 물체 높이의 1배(+1)가 더해질 때, 이맘 알 아잠 아부 하니파의 본원적 견해인 아스르 앗 싸니에서는 2배(+2)가 될 때 아스르가 시작됩니다. 계산 기관 선택기의 아스르 항목은 공식 기관에서 3단계 법학파 선택(기관 기본값 / +1 / +2)을, 사용자 맞춤 모드에서는 직접 +1 또는 +2 그림자 설정을 제공합니다.

이유(이렇게 설계한 까닭): Diyanet의 아스르 알 아우왈(+1 그림자) 기준이 샤피이 법학파만의 것으로 오해되는 일을 막고, 모든 사용자가 임사크/마그립은 현지 기관을 따르면서도 아스르만큼은 자신의 법학파 견해를 선택할 수 있게 하기 위함입니다.
if (SeciliOtorite != Otoriteler.Kisisel) { if (ikindiMezhepModu == 1) ikindi_golge = 1f; else if (ikindiMezhepModu == 2) ikindi_golge = 2f; }
else → otorite_ayari.KisiselIkindiGolgeAyarla(hedefGolge); // 맞춤 모드에서는 1f (아스르 알 아우왈) ↔ 2f (아스르 앗 싸니)
#42

42) 내륙 고원의 국지 지평선(ΔH = 0) vs 해안 사면의 사용자 맞춤 광학 지평선(0.0347°·√ΔH)

해수면 기준으로 유도된 지평선 복각 공식(2.08'·√H ≈ 0.0347°·√H)을 내륙 고원 도시에 그대로 적용하면 오차가 생깁니다. 에르주룸(1900 m), 반(2400 m), 카흐타(670 m), 덴버(1609 m), 퀘타(1680 m) 같은 고원 도시에서는 지평선 방향 지형 역시 관측자와 비슷한 고도에 있습니다(H ≈ H₀ → ΔH ≈ 0 m). 반면 바다를 내려다보는 가파른 해안 경사면(예: 울루다으 또는 바바다으 사면)에서는 H₀ = 0 m이므로 상대 높이 ΔH = max(0, H − H₀)만큼 지평선 복각이 발생합니다.

이유(이렇게 설계한 까닭): 내륙 고원에서 해수면 지평선 공식을 쓰면 태양이 고원 지평선 아래로 진 뒤에도 몇 분 후에 마그립 시각을 제시하게 되며, 상대 ΔH 모델은 고원 평지와 해안 사면을 정확히 구분합니다.
흔한 오해 및 주의사항: 항해력에 나오는 0.0347°·√H 공식을 에르주룸(1900 m), 콘야, 카흐타 같은 내륙 고원에 곧장 적용하는 오류는 매우 흔하며, 주변 평원 자체도 높기 때문에 태양이 진 지 수 분 후로 이프타르가 제시되는 결과를 낳습니다.
double deltaH = rakimUfukDuzeltmesiAktif ? Math.Max(0.0, clamp(H, -450, 8850) - clamp(H0, -450, 8850)) : 0.0;
#43

43) 계곡, 산등성이 및 고층 건물 장애물이 실제 관측 지평선에 미치는 영향

지형학적 투명성 안내: 동서 방향으로 높은 산등성이가 있는 계곡에서는 현지에서 보이는 일출/일몰 시각이 평탄 지평선 계산과 수 분 차이 날 수 있으므로 피크흐상 신중을 기하기 위해 현지 탐킨을 유의해야 합니다.

수학적 지평선 방정식(ΔH ≥ 0)은 관측자가 주변보다 높은 탁 트인 지평선을 가정하지만, 깊은 계곡이나 산기슭, 또는 동서 지평선을 높은 산맥과 고층 빌딩이 가리는 곳(예: 아르트빈 초루흐 계곡, 스위스 알프스 계곡, 마천루 사이)에서는 국지적 물리 지평선이 0°선 위로 올라옵니다. 이러한 지점에서는 태양이 평탄 지역 지평선보다 수 분 늦게 보이거나 산 뒤로 수 분 일찍 지며, 공식 예배 시간표는 지역 전체의 평균 개방 지평선과 탐킨(안전 여유)을 기준으로 삼습니다.

이유(이렇게 설계한 까닭): 전 세계 어떤 스마트폰 공식도 사용자 창 앞의 언덕이나 건물을 홀로 알 수 없기 때문이며, 이러한 자연 지형적 한계와 탐킨의 취지를 분명히 밝히는 것이 과학적 정직함에 부합하기 때문입니다.
// 공식 계산 기관에서는: rakimUfukDuzeltmesiAktif = false (ΔH = 0, 평균 지역 지평선 + 공식 탐킨 보정)
// 좁은 계곡과 산 그림자에서의 이프타르는 지평선 어두워짐 및 현지 시간표 탐킨을 준수해야 합니다
#44

44) 공식 지평선 천정각(90°50') vs 사용자 맞춤 모드에서 지평선 기준 고도(H₀ = H − ΔH)에 따른 기압 굴절 보정

공식 예배 시간표 기관들은 표준 해수면 지평 대기 굴절(34')과 평균 태양 반경(16')의 합인 90°50'(90.833333°) 천정각을 고정 채택합니다. 반면 사용자 맞춤 광학 지평선 모드가 켜지면 높은 해안 관측자에게 도달하는 접선 태양 광선이 가장 조밀한 대기층을 통과하는 곳은 관측자가 선 산정(H)이 아니라 지평선이 스치는 기준 고도(H₀ = H − ΔH)이므로, 지평 대기 굴절을 H₀ 기준 밀도로 비례 조정하고 그날의 실제 태양 시반경(s_☉)과 지평 시차(π_☉)를 결합합니다.

이유(이렇게 설계한 까닭): 해발 2000 m 해안 산에서 0 m 바다 수평선을 바라보는 관측자에게 접선 광선은 해수면을 지나가므로, 2000 m 기압으로 굴절을 줄이는 것은 물리적 광선 경로에 어긋나기 때문입니다.
흔한 오해 및 주의사항: 산 정상의 관측자에 대해서는 정상의 낮은 기압으로 지평 굴절을 줄여야 한다고 얼핏 생각하기 쉽지만, 바다 수평선에 접하는 광선은 최하층의 가장 밀한 대기(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) 6개 예배 시간에 대한 개별 방향 탐킨 및 이흐티야트(신중 보정) 분수 아키텍처

각 예배 시간은 자신의 피크흐상 시작(진입) 또는 종료(이탈) 방향에 따라 독립적인 탐킨 성분을 갖습니다. Diyanet에서는 [임사크 0, 일출 -7, 주흐르 +5, 아스르 +4, 마그립 +7, 이샤 0]분, MABIMS(KEMENAG/JAKIM) 체계에서는 [+2, -2, +2, +2, +2, +2]분, 0-탐킨 기관에서는 [0, 0, 0, 0, 0, 0]분이 적용되며 사용자 맞춤 설정에서는 각 시각을 따로 조절할 수 있습니다. 일출 시각의 음(-)의 탐킨(-7분 또는 -2분)은 새벽 예배(파즈르)가 해가 뜨는 카라하 시간대로 넘어가지 않도록 둔 조기 종료 안전 장치입니다.

이유(이렇게 설계한 까닭): 종료 시각인 일출과 진입 시각인 주흐르·아스르·마그립은 같은 방향으로 신중 보정을 줄 수 없으며, 각 시각에 자신의 방향에 맞는 독립 탐킨을 정의해야 공식 시간표와 일치하기 때문입니다.
double gunesTemkin = otorite_ayari.gunesVakitAyari; // Diyanet: -7분, MABIMS: -2분 (조기 종료 신중 보정)
double aksamTemkin = otorite_ayari.aksamVakitAyari; // Diyanet: +7분, MABIMS: +2분 (진입 신중 보정)
#46

46) Diyanet [44.5°..45.5°] 위도 전환(-17° → -16° 이샤) 및 봄/여름 비율([δ_tam − 9.5°, δ_tam])

튀르키예 종교최고위원회(DİYK)는 중·고위도 유럽 대역(|φ| ≥ 45°; 베를린 52.52°N, 런던 51.51°N, 빈, 파리)에서 겨울을 포함해 연중 이샤 박명 각도를 -16.0°로 적용하며, 45° 경계 도시(리옹, 토리노, 풀라)에서 급변하지 않도록 [44.5°, 45.5°] 구간에서 에르미트 전이를 수행합니다. 여름 추정(타크디르)이 4월 1일 같은 봄날에 이르게 작동해 베를린 시각을 좁히지 않고 5~7월 백야기에만 온전히 동작하도록 완전 여름 임계값 δ_tam = clamp(90° − |φ| − 18°, 6.0°, 20.5°)과 시작 임계값 max(0°, δ_tam − 9.5°)를 정의했습니다.

이유(이렇게 설계한 까닭): 3월 21일 춘분(δ = 0°)에 곧바로 여름 추정을 시작하면 베를린과 런던의 4월 임사크와 이샤 시간이 공식 Diyanet 시간표보다 15~20분 일찍 끊겨 버리기 때문입니다.
etkinYatsiDerece = yatsi_derece + (-16.0 - yatsi_derece) * diyanetEnlemGecisOrani;   diyanetYazlikOran = diyanetEnlemGecisOrani * HermiteSmoothStep(δ_bas, δ_tam, yazDeklin);
#47

47) Diyanet (순수 밤 − 10) · 0.25 여름 추정 시간([20..80]분 이샤, +10분 임사크) 및 근접 해 블렌딩

Diyanet의 |φ| ≥ 45° 여름 추정에서는 원시 천문 밤이 아니라 오늘의 탐킨 반영 마그립과 내일의 탐킨 반영 일출 사이의 순수 밤(Gece_net)에서 1/4 비율로 산출합니다. 이샤 추정 구간은 [20, 80]분 대역의 clamp((Gece_net − 10) · 0.25, 20, 80)분이며, 임사크 추정 구간은 이보다 정확히 +10분 더한 [30, 90]분입니다. 천문학적 해가 끊어지기 직전에도 밤 최저 태양 고도 [target − 4.5°, target]와 겨울 암흑 구간 [target, target + 2.5°] 가중치로 매끄러운 에르미트 블렌딩을 적용합니다.

이유(이렇게 설계한 까닭): 밤/3 같은 거친 비율은 250분의 짧은 베를린 여름밤에서 이샤를 80분에 고정해 버리는 반면, 공식 DİYK 방식의 (Gece_net − 10)/4 공식은 60분 이샤와 70분 임사크를 산출해 밤을 균형 있게 배분하기 때문입니다.
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) Diyanet 62° 이상 극권 대역 3계절 규칙(트롬쇠: 평상 계절, 겨울 ±150분, 여름 19시간 45분)

|φ| ∈ (62.0°, 90.0°] 대역의 도시(트롬쇠 69.65°N, 레이캬비크 64.15°N, 롱위에아르뷔엔 78.22°N)에서는 DİYK 규정이 세 가지 계절 모드로 동작합니다. (1) 봄·가을(낮 길이 300..1173분): 실제 위도가 유지되어 태양이 실제 지평선에서 뜨고 집니다. (2) 극야 겨울(극야이거나 낮 길이 300분 = 5시간 미만): [294..300분] 에르미트 전환으로 일출 = 주흐르 − 150분, 마그립 = 주흐르 + 150분으로 추정합니다. (3) 백야(자정의 태양, 낮 길이 1173..1185분 초과): 남중 ± 592.5분(최대 낮 길이 19시간 45분) 및 ±62.0° 아크라브 알 빌라드 투영에 연결됩니다.

이유(이렇게 설계한 까닭): 연중 고정된 ±62° 위도를 복사하면 4월과 9월 트롬쇠에서 태양이 아직 지평선 위에 떠 있는데도 약 30분 이른 마그립 시각을 내어 주기 때문입니다.
흔한 오해 및 주의사항: 62° 이상 극권 대역에서는 1년 365일 내내 고정된 62° 위도의 예배 시간을 복사한다고 오해하기 쉽지만, 봄과 가을에는 태양이 정상적으로 뜨고 지므로 트롬쇠는 자체 실제 지평선을 사용합니다.
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) Diyanet |φ| ∈ (84°, 90°] 지리 극점 부근 분점 연속성 가교([-7.5°, +6.5°] 에르미트)

정확한 지리 극점 주변(|φ| ∈ (84°, 90°], 예: 89.9°N 또는 남극점 기지)에서는 춘분·추분 날 낮 길이가 하루 만에 0분에서 24시간으로 치솟을 수 있어 5시간 겨울 체제와 19시간 45분 여름 체제 사이에 하루 약 7.3시간의 단차가 발생할 수 있습니다. |φ| ≤ 84° 거주지(롱위에아르뷔엔, 트롬쇠 등)에는 전혀 손을 대지 않는 [84.0°, 86.5°] 위도 가중치와 [-7.5°, +6.5°] 적위 가교를 통해 분점 전환을 약 36일에 걸쳐 분산합니다.

이유(이렇게 설계한 까닭): 위도 89.9°의 365일 달력에서 3월과 9월 분점에 하루 7시간의 급격한 도약이 남지 않게 하면서도 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) 비(非)-Diyanet 기관의 계절별 극지 한계 및 일별(d-1, d, d+1) 유효 위도 산출

Diyanet 이외의 기관에서는 극야와 백야의 접선 경계를 이동 적위(sign(φ)·δ + 지평선 보정각)를 통해 매일(d-1, d, d+1) 각 날의 적위에 대해 개별적으로 풀어 유효 위도에 연결합니다. 엄밀한 ±90.000000° 지리 극점에서는 모든 자오선이 한 점에 모여 물리적 동서 지평선이 특이점에 들어가며, 엔진은 수학적 연속성을 유지하되 극점에서는 가장 가까운 정상 지역 기준으로 예배 시간을 추정(타크디르)하는 것이 피크흐의 기본 원칙입니다.

이유(이렇게 설계한 까닭): d-1과 d+1 날짜에 오늘의 유효 위도를 그대로 복사하면 극권 접선 진입일에 아침·저녁 밤 길이에 인위적인 꺾임이 생기기 때문이며, 매일 각자의 적위로 풀어야 날짜 간 연속성이 유지되기 때문입니다.
etkinEnlemDun = KutupEtkinEnlemCoz(dEnlem, ozetDun.sunDeclinDeg, ...); // d-1, d, d+1 개별 해결
etkinEnlemYarin = KutupEtkinEnlemCoz(dEnlem, ozetYarin.sunDeclinDeg, ...);
#51

51) 고위도 북극(75°..81°, 얼러트 82.5°N) C∞ 쌍곡선형 유효 위도 평활화

중극지 거주지(트롬쇠 69.65°N)에서는 유효 위도의 핵심 반올림을 0.12°, 안전 여유를 0.30°로 유지하는 반면, 고위도 북극 기지(얼러트 82.50°N, 유레카)에서는 분점 스침 기울기를 완만하게 만들기 위해 [75.0°, 81.0°] 대역 에르미트 가중치로 핵심 폭을 0.62°, 안전 여유를 0.52°로 높이고 min(|φ|, 경계 위도)의 날카로운 꺾임을 1.60·w 계수의 C∞ 쌍곡선형 부드러운 전환으로 바꿉니다.

이유(이렇게 설계한 까닭): 82.5°N 얼러트 같은 고위도 북극 지점에서 딱딱한 경계 클램핑을 사용하면 봄철 접선 일에 일출/일몰 시간의 기울기에 급격한 꺾임이 생기기 때문이며, 쌍곡선형 부드러운 위도 전환이 이를 매끄럽게 만듭니다.
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) 비(非)-Diyanet 극지 여름(|φ| ∈ (65.5°, 90°]) [target − 8° .. target] 조기 박명 블렌딩

68° 초과 극지 대역(예: 얼러트 82.5°N 또는 86°N, MWL/ISNA)에서는 춘분 이후 야간 최저 고도가 -18° 경계에 접선으로 접근할 때 d(arccos)/dδ 미분값이 지나치게 가팔라져 순수 천문 파즈르/이샤 해가 마지막 3일간 약 90분 급락했다가 해가 끊길 때 반대 방향으로 튈 수 있습니다. |φ| ≤ 65.5° 미만 도시(런던, 베를린, 오슬로, 레이캬비크)에는 손대지 않는 [65.5°, 68.5°] 극지 가중치를 써서 [target − 8°, target] 대역에서 각도 기반 밤 배분으로 부드럽게 전환합니다.

이유(이렇게 설계한 까닭): 중·고위도 유럽(48°~65°)에서는 실제 천문 해를 마지막 날까지 유지하면서도, 70°~89° 극지 대역의 분점 접선에서 발생하는 수직 기울기 붕괴를 막기 위함입니다.
double wKutup = HermiteSmoothStep(65.5, 68.5, Math.Abs(dEnlem));
double wErken = wKutup * HermiteSmoothStep(hedefAci - 8.0, hedefAci, geceMinYukseklikDeg);
#53

53) 극동절기 깊은 암흑 역전환 램프([target, target + 2.0°] 및 65.5° 초과 [target, target + 4.0°])

깊은 극지 겨울에는 태양이 정오에도 지평선 아래 박명 대역에 머물러 낮 최고 고도(α_zeval)가 파즈르 또는 이샤 박명 각도(예: -18° 또는 -15°)에 위에서부터 접근하면 천문 해가 이번에는 정오 측에서 끊깁니다. 00:00이나 정오 시각으로의 갑작스러운 도약을 막기 위해 α_zeval 최고 고도가 |φ| ≤ 65.5° 대역에서는 [target, target + 2.0°], |φ| ∈ (65.5°, 90°] 극지 대역에서는 [target, target + 4.0°] 구간에서 역 에르미트 램프로 각도 기반 밤 배분에 연결됩니다.

이유(이렇게 설계한 까닭): 여름 백야는 밤 최저 고도(α_min)만 추적하지만, 겨울 극야에서는 낮 최고 고도(α_zeval)가 박명 각도 아래로 내려갈 때 별도의 역 암흑 램프가 필요하기 때문입니다.
double ustBant = Math.Abs(dEnlem) ≤ 65.5 ? 2.0 : 4.0;
double karanlikOran = 1.0 - HermiteSmoothStep(hedefSafakAci, hedefSafakAci + ustBant, d.zevalYukseklikDeg);
#54

54) 그레고리력에서 64비트 정수 율리우스 일수(JDN)로의 변환

태양 궤도 방정식에는 월 길이(28/29/30/31일)와 윤년 규칙의 영향을 받지 않는 연속적인 일수 계수기가 필요합니다. Fliegel–Van Flandern / Jean Meeus 정수 알고리즘을 통해 그레고리력(연, 월, 일) 날짜를 64비트 long 율리우스 일수(JDN)로 변환합니다.

이유(이렇게 설계한 까닭): 소수 기반 Math.Floor 달력 변환에서는 경계 날짜에서 소수점 밀림이 발생할 수 있는 반면, 64비트 정수 나눗셈은 모든 세기에 걸쳐 안정적인 일수 인덱스를 산출하기 때문입니다.
long jdn = gun + (153 * m + 2) / 5 + 365L * y + y / 4 - y / 100 + y / 400 - 32045;
#55

55) IEEE-754 가수부 손실을 막는 (JDN − 2451545L) 정수 뺄셈 및 d2000 일수

고전 천문 코드에서는 먼저 JD ≈ 2,461,357과 같은 큰 부동소수점 수를 만든 뒤 2451545.0을 빼는데, 이 연산은 64비트 double 수의 53비트 가수부 중 21비트를 정수부에 소모시켜 수치 정밀도를 깎아 먹습니다. 본 엔진에서는 J2000.0 기준일(2451545L)을 아직 64비트 long 정수 단계일 때 미리 빼고, 소수부 UTC 일 시각을 이 작은 차이에 직접 더합니다.

이유(이렇게 설계한 까닭): 서로 가까운 두 큰 부동소수점 수의 뺄셈에서 발생하는 IEEE-754 반올림 잡음을 방지하여 이진 탐색 반복 계산에서 시간축의 수치 안정성을 지키기 위함입니다.
흔한 오해 및 주의사항: 64비트 double 타입이면 항상 충분하다고 생각하여 JD − 2451545.0을 소수 연산으로 처리하면 246만에 달하는 정수부 때문에 가수부 21비트를 낭비하게 되며, 정수(long) 뺄셈이 이 손실을 예방합니다.
double d2000Gun = (jdnFarkiJ2000 - 0.5) + kesirliGun;
#56

56) 연속 ΔT = TT − UT1 모델, 장기 추정 특성, 역표 율리우스일(JDE) 및 세기(T)

지구의 자전은 조석 마찰과 핵–맨틀 상호작용으로 인해 불규칙하게 느려지므로 지구 자전시(UT1/UTC)와 행성 천체력이 사용하는 지구역학시(TT) 사이에 ΔT만큼의 차이가 발생합니다. 연초 자정에 계단식 도약이 일어나지 않도록 ΔT는 연속적인 d2000Gun 일수로부터 계산됩니다(2026년 중반 약 69.2초). 먼 미래 수십 년 뒤에는 지구 자전 가속도가 몇 초 변할 수 있으나 태양 궤도에서 5초의 ΔT 차이가 예배 시간에 미치는 영향은 0.2초 미만입니다.

이유(이렇게 설계한 까닭): ΔT 보정을 완전히 생략하면 태양의 황경이 약 70초분의 공전 운동량(약 2.8초각)만큼 뒤처지게 되며, 연속 모델은 이 오차를 해소함과 동시에 새해 불연속도 방지하기 때문입니다.
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) 태양의 기하학적 평균 황경(L₀) 및 IEEE-754 반개구간 [0°, 360°) Mod 가드

지구가 원 궤도를 일정한 각속도로 돈다고 가정했을 때 순시 춘분점 기준 태양의 황경 각도(L₀)를 Jean Meeus(25장) 2차 다항식으로 계산합니다. 매우 작은 음의 부동소수점 값(예: -1e-16)에서 a − b·Floor(a/b) 연산이 정확히 360.0°를 반환하지 않도록 Mod 함수에 반개구간 [0.0, b) 클램핑을 적용합니다.

이유(이렇게 설계한 까닭): 진황경(☉_true)과 균시차(EoT) 모두의 주 기준 위상이 평균 황경 L₀ 각도이며, 반개구간 Mod(360°)가 정확한 경계 각도에서의 오버플로를 방지하기 때문입니다.
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) 태양의 기하학적 평균 근점이각(M)

지구의 타원 궤도에서 근일점(perihelion — 태양에 가장 가까운 점, 1월 초) 위치로부터 쓸고 지나간 평균 각도인 기하학적 평균 근점이각(M)을 도(degree)와 라디안 단위로 함께 계산합니다.

이유(이렇게 설계한 까닭): 궤도 속도가 1월에 빨라지고 7월에 느려지는 정도를 결정하는 케플러 중심차 방정식이 바로 이 M 각도의 조화 사인 급수로 동작하기 때문입니다.
M = Mod(357.52911 + T * (35999.05029 - 0.0001537 * T), 360.0);
#59

59) 지구 궤도의 영년 이심률(e)

지구 궤도가 완전한 원에서 얼마나 찌그러졌는지 나타내는 궤도 이심률 계수(e ≈ 0.016708)는 다른 행성들의 장기 중력 영향으로 매 세기마다 조금씩 감소하며 율리우스 세기(T) 다항식으로 실시간 갱신됩니다.

이유(이렇게 설계한 까닭): 고정된 e 계수를 쓰는 대신 영년 변화를 추적함으로써 태양–지구 거리(R_AU)와 균시차 진폭 모두에서 장기적 표류를 막을 수 있기 때문입니다.
e = 0.016708634 - T * (0.000042037 + 0.0000001267 * T);
#60

60) 케플러 중심차(C) 및 태양의 진근점이각(ν = M + C)

케플러의 면적 속도 일정 법칙에 따라 타원 궤도상의 실제 각위치와 원형 평균 운동 간의 차이(중심차 C, 최대 ±1.915°)를 sin(M), sin(2M), sin(3M) 고조파 항으로 풀고, 여기서 진근점이각 ν = Mod(M + C, 360°)를 구합니다.

이유(이렇게 설계한 까닭): 3차 고조파 항(sin 3M)까지 전개한 급수가 음함수 형태의 케플러 방정식을 반복 없이 약 0.01초각의 수치 근사로 해결하기 때문입니다.
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) 순시 지구–태양 거리(R_AU) 계산

타원의 극좌표 궤도 방정식으로부터 진근점이각(ν)과 이심률(e)을 이용해 그 순간 지구와 태양 중심 간 거리를 천문단위(R_AU ∈ [0.9833, 1.0167] AU; 1월 초 최근접, 7월 초 최원점)로 계산합니다.

이유(이렇게 설계한 까닭): 태양 원반의 겉보기 시반경, 지평 시차각 및 연주 광행차가 바로 이 순시 거리 R_AU에 반비례하여 변하기 때문입니다.
R_AU = (1.000001018 * (1.0 - e * e)) / (1.0 + e * Math.Cos(DereceyiRadyana(sunTrueAnom)));
#62

62) 가변 태양 원반 시반경(s_☉ = 959.63″ / R_AU) 및 지평 시차(π_☉ = 8.794″ / R_AU)

하늘에서 보이는 태양 원반의 겉보기 각반지름(1월 약 16′17″, 7월 약 15′45″)과 지표면 관측자의 지구 중심 대비 지평 시차각(약 8.79″ ≈ 0.00244°)을 IAU 표준 상수를 순시 거리 R_AU로 나누어 계산합니다.

이유(이렇게 설계한 까닭): 사용자 맞춤 광학 지평선의 상단 테두리 일출/일몰 천정각, 이스티와 원반 통과 시간 및 지심 천정각을 관측점 중심 천정각으로 변환하는 과정이 이 두 동적 각도에 직접 의존하기 때문입니다.
gunesYaricapDeg = (959.63 / 3600.0) / sunRadVectorAu;
yatayParalaksDeg = (8.794 / 3600.0) / sunRadVectorAu;
#63

63) 달–지구 공통 질량 중심(EMB 무게중심) 황경 섭동(Δλ_Ay)

태양 주위의 케플러 타원을 그리는 점은 지구 단독 중심이 아니라 지구–달 공통 질량 중심(EMB)입니다. 지구 중심은 29.53일의 삭망월마다 이 공통 중심 주위를 약 4670 km 반경으로 흔들리며 도므로 태양 황경에 ±6.4초각(±0.00179°) 진폭의 sin(D) 보정을 더합니다.

이유(이렇게 설계한 까닭): 달 공통 질량 중심 섭동을 무시하면 상현과 하현 위상에서 태양 황경에 약 6.4초각의 주기적 편차가 남게 되기 때문입니다.
흔한 오해 및 주의사항: 옛 문헌의 350.74° 달 이각 상수를 J2000 세기(T)와 함께 사용하면 J1900과 J2000 역기점을 혼동하게 됩니다. J2000.0 역기점의 올바른 초기 각도는 297.8502°입니다.
ayUzamaD = Mod(297.8502 + 445267.1115 * T - 0.00163 * T * T, 360.0);
ayBarysentrikDeg = 0.00179 * Math.Sin(DereceyiRadyana(ayUzamaD));
#64

64) 금성·목성 및 장주기(E) J2000.0 섭동과 태양의 진황경(☉_true)

금성과 목성이 지구 궤도에 일으키는 중력 섭동 및 뉴컴 장주기 행성 위상은 Meeus(AFC 18장)의 J1900 초기 각도(153.23°, 216.57°, 312.69°, 231.19°)를 T_1900 = T + 1 변환으로 정확한 J2000.0 역기점으로 옮긴 값(A = 351.9841°, B = 254.0782°, C = 157.0477°, E = 231.19° + 20.20° = 251.39°)으로 계산하여 ☉_true = Mod(L₀ + C + Δλ_gez + Δλ_Ay, 360°)를 얻습니다.

이유(이렇게 설계한 까닭): J1900(JD 2415020.0)용으로 발표된 231.19° 같은 원시 위상 상수를 곧장 J2000.0 세기(T)와 곱하면 100년(+1세기) 위상 이동을 일으키기 때문이며, T_1900 = T + 1 이동이 모든 항을 J2000.0 축에 정렬시킵니다.
흔한 오해 및 주의사항: 옛 Meeus(J1900) 표에 익숙한 시각이나 모델은 231.19° 상수를 J2000으로 착각하고 251.39° 값을 J1900 잔재로 오해하기 쉽지만, 1900년에서 2000년으로 +1세기 전진하면 T_1900 = T + 1이 되어 231.19° + 20.20° = 251.39°가 정확한 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) 달의 승교점(Ω), 황경 장동(Δψ), 거리 비례 광행차 및 시황경(λ)

진 기하학적 황경에서 지표면 관측자가 보는 시황경(λ)으로 변환하기 위해 달의 승교점 황경(Ω = Mod(125.04° − 1934.136°·T, 360°))과 반년 주기 태양 항으로 황경 장동(Δψ)을 계산하고, 지구의 궤도 속도와 유한한 광속의 결합으로 생기는 거리 비례 연주 광행차(-20.4898″ / R_AU)를 더해 [0°, 360°) 범위로 환원합니다.

이유(이렇게 설계한 까닭): 빛이 태양에서 지구까지 약 8.3분 걸려 도달하므로 태양의 겉보기 위치가 공전 방향으로 약 20.5초각 밀려 보이며, 근일점과 원일점에서 이 항을 R_AU로 스케일링해야 타원 궤도 속도 차이를 반영하기 때문입니다.
흔한 오해 및 주의사항: 연주 광행차를 연중 고정값 -20.4898″로 취하면 타원 궤도의 속도 변화를 무시하게 됩니다. 지구는 1월 근일점(R_AU ≈ 0.983)에서 더 빠르게 공전하므로 광행차는 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) 라스카 평균 황도 경사각(ε₀) 및 진황도 경사각 장동(ε = ε₀ + Δε)

지구 자전축의 공전 궤도면에 대한 기울기(약 23.439°)는 행성 인력으로 수 세기에 걸쳐 서서히 줄어들며 달의 교점(Ω)과 2·L₀ 반년 주기 위상에 따라 ±9.2초각의 경사각 장동(Δε)을 겪습니다. 평균 경사각 ε₀ 다항식에 Δε를 더해 순간 진황도 경사각(ε)을 구합니다.

이유(이렇게 설계한 까닭): 황도 좌표에서 적도 좌표(적위 δ 및 적경 α)로 변환할 때 바로 이 순시 각도 ε의 사인과 코사인이 직접 사용되기 때문입니다.
ε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) 태양 적위(δ) 및 4사분면 역탄젠트 적경(α)

시황경(λ)과 진황도 경사각(ε)으로부터 천구 적도에 대한 태양의 각거리인 적위(δ = asin(clamp(sin ε · sin λ, -1, 1)))와 천구 적도를 따라 춘분점에서 측정한 적경(α = Mod(atan2(cos ε · sin λ, cos λ), 360°))을 계산합니다.

이유(이렇게 설계한 까닭): sin(δ) 값을 [-1, +1] 범위로 제한하면 부동소수점 초과 시 NaN 위험을 차단하고, 4사분면 atan2 함수는 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) Meeus 28.1 엄밀 균시차(EoT) 및 고전 경사각 보조항(y = tan²(ε/2))

이유(이렇게 설계한 까닭): 2차 절단 Smart 급수는 높은 이심률·경사각 교차항에서 약 0.4~0.8초의 편차를 남기는 반면, 직접식 (L₀ − 0.0057183° − α + Δψ·cos ε)·4 공식은 행성과 달 섭동까지 균시차에 반영하기 때문입니다.
흔한 오해 및 주의사항: 65단계에서 광행차가 R_AU로 나뉜 것을 보고 EoT 내부의 0.0057183°(-20.4898″) 상수도 R_AU로 나누려 할 수 있으나, Meeus 28.1 정의에서 가상의 평균 태양은 등속 운동을 하므로 평균 광행차 상수는 나누지 않습니다.
eotDerece = Sarmala180(geomMeanLongSunDeg - 0.0057183 - sunRightAscensionDeg + deltaPsiDeg * Math.Cos(ε_rad));
eqOfTimeMinutes = eotDerece * 4.0;
#69

69) 진태양시(TST) 및 지방 자오선 시각(H = TST · 0.25 − 180°)

현지 벽시계 분(t_dk), 균시차(EoT), 경도 1도당 4분 환산(4·λ_boylam) 및 활성 시간대(60·TZ)를 결합해 진태양시(TST ∈ [0, 1440)분)를 구하고, 여기서 태양이 지방 자오선에서 떨어진 각거리인 시각 H = TST · 0.25 − 180°(정오 전 음수, 정오 후 양수)를 도출합니다.

이유(이렇게 설계한 까닭): 구면 위치 삼각형에서 관측자의 천정(제니트)과 태양을 잇는 구면 코사인 법칙의 시간 의존 각도가 바로 이 지방 시각(H)이기 때문입니다.
trueSolarTimeMin = Mod(gunIciToplamDakika + eqOfTimeMinutes + 4.0 * guvenliBoylam - 60.0 * temizSaatDilimi, 1440.0);
hourAngleDeg = trueSolarTimeMin * 0.25 - 180.0;
#70

70) 지심 천정각(θ_z_jeo) 및 관측점 시차 보정 기하학적 태양 고도(α_geom)

구면 코사인 법칙으로 먼저 지구 중심 기준의 지심 천정각 θ_z_jeo = acos(clamp(sin φ · sin δ + cos φ · cos δ · cos H, -1, 1))을 구합니다. 관측자는 지구 중심이 아니라 지표면에 서 있으므로 태양이 지평선에서 약 8.79″ 더 낮게 보이며, π_☉ · sin(θ_z_jeo)를 더해 [0°, 180°]로 제한함으로써 관측점 중심(토포센트릭) 천정각(θ_z)과 기하학적 고도(α_geom = 90° − θ_z)를 얻습니다. 이 토포센트릭 각도는 순시 태양 고도, 아스르 그림자 비율(α_zeval, α_asr) 및 박명/이샤 근에 직접 적용되며, 사용자 맞춤 광학 지평선에서는 −π_☉ 항이 지평선 천정각(θ_ufuk) 내부에 포함되므로 일반(단계 76)과 극지 스침(단계 77) 일출/일몰 근 모두 지평 시차를 대칭 적용하고, 7개 공식 기관에서는 90°50'(90.833333°) 표준이 유지됩니다.

이유(이렇게 설계한 까닭): 시차 보정을 sin(θ_z_jeo)로 비례 적용하면 순시 태양 고도, 아스르 그림자 각도, 박명 근 및 사용자 맞춤 광학 지평선에서 약 8.79″(약 0.6초)의 편차를 제거하면서도 공식 기관에서는 90°50' 시간표 표준을 지킬 수 있기 때문입니다.
θ_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) 글래드스톤-데일 공기 밀도 지수(4.25588) 및 기압 굴절 배수(ρ / ρ₀)

대기 굴절은 굴절률 차이(n − 1 ∝ ρ)에 비례하므로 고지대에서는 낮아진 공기 밀도에 따라 감소하고 사해(-430 m) 같은 저지대 분지에서는 증가합니다. 국제표준대기(ISA, T₀ = 288.15 K, L = 0.0065 K/m) 대류권 방정식에서 기압비 P/P₀ 지수 5.25588 대신 (P/P₀)/(T/T₀) = (1 − 2.25577e-5 · H)^4.25588의 완전 밀도 지수를 [-450 m, 11000 m] 구간에 적용합니다.

이유(이렇게 설계한 까닭): 단순 기압 지수(5.25588)는 고도가 높아질수록 공기가 차가워지며 조밀해지는 효과를 놓쳐 2000 m 고도에서 굴절을 약 5% 과소평가하기 때문이며, 4.25588 밀도 지수가 물리적 글래드스톤-데일 법칙에 부합합니다.
double BasincKirilmaCarpaniHesapla(double H) → Math.Pow(1.0 - 2.25577e-5 * Math.Clamp(H, -450.0, 11000.0), 4.25588);
#72

72) 세문드손 / Meeus 16.4 C¹-단조 대기 굴절(+0.00192792 및 [-3°, -1°] 감쇠)

고전적 구간별 NOAA 굴절 공식은 h = -0.575° 지점에서 약 20.9분각의 불연속 단차를 유발할 수 있으므로, 굴절 계산기 내부에서는 (-3.0°, +90.0°) 구간에서 미분 가능하고 단조로운 세문드손 / Meeus 16.4 모델을 사용합니다. 천정(h = 90°)에서 tan(90.1083°)의 음수 항을 정확히 0으로 만들기 위해 +0.00192792분각을 더하고, [-3.0°, -1.0°] 대역에서는 에르미트 감쇠를 적용하며, h ≤ -3.0° 박명 각도에서는 굴절을 정확히 0.0°로 반환합니다.

이유(이렇게 설계한 까닭): 지평선 부근의 21분각 인위적 굴절 계단을 없애고, 천정(h = 90°)에서 R = 0° 조건을 만족시키며, -15°..-20° 박명 해를 불필요한 굴절 꼬리로부터 보호하기 위함입니다.
흔한 오해 및 주의사항: 태양이 지평선 -18° 아래에 있을 때도 34′ 지평 굴절을 더하는 것은 자주 발생하는 오류입니다. 그 깊이에서는 태양 원반의 직접 광선이 눈에 도달하지 않고 상층 대기 산란만 관측되므로 모든 박명 각도는 굴절 없는 기하학적 정의입니다.
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) 실제 대기에서 기온(-30 °C..+45 °C), 기압, 습도 및 역전층으로 인한 자연 편차(±15~40초)

기상학적 겸허함 안내: 순간 기온, 폭풍 저기압, 상대 습도 및 지평선 신기루 같은 국지 대기 현상은 실제 보이는 일몰을 수 초 단위로 바꿀 수 있으므로 피크흐상 이흐티야트 여유가 중요합니다.

모든 천문 및 달력 엔진과 마찬가지로 본 계산 역시 국제표준대기(해수면 15 °C, 1013.25 hPa 건조 공기) 가정에 바탕을 둡니다. 실제 하늘에서는 메카나 바그다드의 여름 폭염(+45 °C)에 공기가 팽창해 지평 굴절이 약 2~3분각 감소하는 반면, 에르주룸이나 시베리아의 혹한(-25..-35 °C), 높은 수증기 습도 또는 해상 기온 역전층(인버전)에서는 굴절이 커집니다. 이 물리적 자연 현상은 보이는 일출과 일몰을 ±15~40초(경계 분 부근에서는 ±1분) 변동시킬 수 있습니다.

이유(이렇게 설계한 까닭): 오프라인으로 동작하는 계산 엔진은 지평선을 따라 펼쳐진 실시간 수직 온도·습도 분포를 측정할 수 없으며, 공식 위원회가 일출과 마그립 시간에 두는 탐킨 여유가 바로 이러한 자연 기상 변동까지 감싸 안기 때문입니다.
// 표준 기준: T₀ = 15 °C (288.15 K), P₀ = 1013.25 hPa → 지평 굴절 R₀ ≈ 34분각
// 극심한 폭염 (+45 °C) / 혹한 (-30 °C) / 역전층 → 자연 ±15..40초 광학 지평선 변동
#74

74) 카바 성전 이스티와 알 아잠(θ_z → 0°) 보호가 적용된 4사분면 Meeus 13.5 태양 방위각

북쪽에서 시계 방향으로 측정되는 태양의 지평 각도(방위각)는 분모에 sin(θ_z)를 가져 태양이 정점 바로 위에 올 때(5월 28일과 7월 16일 정오 메카 카바 성전 이스티와 알 아잠 시 θ_z → 0°) 0/0 부정형을 유발하는 arccos 공식 대신, Math.Atan2(sin H, cos H · sin φ − tan δ · cos φ) + 180° 공식을 직접 사용하여 특이점 없이 계산합니다.

이유(이렇게 설계한 까닭): 열대 지역에서 태양이 천정을 통과할 때 분모 sin(θ_z)가 0에 가까워지기 때문이며, Math.Atan2 공식은 천정각으로 나누지 않으므로 모든 위도에서 안정적으로 동작하기 때문입니다.
흔한 오해 및 주의사항: 교과서의 단일 변수 arccos 방위각 공식은 오전과 오후 방향을 혼자서 구분하지 못할 뿐만 아니라, 카바 성전 위에서 태양이 정점에 설 때(θ_z → 0°) 분모가 0이 되어 불안정해집니다.
azPay = sin(H);   azPayda = cos(H) * sin(φ) - tan(δ) * cos(φ);
guneydenBatiyaDeg = RadyaniDereceye(Math.Atan2(azPay, azPayda));   Azimut = Mod(guneydenBatiyaDeg + 180.0, 360.0);
#75

75) 날짜변경선(±180° IDL) 보호 4회 반복 자왈(남중) 수렴 계산(Sarmala180 경도 차)

정오 자오선 통과 시각(자왈/남중)을 계산할 때 균시차(EoT)가 하루 동안 미세하게 변하므로 남중 추정치에 대해 4회 연속 고정점 반복을 실행합니다. 키리티마티(UTC+14, -157.4°W), 사모아(UTC+13), 채텀(+12:45)처럼 ±180° 인접 지역에서 남중이 전날이나 다음 날로 튕겨 나가지 않도록 (15°·TZ − 경도) 차이를 직접 Sarmala180으로 [-180°, +180°) 범위에 접어 넣습니다.

이유(이렇게 설계한 까닭): 15°·TZ 표준 자오선으로부터 180° 경계 이상 떨어진 섬 시간대에서는 원시 공식이 남중을 ±1440분 밖으로 밀어 버리는 반면, Sarmala180 자오선 차이는 남중을 현지 날짜 한가운데에 잡아 두기 때문입니다.
meridyenFarkiDeg = Sarmala180(temizSaatDilimi * 15.0 - guvenliBoylam);
solarNoonMin = 720.0 + 4.0 * meridyenFarkiDeg - eqOfTimeMinutes; // 4회 연속 고정점 반복
#76

76) 일반 위도(|cos HA_zeval| ≤ 0.90)에서 일출 및 일몰을 위한 8회 고정점 반복 수렴

태양이 뜰 때와 질 때의 적위(δ) 및 균시차(EoT)는 정오 시점의 값과 다릅니다(분점 무렵에는 아침부터 저녁까지 δ가 약 0.4° 변합니다). 따라서 |cos HA_zeval| ≤ 0.90 및 |φ| ∈ [0°, 88°) 조건의 일반 위도에서는 일출과 일몰 시각 모두 각각의 순간 값(δ(t_k), EoT(t_k))으로 최대 8회(|Δt| ≤ 0.0001분 수렴 기준)까지 개별적으로 계산합니다.

이유(이렇게 설계한 까닭): 일출과 일몰을 정오 적위로 한 번에 계산하면 중·고위도의 춘분/추분 날 일출과 일몰 시각에 1~2분의 비대칭 오차가 남기 때문입니다.
cosHa = (cos(ufukZenit) - sin(φ)*sin(δ_k)) / (cos(φ)*cos(δ_k));   t_{k+1} = zeval_k ∓ 4.0 * acos(cosHa);
#77

77) 극지 스침 대역(|cos HA| ∈ (0.90, 1] 또는 |φ| ≥ 88°) 황금분할 극값 탐색 및 28단계 지평선 근 계산

극권 부근과 88°~89.9° 극점 근처에서는 태양이 지평선을 매우 완만하게 스치고 분점 날에는 하루 적위 변화(약 0.4°/일)가 일일 천정각 진폭을 넘기 때문에, 2·(90° − |φ|) + 1.25° 사전 선별 게이트를 거친 뒤 남중(|φ| ≤ 85°에서 ±120분, |φ| ∈ (85°, 88°)에서 ±360분, |φ| ≥ 88°에서 ±720분)과 아침/저녁 천저(|φ| ≤ 85°에서 ±180분, 85° 초과에서 ±360분)를 26단계 황금분할 탐색으로 찾고 지심 천정각과 지평선 천정각의 차이(θ_z,jeo − θ_ufuk = 0) 위에서 28단계 이진 탐색을 수행합니다. 사용자 맞춤 광학 지평선 모드에서는 θ_ufuk = 90° + s_☉ + R_ufuk − π_☉ + α_ufuk 정의 자체가 지평 시차(−π_☉ ≈ −8.79″)를 내포하고 있으므로(단계 44), 단계 76의 cos(θ_ufuk)와 이 이진 탐색이 동일한 지평 시차를 적용해 |cos HA| = 0.90 경계에서 분기 단차가 생기지 않습니다.

이유(이렇게 설계한 까닭): 공식 90°50' 표준과 사용자 맞춤 광학 지평선(−π_☉ 포함 θ_ufuk 각도) 모두에서 8회 반복 arccos와 이진 탐색이 완전히 같은 θ_ufuk 목표값을 공유해야 |cos HA| = 0.90 전환 시 분기 계단을 약 0.15초 이하로 억제하고 89.9°N 분점 일출도 놓치지 않기 때문입니다.
double ZenitFarki(double dk) → HesaplaTamDetay(..., dk, ...).jeosentrikZenitDeg - ufukZenitDeg; // 맞춤 지평선에서는 ufukZenitDeg 내부에 -π_☉ 포함
AltinKesitEkstremumBul(zeval - ogleYaricap, zeval + ogleYaricap, maksimumAraniyor: false, out gercekZeval); // 26단계 + 28단계 이진 탐색
#78

78) 대칭 밤(1440 − 낮)과 연속 비대칭 아침 밤(d-1 → d) 및 저녁 밤(d → d+1)

대칭 밤 시간은 곧바로 1440 − 낮 시간으로 계산됩니다(낮 + 대칭 밤 = 1440분). 그러나 고위도의 봄과 가을에는 낮 길이가 하루 6~12분씩 변하므로 아침 임사크용 밤(어제 일몰 → 오늘 일출)과 저녁 이샤용 밤(오늘 일몰 → 내일 일출)은 대칭 밤과 같지 않으며, 엔진은 이를 각 날짜 쌍에서 따로 계산합니다.

이유(이렇게 설계한 까닭): 임사크와 이샤 추정(타크디르)에 대칭 (1440 − 낮) 차이만 사용하면 낮 길이가 빠르게 변하는 시기에 아침과 저녁 밤 길이가 수 분씩 틀어지기 때문입니다.
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) 적응형(±95 / ±160 / ±300분) 30단계 황금분할 천저 탐색기(굴절 없는 최저점)

한밤중 최저 태양 고도 시점(천저/나디르)은 고위도에서 급격한 적위 변화 때문에 남중 ± 720분 지점에서 벗어날 수 있습니다. 하부 자오선 최저점 탐색은 적응형 창(|φ| ≤ 75°에서 ±95분, (75°, 85°]에서 ±160분, 85° 초과에서 ±300분)에서 굴절 없는 토포센트릭 고도(굴절 여유 없음) 위로 30단계 황금분할 탐색을 수행해 실제 최저점을 찾습니다. 움 알 쿠라 같은 +90/+120분 고정 이샤 모드에서는 주 엔진이 저녁 천저 탐색을 생략하지만, 보고서 참고 측정값이 비지 않도록 같은 창으로 진단 전용 저녁 천저를 별도 표본 추출합니다.

이유(이렇게 설계한 까닭): 박명 각도는 굴절 없는 기하학적 고도로 정의되며 85°~89.9° 극지 대역에서는 천저 시점이 ±95분 밖으로 이동할 수 있으므로 ±300분 황금분할 탐색이 이진 탐색을 올바른 분기에 유지해 주기 때문입니다.
흔한 오해 및 주의사항: 밤 최저 태양 고도는 늘 00:00 또는 정확히 남중 ± 12시간에 나타난다고 여기기 쉽지만, 극지 분점에는 빠른 적위 변화로 실제 최저점 시점이 수 시간 이동할 수 있습니다.
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) 단조 상승 및 하강 분기에서 28단계 이진 탐색(아침 / 저녁 근 해결기)

밤 최저점(천저)과 낮 최고점(남중/자왈)이 분리되면 태양 고도는 아침 분기 [t_nadir,sabah, t_zeval] 구간에서 단조 증가하고, 저녁 분기 [t_zeval, t_nadir,aksam] 구간에서 단조 감소하는 단일 근 함수가 됩니다. 아침과 저녁 고도 근 해결기는 이 구간에서 28단계 이진 탐색을 실행합니다(이러한 축소는 방정식 내부 수치 근 분해능일 뿐, 실제 하늘의 대기 및 지형 불확실성은 수 초 수준입니다).

이유(이렇게 설계한 까닭): 성긴 1분 선형 탐색은 수백 번의 불필요한 천체력 호출을 일으키고 분 반올림 경계에 계단을 남기기 때문이며, 28단계 이진 탐색은 추가 수치 오차 없이 방정식을 풉니다.
TrySabahYukseklikZamaniBul(..., sabahDipDk, zeval, imsakAci, kirilmaliYukseklikKullan: false, out hamImsak, out _, out _); // IkiliAramaYukselis (28단계)
TryAksamYukseklikZamaniBul(..., zevalDk, aksamSinirDk, hedefAci, kirilmaliYukseklikKullan: false, out bulunanDk, out _, out _); // IkiliAramaAlcalis (28단계)
#81

81) 탐킨 없는 순수 물리적 구룹 → 파즈르(d → d+1 UTC) 샤리아 밤 길이

하나피 및 샤피이 법학에서 밤의 시작은 태양의 일몰(구룹)이고, 끝은 다음 날 아침 진여명(파즈르 앗 사디크)의 출현(툴루 알 파즈르)입니다. 마그립 예배에 더해지는 탐킨 여유분이나 DST 서머타임 시계 도약은 물리적인 밤의 길이를 바꾸지 않으므로, 샤리아 밤 길이는 오늘의 순수 일몰 UTC 시점과 내일(d+1)의 순수 파즈르 UTC 시점 차이에서 직접 계산됩니다.

이유(이렇게 설계한 까닭): 탐킨이 반영된 벽시계 시간에서 밤 길이를 빼면 탐킨 여유분이 한밤중 계산에 섞여 들어가고, 봄·가을 DST 전환 야간에는 샤리아 밤을 1시간 잘못 측정하게 되기 때문입니다.
흔한 오해 및 주의사항: 샤리아 기준 한밤중을 카드에 표시된 탐킨 적용 마그립과 같은 날 아침 임사크에서 계산하면 탐킨이 밤에 섞이고 잘못된 날짜의 임사크를 쓰게 되며 DST 전환 밤에는 30분 오차를 냅니다.
seriGeceSuresiDakika = Math.Clamp((yarinHamFecrUtcDakika + 1440.0) - hamGunBatisUtcDakika, 6.0, 1434.0);
#82

82) 하나피·샤피이 법학의 니스프 알 라일(샤리아 한밤중) 및 술루스 알 아히르(밤의 마지막 3분의 1)

샤피이 법학파에서 이샤 예배의 선택 가능(이흐티야리) 시간과 하나피 법학파에서 카라하 없는 이행 경계는 샤리아 한밤중(니스프 알 라일 = 구룹 + 1/2 · 샤리아 밤)까지이며, 타하주드와 사후르의 권장 시간인 술루스 알 아히르는 밤의 마지막 3분의 1 구간(구룹 + 2/3 · 샤리아 밤)에서 시작합니다. 두 시점 모두 순수 UTC 축에서 계산된 뒤 각자의 순간 현지 시간대로 투영됩니다.

이유(이렇게 설계한 까닭): 샤리아 기준 한밤중은 시계의 00:00 자정이 아니라 계절과 경도에 따라 22:30~01:15 사이에서 변하는 실제 구룹–파즈르 중간 시점이기 때문입니다.
seriGeceYarisiUtc = hamGunBatisUtcDakika + 0.5 * seriGeceSuresiDakika;
sonUcteBirGeceUtc = hamGunBatisUtcDakika + (2.0 / 3.0) * seriGeceSuresiDakika;
#83

83) 제1 예배 시간 — 임사크(진여명 / 파즈르 시작) 천문학적 근 계산

이유(이렇게 설계한 까닭): 지평선에 수평 백색 여명(파즈르 앗 사디크)이 비치는 천문학적 모델 시점은 선택된 기관 박명 각도의 굴절 없는 아침 상승 분기 근 값이기 때문입니다.
bool imsakBulundu = TrySabahYukseklikZamaniBul(..., sabahDipDk, zeval, imsak_derece, kirilmaliYukseklikKullan: false, out hamImsak, out _, out _);
#84

84) 임사크 시각의 백야(1.50° 에르미트 / Diyanet 추정), 극지 겨울 분리 및 순수 임사크

이유(이렇게 설계한 까닭): 박명 근이 끊기는 첫 여름밤에 예배 시간이 35~45분씩 절벽처럼 벌어지지 않아야 하며, 깊은 극지 겨울에는 백야 방정식이 잘못 개입하지 않아야 하기 때문입니다.
if (d.diyanetYuksekEnlemAktif) { double takdirImsakNet = d.netGunesDakika - d.diyanetTakdirImsakAralikDk; /* + 에르미트 가교 */ }
#85

85) 제2 시각 — 일출(툴루), 새벽 예배 종료 경계, 음(-)의 탐킨 및 이슈라크 카라하 안내

이유(이렇게 설계한 까닭): 일출은 시작 시각이 아니라 새벽 예배의 종료 경계이므로 신중 보정을 뒤가 아니라 앞으로 당겨 적용해야 카라하 시점 전에 예배를 마치도록 보호하기 때문입니다.
#86

86) 이스티와 카라하, 태양 원반 통과 시간(4·s_☉ / cos δ) 및 움 알 쿠라 중심 기준

이유(이렇게 설계한 까닭): Diyanet/MABIMS에서 이중 이스티와 가산을 피하고, 카바에서 공식 움 알 쿠라 주흐르 시각과 일치시키며, 0-탐킨 기관에서는 카라하 종료를 보호하기 위함입니다.
흔한 오해 및 주의사항: 자왈 순간에 곧바로 주흐르가 시작된다고 여기기 쉽지만, 자왈은 태양 중심의 통과 순간이며 동쪽 테두리가 자오선을 벗어날 때까지(약 65초) 이스티와 카라하가 이어집니다.
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 예배 시간 — 주흐르(정오 예배) 계산 및 맞춤 모드 무(無)불감대 탐킨 단조성

주흐르 시각은 천문학적 남중 분수에 선택된 기관의 주흐르 탐킨과 필요 시 태양 원반 통과를 위한 추가 이스티와 여유를 더해 계산됩니다. 사용자 맞춤 설정 모드에서는 주흐르 탐킨이 0 또는 양수일 때 추가 이스티와 여유가 일정하게 유지되므로 사용자의 탐킨 증가(0 → +0.5 → +1.0분)가 불감대에 걸리지 않고 선형적으로 주흐르 시각에 반영됩니다. 음의 주흐르 탐킨이 입력되면 보상 여유가 작동하여 주흐르 시각을 이스티와 카라하 밖에 유지합니다.

이유(이렇게 설계한 까닭): 양수 구간에서 이전 보상 공식을 쓰면 0..+1.13분 범위에서 사용자 입력을 대수적으로 상쇄해 삼켜 버렸기 때문이며, 이 조건부 구조는 음수 구간에서만 안전 하한을 적용하여 양의 단조성을 보존합니다.
// 음수 ogleTemkin일 때 (else if ogleTemkin이 0.0 미만): zevalIstivaPayiDk = fizikselIstivaDk - ogleTemkin
double netOgleDakika = zevalDakika + ogleTemkin + zevalIstivaPayiDk;
#88

88) 파이 알 자왈 그림자(tan(90° − α_zeval)) 및 카바 성전 이스티와 무(無)그림자 연속성

아스르 시각의 기준은 모든 물체의 정오 최소 그림자(파이 알 자왈) 위에 더해지는 그림자 길이입니다. 단위 막대(1.0 단위)의 남중 그림자는 cot(α_zeval) = tan(90° − α_zeval) 공식으로 계산되며, 태양이 정확히 천정에 오르는(α_zeval → 90°, 메카 카바 성전 이스티와 알 아잠) 시점에도 그림자 길이가 음수가 되지 않도록 남중 고도를 [0.05°, 90.0°] 범위로 연속 제한합니다(α_zeval = 90°일 때 파이 알 자왈 = 0.000000).

이유(이렇게 설계한 까닭): 상한을 89.999° 대신 정확히 90.0°로 유지해야 카바 성전에서 태양이 머리 꼭대기에 있을 때 물리적인 0 그림자 값을 매끄럽게 생성할 수 있기 때문입니다.
zevalYukseklikDeg = Math.Clamp(zevalHamYukseklikDeg, 0.05, 90.0);
zevalGolgeBoyu = Math.Tan(DereceyiRadyana(90.0 - zevalYukseklikDeg));
#89

89) 제4 예배 시간 — 아스르(아스르 알 아우왈 +1 / 아스르 앗 싸니 +2) 기하학적 그림자 각도(atan(1 / L_asr)) 근 계산

이유(이렇게 설계한 까닭): 남중 그림자와 아스르 목표 고도를 모두 굴절 없는 토포센트릭 각도 평면에서 풀고 오후의 실제 적위로 28단계 이진 탐색을 수행해야 고정 적위 편차를 제거할 수 있기 때문입니다.
흔한 오해 및 주의사항: 파이 알 자왈 그림자는 굴절 없이 계산하면서 아스르 태양 고도에만 대기 굴절을 더하거나(혹은 정오 적위를 아스르에 고정해 버리면) 두 그림자 비율이 서로 다른 기준면에 놓여 체계적인 편차가 생깁니다.
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) 아스르 시각의 겨울철 지평선 스침 보정(에르미트 [0.05°..상한 임계], 아스르 알 아우왈 0.16 / 아스르 앗 싸니 0.24 반낮 비율)

이유(이렇게 설계한 까닭): 로바니에미·오울루 같은 65°~66.5° 도시에서 α_zeval ≥ 0.60°일 때 실제 그림자 근을 해치지 않으면서도, 고지대 극야 경계에서 하루 사이에 시간 단위로 아스르가 튀는 현상을 막기 위함입니다.
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) 극지 여름 ±62° 기준 위도 아스르 블렌딩([1.2°..7.2°+] 및 84°..86.5° 극점)

극지 여름(24시간 지지 않는 백야 태양)에서 저녁 분기의 최저 고도(α_min,ikindi)가 목표 아스르 각도(α_asr)에 아래로부터 접선 접근할 때 근이 끊기는 것을 막기 위해, 같은 경도와 날짜의 ±62.0° 기준 위도에서 실제 아스르 시각(t_62°)을 계산하고 정오 고도를 통한 부드러운 에르미트 전환([1.2°, max(7.2°, 상한 임계 + 2.0°)])과 최저 고도 블렌딩([α_asr − 2.0°, α_asr])을 적용합니다. Diyanet 모드에서는 |φ| ∈ (84°, 90°] 극점 고위도 전이([84.0°, 86.5°])가 연속성을 지킵니다.

이유(이렇게 설계한 까닭): 고정 분수를 더하는 대신 ±62° 기준 위도의 실제 그림자 근을 사용해야 샤피이(+1)와 하나피(+2) 사이의 자연스러운 시간 차이가 극지 여름에도 보존되기 때문입니다.
kutupHedefIkindiDk = ikindiYedekDakika + wZevalRef * (refIkindiDk - ikindiYedekDakika);   wYazIkindi = HermiteSmoothStep(hedefAci - 2.0, hedefAci, ikindiMinYukseklikDeg);
#92

92) 제5 예배 시간 — 마그립(일몰 예배 / 이프타르): 상단 테두리 일몰 및 조기 이프타르 방지 이흐티야트

이유(이렇게 설계한 까닭): 태양이 지평선 아래로 완전히 잠기기 몇 초 전에 이프타르를 열면 금식이 위태로워지므로 상단 테두리 일몰과 올림 처리가 이 피크흐상 신중함을 지켜 주기 때문입니다.
#93

93) 제6 예배 시간 — 이샤(밤 예배): 박명 각도, 극지 겨울 및 백야 추정

이유(이렇게 설계한 까닭): 이샤 시각은 중위도에서 실제 박명 소멸을 추적하면서도 백야로 접어들 때는 단차 없이 기관 추정 시간으로 부드럽게 이어져야 하기 때문입니다.
#93B

93) 제6 예배 시간 — 이샤(움 알 쿠라 +분 고정 분 규칙 및 대체 히즈라력)

이유(이렇게 설계한 까닭): 사우디아라비아 및 걸프 지역 시간표에서 라마단 기간 타라위흐와 이프타르 편의를 위해 공식적으로 +120분 규칙을 시행하고 있으며, 2029년 이후 날짜에서도 달력 예외가 발생하지 않아야 하기 때문입니다.
hamYatsi = Math.Min(d.netAksamDakika + eklenecekDakika, d.yatsiUstSinirDakika);   netYatsi = hamYatsi + yatsiTemkin;
#94

94) 내일(d+1) 임사크 시각 및 연속 태양 축상의 이샤 상한

이유(이렇게 설계한 까닭): 고정된 23:55 벽시계 상한을 두면 레이캬비크나 오슬로처럼 이샤가 자연스럽게 00:30~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) UTC 투영 전 6개 예배 시간 단조 순서 보호(2.05분 완충) 및 개별 UTC → 현지 투영

맞춤 모드에서 극단적인 반대 방향 탐킨을 입력했거나 극지 경계에서 연속된 두 시각이 겹치지 않고, Ceiling/Floor 반올림 후에도 카드 시각이 순증가(strictly increasing)를 유지하도록 원시 태양 축에서 2.05분 완충 간격을 둔 순서 보호를 실행한 직후, 각 시각을 협정 세계시(UTC) 축에서 각자의 순간 현지 시간대로 개별 투영합니다.

이유(이렇게 설계한 까닭): 원시 시간 차이가 1.0분일 경우 Ceiling과 Floor 조합에 의해 같은 정수 분(예: 01:15 == 01:15)으로 합쳐질 수 있으므로, 2.05분 완충이 365일 내내 구분되는 카드 부등식을 지켜 주기 때문입니다.
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) 기관별 분 반올림 엔진(Diyanet 및 움 알 쿠라 :30, MABIMS 수부흐 Ceiling, 0-탐킨 Floor/Ceiling)

분 반올림 계층은 각 기관 고유의 달력 관행을 적용합니다. (1) Diyanet과 움 알 쿠라에서는 대칭 :30.00 임계값으로 가장 가까운 분에 반올림합니다. (2) MABIMS(KEMENAG/JAKIM) 표준에서는 수부흐(+2분 이흐티야트 포함)를 비롯한 5개 예배 시작 시각을 올림(Ceiling / Pembulatan ke Atas), 슈루크(일출, -2분)를 내림(Floor) 처리합니다. (3) 0-탐킨 공식 기관과 맞춤 모드에서는 임사크 및 일출 종료 시각을 내림(Floor), 주흐르·아스르·마그립·이샤 시작 시각을 올림(Ceiling) 처리합니다(오직 MABIMS 수부흐만 Ceiling 적용).

이유(이렇게 설계한 까닭): 각 기관의 인쇄 시간표가 자체 반올림 규칙으로 제작되기 때문이며, 예를 들어 자카르타에서는 수부흐가 +2분 이흐티야트를 포함하더라도 Floor 대신 공식 Pembulatan ke Atas(Ceiling)를 적용해야 KEMENAG 시간표와 일치하기 때문입니다.
흔한 오해 및 주의사항: 파즈르/임사크 시각은 전 세계 모든 기관에서 내림(Floor) 처리한다고 생각하기 쉽지만, 인도네시아·말레이시아(MABIMS/KEMENAG) 체계에서는 수부흐가 +2분 이흐티야트가 포함된 예배 시작 시각이므로 공식적으로 올림(Ceiling) 처리됩니다.
bool imsakCikisYuvarla = (SeciliOtorite != Otoriteler.Kemenag_GuneydoguAsya); // MABIMS 수부흐 → Ceiling
FikhiGuvenliSaatMetnineCevir(netDakika, temkin, cikisVaktiMi);
#97

97) 경계 초(:29.9 / :30.1 및 :00.1)에서 나타나는 자연스러운 ±1분 시간표 양자화 차이

달력 양자화 투명성: 반올림 임계값과 불과 수 밀리초~1초 이내로 인접한 날에는 인쇄 시간표와 ±1분의 경계 차이가 보이는 것이 자연스러운 양자화 거동입니다.

예배 시간표는 초 단위를 숨기고 HH:mm 정수 분만 표시하므로, 반올림 임계값(대칭 체계에서는 :30.00초, 올림/내림 체계에서는 :00.00초)에서 0.1~0.5초 떨어진 경계일에는 두 천문대의 천체력 항 개수 차이나 0.5 m 좌표 차이만으로도 12:04:29.9와 12:04:30.1처럼 인접한 두 분(12:04 vs 12:05)으로 갈릴 수 있습니다.

이유(이렇게 설계한 까닭): 0.2초 차이가 겉보기에는 온전한 1분 차이로 인식되는 것이 분 단위 계단화의 수학적 본질이기 때문이며, 이러한 경계 거동을 사용자에게 투명하게 설명하여 오작동 오해를 없애기 위함입니다.
// 대칭 임계 예시: 12:04:29.9 → 12:04 | 12:04:30.1 → 12:05 (실제 물리 차이: 0.2초, 겉보기 차이: 1분)
// 올림(Ceiling) 임계 예시: 18:10:00.2 → 18:11 (조기 이프타르를 막기 위해 다음 정수 분으로 올림)
#98

98) 단일 단계 초 버림(초 미만 절삭) 및 이중 반올림 방지

소수 분에서 시각 문자열로 변환할 때 가장 가까운 초로 반올림(round)을 먼저 하면 29.50초가 우선 30초로 올라간 뒤 카드 파서에서 다시 다음 분으로 올려지는 이중 반올림(double-rounding) 오차가 발생합니다. 초 파서는 ⌊dk × 60 + 10⁻⁷⌋ 수식으로 초 미만 단위를 단일 단계에서 버림 처리하여 29.99초 → :29(아래 분), 30.00초 → :30(위 분)으로 변환합니다.

이유(이렇게 설계한 까닭): 29.50~29.99초 구간에 걸친 시각이 두 번 반올림되어 공식 달력보다 1분 앞으로 튀어 오르는 현상을 차단하기 위함입니다.
흔한 오해 및 주의사항: 소수 분을 먼저 가장 가까운 초로 반올림한 다음 :30초 규칙으로 분을 만들면 12:04:29.60 같은 경계 시각이 먼저 :30으로, 이어서 12:05로 옮겨가 눈에 띄지 않는 이중 반올림 오차를 만듭니다.
double toplamTamSaniye = Math.Floor(dakika * 60.0 + 1e-7); // DakikayiSaatMetnineCevir
TryDakikaBazliVakitCozumle: if (saniye ≥ 30) dakika++;   yuvarlanmisToplamSaniye = saat * 3600 + dakika * 60;
#99

99) 어제(d-1) 이샤 시각의 -86,400초 이동 및 자정 연속성

밤 00:00를 지나 아직 오늘의 임사크 시각이 도래하지 않은 동안 현재 진행 중인 예배 시간은 어제(d-1)의 이샤 시간입니다. 카운트다운 링의 진행률(경과 / 전체 길이)을 끊김 없이 계산하기 위해 어제의 아스르·마그립·이샤 시각을 d-1 날 자체의 전개 축 위에서 풀어낸 뒤 오늘 시간축으로 -86,400초 이동해 가져옵니다.

이유(이렇게 설계한 까닭): 시각이 00:00:00이 되었을 때 이샤 링이 초기화되지 않고 저녁부터 새벽까지 실제 물리적 밤의 진행을 이어서 보여 주어야 하기 때문입니다.
int_dun_yatsi = dunAcikYatsi - 86400; // 자정 00:00 이후 활성 이샤 시작 기준
#100

100) 주흐르(정오) 중심 및 ΔTZ 인식 [-86,400초 .. +172,800초] 전개 초 축(-60초 임계값)

극단적인 동·서 수동 시간대 설정(예: 카슈가르 UTC+8에서 임사크 06:30, 푸위안 23:28, 혹은 반대 방향 수동 TZ 선택으로 주흐르가 자정 부근으로 이동하는 경우)에서 6개 시각의 날짜 이탈을 막기 위해 전개 축 해결기는 먼저 주흐르 시각을 중심 닻으로 잡고 일출과 임사크를 뒤쪽으로 감으며, 아스르·마그립·이샤는 ΔTZ·3600 시차와 -60초 임계값의 자정 넘김 전개 규칙으로 앞쪽으로 펼칩니다.

이유(이렇게 설계한 까닭): 예전의 12시간(-43,200초) 임계값은 58°~65°의 긴 밤에 이샤를 다음 날 아침으로 떨어뜨렸고, 반대로 임사크에서 앞쪽으로 전개하면 극단적 수동 TZ 오프셋에서 하루 전체를 +86,400초 밀어 버릴 수 있었기에 주흐르 닻이 양 끝을 모두 지켜 줍니다.
흔한 오해 및 주의사항: 자정 넘김을 판별할 때 차이가 -12시간(-43,200초)보다 작은지 보는 것은 직관적여 보이지만, 60°N 대역에서 마그립 15:30·다음 날 새벽 이샤 03:45(-11시간 45분)일 때 이샤를 잘못하여 아침 시간으로 떨어뜨립니다.
while (sGunes ≥ (sOgle - tzFarkGO) + 61) sGunes -= 86400;   while (sImsak ≥ (sGunes - tzFarkIG) + 61) sImsak -= 86400;
sIkindi = GeceYarisiSarkmasiniAc(sOgle, sIkindi, tzOgle, tzIkindi); // fizikselFark ≤ -61초 → +86400
#101

101) 동쪽 시간대 끝단(푸위안 23:28 임사크)에서 내일 임사크 및 일출 닻 정렬(±64,800초 일출 닻)

중국 최동단 푸위안(북위48.37°, 동경134.28°, UTC+8) 같은 지점에서는 여름철 내일의 임사크 시각이 23:28(00:00 이전)에 시작됩니다. 내일 전개 알고리즘은 먼저 내일의 일출 시각을 오늘 전개 일출 초 기준 ±64,800초 대역 안에 안착시킨 다음, 내일 임사크 시각을 ΔTZ 차이를 반영해 일출로부터 뒤쪽으로 감아 둘 모두에 +86,400초를 더합니다.

이유(이렇게 설계한 까닭): 23:28에 들어오는 내일 임사크를 +86,400초 뒤로 둔 채 두면 23:28~00:00 사이에 카운트다운이 24시간 더 표시되기 때문이며, 보조 일출 닻과 역방향 감기가 모든 수동 시간대에서 끊김 없이 동작하도록 해 줍니다.
while (cozulmusGunes - yedekGunesSn ≥ 64801) cozulmusGunes -= 86400;   while (yedekGunesSn - cozulmusGunes ≥ 64801) cozulmusGunes += 86400;
while (cozulmusImsak ≥ (cozulmusGunes - tzFark) + 61) cozulmusImsak -= 86400;   yarinImsakAcikSn = cozulmusImsak + 86400;
#102

102) 6일차 예방적 테이블 갱신(d ≥ 6), 코루틴 대기 및 단일 프레임 시간 획득

시간 출력기는 매초 시작 시 위치의 현지 시각과 시간대를 한 번만 표본 추출하여 모든 하위 모듈에 동일한 시간 쌍을 전달합니다. 앱이 며칠 동안 오프라인으로 계속 켜져 있을 때는 테이블이 마지막 날을 소진하기 하루 전에(일수 차이가 6 이상이거나 내일 및 7일차 로컬 저장 기록이 누락되었고 백그라운드 계산이 진행 중이지 않을 때) 새 테이블을 구축하고 즉시 활성 날짜 인덱스를 갱신합니다.

이유(이렇게 설계한 까닭): 갱신을 7일차까지 미루면 6일차 저녁에 내일(d+1 = 7)이나 d+2 예배 시간 카드를 읽을 때 범위 초과가 일어날 수 있으므로 6일차 예방 갱신이 d+1과 d+2 버퍼를 미리 준비해 두기 때문입니다.
if (KonumAlma.IlkKonumKayitliMi() && _sonOtomatikYenilemeTarihi != konumSimdi.Date && (gunFarki ≤ -1 || gunFarki ≥ 6 || yarinVeSonGunDepoKaydiEksik))
{ bulucu.yerel_vakitleri_ayarla(); d = AktifTabloGunIndeksiniBul(konumSimdi, out gunFarki); }
#103

103) 카드–카운터–링 :00 정분 일치, 아침 쌍둥이 링 및 내일 일출 후 주흐르 전환

예배 시간 카드가 HH:mm 정분 단위로 반올림되므로 카운트다운 타이머(초 올림, 남은 시간 − 10⁻⁹)와 원형 진행 링도 동일한 정분 경계(:00)를 기준으로 삼아, 남은 시간이 0.4초일 때 타이머가 미리 00:00:00을 띄우지 않도록 합니다. 임사크–일출 구간에서는 임사크와 일출 쌍둥이 링이 차오르고, 일출–주흐르 구간에서는 링이 비활성(-1)인 채 타이머가 주흐르(금요일에는 주무아 라벨)를 세며, 극동 시간대에서 00:00 전에 내일 일출까지 지났다면 내일의 주흐르 시각까지 셉니다.

이유(이렇게 설계한 까닭): 카드에 19:04라고 적혀 있는데 카운터가 19:03:59.6에 00:00:00이 되면 반초 먼저 초기화되는 느낌을 주기 때문이며, 밀리초 임계값이 적용된 초 올림이 정확히 :00.0 경계에서 0으로 전환합니다.
int kalanSaniye = Math.Max(0, (int)Math.Ceiling(kalanFizikselSn - 1e-9)); // 조기 00:00:00 방지
simUtc ∈ [imsakUtc, gunesUtc) → aktifIndeks = 0;   simUtc ∈ [gunesUtc, ogleUtc) → aktifIndeks = -1; // 비활성 링, 주흐르 카운터
#104

104) 가을철 02:00..02:59 중복 시간 야간의 물리적 UTC 카운트다운 및 실시간 상태

가을에 시계를 03:00에서 02:00로 되돌리는 밤에는 02:00~02:59 벽시계 시각이 두 번 나타납니다(첫 번째 통과는 서머타임, 두 번째 통과는 겨울 시간). UTC 기반 활성 예배 및 남은 시간 해결기는 모든 시각에서 각자의 시간대를 빼 유일한 물리적 UTC 초 축으로 환원하므로 02:59:59 → 02:00:00 되돌림 시점에서도 카운터가 1시간 앞으로 튀지 않고 초 단위로 단조 감소합니다. 예를 들어 자정 이후의 이샤 진행률은 어제의 이동된 이샤 시점부터 오늘의 임사크 시점까지 전체 물리적 밤 구간 중 지난 비율입니다.

이유(이렇게 설계한 까닭): 벽시계끼리 단순 뺄셈하는 타이머는 가을 DST 야간에 시계가 03:00에서 02:00로 돌아가는 순간 남은 시간을 1시간 되감아 망가뜨리는 반면, UTC 축에서는 시간이 한 방향으로만 흐르기 때문입니다.
흔한 오해 및 주의사항: 카운트다운을 현지 벽시계의 차이로 계산하는 타이머는 가을에 시계가 03:00에서 02:00로 되돌려진 순간 남은 시간을 갑자기 1시간 늘려 사용자에게 혼란을 줍니다.
double kalanFizikselSn = (hedefGunIciSaniye - hedefTzSaat * 3600.0) - (suanGunIciSaniye - simdiTzSaat * 3600.0);
#105

105) 6개 예배 시간 카드가 각자의 물리적 UTC 시점을 지나면 개별적으로 내일 시각으로 전환

이유(이렇게 설계한 까닭): 이미 지난 카드에 오늘의 끝난 시각을 남겨 두는 대신 그 예배가 다음에 돌아올 내일 시각을 보여 주는 것이 하루 종일 사후르·아침·낮 일정을 계획하기 훨씬 편리하기 때문입니다.
kart_yapilandirma → KartiYapilandir(bugunVakitStr, bugunAcikHedefSaniye, bugunHedefTz, yarinVakitKey, ...);
DateTime hedefUtc = VakitUtcAniniHesapla(gunTabani, bugunAcikHedefSaniye, bugunHedefTz, enlem, boylam); // simdiUtc ≥ hedefUtc이면 d+1 (필요 시 d+2)
#106

106) 오른쪽에서 왼쪽(RTL: 아랍어 / 우르두어) 서식 텍스트 무결성, 유니코드 기호 보호 및 1650자 분할기

설명 패널 문구가 타자기 애니메이션으로 출력될 때 서식 태그 보호 계층은 어떤 프레임에서도 색상·굵게·기울임 태그를 중간에 자르지 않고 열린 태그를 임시로 닫아 줍니다. 오른쪽에서 왼쪽(RTL) 텍스트 컴포넌트의 태그 파서가 부등호 쌍을 HTML 태그로 오인하지 않도록 문구에는 노출된 부등호 대신 ≤, ≥, ∈, ↔, → 유니코드 기호를 사용하며, 1650자 제한을 넘는 긴 단계는 서식 태그 구조를 유지한 채 연속적인 RTL 텍스트 조각으로 나눕니다.

이유(이렇게 설계한 까닭): 타자기 애니메이션 도중 끊긴 색상 태그나 부등호 충돌이 RTL 언어에서 서식 코드를 화면에 노출시킬 수 있기 때문이며, 균형 잡힌 다중 조각 분할과 유니코드 기호가 모든 언어에서 깔끔한 화면을 보장합니다.
const int RTL_GUVENLI_PARCA_SINIRI = 1650; // 한계를 넘는 단계는 열린 RichText 태그 스택을 유지한 채 연속 RTLTextMeshPro 조각으로 분할
GuvenliDaktiloAltMetniAl(tamMetin, gorunurHarfSayisi);   GuvenliRtlParcalaraBol(metin, 1650);
#107

107) 3중 계층 오프라인 텍스트 보호 및 결정론적 파서 설계

112단계로 구성된 이 공개 기술 보고서는 세 개의 독립 백업 계층에서 보호됩니다: (1) 동적 현지화 테이블, (2) 암호화된 로컬 데이터 백업 스트림, (3) UI에 직접 내장된 최후 안전 백업. 리플렉션(reflection)이 필요 없는 결정론적 상태 머신 기반 파서 덕분에 다양한 모바일 아키텍처에서도 컴파일러 최적화에 영향받지 않고 오프라인 동작을 유지합니다.

이유(이렇게 설계한 까닭): 오프라인 상태나 패키지 로딩 지연 상황에서도 설명 패널이 비어 있지 않고 모든 모바일 플랫폼에서 동일한 안정성으로 열려야 하기 때문입니다.
주 테이블 → 로컬 오프라인 백업 스트림 → 내장 UI 백업;
AyiklaSafJsonYedek(safJsonMetin, hedefTablo); // 무리플렉션 결정론적 상태 머신 파서
#108

108) 77개 독립 알고리즘·측지·시간대·극지 연속성·법학파 검증

개발 환경의 77개 독립 검증 점검은 IEEE-754 JDN 및 Mod(360°) 경계, Meeus 천체력 및 세문드손 굴절 연속성, 이중 계층 EGM96 지오이드, Android/iOS 고도 분리, 8,023개 도시 오프라인 데이터베이스의 국가/기관/시간대 일치성, 동지중해/모로코/카자흐스탄/러시아 11개 시간대/브라질/북미/태평양 경계 폴리곤, 365일 극지 연속성, UTC 카운트다운 및 하나피·샤피이 한정 범위를 테스트합니다.

이유(이렇게 설계한 까닭): 하나의 국경 폴리곤이나 극지 전환을 개선할 때 다른 대륙의 도시가 망가지지 않도록 보장하려면 매 변경마다 실행되는 포괄적 검증 체계가 필수이기 때문입니다.
// 77/77 독립 검증 점검: 천체력 + EGM96 + 8,023개 도시 + 365일 극지 + 피크흐
#109

109) 과학적 겸허함 및 투명성 선언: 자연 대기·지형·달력 양자화 편차 한계

과학적·피크흐적 겸허함 안내: 계산은 표준 대기와 평균 도시 지평선 모델에 기반하므로 경계 초에서 공식 달력과 ±1분 정도의 차이가 나타나는 것은 자연스러우며, 금식과 예배에서는 신중함(이흐티야트)을 지켜야 합니다.

이 112단계 엔진은 높은 수치적 정밀성을 기울여 구축되었으나 하늘과 땅의 모델은 본질적으로 물리적 근사치입니다: (1) 기온(-30 °C..+45 °C), 기압, 습도 및 역전층 변화는 보이는 지평선 굴절을 ±15~40초 바꿀 수 있고, (2) 계곡·산등성이·건물 장애물은 국지 일출/일몰을 평탄 지역 지평선에서 벗어나게 할 수 있으며, (3) 1 m EGM96 지오이드 양자화, 미래 연도 ΔT 추정 및 :30 / Ceiling / Floor 분 반올림은 경계 초에서 인쇄 시간표와 ±1분의 자연 차이를 만들 수 있습니다. 예배 의식에서는 샤리아상 신중함(이흐티야트)이 기본입니다.

이유(이렇게 설계한 까닭): 천문 계산을 변치 않는 기계적 잣대처럼 내세우는 대신 물리적 자연 한계를 솔직하게 공유하는 것이 이슬람적 예의(아답)와 겸허함 그리고 과학적 정직함에 가장 부합하기 때문입니다.
// 물리적·달력상 자연 한계: 대기 (±15..40초) + 국지 지평선 장애물 + 분 양자화 (±1분)
#110

110) 공개 알고리즘 투명성과 앱 내부 저장 계층 경계

이 보고서에 제시된 모든 천문 방정식, 측지 상수, 국가 및 시간대 판별 규칙, 피크흐 반올림 원칙 및 실시간 중간 텔레메트리 값은 최종 사용자와 연구자가 직접 검증할 수 있도록 투명하게 공개됩니다. 가독성을 위해 제목과 설명 문단은 이해하기 쉬운 한국어 기술 용어로 제공되며, 기술 독자를 위해 오직 ‘실제 동작 C# 로직’ 행에만 핵심 메서드 이름을 반영했습니다. 앱의 내부 파일 패키징 형식, 로컬 키-값 저장소 이름 및 인메모리 캐시 구조는 개인정보 보호와 플랫폼 안정성을 위해 추상화된 아키텍처 개념으로 표현됩니다.

이유(이렇게 설계한 까닭): 과학적·피크흐적 계산 방법을 투명하게 공개하는 것과 앱 내부 데이터 패키징 및 저장 세부 사항을 추상화하는 것은 서로 균형을 이루며, 계산 감사에는 수학적·법학적 논리만으로 충분하기 때문입니다.
흔한 오해 및 주의사항: 내부 로컬 저장소 키나 패키지 파일 이름을 비공개로 유지한다고 해서 계산 자체가 비공개인 것은 아니며, 모든 태양·지평선·피크흐 공식은 처음부터 끝까지 공개되어 있습니다.
투명 계층: 천체력 + 시간대 규칙 + 피크흐 반올림 + 실시간 텔레메트리;
추상화 계층: 내부 패키지 경로, 로컬 저장소 키 및 내부 메모리 배치;
#111

111) UTC 축에서 현지 벽시계로의 투영 및 0.0001분(≈ 0.006초) 정밀도 차이

일일 계산에서는 먼저 연속 정오 기준 시간대에서 소수 분으로 구해진 원시 시각(예: 1034.5015분)을 이어 각 시각별로 자신의 유효 현지 시간대(DST 전환 포함)에 협정 세계시(UTC) 축을 거쳐 개별 투영합니다. 세계시에서 현지 틱 타임스탬프로 변환할 때의 IEEE-754 부동소수점 및 밀리초–틱 반올림 때문에 보고서의 소수 넷째 자리 순수 분 출력에서 끝자리 0.0001분(약 0.006초 = 1초의 1/160) 수준의 차이가 보일 수 있으며, 정분 예배 카드(:30 / Floor / Ceiling)는 이 미세 투영 편차의 영향을 받지 않습니다.

이유(이렇게 설계한 까닭): DST 전환일에는 각 예배 시각을 저마다의 순간 UTC 시간대에서 실제 벽시계로 옮겨야 하기 때문이며, 독자가 0.0001분의 끝자리 변화를 계산 오류로 오해하지 않도록 물리적 원인을 분명히 문서화했습니다.
흔한 오해 및 주의사항: 소수 넷째 자리 순수 분 출력에 1034.5015 대신 1034.5016이 적힌 것을 계산 모순으로 보기 쉬우나, 그 차이는 불과 0.006초의 UTC↔현지 시각 투영 반올림일 뿐 실제 시:분 시각을 바꾸지 않습니다.
순수 시각 (현지 분) = TekilVakitUtcDenYerelDakikayaCevir(enlem, boylam, utcGunTabani, yerelGunTabani, ogleSaatDilimi, netVakitDakika, out gercekDilim, ref dstFarkiBulundu); // ≤ 0.0001분 (≈ 0.006초)
#112

112) 오늘 및 내일 최종 6개 예배 시간 감사 요약 및 v6 캐시 서명

이유(이렇게 설계한 까닭): 사용자와 검증자가 모든 중간 천문 물리량으로 산출된 오늘과 내일의 최종 카드 시각 및 캐시 서명을 한눈에 대조할 수 있도록 하여 투명성을 완성하기 위함입니다.