{"id":18483839,"url":"https://github.com/rspective/pagerdatepicker","last_synced_at":"2025-04-08T18:32:54.519Z","repository":{"id":28947661,"uuid":"32473620","full_name":"rspective/PagerDatePicker","owner":"rspective","description":"PagerDatePicker for Android","archived":false,"fork":false,"pushed_at":"2017-04-17T09:02:52.000Z","size":1262,"stargazers_count":80,"open_issues_count":8,"forks_count":29,"subscribers_count":24,"default_branch":"master","last_synced_at":"2025-03-23T17:12:31.549Z","etag":null,"topics":["android","datepicker","ui"],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rspective.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-03-18T17:27:08.000Z","updated_at":"2023-06-27T12:29:13.000Z","dependencies_parsed_at":"2022-09-05T11:50:15.647Z","dependency_job_id":null,"html_url":"https://github.com/rspective/PagerDatePicker","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rspective%2FPagerDatePicker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rspective%2FPagerDatePicker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rspective%2FPagerDatePicker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rspective%2FPagerDatePicker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rspective","download_url":"https://codeload.github.com/rspective/PagerDatePicker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247902654,"owners_count":21015490,"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","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":["android","datepicker","ui"],"created_at":"2024-11-06T12:37:33.787Z","updated_at":"2025-04-08T18:32:49.510Z","avatar_url":"https://github.com/rspective.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PagerDatePicker\n\n### Version: 1.2.0\n\n[![License](https://img.shields.io/badge/license-Apache%202-blue.svg)](https://www.apache.org/licenses/LICENSE-2.0) [![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-PagerDatePicker-brightgreen.svg?style=flat)](http://android-arsenal.com/details/1/1710)\n\n### Description\nPagerDatePicker is a library for Android which allows to setup horizontal (for now;)) date list picker. It is a combination of few main Android components:\n* android.support.v7.widget.RecyclerView\n* android.support.v4.view.ViewPager\n* android.support.v4.app.FragmentStatePagerAdapter\n* android.support.v7.widget.RecyclerView.Adapter\n\nNotice that PagerDatePicker is a project under development.\n\n#### Welcome to fork and pull request.\n\n### Features\n\n#### XML attributes:\nSupport date format MM-dd-yyyy\n\n```xml\n    \u003cattr name=\"date_start\" format=\"string\"/\u003e\n    \u003cattr name=\"date_end\" format=\"string\"/\u003e\n    \u003cattr name=\"default_day_selection\" format=\"string\"/\u003e\n```\n\n#### API\n* Animations\nYou can assign animation for selected day. This could be set for whole date item view or just for single one. To achieve this you have to load and assign animation to the adapter:\n\n```java\ndateAdapter.setCurrentViewAnimation(AnimationUtils.loadAnimation(CONTEXT, ANIM_ID_FOR_YOUR_ANIMATION));\n```\n\nTo select which view has to be animated you have to override below method in your ViewHolder\n```java\nprotected abstract View getCurrentViewToAnimate();\n```\n\n#### Deafult and custom date adapter\nIf default date item is not enough for you don't worry, you can create your own custom date adapter where you can apply default style/view/functions to your date item.\n\n##### Things to know:\n - You have to create your custom adapter which has to extend AbsDateAdapter\n - Your view holder has to extend AbsDateItemHolder\n - Implement required methods and add your own if you need\n\nTo check details, please see demo app.\n\n### Screenshot\n![image](art/app_1.1.0.gif)\n\n\u003ca href=\"https://play.google.com/store/apps/details?id=pl.rspective.pagerdatepicker.sample\"\u003e\n  \u003cimg alt=\"Get it on Google Play\"\n       src=\"https://developer.android.com/images/brand/pl_generic_rgb_wo_60.png\" /\u003e\n\u003c/a\u003e\n\n### Quick Setup（Basic Usage)\n\n##### 1.Integration\n###### Gradle\n```xml\ndependencies {\n    compile 'pl.rspective.pagerdatepicker:pagerdatepicker:1.2.0'\n}\n```\n\n##### 2.Usage (for default date adapter)\nPlease note, that supported date format is MM-dd-yyyy\n\n###### 1. Add picker and pager to your view\n```xml\n\u003cpl.rspective.pagerdatepicker.view.DateRecyclerView\n    android:id=\"@+id/date_list\"\n    android:layout_width=\"match_parent\"\n    android:layout_height=\"100dp\"\n    android:background=\"#ff343434\"/\u003e\n\n\u003candroid.support.v4.view.ViewPager\n   android:id=\"@+id/pager\"\n   android:layout_width=\"match_parent\"\n   android:layout_height=\"match_parent\"\n   android:layout_below=\"@id/date_list\"/\u003e\n```\n\n###### 2. Add item decoration for your picker (OPTIONAL)\n\nYou can do this in two ways:\n```java\ndateList.addItemDecoration(new RecyclerViewInsetDecoration(this);\n```\nDefault insets is 1dp\n\n```java\ndateList.addItemDecoration(new RecyclerViewInsetDecoration(this, R.dimen.date_card_insets));\n```\nAdd your own insets value\n\n###### 3. Create deafult adapter with date range and assign it to our picker\n\n```java\ndateList.setAdapter(new DefaultDateAdapter(start, end));\n```\n\n###### 4. Init pager adapter and assign it to our datepicker\n\n```java\nDatePagerFragmentAdapter fragmentAdapter = new DatePagerFragmentAdapter(getSupportFragmentManager(), dateList.getDateAdapter()) {\n    @Override\n    protected Fragment getFragment(int position, long date) {\n        return ...\n    }\n};\n\npager.setAdapter(fragmentAdapter);\ndateList.setPager(pager);\n```\n\n###### 5. We are almost there. Now you have to assign a listener to your picker\n```java\ndateList.setDatePickerListener(new DateRecyclerView.DatePickerListener() {\n    @Override\n    public void onDatePickerItemClick(DateItem dateItem, int position) {\n        //User clicked date item from top date picker\n    }\n\n    @Override\n    public void onDatePickerPageSelected(int position) {\n        //User changed date using swipe (left/right)\n    }\n\n    @Override\n    public void onDatePickerPageStateChanged(int state) {\n        //User changed page\n    }\n\n    @Override\n    public void onDatePickerPageScrolled(int position, float positionOffset, int positionOffsetPixels) {\n        //User changed page\n    }\n});\n```\n\nIf you want to change the default color, just override below colors in your colors.xml:\n```xml\n\u003ccolor name=\"date_item_unselected_indicator\"\u003e#ff5c5c5c\u003c/color\u003e\n\u003ccolor name=\"date_item_selected_indicator\"\u003e#ffff353b\u003c/color\u003e\n\n\u003ccolor name=\"date_item_background\"\u003e#ff373737\u003c/color\u003e\n\u003ccolor name=\"date_item_month_name\"\u003e#ffd5d5d5\u003c/color\u003e\n\u003ccolor name=\"date_item_day_name\"\u003e#ff9a9a9a\u003c/color\u003e\n\u003ccolor name=\"date_item_day\"\u003e#FFFFFFFF\u003c/color\u003e\n```\n\n#### If you want to see more details, go ahead and check the demo!\n\n### Assets\nDemo launcher icon was made by [jerrylow](https://www.iconfinder.com/jerrylow)\n\nLicense\n--------\n\n    Copyright 2015 RSPECTIVE P RYCHLIK SPÓŁKA JAWNA\n\n    Licensed under the Apache License, Version 2.0 (the \"License\");\n    you may not use this file except in compliance with the License.\n    You may obtain a copy of the License at\n\n       http://www.apache.org/licenses/LICENSE-2.0\n\n    Unless required by applicable law or agreed to in writing, software\n    distributed under the License is distributed on an \"AS IS\" BASIS,\n    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n    See the License for the specific language governing permissions and\n    limitations under the License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frspective%2Fpagerdatepicker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frspective%2Fpagerdatepicker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frspective%2Fpagerdatepicker/lists"}