最好用的iOS日期工具庫： DateTools

mpgg2 9年前發布 | 15K 次閱讀 DateTools iOS開發 移動開發

Banner

項目簡介

DateTools 用于提高Objective-C中日期和時間相關操作的效率.靈感來源于 DateTime.aspx)和Time Period Library.

  • 項目主頁: DateTools

    </li>

  • 最新示例: 點擊下載

    </li>

  • 工程簡議: 支持國際化,支持中文輸出,真的很貼心!

    </li> </ul>

    安裝

    使用 Cocoapods 安裝 

    pod 'DateTools'

    NSDate+DateTools

    DateTools讓NSDate功能更完整,可以讓你更容易地去獲取日期各個組件的信息,如年 月 日等.

    獲取字符串形式的時間間隔.

    DateTools 可以讓你獲取距離一個過去的時間點距離當前時間的字符串表示.和推ter中很像,這個時間字符串有完整形式和縮略形式兩種.你可以像下面這樣使用: 

    NSDate *timeAgoDate = [NSDate dateWithTimeIntervalSinceNow:-4];
NSLog(@"Time Ago: %@", timeAgoDate.timeAgoSinceNow);
NSLog(@"Time Ago: %@", timeAgoDate.shortTimeAgoSinceNow);
    

    //輸出:
//Time Ago: 4 seconds ago
//Time Ago: 4s
    

    // 如果工程支持國際化,并且模擬器或真機環境設為簡體中文,則會輸出:
// Time Ago: 4秒鐘前
// Time Ago: 4秒</pre> 
    如果你的工程支持國際化,DateTools現在會自動支持以下語言的本地化: 
    

      

    • 

      ar (Arabic) 
      
</li>
      

    • 

      bg (Bulgarian) 
      
</li>
      

    • 

      ca (Catalan) 
      
</li>
      

    • 

      zh_Hans (簡體中文) 
      
</li>
      

    • 

      zh_Hant (繁體中文) 
      
</li>
      

    • 

      cs (Czech) 
      
</li>
      

    • 

      da (Danish) 
      
</li>
      

    • 

      nl (Dutch) 
      
</li>
      

    • 

      en (English) 
      
</li>
      

    • 

      fi (Finnish) 
      
</li>
      

    • 

      fr (French) 
      
</li>
      

    • 

      de (German) 
      
</li>
      

    • 

      gre (Greek) 
      
</li>
      

    • 

      gu (Gujarati) 
      
</li>
      

    • 

      he (Hebrew) 
      
</li>
      

    • 

      hi (Hindi) 
      
</li>
      

    • 

      hu (Hungarian) 
      
</li>
      

    • 

      is (Icelandic) 
      
</li>
      

    • 

      id (Indonesian) 
      
</li>
      

    • 

      it (Italian) 
      
</li>
      

    • 

      ja (Japanese) 
      
</li>
      

    • 

      ko (Korean) 
      
</li>
      

    • 

      lv (Latvian) 
      
</li>
      

    • 

      ms (Malay) 
      
</li>
      

    • 

      nb (Norwegian) 
      
</li>
      

    • 

      pl (Polish) 
      
</li>
      

    • 

      pt (Portuguese) 
      
</li>
      

    • 

      ro (Romanian) 
      
</li>
      

    • 

      ru (Russian) 
      
</li>
      

    • 

      sl (Slovenian) 
      
</li>
      

    • 

      es (Spanish) 
      
</li>
      

    • 

      sv (Swedish) 
      
</li>
      

    • 

      th (Thai) 
      
</li>
      

    • 

      tr (Turkish) 
      
</li>
      

    • 

      uk (Ukrainian) 
      
</li>
      

    • 

      vi (Vietnamese) 
      
</li>
      

    • 

      cy (Welsh) 
      
</li>
      

    • 

      hr (Croatian) 
      
</li>
</ul>
      

      獲取日期的某個組成部分,如年月周日時分秒等. 
      

      使用 DateTools 可以很容易地獲取日期對象的某一組成部分: 
      

      NSDate * date = [NSDate date];
NSInteger year = date.year;
NSInteger month = date.month;
NSLog(@"year: %ld, month: %ld", (long)year, (long)month); // year: 2015, month: 9
       
      如果你不想使用公歷,可以這樣做: 
      

      NSInteger day = [date dayWithCalendar:calendar];
       
      如果你想改變 DateTools 使用的默認日歷,可以改寫NSDate+DateTools.m中的defaultCalendar方法. 
      

      日期編輯 
      

      可以使用dateByAdding...或dateBySubtractingYears...進行日期按年/月/日/時分/秒等增加或減少: 
      

      NSDate * date = [NSDate date];
NSInteger oldYear = date.year;
      

      NSDate *newDate = [date dateByAddingYears:1];
NSInteger newYear = newDate.year;
      

      NSLog(@"oldYear: %ld newYear: %ld", (long)oldYear, (long)newYear); // 輸出: oldYear: 2015 newYear: 2016</pre> 
      日期比較 
      

      DateTools 提供下列方法,比較兩個日期的大小,返回結果為一個布爾值: 
      

        

      • 

        isEarlierThan 
        
</li>
        

      • 

        isEarlierThanOrEqualTo 
        
</li>
        

      • 

        isLaterThan 
        
</li>
        

      • 

        isLaterThanOrEqualTo 
        
</li>
</ul>
        

        如果想獲取兩個日期具體的差值: 獲取毫秒間隔可以使用 NSDate 提供的timeIntervalSinceDate:和timeIntervalSinceNow方法;獲取相差多少年/月/周/日/時/分/秒等,可以直接使用 DateTools的擴展方法. 
        

        NSInteger yearsApart = [firstDate yearsFrom:secondDate];
         
        類似yearsFrom:用于日期比較的方法包括: 
        

          

        • 

          yearsFrom:,yearsUntil,yearsAgo,yearsEarlierThan:,yearsLaterThan: 
          
</li>
          

        • 

          monthsFrom:,monthsUntil,monthsAgo,monthsEarlierThan:,monthsLaterThan: 
          
</li>
          

        • 

          weeksFrom:,weeksUntil,weeksAgo,weeksEarlierThan:,weeksLaterThan: 
          
</li>
          

        • 

          daysFrom:,daysUntil,daysAgo,daysEarlierThan:,daysLaterThan: 
          
</li>
          

        • 

          hoursFrom:,hoursUntil,hoursAgo,hoursEarlierThan:,hoursLaterThan: 
          
</li>
          

        • 

          minutesFrom:,minutesUntil,minutesAgo,minutesEarlierThan:,minutesLaterThan: 
          
</li>
          

        • 

          secondsFrom:,secondsUntil,secondsAgo,secondsEarlierThan:,secondsLaterThan: 
          
</li>
</ul>
          

          日期的格式化輸出 
          

          可以使用 code>formattedDateWithStyle: 和formattedDateWithFormat:方法格式化輸出日期: 
          

          NSDate  date = [NSDate date];
NSString  dateStr = [date formattedDateWithStyle: NSDateFormatterFullStyle];
          

          // 此處輸出的具體內容會根據你的手機或模擬器語言環境的不同而不同.
NSLog(@"%@", dateStr); // 輸出: 2015年9月25日 星期五
          

          dateStr =  [date formattedDateWithFormat:@"YYYY/MM/dd HH:mm:ss"];
NSLog(@"%@", dateStr); // 輸出: 2015/09/25 15:19:23</pre> 
          時間段 
          

          DateTools 通過DTTimePeriod類來簡化時間段相關的操作. 
          

          初始化 
          

          已知開始和結束時間,可以使用下面的方法初始化時間段對象: 
          

          DTTimePeriod *timePeriod = [[DTTimePeriod alloc] initWithStartDate:startDate endDate:endDate];
           
          或者,已知起始或結束時間,同時知道時間段的總時長,可以用類似下面的方法創建時間端對象: 
          

          // 創建一個時間段,從現在開始,共5個小時.
DTTimePeriod *timePeriod = [DTTimePeriod timePeriodWithSize:DTTimePeriodSizeHour amount:5 startingAt:[NSDate date]];
           
          時間段信息 
          

          可以通過 DTTimePeriod 的實例方法來獲取時間段的相關信息: 
          

            

          • 

            hasStartDate- 返回YES,如果有起始時間. 
            
</li>
            

          • 

            hasEndDate- 返回YES,如果有結束時間. 
            
</li>
            

          • 

            isMoment- 返回YES,如果起始時間和結束時間相同. 
            
</li>
            

          • 

            durationIn....- 返回指定單位下時間段的長度. 
            
</li>
</ul>
            

            DTTimePeriod *timePeriod = [[DTTimePeriod alloc] initWithStartDate:date endDate: [date dateByAddingDays: 10]];
            

            NSLog(@"相差 %g 天", [timePeriod durationInDays]); // 輸出: 相差 10 天</pre> 
            操作 
            

            可以對時間段進行移動,延長或縮短的操作. 
            

            移動 
            

            當一個時間段被移動時,起始時間和結束時間會相應地同步遷移或推后.可以使用下面兩個方法移動時間段: 
            

              

            • 

              shiftEarlierWithSize:amount:時間段整體前移 
              
</li>
              

            • 

              shiftLaterWithSize:amount:時間段整體推后 
              
</li>
</ul>
              

              延長/縮短 
              

              可以通過保持起始點/中間時間點/結束時間點不變,然后改變開始或結束時間點,以得到延長或縮短時間段的目的: 
              

              // 通過前移起始時間,把時間段總時長從1分鐘變為2分鐘.
DTTimePeriod *timePeriod  = [DTTimePeriod timePeriodWithSize:DTTimePeriodSizeMinute endingAt:[NSDate date]];
[timePeriod lengthenWithAnchorDate:DTTimePeriodAnchorEnd size:DTTimePeriodSizeMinute amount:1];
               
              關系 
              

              可以使用DTTimePeriod的關系操作相關的方法,來判斷兩個時間段的相互關系,如是否包含,是否是同一段時間等. 
              

              基礎 
              

              下圖表格列出了兩個時間段所有可能的關系:
              
TimePeriods 
              

              可通過下列方法判斷兩個時間段的關系: 
              

                

              • 

                isEqualToPeriod: 
                
</li>
                

              • 

                isInside: 
                
</li>
                

              • 

                contains: 
                
</li>
                

              • 

                overlapsWith: 
                
</li>
                

              • 

                intersects: 
                
</li>
</ul>
                

                你可以通過下面這個方法獲取相對于另一個時間段的關系: 
                

                -(DTTimePeriodRelation)relationToPeriod:(DTTimePeriod *)period;
                 
                所有可能的時間段間的關系都列在了枚舉DTTimePeriodRelation中了. 
                

                點擊示例中 Time Periods 按鈕,然后滑動滑塊,可以更好地掌握時間段之間的相互關系 
                

                TimePeriods 
                

                時間段集合 
                

                DateTools 提供兩種時間段集合類:DTTimePeriodCollection和DTTimePeriodChain.前者,允許存儲彼此有交集的時間段;后者,不允許存儲彼此有交集的時間段. 
                

                這兩個時間段集合類,操作和 NSArray 很像.你可以添加,插入和移除 DTTimePeriod 對象,就像你在數組時的那樣.唯一的不同是,兩中集合存儲時間段的方式. 
                

                DTTimePeriodCollection和DTTimePeriodChain,是為了簡化基于多個時間段的邏輯處理.比如同一團隊中,給不同的人設置任務的起始和結束時間,此時如果使用 DTTimePeriodCollection 來處理各個時間段,可以直接得到團隊總任務的起始時間和結束時間. 
                

                DTTimePeriodCollection 
                

                DTTimePeriodCollection 是一個規則相對寬松的集合.默認無序(指的是順序和各個時間段的起止時間無關.),但支持手動排序;擁有自己的屬性,比如基于內粗存儲的時間段計算出的此集合的開始時間和結束時間.這個結合允許存儲有交集的時間段. 
                

                TimePeriodCollections 
                

                可以像下面這樣創建新的DTTimePeriodCollection集合: 
                

                // 創建集合.
DTTimePeriodCollection *collection = [DTTimePeriodCollection collection];
                

                // 創建時間段
NSDateFormatter  dateFormatter = [[NSDateFormatter alloc]init];
[dateFormatter setDateFormat: @"YYYY MM dd HH:mm:ss.SSS"];
DTTimePeriod firstPeriod = [DTTimePeriod timePeriodWithStartDate:[dateFormatter dateFromString:@"2014 11 05 18:15:12.000"] endDate:[dateFormatter dateFromString:@"2015 11 05 18:15:12.000"]];
DTTimePeriod *secondPeriod = [DTTimePeriod timePeriodWithStartDate:[dateFormatter dateFromString:@"2015 11 05 18:15:12.000"] endDate:[dateFormatter dateFromString:@"2016 11 05 18:15:12.000"]];
                

                // 把時間段添加到集合中.
[collection addTimePeriod:firstPeriod];
[collection addTimePeriod:secondPeriod];
                

                // 從集合中獲取時間段.
firstPeriod = collection[0];</pre> 
                排序 
                

                有三類給集合內時間段排序的方法: 
                

                  

                • 

                  根據起始時間排序 -sortByStartAscending,sortByStartDescending 
                  
</li>
                  

                • 

                  根據結束時間排序 -sortByEndAscending,sortByEndDescending 
                  
</li>
                  

                • 

                  根據時長排序 -sortByDurationAscending,sortByDurationDescending 
                  
</li>
</ul>
                  

                  操作 
                  

                  也可以去獲取一個 NSDate 對象或一個 DTTimePeriod 對象與一個 時間段結合的相對關系.例如,你可以通過 <cdoe>periodsIntersectedByDate: 方法獲取所有與某個時間有交集的時間段.這個方法會返回一個新的 DTTimePeriodCollection 對象,里面包含所有符合條件的時間段. 
                  

                  有許多類似的方法,如下圖: 
                  

                  TimePeriodCollectionOperations 
                  

                  DTTimePeriodChain 
                  

                  DTTimePeriodChain 以較為嚴格的方式存儲時間段對象. DTTimePeriodChain集合通常依據開始和結束時間存儲時間段對象,并且有自己的屬性,如 根據內部存儲的時間段對象推斷出來的此集合的開始時間和結束時間. DTTimePeriodChain 內部存儲的時間段對象不允許有交集.這種集合很適用于連續會議或約會等日程類事務的建模. 
                  

                  TimePeriodChains 
                  

                  創建一個新的 DTTimePeriodChain 集合: 
                  

                  // 創建集合.
DTTimePeriodChain *chain = [DTTimePeriodChain chain];
                  

                  // 創建時間段
NSDateFormatter * dateFormatter = [[NSDateFormatter alloc]init];
[dateFormatter setDateFormat: @"YYYY MM dd HH:mm:ss.SSS"];
                  

                  DTTimePeriod firstPeriod = [DTTimePeriod timePeriodWithStartDate:[dateFormatter dateFromString:@"2014 11 05 18:15:12.000"] endDate:[dateFormatter dateFromString:@"2015 11 05 18:15:12.000"]];
DTTimePeriod secondPeriod = [DTTimePeriod timePeriodWithStartDate:[dateFormatter dateFromString:@"2015 11 05 18:15:12.000"] endDate:[dateFormatter dateFromString:@"2016 11 05 18:15:12.000"]];
                  

                  // 添加時間段對象到集合中.
[chain addTimePeriod:firstPeriod];
                  

                  // 如果后存入的時間和前一個存入的時間無法前后完全銜接,則后一個時間會適當前移或后移,以使前后時間段緊湊.
[chain addTimePeriod:secondPeriod];
                  

                  // 獲取集合中的元素.
firstPeriod = chain[0];</pre> 
                  新加入的時間段,時長不變,起始時間變為前一個時間段的結束時間,結束時間對應前移后后移.在非零位置新插入的時間,其后的時間段相應后移.在零位置插入的時間,集合的起始時間前移.操作圖解如下: 
                  

                  操作
                  
像 DTTimePeriodCollection 一樣, DTTimePeriodChain 也可以進行相等性比較,并且也可以前移后后移.其他執行的方法在下圖列出: 
                  

                  TimePeriodChainOperations 
                  
來自：http://segmentfault.com/a/1190000003794160
 本文由用戶 mpgg2 自行上傳分享，僅供網友學習交流。所有權歸原作者，若您的權利被侵害，請聯系管理員。
 轉載本站原創文章，請注明出處，并保留原始鏈接、圖片水印。
 本站是一個以用戶分享為主的開源技術平臺，歡迎各類分享！