{"id":13850594,"url":"https://github.com/benignware/date_picker","last_synced_at":"2025-08-10T01:33:01.800Z","repository":{"id":30775232,"uuid":"34332011","full_name":"benignware/date_picker","owner":"benignware","description":"Rails DatePicker-Integration","archived":false,"fork":false,"pushed_at":"2018-03-24T19:05:22.000Z","size":6441,"stargazers_count":3,"open_issues_count":1,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-07-27T01:20:59.063Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/benignware.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"MIT-LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-04-21T14:29:31.000Z","updated_at":"2018-08-18T23:35:14.000Z","dependencies_parsed_at":"2022-08-26T16:42:23.705Z","dependency_job_id":null,"html_url":"https://github.com/benignware/date_picker","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/benignware/date_picker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benignware%2Fdate_picker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benignware%2Fdate_picker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benignware%2Fdate_picker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benignware%2Fdate_picker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/benignware","download_url":"https://codeload.github.com/benignware/date_picker/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benignware%2Fdate_picker/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269631157,"owners_count":24450144,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-09T02:00:10.424Z","response_time":111,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-04T20:01:19.913Z","updated_at":"2025-08-10T01:33:01.724Z","avatar_url":"https://github.com/benignware.png","language":"Ruby","funding_links":[],"categories":["Ruby"],"sub_categories":[],"readme":"# date_picker\n\u003e Rails DatePicker-Integration\n\n* Supports [bootstrap-datetimepicker](https://github.com/Eonasdan/bootstrap-datetimepicker), [flatpickr](https://chmln.github.io/flatpickr/), [jqueryui-datepicker](https://jqueryui.com/datepicker/) and [pickadate](http://amsul.ca/pickadate.js/)\n* Seamless i18n-Integration\n* FormBuilder- and SimpleForm-Helpers for date, datetime and time-attributes\n* HTML5-Fallback on Mobile\n\n## Install\n\nAdd the following to your Gemfile:\n\n```cli\ngem 'date_picker'\n```\n\nDatePicker does not bundle any third-party assets. \nIt is recommended to utilize a package manager to download client-side dependencies.\nExamples assume, you're using [bower](http://bower.io). \n\nIntegrate bower into your rails-app by running `bower init` from command-line:\n\n```cli\nbower init\n```\n\nCreate a `.bowerrc`-file to point bower's installation directory to `vendor/assets/components`:\n```json\n{\n  \"directory\": \"vendor/assets/components\"\n}\n```\n\nAdd bower components to asset paths:\n```ruby\n# config/application.rb\nconfig.assets.paths \u003c\u003c Rails.root.join('vendor', 'assets', 'components')\n```\n\n\n### Bootstrap DateTimePicker\n\n[bootstrap-datetimepicker](https://github.com/Eonasdan/bootstrap-datetimepicker)\n\nRun the config-generator\n\n```cli\nrails g date_picker:config :bootstrap\n```\n\nInstall dependencies via bower\n\n```cli\nbower install bootstrap --save\nbower install eonasdan-bootstrap-datetimepicker --save\n```\n\nRequire javascript dependencies\n\n```javascript\n// app/assets/javascripts/application.js\n//= require jquery/dist/jquery.min\n//= require moment/min/moment-with-locales.min\n//= require moment-timezone/builds/moment-timezone-with-data.min\n//= require moment/min/locales.min\n//= require eonasdan-bootstrap-datetimepicker/build/js/bootstrap-datetimepicker.min\n```\n\nRequire css dependencies\n\n```css\n/* app/assets/stylesheets/application.css\n *= require bootstrap/dist/css/bootstrap.min\n *= require eonasdan-bootstrap-datetimepicker/build/css/bootstrap-datetimepicker.min\n */\n```\n\n### Flatpickr\n\n[flatpickr](https://chmln.github.io/flatpickr/)\n\nRun the config-generator\n\n```cli\nrails g date_picker:config :flatpickr\n```\n\nInstall dependencies via bower\n\n```cli\nbower install flatpickr-calendar --save\n```\n\nRequire javascript dependencies\n\n```javascript\n// app/assets/javascripts/application.js\n//= require flatpickr/dist/flatpickr.min\n//= require flatpickr/src/flatpickr.l10n.de\n```\n\nRequire css dependencies\n\n```css\n/* app/assets/stylesheets/application.css\n *= require flatpickr/dist/flatpickr.min\n */\n```\n\n### jQueryUI DatePicker\n\n[jqueryui-datepicker](https://jqueryui.com/datepicker/)\n\nRun the config-generator using `:jquery_ui`\n```cli\nrails g date_picker:config :jquery_ui\n```\n\nInstall dependencies via bower\n```cli\nbower install jquery-ui --save\n```\n\nRequire javascript dependencies\n\n```javascript\n// app/assets/javascripts/application.js\n//= require jquery/dist/jquery.min\n//= require jquery-ui/jquery-ui.min\n```\n\nRequire css dependencies\n\n```css\n/* app/assets/stylesheets/application.css\n *= require jquery-ui/themes/smoothness/jquery-ui.min\n *= require jquery-ui/themes/smoothness/theme\n */\n```\n\n### PickADate\n\n[pickadate](http://amsul.ca/pickadate.js/)\n\n\nRun the config-generator\n```cli\nrails g date_picker:config :pickadate\n```\n\nInstall dependencies via bower\n```cli\nbower install pickadate --save\n```\n\nRequire javascript dependencies\n\n```javascript\n// app/assets/javascripts/application.js\n//= require jquery/dist/jquery.min\n//= require pickadate/lib/compressed/picker\n//= require pickadate/lib/compressed/picker.date\n//= require pickadate/lib/compressed/picker.time\n```\n\nRequire css dependencies\n\n```css\n/* app/assets/stylesheets/application.css\n *= require pickadate/lib/themes/classic\n *= require pickadate/lib/themes/classic.date\n *= require pickadate/lib/themes/classic.time\n */\n```\n\n\n## Form helpers\n\nThe date_picker-Module provides tag helpers, form-builder helpers and simple_form-helpers for attributes of type `:date`, `:datetime` and `:time`.\n\n\u003e Please note that jqueryui-datepicker can only handle dates, while bootstrap-datetimepicker also supports attributes of type `:datetime` and `:time`. Form helpers will fall back to the corresponding standard-rails date_select-helpers. \n\n### FormTagHelper\n\nUse the form-tag-helper for non-model purposes:  \n```erb\ndate_picker_tag(name, value, options = {})\ndatetime_picker_tag(name, value, options = {})\ntime_picker_tag(name, value, options = {})\n```\n\n### FormBuilder\n\nScaffold an example model and migrate database:\n```cli\nrails g scaffold Event date:date datetime:datetime time:time\nrake db:migrate\n```\n\u003csub\u003eIf you're using Bootstrap, make sure to exclude generated `scaffold.css` because it may affect datepicker-styles undesirably. You may also want to add `form-group` to the field element's class\u003c/sub\u003e\n\n\nAdd date_picker-helpers to form-view: \n```erb\n\u003c%# app/views/events/_form.html.erb %\u003e\n\u003c%= form_for(@event) do |f| %\u003e\n  \u003cdiv class=\"field\"\u003e\n    \u003c%= f.label :date %\u003e\u003cbr\u003e\n    \u003c%= f.date_picker :date %\u003e\n  \u003c/div\u003e\n  \u003cdiv class=\"field\"\u003e\n    \u003c%= f.label :datetime %\u003e\u003cbr\u003e\n    \u003c%= f.datetime_picker :datetime %\u003e\n  \u003c/div\u003e\n  \u003cdiv class=\"field\"\u003e\n    \u003c%= f.label :time %\u003e\u003cbr\u003e\n    \u003c%= f.time_picker :time %\u003e\n  \u003c/div\u003e\n  \u003cdiv class=\"actions\"\u003e\n    \u003c%= f.submit %\u003e\n  \u003c/div\u003e\n\u003c% end %\u003e\n```\n\n\n### SimpleForm\n\nMake sure, you added [simple_form](https://github.com/plataformatec/simple_form) to your bundle and have run the install-generator, i.e. `rails g simple_form:install --bootstrap`.\n\nRun date_picker's simple_form-generator in order to create the date_picker-component:\n```cli\nrails g date_picker:simple_form\n```\nThis will create a custom-input `date_picker`. You may choose a different name by adding it to the command, e.g. `datetime` will override simple_form's default datetime-component.\n```cli\nrails g date_picker:simple_form date_time\n```\n\nAdjust the form to use simple_form-builder:\n```erb\n\u003c%= simple_form_for(@event) do |f| %\u003e\n  \u003c%# ... %\u003e\n  \u003cdiv class=\"field form-group\"\u003e\n    \u003c%= f.input :date %\u003e\n  \u003c/div\u003e\n  \u003cdiv class=\"field form-group\"\u003e\n    \u003c%= f.input :datetime %\u003e\n  \u003c/div\u003e\n  \u003cdiv class=\"field form-group\"\u003e\n    \u003c%= f.input :time %\u003e\n  \u003c/div\u003e\n  \u003cdiv class=\"actions\"\u003e\n    \u003c%= f.submit %\u003e\n  \u003c/div\u003e\n\u003c% end %\u003e\n```\n\n### Options\n\n\u003ctable\u003e\n  \u003cthead\u003e\n    \u003ctr\u003e\n      \u003cth\u003eName\u003c/th\u003e\n      \u003cth\u003eDescription\u003c/th\u003e\n    \u003c/tr\u003e\n  \u003c/thead\u003e\n  \u003ctbody\u003e\n    \u003ctr\u003e\n      \u003ctd\u003etype\u003c/td\u003e\n      \u003ctd\u003eData type. One of `:date`, `:datetime` or `:time`\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003edefault\u003c/td\u003e\n      \u003ctd\u003eSpecify default date.\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003eformat\u003c/td\u003e\n      \u003ctd\u003eProvide a strftime-pattern or an i18n-identifier.\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003emax\u003c/td\u003e\n      \u003ctd\u003eSpecify maximum date\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003emin\u003c/td\u003e\n      \u003ctd\u003eSpecify minimum date\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003etime_zone\u003c/td\u003e\n      \u003ctd\u003eSpecify whether to include timezone-offset in format. Defaults to `false`.\u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/tbody\u003e\n\u003c/table\u003e\n\nAll other options are passed as html-options to text_field-element. All `data-attributes` are passed to the javascript date_picker-implementation. \n\n\n## Internationalization\n\nInstall `rails-i18n`-gem to get a basic support for many languages.\n```\n# Gemfile\ngem 'rails-i18n', '~\u003e 4.0.0' # For 4.0.x\n```\n\nDefine date and time formats in yml locale:\n```\n# config/locales/en.yml\nen:\n  date:\n    formats:\n      default: \"%Y-%m-%d\"\n  time:\n    formats:\n      default: \"%a, %d %b %Y %H:%M:%S %z\"\n      only_time: \"%H:%M:%S %z\"\n```\n\nYou may want to change the default i18n-identifier names by editing the configuration:\n\n```rb\n# config/initializers/date_picker.rb\nDatePicker.configure do |config|\n  config.formats = {\n    date: :default,\n    datetime: :default,\n    time: :only_time\n  }\nend\n```\n\n## Mobile\nOn mobile devices the plugin falls back to date_field-helpers using html5-input-types.\n\n\n## Changelog\nSee the [Changelog](CHANGELOG.md) for recent enhancements, bugfixes and deprecations.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbenignware%2Fdate_picker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbenignware%2Fdate_picker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbenignware%2Fdate_picker/lists"}