Documentation #

• Updated READMEs.

Added #

• addCalendarDays(int days): Adds calendar days preserving local time (DST-safe).
• subtractCalendarDays(int days): Subtracts calendar days preserving local time (DST-safe).

Changed #

• tomorrow / yesterday: Now use calendar day semantics instead of physical time (DST-safe).

Fixed #

• EasyDateTime.parse(): Correct DST offset resolution for gap/overlap times.

Documentation #

• Updated READMEs.

Added #

• EasyDateTime.operator ==: Added support for equality comparison with DateTime.

Documentation #

• Updated operator == and hashCode documentation to clarify behavior and warn about mixed-type usage.

Contributors #

• Thanks to @timmaffett for this release (#19).

Fixed #

• Documentation: xxxxx token (timezone with colon) now documented in format() API

Added #

• DateTimeUnit.week: ISO 8601 week boundary support for startOf() and endOf() (Monday = start, Sunday = end)

⚠️ Breaking Changes #

• Removed deprecated global functions (use static methods instead):
  • initializeTimeZone() → EasyDateTime.initializeTimeZone()
  • setDefaultLocation() → EasyDateTime.setDefaultLocation()
  • getDefaultLocation() → EasyDateTime.getDefaultLocation()
  • clearDefaultLocation() → EasyDateTime.clearDefaultLocation()
  • isTimeZoneInitialized → EasyDateTime.isTimeZoneInitialized

Added #

• EasyDateTime now implements DateTime — true drop-in replacement for any DateTime API
• startOf(DateTimeUnit) / endOf(DateTimeUnit): Truncate to time unit boundaries
• DateTimeUnit enum: year, month, day, hour, minute, second

Changed #

• == operator now matches DateTime semantics (compares moment + isUtc)
• Updated documentation with clearer equality comparison examples
• Added intl integration examples

Contributors #

• Thanks to @timmaffett for this release (#12).

Added #

• EasyDateTime.timestamp(): Returns current UTC time, equivalent to DateTime.timestamp().
• fromSecondsSinceEpoch(): Added isUtc parameter for DateTime API compatibility.
• fromMicrosecondsSinceEpoch(): Added isUtc parameter for DateTime API compatibility.

Contributors #

• Thanks to @timmaffett for this release (#16).

Added #

• EasyDateTimeFormatter: Named constructors (.isoDate(), .isoTime(), .isoDateTime(), .rfc2822(), .time12Hour(), .time24Hour()).
• EasyDateTimeFormatter: Pattern caching for better performance.
• EasyDateTimeFormatter.clearCache(): Clears cached formatters.

Contributors #

• Thanks to @timmaffett for this release (#13).

Added #

• fromMillisecondsSinceEpoch(): Added isUtc parameter for DateTime compatibility.

Contributors #

• Thanks to @timmaffett for this release (#11).

⚠️ Breaking Changes #

• Removed Constants: The following non-standard formats were removed:
  • DateTimeFormats.asianDate, usDate, euDate, fullDateTime, fullDateTime12Hour

  Migration: Use EasyDateTime.format() with custom patterns.

Added #

• Format tokens: EEE (weekday), MMM (month name), xxxxx/xxxx/xx/X (timezone offsets).

Fixed #

• DateTimeFormats.rfc2822 now outputs correct RFC 2822 format.

Added #

• EasyDateTimeFormatter: Pre-compiled date format patterns for better loop performance.
• Caching for offset location lookups in parsing module.

Added #

• DateTime compatibility constants: monday-sunday, january-december, daysPerWeek, monthsPerYear.
• Static methods: EasyDateTime.setDefaultLocation(), .getDefaultLocation(), .clearDefaultLocation(), .effectiveDefaultLocation, .initializeTimeZone(), .isTimeZoneInitialized.

Deprecated #

• Global functions deprecated in favor of static methods (removal in v0.4.0):
  • initializeTimeZone() → EasyDateTime.initializeTimeZone()
  • setDefaultLocation() → EasyDateTime.setDefaultLocation()
  • getDefaultLocation() → EasyDateTime.getDefaultLocation()
  • clearDefaultLocation() → EasyDateTime.clearDefaultLocation()
  • isTimeZoneInitialized → EasyDateTime.isTimeZoneInitialized

Fixed #

• Fixed undefined isTimeZoneInitialized reference in parsing module.

Contributors #

• Thanks to @timmaffett for this release (#7).

Added #

• DateTimeFormats.rfc2822 constant.
• Optimized timezone offset lookup with cached common mappings.

Fixed #

• Fixed quote handling in date formatting logic.
• Verified pre-1970 date handling with boundary tests.

Changed #

• Updated package topics in pubspec.yaml.

Fixed #

• Updated example documentation to use latest APIs.

Added #

• format(String pattern): Flexible date/time formatting with tokens (yyyy, MM, dd, HH, mm, ss, etc.).
• DateTimeFormats: Predefined format constants (isoDate, isoTime, isoDateTime, time12Hour, time24Hour).

Fixed #

• Fixed formatting in CHANGELOG.md.
• Updated documentation installation instructions.

Fixed #

• Updated example code to use fromIso8601String.

Changed #

• Standardized documentation tone across all languages.
• Added CI validation for example code.

⚠️ Breaking Changes #

• Renamed inUtc() → toUtc(), inLocalTime() → toLocal(), isAtSameMoment() → isAtSameMomentAs().
• Removed fromJson() and toJson() — Use fromIso8601String() and toIso8601String().

Added #

• fromSecondsSinceEpoch(int seconds, {Location? location}): Factory for Unix timestamps.
• fromIso8601String(String dateTimeString): Explicit factory for ISO 8601 strings.

Changed #

• Modularized codebase into separate parsing and utilities files.

Documentation #

• Updated READMEs.

• Initial release.