No release in over 3 years
Datetime Picker for Activeadmin
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

>= 2.9.0, ~> 2.9
~> 5.15, >= 5.15.1
 Project Readme

DateNTimePickerActiveadmin

A datetimepicker, tailored for ActiveAdmin.



Installation

Add this line to your application's Gemfile:

gem 'date_n_time_picker_activeadmin'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install date_n_time_picker_activeadmin



Usage

Code Sample

f.input :column_name, as: :datetimepicker

CSS In active_admin.scss, add the line,

@import date_n_time_picker_activeadmin

JS In active_admin.js, add the line,

//= require date_n_time_picker_activeadmin



Customisations

Add a Minimum Date

Disables all dates before the specified minimum date.

f.input :column_name, as: :datetimepicker, datetimepicker_options: { min_date: Date.today }
Add a Maximum Date

Disables all dates after the specified minimum date.

f.input :column_name, as: :datetimepicker, datetimepicker_options: { max_date: Date.today }
Specify a date format

Displays selected datetime in the specified format.

f.input :column_name, as: :datetimepicker, datetimepicker_options: { format: "%mm-%dd-%yyyy %HH:%MM:%SS %P"}
Example

Consider selected date is 09 August 2021, 05:07:08 pm, then format would be %dd %B %yyyy, %hh:%MM:%SS %p

Format Options Meaning Example
'%d' day (single digit) 9
'%dd' day (2 digits) 09
'%m' month (single digit) 8
'%mm' month (2 digits) 08
'%yy' year (2 digits) 21
'%yyyy' year (4 digits) 2021
'%h' hour (12hr format, single digit) 5
'%hh' hour (12hr format, 2 digits) 05
'%H' hour (24hr format, single digit) 13
'%HH' hour (24hr format, 2 digits) 13
'%M' minutes (single digit) 7
'%MM' minutes (2 digits) 07
'%S' seconds (single digit) 8
'%SS' seconds (2 digits) 08
'%P' time period in upper case AM/PM
'%p' time period in lower case am/pm
'%a' Day in words (short) Thu
'%A' Day in words Thursday
'%b' Month in words (short) Aug
'%B' Month in words August
Exclude Timepicker

Hides the timepicker.

f.input :column_name, as: :datetimepicker, datetimepicker_options: { only_datepicker: true }



Customize CSS

To change the major colors, you can use the following SASS variables:

Variable Name Default Value Description
$date-n-time-picker-primary-color #339AF0 #339AF0 Header and Hover background color
$date-n-time-picker-primary-text-color #FFF #FFF Header and Hover text color
$date-n-time-picker-container-color #FFF #FFF DatetimePicker Container Background color
$date-n-time-picker-container-text-color #323537 #323537 Datetimepicker container Text Color

Please make sure to define these variables before importing the datetimepicker's stylesheet.

For Example,

// active_admin.scss

$date-n-time-picker-primary-color: red; //make sure this comes first, before importing datetimepicker's stylesheet
@import "date_n_time_picker_activeadmin"

Note: All the CSS classes used for the datetimepicker elements can be overridden in your stylesheet. To know more, check the default stylesheet here.



Customise the Toggle Icon

To customize the toggle icon, create a .js file to store the following variables and require it before requiring datetimepicker's javascript file:

Variable Name Default Value Description
toggleTimeIcon <i class="far fa-clock"></i> Stores the element to be displayed as the toggle time icon
toggleCalendarIcon <i class="far fa-calendar-alt"></i> Stores the element to be displayed as the toggle time icon

For Example,

// var.js

var toggleTimeIcon = '<div>TIME</div'
var toggleCalendarIcon = '<div>CALENDAR</div>'

// active_admin.js

//= require var.js //make sure this comes first, before requiring datetimepicker's javascript file
//= require date_n_time_picker_activeadmin.js

Please make sure to define these variables before requiring the datetimepicker's javascript file.



Testing

To run tests,

RAILS_ENV=test rspec spec



Patches/Pull Requests

Bug reports and pull requests are welcome on GitHub at https://github.com/NikhithaGraceJosh/date_n_time_picker_activeadmin. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.

  1. Clone the project
  2. Checkout your own feature (or bug fix) branch from the master branch (git checkout -b my-new-proposed-feature)
  3. Commit the changes (git commit -m 'New Proposed feature')
  4. Push the changes to the my-new-proposed-feature branch (git push origin my-new-proposed-feature)
  5. Create new Pull Request



Code of Conduct

Everyone interacting in the DateNTimePickerActiveadmin project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.



Copyright

Copyright (c) 2021 Nikhitha Grace Josh. See LICSENCE for more details.