iOS NSDate的常用API

目录

一、创建日期

1.获取当前时间

2.当前时间指定秒数之后/前的时间

3.指定日期之后/后的时间

4.2001年之后/前指定秒数的时间

5.1970年之后/后指定秒数的时间

二、初始化日期

1.init

2.时间间指定秒数的时间

3.指定时间指定秒数之前/后的时间

4.2001年指定秒数之后/前的时间

三、获取时间边界

1.distantFuture

2.distantPast

四、时间比较

1.比较日期是否相等

2.比较日期是否较早

3.比较日期是否较晚

4.带回调的日期比较的方法

五、获取时间间隔

1.与指定日期的时间间隔

2.距离现在的时间间隔

3.距离2001年的时间间隔

4.距离1970年的时间间隔 

六、时间的运算

总结

---

前言

     

        本文整理了一下NSDate的API，以便需要或者忘记的时候查询下用法，文章末尾贴出了开发过长中常用的NSDate的拓展方法。

        系统默认NSDate的默认时间为UTC时间。

一、创建日期

1.获取当前时间

+ (instancetype)date;

        这里返回的当前的时间(UTC时间)，下面的示例展示了获取当前时间的方法。        

NSDate * todayDate = [NSDate date];
NSLog(@"当前时间:%@",todayDate);

2.当前时间指定秒数之后/前的时间

+ (instancetype)dateWithTimeIntervalSinceNow:(NSTimeInterval)secs;

        这里返回的时候当前时间之后多少秒的时间。使用负数表示之前多少秒的时间。

NSDate * todayDate = [NSDate date];
NSLog(@"当前时间:%@",todayDate);
NSDate * afterTenSeconds = [NSDate dateWithTimeIntervalSinceNow:10];
NSLog(@"10秒钟之后的时间:%@",afterTenSeconds);
NSDate * beforeTenSeconds = [NSDate dateWithTimeIntervalSinceNow:-10];
NSLog(@"10秒钟之前的时间:%@",beforeTenSeconds);

3.指定日期之后/后的时间

+ (instancetype)dateWithTimeInterval:(NSTimeInterval)secsToBeAdded sinceDate:(NSDate *)date;

        指定日期多少秒之后的时间，负数表示指定日期多少秒之前的时间。

NSDate * todayDate = [NSDate date];    
NSLog(@"当前时间:%@",todayDate);     
NSDate * afterTenSecondDate = [NSDate dateWithTimeInterval:10 sinceDate:todayDate];        
NSDate * beginTenSecondDate = [NSDate dateWithTimeInterval:-10 sinceDate:todayDate];   
NSLog(@"10秒钟之后的时间:%@",afterTenSecondDate);
NSLog(@"10秒钟之后的时间:%@",beginTenSecondDate);

4.2001年之后/前指定秒数的时间

+ (instancetype)dateWithTimeIntervalSinceReferenceDate:(NSTimeInterval)ti;

        返回从 2001 年 1 月 1 日 00:00:00 UTC 开始的给定秒数之后的时间，负数表示给定秒数之前的时间。

NSDate * todayDate = [NSDate date];
NSLog(@"当前时间:%@",todayDate);
NSDate * tenSecondsAfter2001 = [NSDate dateWithTimeIntervalSinceReferenceDate:10];  
NSLog(@"2001-1-1 00:00:00 之后10秒的时间当前时间:%@",tenSecondsAfter2001);

5.1970年之后/后指定秒数的时间

+ (instancetype)dateWithTimeIntervalSince1970:(NSTimeInterval)secs;

        返回从 1970 年 1 月 1 日 00:00:00 UTC 开始的给定秒数之后的时间，负数表示给定秒数之前的时间。

NSDate * tenSecondsAfter1970 = [NSDate dateWithTimeIntervalSince1970:10];
NSLog(@"2001-1-1 00:00:00 之后10秒的时间当前时间:%@",tenSecondsAfter1970);

二、初始化日期

1.init

- (instancetype)init;

        这里返回的也是当前的时间

NSDate * nowDate = [[NSDate alloc]init];
NSLog(@"当前时间:%@",nowDate);

2.时间间指定秒数的时间

- (instancetype)initWithTimeIntervalSinceNow:(NSTimeInterval)secs;

NSDate * nowDate = [[NSDate alloc]init];    
NSLog(@"当前时间:%@",nowDate);
NSDate * afterTenSecondsDate = [[NSDate alloc]initWithTimeIntervalSinceNow:10];
NSLog(@"10秒钟之后的时间:%@",afterTenSecondsDate);

3.指定时间指定秒数之前/后的时间

- (instancetype)initWithTimeInterval:(NSTimeInterval)secsToBeAdded sinceDate:(NSDate *)date;

NSDate * nowDate = [[NSDate alloc]init];        
NSLog(@"当前时间:%@",nowDate);
NSDate * afterTenSecondsDate = [[NSDate alloc]initWithTimeInterval:10 sinceDate:nowDate];        
NSLog(@"10秒钟之后的时间:%@",afterTenSecondsDate);

4.2001年指定秒数之后/前的时间

- (instancetype)initWithTimeIntervalSinceReferenceDate:(NSTimeInterval)ti;

NSDate * nowDate = [[NSDate alloc]init];        
NSLog(@"当前时间:%@",nowDate);        
NSDate * afterTenSecondsFrom2001 = [[NSDate alloc]initWithTimeIntervalSinceReferenceDate:10];        
NSLog(@"2001年10秒钟之后的时间:%@",afterTenSecondsFrom2001);

5.1970年指定秒数之后/前的时间

- (instancetype)initWithTimeIntervalSince1970:(NSTimeInterval)secs;

NSDate * nowDate = [[NSDate alloc]init];        
NSLog(@"当前时间:%@",nowDate);        
NSDate * afterTenSecondsFrom1970 = [[NSDate alloc]initWithTimeIntervalSince1970:10];        
NSLog(@"1970年10秒钟之后的时间:%@",afterTenSecondsFrom1970);

三、获取时间边界

1.distantFuture

2.distantPast

四、时间比较

1.比较日期是否相等

- (BOOL)isEqualToDate:(NSDate *)otherDate;

        比较A日期是否和B日期是否相同。相同返回YES,不同返回NO。

NSDate * nowDate = [NSDate now];
NSDate * nowDateAfter10Seconds = [NSDate dateWithTimeIntervalSinceNow:10];
if ([nowDate isEqualToDate:nowDateAfter10Seconds]) {
    NSLog(@"nowDate == nowDateAfter10Seconds");
} else {
    NSLog(@"nowDate != nowDateAfter10Seconds");
}
if ([[NSDate now] isEqualToDate:[[NSDate alloc]init]]) {
    NSLog(@"equal");
}

2.比较日期是否较早

- (NSDate *)earlierDate:(NSDate *)anotherDate;

        比较A日期是否早于B日期，是的话返回YES,否则返回NO。

NSDate * nowDate = [NSDate now];
NSDate * nowDateAfter10Seconds = [NSDate dateWithTimeIntervalSinceNow:10];
if ([nowDate isEarlierThanOrEqualTo:nowDateAfter10Seconds]) {
     NSLog(@"nowDate isEarlierThanOrEqualTo nowDateAfter10Seconds"); 
} else {
    NSLog(@"nowDate isNotEarlierThanOrEqualTo nowDateAfter10Seconds");
}

3.比较日期是否较晚

- (NSDate *)laterDate:(NSDate *)anotherDate;

        比较A日期是否晚与B日期和上面的返回结果刚好相反。

    
NSDate * nowDate = [NSDate now];
NSDate * nowDateAfter10Seconds = [NSDate dateWithTimeIntervalSinceNow:10];    
if ([nowDate isLaterThan:nowDateAfter10Seconds]) {
   NSLog(@"nowDate isLaterThan nowDateAfter10Seconds");    
} else {
    NSLog(@"nowDate isNotLaterThan nowDateAfter10Seconds");
}

4.带回调的日期比较的方法

- (NSComparisonResult)compare:(NSDate *)other;

        这里这个方法的返回值是NSComparisonResult类型的枚举，当两个日期完全相同的时候返回NSOrderedSame。  

1. A < B     返回 NSOrderedAscending

2. A > B     返回 NSOrderedSame

3. A == B   返回 NSOrderedDescending

NSDate * nowDate = [NSDate now];=   
NSDate * nowDateAfter10Seconds = [NSDate dateWithTimeIntervalSinceNow:10];  
NSComparisonResult  comparisonResult = [nowDate compare:nowDateAfter10Seconds];
NSLog(@"比较结果:%ld",comparisonResult );

五、获取时间间隔

1.与指定日期的时间间隔

- (NSTimeInterval)timeIntervalSinceDate:(NSDate *)anotherDate;        

        返回和指定日期的时间间隔，单位是秒。

NSDate * nowDate = [NSDate now];
NSDate * nowDateAfter10Seconds = [NSDate dateWithTimeIntervalSinceNow:10]; 
NSTimeInterval timeInterval = [nowDate timeIntervalSinceDate:nowDateAfter10Seconds]; 
NSLog(@"nowDate和nowDateAfter10Seconds间隔%lf秒",timeInterval);

2.距离现在的时间间隔

@property (readonly) NSTimeInterval timeIntervalSinceNow;

        返回指定日期距离现在的时间间隔。

NSDate * nowDate = [NSDate now];    
NSDate * nowDateAfter10Seconds = [NSDate dateWithTimeIntervalSinceNow:10]; 
NSTimeInterval timeInterval = nowDateAfter10Seconds.timeIntervalSinceNow;  
NSLog(@"timeInterval:%lf秒",timeInterval);

3.距离2001年的时间间隔

@property (readonly) NSTimeInterval timeIntervalSinceReferenceDate;        

        返回指定日期距离2001年1月1日的时间间距，单位是秒。

NSDate * nowDate = [NSDate now];    
NSTimeInterval timeInterval = nowDate.timeIntervalSinceReferenceDate;    
NSLog(@"timeInterval:%lf秒",timeInterval);

4.距离1970年的时间间隔 

@property (readonly) NSTimeInterval timeIntervalSince1970; 

        返回指定日期距离1970年1月1日的时间间距，单位是秒。

NSDate * nowDate = [NSDate now];    
NSTimeInterval timeInterval = nowDate.timeIntervalSince1970;    
NSLog(@"timeInterval:%lf秒",timeInterval);

六、时间的运算

- (instancetype)dateByAddingTimeInterval:(NSTimeInterval)ti;   

        返回指定秒数之后的时间。

NSDate * nowDate = [NSDate now];
NSDate * nowDateAfter = [nowDate dateByAddingTimeInterval:24 * 60 * 60];
NSLog(@"nowDateAfter:%@",nowDateAfter);