remove the verb 'is' from dateTime validators

Author: ArturAssisComp

example/lib/forms_with_validate_granularlly.dart

@@ -100,8 +100,8 @@ class _BodyState extends State<_Body> {
                     hintText: 'YYYY-MM-DD',
                     prefixIcon: Icon(Icons.calendar_today),
                   ),
-                  validator: V.required(V.dateTime(V.isBefore(DateTime.now(),
-                      isBeforeMsg: (_, __) => 'Date must be in the past.'))),
+                  validator: V.required(V.dateTime(V.before(DateTime.now(),
+                      beforeMsg: (_, __) => 'Date must be in the past.'))),
                   keyboardType: TextInputType.datetime,
                   textInputAction: TextInputAction.next,
                   onTap: () async {

lib/src/form_builder_validators.dart

@@ -3322,14 +3322,14 @@ final class Validators {
       val.betweenLength(min, max, betweenLengthMsg: betweenLengthMsg);
 
   // DateTime Validators
-  /// {@template validator_is_after}
+  /// {@template validator_after}
   /// Creates a [DateTime] validator that checks if an input date occurs after
   /// `reference`.
   ///
   /// ## Parameters
   /// - `reference` (`DateTime`): The baseline date against which the input will be compared.
   ///   This serves as the minimum acceptable date (exclusive by default).
-  /// - `isAfterMsg` (`String Function(DateTime input, DateTime reference)?`): Optional custom
+  /// - `afterMsg` (`String Function(DateTime input, DateTime reference)?`): Optional custom
   ///   error message generator. When provided, it receives both the input and reference
   ///   dates to construct a context-aware error message.
   /// - `inclusive` (`bool`): When set to `true`, allows the input date to exactly match
@@ -3343,36 +3343,36 @@ final class Validators {
   /// ## Examples
   /// ```dart
   /// // Basic usage requiring date after January 1st, 2025
-  /// final validator = isAfter(DateTime(2025));
+  /// final validator = Validators.after(DateTime(2025));
   ///
   /// // Inclusive validation allowing exact match
-  /// final inclusiveValidator = isAfter(
+  /// final inclusiveValidator = Validators.after(
   ///   DateTime(2024),
   ///   inclusive: true,
   /// );
   ///
   /// // Custom error message
-  /// final customValidator = isAfter(
+  /// final customValidator = Validators.after(
   ///   DateTime(2024),
   ///   isAfterMsg: (_, ref) => 'Please select a date after ${ref.toString()}',
   /// );
   /// ```
   /// {@endtemplate}
-  static Validator<DateTime> isAfter(
+  static Validator<DateTime> after(
     DateTime reference, {
-    String Function(DateTime input, DateTime reference)? isAfterMsg,
+    String Function(DateTime input, DateTime reference)? afterMsg,
     c.bool inclusive = false,
   }) =>
-      val.isAfter(reference, isAfterMsg: isAfterMsg, inclusive: inclusive);
+      val.after(reference, afterMsg: afterMsg, inclusive: inclusive);
 
-  /// {@template validator_is_before}
+  /// {@template validator_before}
   /// Creates a [DateTime] validator that checks if an input date occurs before
   /// `reference`.
   ///
   /// ## Parameters
   /// - `reference` (`DateTime`): The baseline date against which the input will be compared.
   ///   This serves as the maximum acceptable date (exclusive by default).
-  /// - `isBeforeMsg` (`String Function(DateTime input, DateTime reference)?`): Optional custom
+  /// - `beforeMsg` (`String Function(DateTime input, DateTime reference)?`): Optional custom
   ///   error message generator. When provided, it receives both the input and reference
   ///   dates to construct a context-aware error message.
   /// - `inclusive` (`bool`): When set to `true`, allows the input date to exactly match
@@ -3387,29 +3387,29 @@ final class Validators {
   /// ## Examples
   /// ```dart
   /// // Basic usage requiring date before January 1st, 2025
-  /// final validator = isBefore(DateTime(2025));
+  /// final validator = Validators.before(DateTime(2025));
   ///
   /// // Inclusive validation allowing exact match
-  /// final inclusiveValidator = isBefore(
+  /// final inclusiveValidator = Validators.before(
   ///   DateTime(2024),
   ///   inclusive: true,
   /// );
   ///
   /// // Custom error message
-  /// final customValidator = isBefore(
+  /// final customValidator = Validators.before(
   ///   DateTime(2024),
   ///   isBeforeMsg: (_, ref) => 'Please select a date before ${ref.toString()}',
   /// );
   /// ```
   /// {@endtemplate}
-  static Validator<DateTime> isBefore(
+  static Validator<DateTime> before(
     DateTime reference, {
-    String Function(DateTime input, DateTime reference)? isBeforeMsg,
+    String Function(DateTime input, DateTime reference)? beforeMsg,
     c.bool inclusive = false,
   }) =>
-      val.isBefore(reference, isBeforeMsg: isBeforeMsg, inclusive: inclusive);
+      val.before(reference, beforeMsg: beforeMsg, inclusive: inclusive);
 
-  /// {@template validator_is_date_time_between}
+  /// {@template validator_date_time_between}
   /// Creates a [DateTime] validator that checks if an input date falls within a specified
   /// range defined by `minReference` and `maxReference`.
   ///
@@ -3422,7 +3422,7 @@ final class Validators {
   ///   Input dates must occur after this date (or equal to it if `minInclusive` is true).
   /// - `maxReference` (`DateTime`): The upper bound of the acceptable date range.
   ///   Input dates must occur before this date (or equal to it if `maxInclusive` is true).
-  /// - `isDateTimeBetweenMsg` (`String Function(DateTime, DateTime, DateTime)?`): Optional
+  /// - `dateTimeBetweenMsg` (`String Function(DateTime, DateTime, DateTime)?`): Optional
   ///   custom error message generator. When provided, it receives the input date and both
   ///   reference dates to construct a context-aware error message.
   /// - `minInclusive` (`bool`): When set to `true`, allows the input date to exactly match
@@ -3443,39 +3443,39 @@ final class Validators {
   /// ## Examples
   /// ```dart
   /// // Basic usage requiring date between 2023 and 2025
-  /// final validator = isDateTimeBetween(
+  /// final validator = Validators.dateTimeBetween(
   ///   DateTime(2023),
   ///   DateTime(2025),
   /// );
   ///
   /// // Inclusive validation allowing exact matches
-  /// final inclusiveValidator = isDateTimeBetween(
+  /// final inclusiveValidator = Validators.dateTimeBetween(
   ///   DateTime(2023),
   ///   DateTime(2025),
   ///   minInclusive: true,
   ///   maxInclusive: true,
   /// );
   ///
   /// // Custom error message
-  /// final customValidator = isDateTimeBetween(
+  /// final customValidator = Validators.dateTimeBetween(
   ///   DateTime(2023),
   ///   DateTime(2025),
   ///   isDateTimeBetweenMsg: (_, min, max) =>
   ///     'Please select a date between ${min.toString()} and ${max.toString()}',
   /// );
   /// ```
   /// {@endtemplate}
-  static Validator<DateTime> isDateTimeBetween(
+  static Validator<DateTime> dateTimeBetween(
     DateTime minReference,
     DateTime maxReference, {
     String Function(
             DateTime input, DateTime minReference, DateTime maxReference)?
-        isDateTimeBetweenMsg,
+        dateTimeBetweenMsg,
     c.bool leftInclusive = false,
     c.bool rightInclusive = false,
   }) =>
-      val.isDateTimeBetween(minReference, maxReference,
-          isDateTimeBetweenMsg: isDateTimeBetweenMsg,
+      val.dateTimeBetween(minReference, maxReference,
+          dateTimeBetweenMsg: dateTimeBetweenMsg,
           minInclusive: leftInclusive,
           maxInclusive: rightInclusive);
 

lib/src/validators/datetime_validators.dart

@@ -1,44 +1,44 @@
 import '../../localization/l10n.dart';
 import 'constants.dart';
 
-/// {@macro validator_is_after}
-Validator<DateTime> isAfter(
+/// {@macro validator_after}
+Validator<DateTime> after(
   DateTime reference, {
-  String Function(DateTime input, DateTime reference)? isAfterMsg,
+  String Function(DateTime input, DateTime reference)? afterMsg,
   bool inclusive = false,
 }) {
   return (DateTime input) {
     return input.isAfter(reference) ||
             (inclusive ? input.isAtSameMomentAs(reference) : false)
         ? null
-        : isAfterMsg?.call(input, reference) ??
+        : afterMsg?.call(input, reference) ??
             FormBuilderLocalizations.current
                 .dateMustBeAfterErrorText(reference.toLocal());
   };
 }
 
-/// {@macro validator_is_before}
-Validator<DateTime> isBefore(
+/// {@macro validator_before}
+Validator<DateTime> before(
   DateTime reference, {
-  String Function(DateTime input, DateTime reference)? isBeforeMsg,
+  String Function(DateTime input, DateTime reference)? beforeMsg,
   bool inclusive = false,
 }) {
   return (DateTime input) {
     return input.isBefore(reference) ||
             (inclusive ? input.isAtSameMomentAs(reference) : false)
         ? null
-        : isBeforeMsg?.call(input, reference) ??
+        : beforeMsg?.call(input, reference) ??
             FormBuilderLocalizations.current
                 .dateMustBeBeforeErrorText(reference.toLocal());
   };
 }
 
-/// {@macro validator_is_date_time_between}
-Validator<DateTime> isDateTimeBetween(
+/// {@macro validator_date_time_between}
+Validator<DateTime> dateTimeBetween(
   DateTime minReference,
   DateTime maxReference, {
   String Function(DateTime input, DateTime minReference, DateTime maxReference)?
-      isDateTimeBetweenMsg,
+      dateTimeBetweenMsg,
   bool minInclusive = false,
   bool maxInclusive = false,
 }) {
@@ -52,7 +52,7 @@ Validator<DateTime> isDateTimeBetween(
             (input.isAfter(minReference) ||
                 (minInclusive ? input.isAtSameMomentAs(minReference) : false))
         ? null
-        : isDateTimeBetweenMsg?.call(input, minReference, maxReference) ??
+        : dateTimeBetweenMsg?.call(input, minReference, maxReference) ??
             FormBuilderLocalizations.current.dateMustBeBetweenErrorText(
                 minReference.toLocal(), maxReference.toLocal());
   };

…_validators/is_after_validator_test.dart …ime_validators/after_validator_test.darttest/src/validators/datetime_validators/is_after_validator_test.dart renamed to test/src/validators/datetime_validators/after_validator_test.dart test/src/validators/datetime_validators/is_after_validator_test.dart renamed to test/src/validators/datetime_validators/after_validator_test.dart

@@ -7,7 +7,7 @@ void main() {
   setUpAll(() async {
     await initializeDateFormatting('en', null);
   });
-  group('Validator: isAfter', () {
+  group('Validator: after', () {
     test('Validation for the year 1994', () {
       final DateTime reference = DateTime(1994);
       final DateTime eq = reference.copyWith();
@@ -16,7 +16,7 @@ void main() {
       final DateTime before1Year = DateTime(1993);
       final DateTime before1Sec =
           reference.subtract(const Duration(seconds: 1));
-      final Validator<DateTime> v = isAfter(reference);
+      final Validator<DateTime> v = after(reference);
       final String errorMsg =
           FormBuilderLocalizations.current.dateMustBeAfterErrorText(reference);
 
@@ -56,7 +56,7 @@ void main() {
       final DateTime before1Year = reference.copyWith(year: 2088);
       final DateTime before1Sec =
           reference.subtract(const Duration(seconds: 1));
-      final Validator<DateTime> v = isAfter(reference, inclusive: true);
+      final Validator<DateTime> v = after(reference, inclusive: true);
       final String errorMsg =
           FormBuilderLocalizations.current.dateMustBeAfterErrorText(reference);
 
@@ -93,7 +93,7 @@ void main() {
       const String errorMsg = 'error msg';
       final DateTime reference = DateTime(2);
       final Validator<DateTime> v =
-          isAfter(reference, isAfterMsg: (_, __) => errorMsg);
+          after(reference, afterMsg: (_, __) => errorMsg);
 
       expect(
         v(reference.copyWith()),

…validators/is_before_validator_test.dart …me_validators/before_validator_test.darttest/src/validators/datetime_validators/is_before_validator_test.dart renamed to test/src/validators/datetime_validators/before_validator_test.dart test/src/validators/datetime_validators/is_before_validator_test.dart renamed to test/src/validators/datetime_validators/before_validator_test.dart

@@ -7,7 +7,7 @@ void main() {
   setUpAll(() async {
     await initializeDateFormatting('en', null);
   });
-  group('Validator: isBefore', () {
+  group('Validator: before', () {
     test('Validation for the year 1994', () {
       final DateTime reference = DateTime(1994);
       final DateTime eq = reference.copyWith();
@@ -16,7 +16,7 @@ void main() {
       final DateTime before1Year = DateTime(1993);
       final DateTime before1Sec =
           reference.subtract(const Duration(seconds: 1));
-      final Validator<DateTime> v = isBefore(reference);
+      final Validator<DateTime> v = before(reference);
       final String errorMsg =
           FormBuilderLocalizations.current.dateMustBeBeforeErrorText(reference);
 
@@ -56,7 +56,7 @@ void main() {
       final DateTime before1Year = reference.copyWith(year: 2088);
       final DateTime before1Sec =
           reference.subtract(const Duration(seconds: 1));
-      final Validator<DateTime> v = isBefore(reference, inclusive: true);
+      final Validator<DateTime> v = before(reference, inclusive: true);
       final String errorMsg =
           FormBuilderLocalizations.current.dateMustBeBeforeErrorText(reference);
 
@@ -93,7 +93,7 @@ void main() {
       const String errorMsg = 'error msg';
       final DateTime reference = DateTime(2);
       final Validator<DateTime> v =
-          isBefore(reference, isBeforeMsg: (_, __) => errorMsg);
+          before(reference, beforeMsg: (_, __) => errorMsg);
 
       expect(
         v(reference.copyWith()),

…/is_datetime_between_validator_test.dart …ors/datetime_between_validator_test.darttest/src/validators/datetime_validators/is_datetime_between_validator_test.dart renamed to test/src/validators/datetime_validators/datetime_between_validator_test.dart test/src/validators/datetime_validators/is_datetime_between_validator_test.dart renamed to test/src/validators/datetime_validators/datetime_between_validator_test.dart

@@ -7,7 +7,7 @@ void main() {
   setUpAll(() async {
     await initializeDateFormatting('en', null);
   });
-  group('Validator: isDateTimeBetween', () {
+  group('Validator: dateTimeBetween', () {
     test('Validation for the range 1994 and 1997', () {
       final DateTime leftReference = DateTime(1994);
       final DateTime rightReference = DateTime(1997);
@@ -25,7 +25,7 @@ void main() {
       final DateTime beforeLeft1Micro =
           leftReference.subtract(const Duration(microseconds: 1));
       final Validator<DateTime> v =
-          isDateTimeBetween(leftReference, rightReference);
+          dateTimeBetween(leftReference, rightReference);
       final String errorMsg = FormBuilderLocalizations.current
           .dateMustBeBetweenErrorText(leftReference, rightReference);
 
@@ -91,7 +91,7 @@ void main() {
       final DateTime before1Sec =
           leftReference.subtract(const Duration(seconds: 1));
       final Validator<DateTime> v =
-          isDateTimeBetween(leftReference, rightReference, minInclusive: true);
+          dateTimeBetween(leftReference, rightReference, minInclusive: true);
       final String errorMsg = FormBuilderLocalizations.current
           .dateMustBeBetweenErrorText(leftReference, rightReference);
 
@@ -145,9 +145,9 @@ void main() {
       const String errorMsg = 'error msg';
       final DateTime leftReference = DateTime(2);
       final DateTime rightReference = DateTime(5);
-      final Validator<DateTime> v = isDateTimeBetween(
+      final Validator<DateTime> v = dateTimeBetween(
           leftReference, rightReference,
-          isDateTimeBetweenMsg: (_, __, ___) => errorMsg);
+          dateTimeBetweenMsg: (_, __, ___) => errorMsg);
 
       expect(
         v(rightReference.copyWith()),
@@ -173,7 +173,7 @@ void main() {
         'Should throw AssertionError when the right reference is not after left reference',
         () {
       expect(
-          () => isDateTimeBetween(
+          () => dateTimeBetween(
               DateTime(1990, 12, 23, 20), DateTime(1990, 12, 22, 20)),
           throwsAssertionError);
     });