Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/naoty/Timepiece
Intuitive date handling in Swift
https://github.com/naoty/Timepiece
date swift
Last synced: about 2 months ago
JSON representation
Intuitive date handling in Swift
- Host: GitHub
- URL: https://github.com/naoty/Timepiece
- Owner: naoty
- License: mit
- Created: 2014-08-16T10:35:34.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2019-10-15T08:55:28.000Z (over 4 years ago)
- Last Synced: 2024-04-15T02:57:38.966Z (2 months ago)
- Topics: date, swift
- Language: Swift
- Homepage:
- Size: 270 KB
- Stars: 2,639
- Watchers: 42
- Forks: 147
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
Lists
- awesome-ios - Timepiece - Intuitive NSDate extensions in Swift. (Date & Time / Getting Started)
- awesome-swift - Timepiece - Intuitive NSDate extensions. (Libs / Date)
- awesome-swift - Timepiece - Intuitive NSDate extensions. (Libs / Date)
- awesome-stars - Timepiece
- awesome-swifte - Timepiece - Intuitive NSDate extensions. (Libs / Date)
- awesome-swifty - Timepiece - Intuitive NSDate extensions. (Libs / Date)
- awesome-swift4 - Timepiece - Intuitive NSDate extensions. (Libs / Date)
- awesome-ios2 - Timepiece - Intuitive NSDate extensions in Swift (Date & Time / Other free courses)
- awesome-ios - Timepiece - Intuitive NSDate extensions in Swift (Date & Time / Other free courses)
- awesome-ios-star - Timepiece - Intuitive NSDate extensions in Swift. (Date & Time / Getting Started)
- awesome-anything - Timepiece - date/time handling (Development / iOS)
- awesome-swiftxx - Timepiece - Intuitive NSDate extensions. (Libs / Date)
- awesome-ios - Timepiece - Intuitive NSDate extensions in Swift. (Date & Time / Linter)
- awesome-ios - Timepiece - Intuitive NSDate extensions in Swift (Date & Time / Other free courses)
- fucking-awesome-swift - Timepiece - Intuitive NSDate extensions. (Libs / Date)
- awesome-swiftqq - Timepiece - Intuitive NSDate extensions. (Libs / Date)
- awesome-swift-cn - Timepiece - Intuitive NSDate extensions in Swift. (Libs / Date)
- awesome-xamarin-forms - Timepiece - Intuitive NSDate extensions :large_orange_diamond:[e] (Date & Time)
- awesome-swift - Timepiece - Intuitive NSDate extensions. (Libs / Date)
- awesome-ios - Timepiece - Intuitive NSDate extensions in Swift. (Date & Time / Linter)
- awesome-from-stars - naoty/Timepiece
- awesome-stars - naoty/Timepiece - Intuitive date handling in Swift (Swift)
- awesome-ios - Timepiece - Intuitive NSDate extensions in Swift :large_orange_diamond: (Date & Time / Other free courses)
- awesome-iosx - Timepiece - Intuitive NSDate extensions in Swift. (Date & Time / Getting Started)
- awesome-ios - Timepiece - Intuitive NSDate extensions in Swift. (Date & Time / Linter)
- awesome-iosr - Timepiece - Intuitive NSDate extensions in Swift. (Date & Time / Getting Started)
- learn.awesome-iOS - Timepiece - Intuitive NSDate extensions in Swift :large_orange_diamond: (Date & Time)
- learn.awesome.ios - Timepiece - Intuitive NSDate extensions in Swift. (Date & Time / Linter)
- awesome-ios - Timepiece - Intuitive NSDate extensions in Swift. (Date & Time / Linter)
- awesome-swift - Timepiece - Intuitive date handling in Swift ` 📝 2 years ago ` (Date [🔝](#readme))
README
# Timepiece [](https://cocoapods.org/pods/Timepiece) [](https://travis-ci.org/naoty/Timepiece)
Intuitive date handling in Swift
## Features
* :bulb: **Intuitive**: Timepiece provides a set of helpers to make date handling easier.
* :clock9: **Correct**: Using Foundation API correctly, Timepiece helps to calculate dates correctly without deep understanding.
* :package: **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
```swift
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
```swift
now + 1.year
now - 2.months
now + (3.weeks - 4.days + 5.hours)
1.year.later
1.year.ago
```
### Change
```swift
now.changed(year: 2014)
now.changed(weekday: 1)
now.truncated([.minute, .second, .nanosecond])
now.truncated(from: .day)
```
### Formating
```swift
now.stringIn(dateStyle: .long, timeStyle: .medium)
now.dateString(in: .medium)
now.timeString(in: .short)
3.days.string(in: .full)
```
### Parsing
```swift
"2014/8/14".date(inFormat: "yyyy/MM/dd")
"2014-08-14T20:25:43+0900".dateInISO8601Format()
```
## Installation
### CocoaPods
```ruby
# Podfile
pod "Timepiece"
```
### Carthage
```ruby
# Cartfile
github "naoty/Timepiece"
```
## Contribution
1. Fork
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request
## License
Timepiece is available under the MIT license. See the LICENSE file for more info.
## Author
[naoty](https://github.com/naoty)