SwiftDateUtils

A number of NSDate utilities written in Swift.

Usage

This module introduces two new methods on NSDate, and a couple of overloaded operators, too.

Formatting

First of all, .format. Let's face it, setting up an NSDateFormatter every time you want to format a date is tedious. We all just want a format function. Now we have one. It takes either a string:

//July 4, 2008, Midnight GMT
let d1 = NSDate(timeIntervalSince1970: 1215129600)

d1.format("YYYY-MM-dd'T'hh:mm:ss")
// > 2008-07-04T12:00:00

or one or two NSDateFormatStyles, named date: and time:

d1.format(date: .ShortStyle, time: .ShortStyle)
// > "7/4/08, 12:00 AM" (depending on your locale)

d1.format(date: .FullStyle)
// > "Friday, July 4, 2008"

d1.format(time: .FullStyle)
// > "12:00:00 AM GMT"

Adding and subtracting time

NSDate already has a handy dateByAddingTimeInterval function. Can we make it better? Damn right we can. You can add time more safely - respecting calendar changes - in two syntaxes. First, the add function, using named parameters.

d1.add(hours: 2)
// > July 4, 2008, 2:00 AM GMT

d1.add(weeks: 3, days: 2, hours: 1)
// > July 27, 2008, 1:00 AM GMT

Any usage of add can also be used with subtract, which does the same thing, but in reverse.

Or you can use the significantly cooler operator overloading.

d1 + 5.hours()
// > July 4, 2008, 5:00 AM GMT

d1 - 2.days() - 1.hour() + 5.minutes()
// > July 1, 2008, 11:05 PM GMT

Using it in your project

It's a Swift library, so just build the framework, drop it into your project and import SwiftDateUtils.

Known issues

Any module that imports SwiftDateUtils will magically gain a module-level constant called formatter. You can still declare your own variables and constants, of any type, called formatter, or just ignore it, but it will turn up in your auto-complete. Any suggestions for getting rid of this, I am happy to hear them.