https://github.com/nomanr/WeekCalendar

A simple weekly calendar.
https://github.com/nomanr/WeekCalendar

android android-application androidapp calendar week

Last synced: about 2 months ago
JSON representation

A simple weekly calendar.

• Host: GitHub
• URL: https://github.com/nomanr/WeekCalendar
• Owner: nomanr
• Created: 2015-12-08T10:39:07.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2019-03-17T14:59:35.000Z (over 5 years ago)
• Last Synced: 2024-06-16T03:33:45.803Z (3 months ago)
• Topics: android, android-application, androidapp, calendar, week
• Language: Java
• Homepage:
• Size: 5.09 MB
• Stars: 647
• Watchers: 20
• Forks: 128
• Open Issues: 33
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-github-android-ui - WeekCalendar - 提供星期日历的库 (日历时间)

README

        

I AM NOT WORKING ON THIS LIBRARY ANYMORE. I AM NOT VERY PROUD OF THEY WAY I WROTE THIS WIDGET :grin:. I WOULD RECOMMEND TO USE CALENDAR AS A CUSTOM VIEW INSTEAD OF ADDING IT AS GRADLE DEPENDENCY. FORKS + PRS ARE WELCOME. 





WeekCalendar is a library which provides a weekly calendar. 

The sample project includes the usage of the library.

Support for Android 4.0 and up.


Feel free to fork or issue pull requests on github. Issues can be reported on the github issue tracker.



[![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-WeekCalendar-green.svg?style=true)](https://android-arsenal.com/details/1/2905)

Demo




Setup


----------

Gradle


    dependencies {

       compile 'noman.weekcalendar:weekcalendar:1.0.6'

    }

 
Maven


    

      noman.weekcalendar

      weekcalendar

      1.0.6

    

Sample Usage


----------

     

Theme the calendar

There are a few xml attributes to customise the calendar. If you feel that any customization option is missing, let me know.


----------

 - `numOfPages` 

 - `daysTextSize`

 - `daysTextColor`

 - `daysBackgroundColor`

 - `weekTextSize`

 - `weekTextColor`

 - `weekBackgroundColor`

 - `selectedBgColor`

 - `todaysDateBgColor`

 - `todaysDateTextColor`

 - `dayNameLength`

 - `hideNames`

----------

Example


     

Explained


 - `numOfPages`  by default, calendar has 100 pages. You can scroll 49 to left and 49 to right. Using this attribute you can set number of pages. You can send it to 1000, it depends on requirements. 

 - `daysTextSize` day means day of the month. By default text size is `17sp`.

 - `daysTextColor` by default the day text color is set to be white.

 - `daysBackgroundColor` if you have `colorPrimary` attribute in `color.xml`, then the backgroud color will be that one. Otherwise the purple color shown in the demo.

 - `weekTextSize` week means day of the week,i.e (S,M,T ..). By default text size is `17sp`.

 - `weekTextColor` by default the week day text color is set to be white.

 - `weekBackgroundColor`  same as `daysBackgroundColor`

 - `selectedBgColor` By default, its color is set to be `colorAccent`, if you've that attribute in attribute in `color.xml`, then the backgroud color will be that one. Otherwise the pink color shown in the demo.

 - `todaysDateBgColor` todays date background color, same as `selectedBgColor`.

 - `todaysDateTextColor` todays date text color,  by default the text color is set to be white.

 - `dayNameLength` week day name length, `singleLetter` means (S,M,T..) and `threeLetters` means (Sun, Mun, Tue..)

 - `hideNames` , set this attribute to hide name of week days.

----------

Impelement Listener 

`OnDateClickListener` returns `DateTime` object. `DateTime` is class available in Joda Time. I will recommend using this library if you are playing with date and time.


    weekCalendar.setOnDateClickListener(new OnDateClickListener() {

            @Override

            public void onDateClick(DateTime dateTime) {

                Toast.makeText(MainActivity.this, 

                "You Selected " + dateTime.toString(), Toast.LENGTH_SHORT).show();

            }

        });

  See the sample project for usage of methods like 

  - `reset()` 

  - `moveToNext()` 

  - `moveToPrevious()`

  - `setSelectedDate(DateTime)`

  - `setStartDate(DateTime)`

Libraries Used


----------

 - Joda Time

 - Otto

License


----------

    Copyright (c) 2015 Noman Rafique

    Licensed under the Apache License, Version 2.0 (the "License");

    you may not use this file except in compliance with the License.

    You may obtain a copy of the License at

    

    http://www.apache.org/licenses/LICENSE-2.0

    

    Unless required by applicable law or agreed to in writing, software

    distributed under the License is distributed on an "AS IS" BASIS,

    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

    See the License for the specific language governing permissions and

    limitations under the License.