Skip to main content

dateBetween()

🧭 API map​

I want to…Details
See every accepted call styleSignatures
See common and advanced usageUsage and behavior
Customize messagesMessage configuration
Understand reactive constraintsReactive behavior
Return to the complete catalogBuilt-in validators

📐 Signatures​

dateBetween(minimum, maximum)
dateBetween(minimum, maximum, message)
dateBetween(minimum, maximum, options)

Reactive constraint arguments use a zero-argument function. The function may read signals and, where supported, return undefined to disable the constraint temporarily.

📖 Usage and behavior​

Requires a valid date within an inclusive range:

const myForm = form({
  immediateBookingDate: field<Date>(null, [
    dateBetween('today', '2026-12-31'),
  ]),
  campaignDate: field<Date>(null, [
    dateBetween('2026-08-24', '2026-09-30'),
  ]),
  bookingDate: field<Date>(null, [
    dateBetween(
      () => bookingWindow().start,
      () => bookingWindow().end,
    ),
  ]),
  localDate: field<Date>(null, [
    dateBetween('2026-08-24', '2026-09-30', { parseAs: 'local' }),
  ]),
  messagedDate: field<Date>(null, [
    dateBetween('2026-08-24', '2026-09-30', {
      message: 'Choose a date within the booking window.',
    }),
  ]),
});

Both boundaries accept a Date, YYYY-MM-DD, 'today', or a reactive source. parseAs applies to both string limits and the shortcut. null and invalid current dates pass. If either limit is absent or invalid, the range and both metadata constraints are disabled together. A failure is { kind: 'dateBetween', minDate, maxDate, actual, message }. The normalized boundaries contribute to min() and max() metadata.

💬 Message configuration​

Every failure has a default English message. Where supported, pass a string as the final argument or use an options object for a static or reactive message, as shown above.

A message function may read signals. Returning undefined continues through node, Angular provider, process-wide, and built-in message fallbacks. See Validator messages.

⚡ Reactive behavior​

The options object accepts a reactive when predicate. Signals read from its validator context are tracked; while it returns false, the rule contributes neither errors nor constraint metadata.

const enforceBookingWindow = signal(false);
const departure = field(new Date('2027-01-01'), [
  dateBetween('2026-06-01', '2026-12-31', { when: () => enforceBookingWindow() })
]);

Reactive constraint functions and message functions track the signals they read. When a resolved constraint becomes unavailable, validators that support optional constraint sources temporarily stop contributing their error and metadata.

The validator runs synchronously as part of its node's validator source. Disabled, readonly, and hidden nodes skip validation until they become interactive again.

Last updated on