This framework provides easy to use wrappers and category over NSDate. The key factor while designing this framework is easy and intuitive way of using NSDate.
The smallest unit precision is a second in most of the date arithmetic.
Use comparison operator intuitively for comparing dates:
let d1 = //Some date
let d2 = //Some other date
if d1 == d2 {}
if d1 != d2 {}
if d1 <= d2 {}
if d1 >= d2 {}
if d1 < d2 {}
if d1 > d2 {}
You can use + or - operator to add or subtract time interval respectively. The result is a new date.
let d1 = //Some date
let oneHour = 60.0 * 60.0
let d2 = d1 + oneHour
let d3 = d1 + 20.0
let d4 = d1 - oneHour
let d5 = d1 - 115.5
You can also use + add NSDateComponents. Likewise the result is a new date.
let d1 = //Some date
let comps = //Some date components
let d2 = d1 + comps
Subtracting components may be achieved by setting negative values in components.
You can also subtract one NSDate from other by sing - operator. The result is NSDateComponent
let d1 = //Some date
let d2 = //Some other date
let diffComps = d1 - d2
In my view adding dates just don't make much sense.
In this framework I have created a concept of Time Period that can be added to or subtracted from an NSDate object. Below are the predefined time period in this framework:
Second
Minute
Hour
Day
Week
Month
Year
You could use these time periods to do date arithmetic:
let date = //Some date
let afterASecond = date + Second()
let after20Seconds = date + Second(20)
let befor15Seconds = date - Second(15)
let after2Hours = date + Hour(2)
let beforeADay = date - Day()
let after4Weeks = date + Week(4)
let before2Years = date - Year(2)
let before2Weeks3daysAnd5Hours = date - Week(2) - Day(3) - Hour(5)
The calculations are based on current calendar of the system.
Note on adding or subtracting months and years: Adding one month will increment month part of date by one or if month is December it will increment year by one and set month as Jan. Similarly for years.
let d1 = \\Feb 19 2015, 13:30:30
let d2 = \\Mar 21 2015, 13:30:30
let res1 = d1 + Month() \\Mar 19 2015, 13:30:30 (adding 28 days)
let res2 = d2 + Month() \\Apr 21 2015, 13:30:30 (adding 31 days)
It is also possible to define your own custom time period for date arithmetic. For example a fortnight or lecture duration of 45 minutes etc.
public class Lecture: TimePeriodBase {
let lectureMinutes = 45.0
public class override var INTERVAL: NSTimeInterval {
return Minute.INTERVAL * Lecture().lectureMinutes
}
public override var interval: NSTimeInterval {
return Lecture.INTERVAL * Double(count)
}
public override var component: NSDateComponents {
var component = NSDateComponents()
component.minute = Int(Double(count) * lectureMinutes)
return component
}
public override var negativeComponent: NSDateComponents {
var component = NSDateComponents()
component.minute = -Int(Double(count) * lectureMinutes)
return component
}
}
let numLecturesInFirtHalf = 4
let firstLectureStarts = \\Some time
let secondLectureStarts = firstLectureStarts + Lecture()
...
let lastLectureStarts = firstLectureStarts + Lecture(numLectureInFirstHalf)
You could also create complex duration with multiple date components involved in it.
Access components of date using calculated properties. These are based on current calendar of the system.
let date = \\Mar 21 2015, 13:30:49
let second = date.second \\ 49
let minute = date.minute \\ 30
let hour = date.hour \\ 13
let day = date.day \\ 21
let weekDay = date.weekDay \\ 7 Sat
let month = date.month \\ 3
let year = date.year \\ 2015
let weekOfMonth = date.weekOfMonth \\ 3 - 3rd week
Following are utility methods for creating some basic dates:
//Suppose it is right now Mar 21 2015, 13:30:49
let now = NSDate.now() \\Mar 21 2015, 13:30:49
let today = NSDate.today() \\Mar 21 2015, 00:00:00 - Start of today
let yesterday = NSDate.yesterday() \\Mar 20 2015, 00:00:00 - Start of yesterday
let tomorrow = NSDate.tomorrow() \\Mar 22 2015, 00:00:00 - Start of tomorrow
let dby = NSDate.dayBeforeYesterday() \\Mar 19 2015, 00:00:00
let dat = NSDate.dayAfterTomorrow() \\Mar 23 2015, 00:00:00
let thisMinute = NSDate.thisMinute() \\Mar 21 2015, 13:30:00 - Start of this minute
let thisHour = NSDate.thisHour() \\Mar 21 2015, 13:00:00 - Start of this hour
let thisWeek = NSDate.thisWeek() \\Mar 15 2015, 00:00:00 - Start of this week
let thisMonth = NSDate.thisMonth() \\Mar 1 2015, 00:00:00 - Start of this month
let thisYear = NSDate.thisYear() \\Jan 1 2015, 00:00:00 - Start of this year
Following methods gives start and end times for specified date.
let date = //Mar 21 2015, 13:30:49
let startOfMinute = date.startOfMinute() //Mar 21 2015, 13:30:00
let endOfMinute = date.endOfMinute() //Mar 21 2015, 13:30:59
let startOfHour = date.startOfHour() //Mar 21 2015, 13:00:00
let endOfHour = date.endOfHour() //Mar 21 2015, 13:59:59
let startOfDay = date.startOfDay() //Mar 21 2015, 00:00:00
let endOfDay = date.endOfDay() //Mar 21 2015, 23:59:59
let startOfWeek = date.startOfWeek() //Mar 15 2015, 00:00:00
let endOfWeek = date.endOfWeek() //Mar 21 2015, 23:59:59
let startOfMonth = date.startOfMonth() //Mar 01 2015, 00:00:00
let endOfMonth = date.endOfMonth() //Mar 31 2015, 23:59:59
let startOfYear = date.startOfYear() //Jan 01 2015, 00:00:00
let endOfYear = date.endOfYear() //Dec 31 2015, 23:59:59
Following method gives next and previous dates for specified date.
let date = //Mar 21 2015, 13:30:49
let nextMinute = date.nextfMinute() //Mar 21 2015, 13:31:00
let previousMinute = date.previousMinute() //Mar 21 2015, 13:29:00
let nextHour = date.nextHour() //Mar 21 2015, 14:00:00
let previousHour = date.previousHour() //Mar 21 2015, 12:00:00
let nextDay = date.nextfDay() //Mar 22 2015, 00:00:00
let previousDay = date.previousDay() //Mar 20 2015, 00:00:00
let nextWeek = date.nextWeek() //Mar 22 2015, 00:00:00
let previousWeek = date.previousWeek() //Mar 08 2015, 00:00:00
let nextMonth = date.nextMonth() //Apr 01 2015, 00:00:00
let previousMonth = date.previousMonth() //Feb 01 2015, 00:00:00
let nextYear = date.nextYear() //Jan 01 2016, 00:00:00
let previousYear = date.previousYear() //Jan 01 2014, 00:00:00
All the date related calcuations are done using system default calender i.e. NSCalendar.currentCalendar(). If you wish to use any other calendar you could do so by
NSCalendar.defaultCalendar = Some new calendar instance here
This is the easiest way to use iDate. Add following line to your Podfile:
pod 'iDate'
- Download and place the code into workspace directory
- Click file -> "Add files to <Workspace_name>"
- Navigate to iDate directory into your workspace directory
- Click on iDate.xcodeproj
The project is now part of your workspace. You will have to add its reference to your main project in target section.
- Copy the iDate/iDate source folder into your project
The MIT License (MIT)
Copyright (c) 2015 abdullah-chhatra
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.