{"id":13643463,"url":"https://github.com/memfis19/Cadar","last_synced_at":"2025-04-21T01:32:53.990Z","repository":{"id":201838080,"uuid":"74478601","full_name":"memfis19/Cadar","owner":"memfis19","description":"Android solution which represents month and list calendar views.","archived":false,"fork":false,"pushed_at":"2017-08-09T11:37:59.000Z","size":7687,"stargazers_count":359,"open_issues_count":6,"forks_count":48,"subscribers_count":8,"default_branch":"master","last_synced_at":"2024-11-09T15:42:46.803Z","etag":null,"topics":["android","calendar","calendar-view","events","listview","month-view","repeat-period"],"latest_commit_sha":null,"homepage":"","language":"Java","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/memfis19.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2016-11-22T14:08:34.000Z","updated_at":"2024-11-02T04:42:37.000Z","dependencies_parsed_at":null,"dependency_job_id":"949b1678-d0d6-4c53-95de-27b6a3fd9236","html_url":"https://github.com/memfis19/Cadar","commit_stats":null,"previous_names":["memfis19/cadar"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/memfis19%2FCadar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/memfis19%2FCadar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/memfis19%2FCadar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/memfis19%2FCadar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/memfis19","download_url":"https://codeload.github.com/memfis19/Cadar/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249982649,"owners_count":21355737,"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","calendar","calendar-view","events","listview","month-view","repeat-period"],"created_at":"2024-08-02T01:01:47.971Z","updated_at":"2025-04-21T01:32:48.976Z","avatar_url":"https://github.com/memfis19.png","language":"Java","funding_links":[],"categories":["日历时间"],"sub_categories":[],"readme":"# Cadar\n\n[ ![Download](https://api.bintray.com/packages/m-e-m-f-i-s/io.github.memfis19/cadar/images/download.svg) ](https://bintray.com/m-e-m-f-i-s/io.github.memfis19/cadar/_latestVersion)\n[![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-Cadar-brightgreen.svg?style=flat)](http://android-arsenal.com/details/1/4783) [![Build Status](https://travis-ci.org/memfis19/Cadar.svg?branch=master)](https://travis-ci.org/memfis19/Cadar)\n\nAndroid solution which represents month and list calendars views and possibility to display events: just set of events and recurrent as well, but with limitations. For events processing I am using \u003ca href=\"https://github.com/ical4j/ical4j\"\u003eIcal4J\u003c/a\u003e library.\u003c/br\u003e\n\n\u003cimg src=\"https://github.com/memfis19/Cadar/blob/master/art/list_calendar.png\" width=\"200px\" /\u003e \u003cimg src=\"https://github.com/memfis19/Cadar/blob/master/art/month_calendar.png\" width=\"200px\" /\u003e \u003cimg src=\"https://github.com/memfis19/Cadar/blob/master/art/interaction_anim.gif\" width=200px/\u003e\n\n## Example of most common using:\n##### Add to your layout:\n\n```\n \u003cio.github.memfis19.cadar.view.MonthCalendar\n        android:id=\"@+id/monthCalendar\"\n        android:layout_width=\"match_parent\"\n        android:layout_height=\"300dp\" /\u003e\n```\n##### Using in code:\n```\nMonthCalendarConfiguration.Builder builder = new MonthCalendarConfiguration.Builder(this);\nmonthCalendar.setCalendarPrepareCallback(this);\nmonthCalendar.prepareCalendar(builder.build());\n\nmonthCalendar.setOnDayChangeListener(new OnDayChangeListener() {\n    @Override\n    public void onDayChanged(Calendar calendar) {\n        Toast.makeText(MonthCalendarActivity.this, calendar.getTime().toString(), Toast.LENGTH_SHORT).show();\n      }\n    });\nmonthCalendar.setOnMonthChangeListener(new OnMonthChangeListener() {\n    @Override\n    public void onMonthChanged(Calendar calendar) {\n        Toast.makeText(MonthCalendarActivity.this, calendar.getTime().toString(), Toast.LENGTH_SHORT).show();\n      }\n    });\n...\n\n@Override\npublic void onCalendarReady(CalendarController calendar) {\n   monthCalendar.displayEvents(events, new DisplayEventCallback() {\n   @Override\n     public void onEventsDisplayed() {\n\n     }\n });\n}\n```\n##### Don't forget to release calendar:\n```\n@Override\nprotected void onDestroy() {\n   super.onDestroy();\n   monthCalendar.releaseCalendar();\n}\n```\n#### For more specific using please look at sample project.\n\n## Events processing:\nEvents processing implemented in most simple way, each event has start date - date of start and end date - date of event end. Please notice that event does not have duration. so there is not exist stop date. Each event next periods for recurrency processting: none, every week, every 2 week, every 3 week, every 4 week, every month, every year. If event does npt have end date and repeat period set to none, that will single event, in case even has any other repeat period without end date, it will be endless event. \n\nMonth and list calendars limited in time, by defualt they displayed for 3 years. You are able to extend it via calendar configurations. In case if you want to use list and month calendars coupled, then you need to keep the same configuration settings for them.\n\n#### One more important thing to know about event processing\nIn some cases during event processing, periods of calculaction may overlap and in this case events can be duplicated, to avoid this please override ```equals()``` and ```hashCode()``` methods in your model class which implements ```Event```. For more details please look at sample source code.\n\n## How to add to your project?\n```\ncompile 'io.github.memfis19:cadar:0.4.8'\n```\n\n## Know issues\n-Library has not release yet, so it will be extended in future.\u003c/br\u003e\n-Not full documentation will be fixed soon.\n\n## Roadmap\n-Add more documentation;\u003c/br\u003e\n-Extend event's recurring settings;\u003c/br\u003e\n-Add more tools to customize list calendar UI.\n\n## Bugs and Feedback\nFor bugs, feature requests, and discussion please use \u003ca href=\"https://github.com/memfis19/Cadar/issues\"\u003eGitHub Issues\u003c/a\u003e.\n\n# [LICENSE](/LICENSE.md)\n\n###### MIT License\n\n###### Copyright (c) 2016 Rodion Surzhenko\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmemfis19%2FCadar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmemfis19%2FCadar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmemfis19%2FCadar/lists"}