isAnnualDateInRange method

@useResult bool isAnnualDateInRange(DateTimeRange<DateTime>? range, { bool isInclusive = true, })

Returns true if this DateTime is within the specified range.

When year is 0, this method checks if the month/day combination falls within the range for ANY year covered by the range. This correctly handles ranges that span year boundaries (e.g., Dec 2023 to Feb 2024).

If isInclusive is true (default), the start and end dates of the range are included in the check. Returns true if range is null.

Implementation

@useResult
bool isAnnualDateInRange(DateTimeRange? range, {bool isInclusive = true}) {
  if (range == null) {
    return true;
  }

  if (year == 0) {
    for (int checkYear = range.start.year; checkYear <= range.end.year; checkYear++) {
      final DateTime dateInYear = DateTime(checkYear, month, day);

      if (dateInYear.isBetween(
        range.start,
        range.end,
        isInclusive: isInclusive,
      )) {
        return true;
      }
    }

    return false;
  }

  return isBetweenRange(range, isInclusive: isInclusive);
}