NSDateCalculations 技术文档

1. 安装指南

将 DateCalculations 文件夹拖入你的项目目录中，并在你的代码中导入 NSDate+Calculations.h 文件。

#import "NSDate+Calculations.h"

2. 项目的使用说明

NSDateCalculations 是一个Objective C库，旨在为Mac和iPhone平台上的日期计算提供一个简单的接口。

以下是库中当前实现的几种方法：

• 创建日期：

  • + (NSDate *)dateWithYear:(int)year month:(int)month day:(int)day hour:(int)hour minute:(int)minute second:(int)second;
  • + (NSDate *)createDate:(int)year month:(int)month day:(int)day hour:(int)hour minute:(int)minute second:(int)second;（已弃用）

• 获取开始时间：

  • - (NSDate *)beginningOfDay;
  • - (NSDate *)beginningOfMonth;
  • - (NSDate *)beginningOfQuarter;
  • - (NSDate *)beginningOfWeek;
  • - (NSDate *)beginningOfYear;

• 获取结束时间：

  • - (NSDate *)endOfDay;
  • - (NSDate *)endOfMonth;
  • - (NSDate *)endOfQuarter;
  • - (NSDate *)endOfWeek;
  • - (NSDate *)endOfYear;

• 日期推进与回退：

  • - (NSDate *)advance:(int)years months:(int)months weeks:(int)weeks days:(int)days hours:(int)hours minutes:(int)minutes seconds:(int)seconds;
  • - (NSDate *)ago:(int)years months:(int)months weeks:(int)weeks days:(int)days hours:(int)hours minutes:(int)minutes seconds:(int)seconds;

• 日期变更：

  • - (NSDate *)change:(NSDictionary *)changes;

• 获取月份天数：

  • - (int)daysInMonth;

• 日期偏移：

  • - (NSDate *)monthsSince:(int)months;
  • - (NSDate *)yearsSince:(int)years;

• 获取未来日期：

  • - (NSDate *)nextMonth;
  • - (NSDate *)nextWeek;
  • - (NSDate *)nextYear;

• 获取过去日期：

  • - (NSDate *)prevMonth;
  • - (NSDate *)prevYear;
  • - (NSDate *)yearsAgo:(int)years;
  • - (NSDate *)yesterday;

• 获取明天日期：

  • - (NSDate *)tomorrow;

• 日期状态判断：

  • - (BOOL)future;
  • - (BOOL)past;
  • - (BOOL)today;

更多文档将在项目发展过程中不断完善。

3. 项目API使用文档

请参考上文的项目使用说明部分，其中详细介绍了每个方法的功能和用法。

4. 项目安装方式

请参考上文中的安装指南部分。