aric/hijri-core-dart
1
0
Fork 0
mirror of https://github.com/acamarata/hijri-core-dart.git synced 2026-06-30 18:54:27 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
hijri-core-dart/CHANGELOG.md
Aric Camarata c79368a4ee fix: interpret DateTime by UTC calendar day for exact round-trips 
toHijri in both UAQ and FCNA engines read .year/.month/.day from the
input DateTime — local calendar components — then passed them to
DateTime.utc(). On hosts west of UTC a UTC-midnight local DateTime
resolves to the previous local day, causing toHijri(toGregorian(y,m,d))
to return the wrong Hijri day.

Fix: call date.toUtc() first in both engines before extracting calendar
components. This is symmetric with toGregorian which always returns
DateTime.utc(). Adds 3 regression tests covering the round-trip and the
local-DateTime-on-UTC-west-host case.
2026-06-13 10:28:16 -04:00

1.4 KiB
Raw Blame History

Changelog

All notable changes to this project will be documented in this file.

The format follows Keep a Changelog. This project adheres to Semantic Versioning.

[Unreleased]

Fixed

  • toHijri now normalizes the input DateTime to its UTC calendar day before lookup (via date.toUtc()), matching the UTC-midnight contract of toGregorian. Previously, passing a local DateTime on a host west of UTC could return the previous Hijri day, breaking toHijri(toGregorian(y, m, d)) round-trips. Applies to both the UAQ and FCNA engines.

[1.0.0] - 2026-05-25

Added

  • Initial public release.
  • toHijri — converts a Gregorian DateTime to a Hijri date tuple.
  • fromHijri — converts a Hijri date tuple to a Gregorian DateTime.
  • daysInMonth — returns the number of days in a given Hijri month for a given engine.
  • isValid — validates a Hijri date for a given engine.
  • listCalendars / getCalendar — registry API for available calendar engines.
  • Built-in Umm al-Qura (UAQ) engine with tabular data.
  • Built-in FCNA (Fiqh Council of North America) calculated engine.
  • Pluggable CalendarEngine abstract class for custom Hijri calendar implementations.
  • Pure Dart implementation. Zero runtime dependencies.
  • Dart SDK ^3.7.0 compatibility.
  • 42 unit tests covering all 8 SPORT features across both UAQ and FCNA engines.