待办事项提醒应用程序ToDoList

 ## DateTools DateTools was written to streamline date and time handling in Objective-C. Classes and concepts from other languages served as an inspiration for DateTools, especially the [DateTime](http://msdn.microsoft.com/en-us/library/system.datetime(v=vs.110).aspx) structure and [Time Period Library](Time Period Library) for .NET. Through these classes and others, DateTools removes the boilerplate required to access date components, handles more nuanced date comparisons, and serves as the foundation for entirely new concepts like Time Periods and their collections. [](https://travis-ci.org/MatthewYork/DateTools) [](http://cocoapods.org/?q=datetools) ####Featured In <table> <tr> <td align="center"> <a href="https://itunes.apple.com/hk/app/yahoo-livetext-video-messenger/id995121875?mt=8"><img src="http://a4.mzstatic.com/us/r30/Purple2/v4/7c/1b/11/7c1b11f3-2a73-b655-751e-b21b2e8bc6f7/icon100x100.png" /></a> </td> <td align="center"> <a href="https://itunes.apple.com/app/id547436543"><img src="http://a5.mzstatic.com/us/r30/Purple5/v4/1f/7b/a5/1f7ba545-038e-353e-18a0-b6472eef1913/icon100x100.jpeg" /></a> </td> <td align="center"> <a href="https://itunes.apple.com/us/app/aldi-usa/id429396645?mt=8"><img src="http://a4.mzstatic.com/us/r30/Purple7/v4/a7/63/20/a76320db-2de4-62ad-b620-efaab8a179dc/icon100x100.jpeg" /></a> </td> <td align="center"> <a href="https://itunes.apple.com/us/app/guidebook/id428713847?mt=8"><img src="http://a5.mzstatic.com/us/r30/Purple7/v4/e4/af/db/e4afdbc1-9ceb-c403-4d06-299e7e693120/icon100x100.png" /></a> </td> <td align="center"> <a href="https://itunes.apple.com/us/app/pitch-locator-pro/id964965940?mt=8"><img src="http://a2.mzstatic.com/us/r30/Purple7/v4/39/ed/24/39ed248b-afab-ce8d-4276-35ba0459ac60/icon100x100.png" /></a> </td> <tr> <td align="center">Yahoo! Livetext</td> <td align="center">My Disney Experience</td> <td align="center">ALDI</td> <td align="center">Guidebook</td> <td align="center">Pitch Locator Pro</td> </tr> </tr> </table> ## Installation **Cocoapods** <code>pod 'DateTools'</code> **Manual Installation** All the classes required for DateTools are located in the DateTools folder in the root of this repository. They are listed below: * <code>DateTools.h</code> * <code>NSDate+DateTools.{h,m}</code> * <code>DTConstants.h</code> * <code>DTError.{h,m}</code> * <code>DTTimePeriod.{h,m}</code> * <code>DTTimePeriodGroup.{h,m}</code> * <code>DTTimePeriodCollection.{h,m}</code> * <code>DTTimePeriodChain.{h,m}</code> The following bundle is necessary if you would like to support internationalization or would like to use the "Time Ago" functionality. You can add localizations at the `Localizations` subheading under `Info` in the `Project` menu. * <code>DateTools.bundle</code> <code>DateTools.h</code> contains the headers for all the other files. Import this if you want to link to the entire framework. ## Table of Contents * [**NSDate+DateTools**](#nsdate-datetools) * [Time Ago](#time-ago) * [Date Components](#date-components) * [Date Editing](#date-editing) * [Date Comparison](#date-comparison) * [Formatted Date Strings](#formatted-date-strings) * [**Time Periods**](#time-periods) * [Initialization](#initialization) * [Time Period Info](#time-period-info) * [Manipulation](#manipulation) * [Relationships](#relationships) * [**Time Period Groups**](#time-period-groups) * [Time Period Collections](#time-period-collections) * [Time Period Chains](#time-period-chains) * [**Unit Tests**](#unit-tests) * [**Credits**](#credits) * [**License**](#license) ##NSDate+DateTools One of the missions of DateTools was to make NSDate feel more complete. There are many other languages that allow direct access to information about dates from their date classes, but NSDate (sadly) does not. It safely works only in the Unix time offsets through the <code>timeIntervalSince...</code> methods for building dates and remains calendar agnostic. But that's not <i>always</i> what we want to do. Sometimes, we want to work with dates based on their date components (like year, month, day, etc) at a more abstract level. This is where DateTools comes in. ####Time Ago No date library would be complete without the ability to quickly make an NSString based on how much earlier a date is than now. DateTools has you covered. These "time ago" strings come in a long and short form, with the latter closely resembling Twitter. You can get these strings like so: ```objc NSDate *timeAgoDate = [NSDate dateWithTimeIntervalSinceNow:-4]; NSLog(@"Time Ago: %@", timeAgoDate.timeAgoSinceNow); NSLog(@"Time Ago: %@", timeAgoDate.shortTimeAgoSinceNow); //Output: //Time Ago: 4 seconds ago //Time Ago: 4s ``` Assuming you have added the localization to your project, `DateTools` currently supports the following languages: - ar (Arabic) - bg (Bulgarian) - ca (Catalan) - zh_Hans (Chinese Simplified) - zh_Hant (Chinese Traditional) - cs (Czech) - da (Danish) - nl (Dutch) - en (English) - fi (Finnish) - fr (French) - de (German) - gre (Greek) - gu (Gujarati) - he (Hebrew) - hi (Hindi) - hu (Hungarian) - is (Icelandic) - id (Indonesian) - it (Italian) - ja (Japanese) - ko (Korean) - lv (Latvian) - ms (Malay) - nb (Norwegian) - pl (Polish) - pt (Portuguese) - ro (Romanian) - ru (Russian) - sl (Slovenian) - es (Spanish) - sv (Swedish) - th (Thai) - tr (Turkish) - uk (Ukrainian) - vi (Vietnamese) - cy (Welsh) - hr (Croatian) If you know a language not listed here, please consider submitting a translation. [Localization codes by language](http://stackoverflow.com/questions/3040677/locale-codes-for-iphone-lproj-folders). This project is user driven (by people like you). Pull requests close faster than issues (merged or rejected). Thanks to Kevin Lawler for his work on [NSDate+TimeAgo](https://github.com/kevinlawler/NSDate-TimeAgo), which has been officially merged into this library. ####Date Components There is a lot of boilerplate associated with getting date components from an NSDate. You have to set up a calendar, use the desired flags for the components you want, and finally extract them out of the calendar. With DateTools, this: ```objc //Create calendar NSCalendar *calendar = [[NSCalendar alloc] initWithCalendarIdentifier:NSGregorianCalendar]; unitFlags = NSYearCalendarUnit | NSMonthCalendarUnit; NSDateComponents *dateComponents = [calendar components:unitFlags fromDate:date]; //Get components NSInteger year = dateComponents.year; NSInteger month = dateComponents.month; ``` ...becomes this: ```objc NSInteger year = date.year; NSInteger month = date.month; ``` And if you would like to use a non-Gregorian calendar, that option is available as well. ```objc NSInteger day = [date dayWithCalendar:calendar]; ``` If you would like to override the default calendar that DateTools uses, simply change it in the <code>defaultCalendar</code> method of <code>NSDate+DateTools.m</code>. ####Date Editing The date editing methods in NSDate+DateTools makes it easy to shift a date earlier or later by adding and subtracting date components. For instance, if you would like a date that is 1 year later from a given date, simply call the method <code>dateByAddingYears</code>. With DateTools, this: ```objc //Create calendar NSCalendar *calendar = [[NSCalendar alloc] initWithCalendarIdentifier:[NSDate defaultCalendar]]; NSDateComponents *components = [[NSDateComponents alloc] init]; //Make changes [components setYear:1]; //Get new date with updated year NSDate *newDate = [calendar dateByAddingComponents:components toDate:date options:0]; ``` ...becomes this: ```objc NSDate *newDate = [date dateByAddingYears:1]; ``` Subtraction of date components is