[FSCalendar] 可定制的iOS日历组件 | docs | Interface Builder
链接：WenchaoD/FSCalendar: A fully customizable iOS calendar library, compatible with Objective-C and Swift
（ipad上已经diy用上了，邻居家的小孩很喜欢吃😋）
docs：FSCalendar日历组件
FSCalendar是一款功能强大且高度可定制的iOS日历库，能够帮助开发者轻松实现日历视图集成
提供灵活的网格布局展示日期，支持日期选择等交互操作，并具备丰富的样式定制与动画效果，可流畅切换月/周视图模式。
可视化
章节
- FSCalendarCell (日期单元)
- 日历标题组件
- FSCalendar (主日历)
- FSCalendarAppearance (样式指南)
- FSCalendarDelegationProxy (代理中转)
- 日历集合视图网格
- FSCalendarCalculator (日期计算器)
- FSCalendarTransitionCoordinator (转场协调器)
（文档代码之后有机会窝给它更出来（下次一定bush🕳+1）
目录
截图展示
iPhone效果
iPad效果
安全方向适配
今日扩展
iOS8/9 | iOS10
交互式范围手势
自定义支持
通过DIY示例自定义单元格样式（参见Example-Swift或Example-Objc）
滑动选择演示
单选模式 | 多选模式 | DIY模式
用户成果展示
更多作品详见FSCalendar图库
安装指南
CocoaPods
iOS8+推荐：
use_frameworks!
target '项目名称' dopod 'FSCalendar'
end
iOS7+兼容：
target '项目名称' dopod 'FSCalendar'
end
需配合NSCalendarExtension使用
Carthage
iOS8+：
github "WenchaoD/FSCalendar"
SPM
添加依赖：
.package(url: "https://github.com/WenchaoD/FSCalendar.git", from: "2.8.4")
手动集成
将FSCalendar文件夹所有文件拖入工程（支持IB设计）
或直接运行Example-Objc/Example-Swift中的UITest Target
配置方法
Interface Builder方式
- 添加UIView到ViewController场景
- 修改Custom Class为FSCalendar
- 关联dataSource和delegate
- 实现FSCalendarDataSource和FSCalendarDelegate协议
代码方式
Objective-C：
@property (weak, nonatomic) FSCalendar *calendar;
// 在loadView或viewDidLoad中
FSCalendar *calendar = [[FSCalendar alloc] initWithFrame:CGRectMake(0, 0, 320, 300)];
calendar.dataSource = self;
calendar.delegate = self;
[self.view addSubview:calendar];
self.calendar = calendar;
Swift：
private weak var calendar: FSCalendar!
// 在loadView或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
Swift3需创建Bridge Header，详见Example-Swift
重要提示
FSCalendar不会自动更新frame，需实现以下方法：
自动布局：
- (void)calendar:(FSCalendar *)calendar boundingRectWillChange:(CGRect)bounds animated:(BOOL)animated {self.calendarHeightConstraint.constant = bounds.size.height;[self.view layoutIfNeeded];
}
手动布局：
calendar.frame = (CGRect){calendar.frame.origin, bounds.size};
Masonry：
[calendar mas_updateConstraints:^(MASConstraintMaker *make) {make.height.equalTo(@(bounds.size.height));
}];
SnapKit：
calendar.snp.updateConstraints { make inmake.height.equalTo(bounds.height)
}
基础须知
Swift3中NSDate和NSDateFormatter已重命名为Date和DateFormatter
日期对象操作
创建NSDate：
// 通过日历
self.gregorian = [NSCalendar calendarWithIdentifier:NSCalendarIdentifierGregorian];
NSDate *date = [gregorian dateWithEra:1 year:2016 month:9 day:10 hour:0 minute:0 second:0 nanosecond:0];// 通过格式化
self.formatter = [[NSDateFormatter alloc] init];
self.formatter.dateFormat = @"yyyy-MM-dd";
NSDate *date = [self.formatter dateFromString:@"2016-09-10"];
日期计算：
// 获取下个月/天
NSDate *nextMonth = [gregorian dateByAddingUnit:NSCalendarUnitMonth value:1 toDate:date options:0];
NSDate *nextDay = [gregorian dateByAddingUnit:NSCalendarUnitDay value:1 toDate:date options:0];// 日期判断
BOOL isToday = [gregorian isDateInToday:date];
BOOL isWeekend = [gregorian isDateInWeekend:date];// 日期比较
BOOL sameDay = [gregorian isDate:date1 inSameDayAsDate:date2];
NSComparisonResult result = [gregorian compareDate:date1 toDate:date2 toUnitGranularity:NSCalendarUnitDay];