ValidatesTimeliness 使用与安装指南

安装指南

在 Gemfile 中添加以下代码：

gem 'validates_timeliness', '~> 7.0.0.beta1'

然后运行以下命令安装：

$ bundle install

接着执行以下命令：

$ rails generate validates_timeliness:install

此命令将创建配置初始化程序和本地化文件。在初始化程序中，您可以自定义插件的各种配置选项。

使用说明

要在模型中验证日期、时间或日期时间属性，请使用相应的验证方法。以下是一些示例：

validates_datetime :occurred_at

validates_date :date_of_birth, before: lambda { 18.years.ago },
                              before_message: "必须至少18岁"

validates_datetime :finish_time, after: :start_time # 方法符号

validates_date :booked_at, on: :create, on_or_after: :today # 请参阅限制简写。

validates_time :booked_at, between: ['9:00am', '5:00pm'] # 在9:00AM之后和5:00PM之前
validates_time :booked_at, between: '9:00am'..'5:00pm' # 与前一个示例相同
validates_time :booked_at, between: '9:00am'...'5:00pm' # 在9:00AM之后且严格在5:00PM之前

validates_time :breakfast_time, on_or_after: '6:00am',
                                 on_or_after_message: '必须在开门时间之后',
                                 before: :lunchtime,
                                 before_message: '必须在午餐时间之前'

项目API使用文档

以下是一些可用的验证方法：

• validates_date：验证值是否为日期
• validates_time：验证值是否为时间（例如 '12:20pm'）
• validates_datetime：验证值是否为完整的日期和时间
• validates：使用 :timeliness 键并设置哈希中的类型

验证方法接受通常的选项以及一些特定的选项来限制允许的日期或时间范围。

时间选项（或限制）包括：

• :is_at：属性值必须等于指定值才有效
• :before：属性值必须在指定值之前才有效
• :on_or_before：属性值可以等于或早于指定值才有效
• :after：属性值必须在指定值之后才有效
• :on_or_after：属性值可以等于或晚于指定值才有效
• :between：属性值必须在两个值之间才有效

常规验证选项包括：

• :allow_nil：允许 nil 值有效
• :allow_blank：允许 nil 或空字符串值有效
• :if：当 :if 条件评估为真时执行验证
• :unless：当 :unless 条件评估为假时执行验证
• :on：指定验证上下文，例如 :save、:create 或 :update。默认为 :save。

特殊选项包括：

• :ignore_usec：忽略微秒值在日期时间限制上
• :format：限制验证为单一格式，对于特殊情况需要插件解析器

项目安装方式

如上所述，通过在 Gemfile 中添加依赖，然后运行 bundle install 和 rails generate validates_timeliness:install 来安装项目。

确保阅读和遵循上述安装指南以正确设置和配置 ValidatesTimeliness 插件。