FSCalendar使用前的必修课NSCalendar与NSDate核心技巧详解【免费下载链接】FSCalendarA fully customizable iOS calendar library, compatible with Objective-C and Swift项目地址: https://gitcode.com/gh_mirrors/fs/FSCalendarFSCalendar 是一款高度可定制的 iOS 日历控件兼容 Objective-C 与 Swift而它几乎全部对外接口都围绕NSDate展开。在正式使用 FSCalendar 之前先把NSCalendar 与 NSDate这两个 Foundation 日期类搞明白你的日历开发之路将少走 90% 的坑。为什么必须先懂 NSCalendar 与 NSDate打开 FSCalendar.h 你会发现FSCalendar 的核心属性几乎全是日期类型today、currentPage、minimumDate、maximumDate、selectedDate(s)都是NSDatetimeZone、locale决定了日历的时区与文案语言选中、范围限制、翻页……全部依赖日期运算而日期运算不能自己写加减毫秒必须交给NSCalendar。官方内部就是这么做的——在 FSCalendar.m 中控件初始化了一个格里高利历实例_gregorian [[NSCalendar alloc] initWithCalendarIdentifier:NSCalendarIdentifierGregorian]; _today [self.gregorian startOfDayForDate:[NSDate date]]; 记住一个心智模型NSDate 负责表示一个时间点NSCalendar 负责理解它。快速创建 NSCalendar 的 3 个要点NSCalendar *gregorian [NSCalendar calendarWithIdentifier:NSCalendarIdentifierGregorian]; gregorian.firstWeekday 2; // 让周一成为每周第一列 gregorian.timeZone [NSTimeZone timeZoneForSecondsFromGMT:0];用公历标识符创建绝大多数日历应用都用NSCalendarIdentifierGregorian。设置 firstWeekday对应 FSCalendar 的同名属性1是周日、2是周一。对齐时区避免服务器返回的时间在本地被挪动到相邻日期。最实用的 4 个日期运算技巧技巧一用 dateFromComponents 精确定位某一天这是构造日期最可靠的方式推荐指定年、月、日不要只给年月日再加小时NSDateComponents *c [gregorian components:NSCalendarUnitYear|NSCalendarUnitMonth|NSCalendarUnitDay fromDate:[NSDate date]]; c.day 1; NSDate *firstDay [gregorian dateFromComponents:c]; // 当月 1 号FSCalendar 的每月首日扩展 FSCalendarExtensions.m 正是这样实现的。技巧二用 dateByAddingUnit 做月/周翻页官方示例 ButtonsViewController.m 的上一月/下一月按钮只有三行核心代码NSDate *prev [self.gregorian dateByAddingUnit:NSCalendarUnitMonth value:-1 toDate:currentPage options:0]; [self.calendar setCurrentPage:prev animated:YES];同理NSCalendarUnitDay加减 1 就是前后一天NSCalendarUnitWeekOfYear加减 1 就是前后一周。⚠️ 千万不要用86400 秒自己加一天——夏令时切换日会出 bug。技巧三用 isDate:inSameDayAsDate: 判断同一天今天这个概念最容易被误判为时间戳完全相等。正确姿势来自 FSCalendar.mBOOL isToday [self.gregorian isDate:date inSameDayAsDate:self.today];范围选择器 RangePickerViewController.m 里用isDateInToday:把今天显示为今也是同样思路。技巧四用 compareDate:toDate:toUnitGranularity: 做粒度比较比较两个日期时带上粒度单位NSCalendarUnitDay/NSCalendarUnitMonth可以忽略时分秒的差异非常适合做日期区间判断例如 FSCalendarCalculator.m 中的安全日期钳制逻辑。进阶月内日期计算与农历显示想知道一个月有多少天、某天是几号FSCalendar 把常用扩展集中在 FSCalendarExtensions.h方法作用fs_firstDayOfMonth:求某月 1 号fs_lastDayOfMonth:求某月最后一天自动处理大小月/闰年fs_firstDayOfWeek:求某周第一天fs_numberOfDaysInMonth:求当月天数内部用rangeOfUnit:inUnit:想给日历加农历副标题看官方示例 LunarFormatter.m它创建了一个NSCalendarIdentifierChinese实例再配合NSDateFormatter提取农历月与日。这再次说明NSCalendar 不止有公历所有历法它都能算。避坑清单 ✅比较日期前统一用startOfDayForDate:归零消除时分秒干扰翻页、加减天数一律走NSCalendar禁止手工加减秒数跨时区场景给NSCalendar和FSCalendar.timeZone设置同一个时区minimumDate必须早于maximumDate否则 FSCalendar 会直接断言崩溃见 FSCalendar.m修改minimumDate/maximumDate后记得调用reloadData小结场景首选 API构造某一天components:dateFromComponents:翻页/加减dateByAddingUnit:value:toDate:options:判断同一天isDate:inSameDayAsDate:区间比较compareDate:toDate:toUnitGranularity:月/周起止FSCalendarExtensions.h 的fs_系列把上表贴在 IDE 旁边配合仓库里 Example-Objc 与 Example-Swift 中的真实用例反复对照你就已经掌握了 FSCalendar 之前最需要的日期功底。剩下的就交给日历控件本身吧。【免费下载链接】FSCalendarA fully customizable iOS calendar library, compatible with Objective-C and Swift项目地址: https://gitcode.com/gh_mirrors/fs/FSCalendar创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考