近期項目中NSDate使用較多,所以網上也查了一些資料,發現一篇不錯的文章 iOS NSDate的Category,也剛好滿足需求,所以在此基礎上增加了一些自己需要的部分。
#import <Foundation/Foundation.h>
@interface NSDate (Category)
#pragma mark - 日期分解
@property (nonatomic, readonly) NSInteger year;
@property (nonatomic, readonly) NSInteger month;
@property (nonatomic, readonly) NSInteger day;
@property (nonatomic, readonly) NSInteger hour;
@property (nonatomic, readonly) NSInteger minute;
@property (nonatomic, readonly) NSInteger second;
/**
* 當前年的第幾周
*
* @return 當前年的第幾周
*/
@property (nonatomic, readonly) NSInteger weekOfYear;
/**
* 當前月的第幾周
*
* @return 當前月的第幾周
*/
@property (nonatomic, readonly) NSInteger weekOfMonth;
/**
* 當前日期所在周的第幾天
*
* @return 第幾天
*/
@property (nonatomic, readonly) NSInteger weekday;
/**
* 當前日期所在年的第幾季度
*
* @return 獲得的季度
*/
@property (nonatomic, readonly) NSInteger weekdayOrdinal;
/**
* 距離當前時間最近的小時 比如9:55 就是10:00 9:25就是9:00
*
* @return 最近的小時
*/
@property (nonatomic, readonly) NSInteger nearestHour;
#pragma mark - 當前客戶端的邏輯日歷
/**
* 獲獲取當前客戶端的邏輯日歷
*
* @return 當前客戶端的邏輯日歷
*/
+ (NSCalendar *)currentCalendar;
#pragma mark - 獲取指定日期天數
/**
指定日期天數
@param year 指定年
@param month 指定月
@return 天數
*/
+ (NSInteger)getDaysWithYear:(NSInteger)year month:(NSInteger)month;
#pragma mark - 日期轉換
/**
* 將日期轉換為當前時區的日期
*
* @param forDate 要轉換的日期
*
* @return 轉換過的日期
*/
+ (NSDate *)convertDateToLocalTime:(NSDate *)forDate;
/**
指定NSDate、指定格式轉換日期字符串
@param date 指定NSDate
@param formatterString 指定格式
@return 轉換后的字符串
*/
+ (NSString *)stringFromDate:(NSDate *)date dateFormat:(NSString *)formatterString;
/**
指定日期字符串、指定格式轉換NSDate
@param string 指定日期字符串
@param formatterString 指定格式
@return 轉換后的NSDate
*/
+ (NSDate *)dateFromString:(NSString *)string dateFormat:(NSString *)formatterString;
#pragma mark - 日期調整
/**
指定日期后推指定年得到的日期
@param dYear 后推的年數
@return 后推指定年數后的日期
*/
- (NSDate *)dateByAddingYears:(NSInteger)dYear;
/**
指定日期前推指定年得到的日期
@param dYear 前推的年數
@return 前推指定年數后的日期
*/
- (NSDate *)dateBySubtractingYears:(NSInteger)dYear;
/**
指定日期后推指定月得到的日期
@param dMonth 后推的月數
@return 后推指定月數后的日期
*/
- (NSDate *)dateByAddingMonths:(NSInteger)dMonth;
/**
指定日期前推指定月得到的日期
@param dMonth 前推的月數
@return 前推指定月數后的日期
*/
- (NSDate *)dateBySubtractingMonths:(NSInteger)dMonth;
/**
指定日期后推指定天得到的日期
@param dDay 后推的天數
@return 后推指定天數后的日期
*/
- (NSDate *)dateByAddingDays:(NSInteger)dDay;
/**
指定日期前推指定月得到的日期
@param dDay 前推的月數
@return 前推指定月數后的日期
*/
- (NSDate *)datebySubtractingDays:(NSInteger)dDay;
/**
* 指定日期后推指定小時得到的日期
*
* @param dHour 后推的幾個小時
* @return 后推后的日期
*/
- (NSDate *)dateByAddingHours:(NSInteger)dHour;
/**
* 指定日期前推幾小時得到的日期
*
* @param dHour 前推的小時數
* @return 前推后得到的日期
*/
- (NSDate *)dateBySubtractingHours:(NSInteger)dHour;
#pragma mark - 極端日期
/**
指定日期當年的開始時間(如:2018-01-01 00:00:00)
@return 當年開始日期
*/
- (NSDate *)dateAtStartOfYear;
/**
指定日期當年的結束時間(如:2018-12-31 23:59:59)
@return 當年結束日期
*/
- (NSDate *)dateAtEndOfYear;
/**
指定日期當月的開始時間(如:2018-01-01 00:00:00)
@return 當月開始日期
*/
- (NSDate *)dateAtStartOfMonth;
/**
指定日期當月的結束時間(如:2018-01-31 23:59:59)
@return 當月結束日期
*/
- (NSDate *)dateAtEndOfMonth;
/**
指定日期當天開始時間(如:2018-01-01 00:00:00)
@return 當天開始時間
*/
- (NSDate *)dateAtStartOfDay;
/**
指定日期當天結束時間(如:2018-01-01 23:59:59)
@return 當天結束時間
*/
- (NSDate *)dateAtEndOfDay;
#pragma mark - 日期比較
/**
判斷是否是同一年
@param date 比較的日期
@return yes:是,no:不是
*/
- (BOOL)isSameYearAsDate:(NSDate *)date;
/**
判斷是否是同一個月
@param date 比較的日期
@return yes:是,no:不是
*/
- (BOOL)isSameMonthAsDate:(NSDate *)date;
/**
判斷是否是同一天
@param date 比較的日期
@return yes:是,no:不是
*/
- (BOOL)isSameDayAsDate:(NSDate *)date;
/**
判斷是否是同一小時
@param date 比較的日期
@return yes:是,no:不是
*/
- (BOOL)isSameHourAsDate:(NSDate *)date;
@end