Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/WenchaoD/FSCalendar
A fully customizable iOS calendar library, compatible with Objective-C and Swift
https://github.com/WenchaoD/FSCalendar
calendar carthage cocoapods ios library objective-c swift
Last synced: 3 months ago
JSON representation
A fully customizable iOS calendar library, compatible with Objective-C and Swift
- Host: GitHub
- URL: https://github.com/WenchaoD/FSCalendar
- Owner: WenchaoD
- License: mit
- Created: 2015-02-15T08:43:09.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2024-01-30T13:12:46.000Z (9 months ago)
- Last Synced: 2024-04-14T08:54:42.097Z (7 months ago)
- Topics: calendar, carthage, cocoapods, ios, library, objective-c, swift
- Language: Objective-C
- Homepage:
- Size: 2.4 MB
- Stars: 10,534
- Watchers: 213
- Forks: 1,914
- Open Issues: 480
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - FSCalendar - A fully customizable iOS calendar library, compatible with Objective-C and Swift. (UI / Calendar)
- awesome-ios-star - FSCalendar - A fully customizable iOS calendar library, compatible with Objective-C and Swift. (UI / Calendar)
- awesome-swift-lib-hunt - FSCalendar - Very good calendar library with its UI, supports Widget Calendar (UI)
- awesome-swift-lib-hunt - FSCalendar - Very good calendar library with its UI, supports Widget Calendar (UI)
- Awesome-iOS - FSCalendar - A fully customizable iOS calendar library, compatible with Objective-C and Swift (UI Components)
README
[](https://cocoapods.org/pods/FSCalendar)
[](https://cocoapods.org/pods/FSCalendar)
[](https://travis-ci.org/WenchaoD/FSCalendar)
[](http://cocoadocs.org/docsets/FSCalendar)
[](http://cocoadocs.org/docsets/FSCalendar)
[](https://github.com/Carthage/Carthage)
[](https://swift.org/package-manager/)
[](#)
# Table of contents
* [Screenshots](#screenshots)
* [Installation](#installation)
* [Pre-knowledge](#pre-knowledge)
* [Support](#support)
* [Contact](#contact)
### iPhone
### iPad
### Safe Orientation
### Today Extension
| iOS8/9 | iOS10 |
|--------------|-------------|
|||
### Interactive Scope Gesture
|  |
| ---- |
### DIY support
|  |
| ------------- |
> To customize your own cell, view DIY Example in `Example-Swift` or `Example-Objc`
### Swipe-To-Choose
|Single-Selection
Swipe-To-Choose|Multiple-Selection
Swipe-To-Choose|DIY
Swipe-To-Choose|
|----------|--------|--------|
||||
|  |  |  |  |
| ------------- | ------------- | ------------- | ------------- |
#### [***More Achievements***](https://github.com/WenchaoD/FSCalendar/wiki/) are available in [***FSCalendar Gallery***](https://github.com/WenchaoD/FSCalendar/wiki/)
## CocoaPods:
* For iOS8+: 👍
```ruby
use_frameworks!
target '' do
pod 'FSCalendar'
end
```
* For iOS7+:
```ruby
target '' do
pod 'FSCalendar'
end
```
> [NSCalendarExtension](https://github.com/WenchaoD/NSCalendarExtension) is required to get iOS7 compatibility.
## Carthage:
* For iOS8+
```ruby
github "WenchaoD/FSCalendar"
```
## SPM:
Add dependency:
```swift
.package(url: "https://github.com/WenchaoD/FSCalendar.git", from: "2.8.4")
```
## Manually:
* Drag all files under `FSCalendar` folder into your project. 👍
> Alternatively to give it a test run, simply press `command+u` in `Example-Objc` or `Example-Swift` and launch the ***UITest Target***.
> Only the methods marked "👍" support IBInspectable / IBDesignable feature. [Have fun with Interface builder](#roll_with_interface_builder)
# Setup
## Use Interface Builder
1、 Drag an UIView object to ViewController Scene
2、 Change the `Custom Class` to `FSCalendar`
3、 Link `dataSource` and `delegate` to the ViewController
4、 Finally, implement `FSCalendarDataSource` and `FSCalendarDelegate` in your `ViewController`
## Or use code
```objc
@property (weak , nonatomic) FSCalendar *calendar;
```
```objc
// In loadView(Recommended) or viewDidLoad
FSCalendar *calendar = [[FSCalendar alloc] initWithFrame:CGRectMake(0, 0, 320, 300)];
calendar.dataSource = self;
calendar.delegate = self;
[self.view addSubview:calendar];
self.calendar = calendar;
```
## Or swift
* To use `FSCalendar` in swift, you need to [Create Bridge Header](https://developer.apple.com/library/ios/documentation/Swift/Conceptual/BuildingCocoaApps/MixandMatch.html) first.
```swift
fileprivate weak var calendar: FSCalendar!
```
```swift
// In loadView or viewDidLoad
let calendar = FSCalendar(frame: CGRect(x: 0, y: 0, width: 320, height: 300))
calendar.dataSource = self
calendar.delegate = self
view.addSubview(calendar)
self.calendar = calendar
```
> To use **FSCalendar** in Swift3, see `Example-Swift` for details.
## Warning
`FSCalendar` ***doesn't*** update frame by itself, Please implement
* For ***AutoLayout***
```objc
- (void)calendar:(FSCalendar *)calendar boundingRectWillChange:(CGRect)bounds animated:(BOOL)animated
{
self.calendarHeightConstraint.constant = CGRectGetHeight(bounds);
// Do other updates here
[self.view layoutIfNeeded];
}
```
* For ***Manual Layout***
```objc
- (void)calendar:(FSCalendar *)calendar boundingRectWillChange:(CGRect)bounds animated:(BOOL)animated
{
calendar.frame = (CGRect){calendar.frame.origin,bounds.size};
// Do other updates here
}
```
* If you are using ***Masonry***
```objc
- (void)calendar:(FSCalendar *)calendar boundingRectWillChange:(CGRect)bounds animated:(BOOL)animated
{
[calendar mas_updateConstraints:^(MASConstraintMaker *make) {
make.height.equalTo(@(bounds.size.height));
// Do other updates
}];
[self.view layoutIfNeeded];
}
```
* If you are using ***SnapKit***
```swift
func calendar(_ calendar: FSCalendar, boundingRectWillChange bounds: CGRect, animated: Bool) {
calendar.snp.updateConstraints { (make) in
make.height.equalTo(bounds.height)
// Do other updates
}
self.view.layoutIfNeeded()
}
```
### Roll with Interface Builder
> In `Swift3`, `NSDate` and `NSDateFormatter` have been renamed to ***Date*** and ***DateFormatter*** , see `Example-Swift` for details.
## How to create NSDate object
* By **NSCalendar**.
```objc
self.gregorian = [NSCalendar calendarWithIdentifier:NSCalendarIdentifierGregorian];
```
Then:
```objc
NSDate *date = [gregorian dateWithEra:1 year:2016 month:9 day:10 hour:0 minute:0 second:0 nanosecond:0];
// 2016-09-10 00:00:00
```
* Or by **NSDateFormatter**
```objc
self.formatter = [[NSDateFormatter alloc] init];
self.formatter.dateFormat = @"yyyy-MM-dd";
```
Then:
```objc
NSDate *date = [self.formatter dateFromString:@"2016-09-10"];
```
## How to print out NSDate object
* Use **NSDateFormatter**
```objc
self.formatter = [[NSDateFormatter alloc] init];
self.formatter.dateFormat = @"yyyy/MM/dd";
```
```objc
NSString *string = [self.formatter stringFromDate:date];
NSLog(@"Date is %@", string);
```
## How to manipulate NSDate with NSCalendar
```objc
self.gregorian = [NSCalendar calendarWithIdentifier:NSCalendarIdentifierGregorian];
```
* Get component of NSDate
```objc
NSInteger era = [self.gregorian component:NSCalendarUnitEra fromDate:date];
NSInteger year = [self.gregorian component:NSCalendarUnitYear fromDate:date];
NSInteger month = [self.gregorian component:NSCalendarUnitMonth fromDate:date];
NSInteger day = [self.gregorian component:NSCalendarUnitDay fromDate:date];
NSInteger hour = [self.gregorian component:NSCalendarUnitHour fromDate:date];
NSInteger minute = [self.gregorian component:NSCalendarUnitMinute fromDate:date];
...
```
* Get next **month**
```objc
NSDate *nextMonth = [self.gregorain dateByAddingUnit:NSCalendarUnitMonth value:1 toDate:date options:0];
```
* Get next **day**
```objc
NSDate *nextDay = [self.gregorain dateByAddingUnit:NSCalendarUnitDay value:1 toDate:date options:0];
```
* Is date in today/tomorrow/yesterday/weekend
```objc
BOOL isToday = [self.gregorian isDateInToday:date];
BOOL isYesterday = [self.gregorian isDateInYesterday:date];
BOOL isTomorrow = [self.gregorian isDateInTomorrow:date];
BOOL isWeekend = [self.gregorian isDateInWeekend:date];
```
* Compare two dates
```objc
BOOL sameDay = [self.gregorian isDate:date1 inSameDayAsDate:date2];
// Yes if the date1 and date2 are in same day
[self.gregorian compareDate:date1 toDate:date2 toUnitGranularity:unit];
// compare the era/year/month/day/hour/minute .etc ...
// return NSOrderAscending/NSOrderSame/NSOrderDecending
BOOL inSameUnit = [self.gregorian isDate:date1 equalToDate:date2 toUnitGranularity:unit];
// if the given unit (era/year/month/day/hour/minute .etc) are the same
```
## Support this repo
* [**★Star**](#) this repo
* Support with 
* Support with 
or
## Contact
* 微博： [**@WenchaoD**](http://weibo.com/WenchaoD)
* Twitter：[**@WenchaoD**](https://twitter.com/WenchaoD)
* QQ支持群:
> If your made a beautiful calendar with this library in your app, please take a screen shot and [@me](https://twitter.com/WenchaoD) in twitter. Your help really means a lot to me!
# License
FSCalendar is available under the MIT license. See the LICENSE file for more info.
### [Documentation](http://cocoadocs.org/docsets/FSCalendar/) | [More Usage](https://github.com/WenchaoD/FSCalendar/blob/master/MOREUSAGE.md) | [简书](http://www.jianshu.com/notebooks/4276521/latest)
