Date Validator

​

Examples

DateTime date = NeoDateValidator.validate("31-10-2024");

try {
  DateTime date = NeoDateValidator.validate("25-12-2023");
  NeoLogger.trace("Valid date: $date");
} catch (e) {
  NeoLogger.error("This is not a valid date", error: e);
}

try {
  DateTime date = NeoDateValidator.validate("25-12-2023");
  NeoDateValidator.validateIsNotFuture(date);
  NeoLogger.trace("Valid past date");
} on FormatException catch (e) {
  NeoLogger.error("This is not a valid date", error: e);
} on ArgumentError catch (e) {
  NeoLogger.error("Date cannot be in the future", error: e);
}

final date = DateTime(2023, 12, 25);
String formatted = NeoDateValidator.format(date); // "25-12-2023"

final dateString = useState("");
final errorMessage = useState<String?>(null);

NeoDateField(
  dateString: dateString.value,
  label: "Birth Date",
  errorText: errorMessage.value,
  onSubmitted: (value) {
    dateString.value = value;
    try {
      final date = NeoDateValidator.validate(value);
      NeoDateValidator.validateIsNotFuture(date);
      errorMessage.value = null;
    } on FormatException catch (e) {
      errorMessage.value = e.message;
    } on ArgumentError catch (e) {
      errorMessage.value = e.message;
    }
  },
),

​

Methods

​

NeoDateValidator.validate()

​

Parameters

​

Return Value

​

Exceptions

​

NeoDateValidator.validateIsBefore()

​

Parameters

​

Exceptions

​

NeoDateValidator.validateIsAfter()

​

Parameters

​

Exceptions

​

NeoDateValidator.validateIsInRange()

​

Parameters

​

Exceptions

​

NeoDateValidator.validateIsNotFuture()

​

Parameters

​

Exceptions

​

NeoDateValidator.validateIsNotPast()

​

Parameters

​

Exceptions

​

NeoDateValidator.format()

​

Parameters

​

Return Value

​

Best Practices

• Handle exceptions properly: Use try-catch blocks to handle FormatException and ArgumentError separately
• Combine validation methods: Chain multiple validations for comprehensive date checking
• Use in form callbacks: Validate in onSubmitted callbacks for immediate feedback
• Implement business rules: Combine with custom validation logic for application-specific requirements

​

Integration Notes

• Detailed error messages: Provides specific error messages that can be displayed directly to users
• NeoDateField integration: Designed to work seamlessly with the string-based NeoDateField API