Timepiece
Intuitive date handling in Swift
Features
-
π‘ Intuitive: Timepiece provides a set of helpers to make date handling easier. -
π Correct: Using Foundation API correctly, Timepiece helps to calculate dates correctly without deep understanding. -
π¦ Small: Timepiece has only 4 file. You can read the inside of this easily.
Requirements
- Swift 3.0+
- iOS 8.0+ / macOS 10.9+ / tvOS 9.0+ / watchOS 2.0+
Usage
Initialization
Date(era: 235, year: 26, month: 8, day: 14, hour: 20, minute: 25, second: 43, nanosecond: 0, on: Calendar(identifier: .japanese))
Date(year: 2014, month: 8, day: 14, hour: 20, minute: 25, second: 43, nanosecond: 0)
Date(year: 2014, month: 8, day: 14, hour: 20, minute: 25, second: 43)
Date(year: 2014, month: 8, day: 14)
Date.today()
Date.yesterday()
Date.tomorrow()
Calculation
now + 1.year
now - 2.months
now + (3.weeks - 4.days + 5.hours)
1.year.later
1.year.ago
Change
now.changed(year: 2014)
now.changed(weekday: 1)
now.truncated([.minute, .second, .nanosecond])
now.truncated(from: .day)
Formating
now.stringIn(dateStyle: .long, timeStyle: .medium)
now.dateString(in: .medium)
now.timeString(in: .short)
3.days.string(in: .full)
Parsing
"2014/8/14".date(inFormat: "yyyy/MM/dd")
"2014-08-14T20:25:43+0900".dateInISO8601Format()
Installation
CocoaPods
# Podfile
pod "Timepiece"
Carthage
# Cartfile
github "naoty/Timepiece"
Contribution
- Fork
- Create your feature branch (git checkout -b my-new-feature)
- Commit your changes (git commit -am 'Add some feature')
- Push to the branch (git push origin my-new-feature)
- Create new Pull Request
License
Timepiece is available under the MIT license. See the LICENSE file for more info.