Timepiece - SwiftGit

ScrollView SwiftUI

Timepiece

April 7, 2024

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

GitHub

View Github

#datetime

YOU MIGHT ALSO LIKE...

August 22, 2025
SwiftUI

Popup View

Floaters Toasts Popups Sheets

August 21, 2025
SwiftUI

Drops 💧

A µFramework for showing alerts like the one used when copying from pasteboard or connecting Apple pencil.

August 21, 2025
SwiftUI

MarqueeText

A SwiftUI Marquee or "scrolling text" effect found in Apple native apps. For when one line isn't enough, but two ...

August 21, 2025
SwiftUI

TextBuilder

Introduction Text composition in SwiftUI can often be cumbersome, especially when there's logic affecting its format and content. TextBuilder leverages the ...

August 20, 2025
SwiftUI

TextView

Download File -> Swift Packages -> Add Package Dependency... Select your project Enter https://github.com/kenmueller/TextView for the package repository URL Select Branch: master Click Finish ...