@activeadmin-plugins/active_admin_datetimepicker

中文文档
2.1.0发布于 2026/10/03MITCommonJS近 30 天下载 1.8万

Integrate jQuery xdan datetimepicker plugin to ActiveAdmin

原始使用文档
文档目录5 节
  1. Installation
  2. Usage
  3. Override behaviour in initializer
  4. Change datetime format
  5. Contributing

Gem Version NPM Version npm CI Coverage

ActiveAdminDatetimepicker

Adds XDSoft's DateTime picker as a date_time_picker input for forms, and date_time_range for filters.

ActiveAdminDatetimepicker

Installation

Add this line to your application's Gemfile:

gem 'active_admin_datetimepicker'

And then execute:

$ bundle

Or install it yourself as:

$ gem install active_admin_datetimepicker
Using assets via Sprockets

Add the following line into app/assets/stylesheets/active_admin.scss:

@import "active_admin_datetimepicker";

Add the following line into app/assets/javascripts/active_admin.js:

//= require active_admin_datetimepicker
Using assets via NPM/Yarn

Execute:

$ npm i @activeadmin-plugins/active_admin_datetimepicker

Or

$ yarn add @activeadmin-plugins/active_admin_datetimepicker

Or add manually to package.json:

"dependencies": {
  "@activeadmin-plugins/active_admin_datetimepicker": "latest"
}

and execute:

$ yarn

Add the following line into app/assets/javascripts/active_admin.js:

import '@activeadmin-plugins/active_admin_datetimepicker';

Add the following line into app/assets/stylesheets/active_admin.scss:

@import '@activeadmin-plugins/active_admin_datetimepicker';

Usage

This plugin adds the date_time_picker input and date_time_range filter, which use the XDSoft DateTime Picker.

The date_time_picker input accepts many of the options available to the standard jQueryUI Datepicker. For example:

  # Index page filters
  filter :created_at, as: :date_time_range

  # New/Edit form
  form do |f|
    f.input :starts_at, as: :date_time_picker, datepicker_options: { min_date: "2013-10-8",        max_date: "+3D" }
    f.input :ends_at,   as: :date_time_picker, datepicker_options: { min_date: 3.days.ago.to_date, max_date: "+1W +5D" }
  end

Override behaviour in initializer

# This if for the front-end JavaScript side
ActiveAdminDatetimepicker::Base.default_datetime_picker_options = {
    defaultDate: proc { Time.current.strftime("%Y-%m-%d 00:00") }
}
# This if for the Ruby backend
ActiveAdminDatetimepicker::Base.format = "%Y-%m-%d %H:%M:%S"

Change datetime format

If you want to change the format you need to make sure that front-end and back-end formats are identical. And remember JS and Ruby datetime format have different syntaxes.

Create configuration file config/initializers/init_datetimepicker.rb:

# Example "11/03/2016 13:00"
ActiveAdminDatetimepicker::Base.default_datetime_picker_options = {
    format: 'd/m/Y H:i', # JS format
    defaultTime: proc { Time.current.strftime('%H:00') } # not necessary
}
ActiveAdminDatetimepicker::Base.format = "%d/%m/%Y %H:%M" # Ruby format

See the datetimepicker documentation for more details.

Contributing

  1. Fork it ( https://github.com/activeadmin-plugins/active_admin_datetimepicker/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

版本与发布记录

@activeadmin-plugins/active_admin_datetimepicker 共发布 3 个版本,首次发布于 2022/04/15;过去 12 个月发布了 2 个版本。

版本发布日期距今
2.1.0latest2026/10/031 个月前
2.0.02026/04/086 个月前
1.0.02022/04/154 年前

关于 @activeadmin-plugins/active_admin_datetimepicker 的常见问题

@activeadmin-plugins/active_admin_datetimepicker 是什么?

Integrate jQuery xdan datetimepicker plugin to ActiveAdmin

如何安装 @activeadmin-plugins/active_admin_datetimepicker?

在项目目录运行 npm install @activeadmin-plugins/active_admin_datetimepicker,或使用 pnpm add / yarn add / bun add。

@activeadmin-plugins/active_admin_datetimepicker 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/activeadmin-plugins__active_admin_datetimepicker 是否存在。

@activeadmin-plugins/active_admin_datetimepicker 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@activeadmin-plugins/active_admin_datetimepicker 可以商用吗?

@activeadmin-plugins/active_admin_datetimepicker 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@activeadmin-plugins/active_admin_datetimepicker 的下载量有多少?

根据 npm 官方下载统计,@activeadmin-plugins/active_admin_datetimepicker 在 2026/10/05 – 2026/11/03 这 30 天内被下载 18,415 次,日均约 614 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@activeadmin-plugins/active_admin_datetimepicker 还在维护吗?

最新版本 2.1.0 发布于 2026/10/03(1 个月前);至今共发布 3 个版本,其中过去 12 个月发布了 2 个;首次发布于 2022/04/15。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。