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 1, 2025
SwiftUI

FigmaPreviewSwiftUI

A Figma component preview for your SwiftUI views. You can use Figma components instead of real views within your app ...

August 1, 2025
SwiftUI

SafePreviewDevice

Motivation At WWDC 2019, Apple announced SwiftUI a new library for building UI in a simple and fast way. Xcode’s ...

August 1, 2025
SwiftUI

PreviewView

Make use of SwiftUI previews for rapidly prototyping your UIViewControllers and UIViews! The SwiftUI preview canvas is tied to a specific version of ...

August 1, 2025
SwiftUI

PreviewDevice

Requirements Dev environment: Xcode 13+, macOS 12+ iOS 13.0+, macOS 10.15+, Mac Catalyst 13.0+, tvOS 13.0+, watchOS 6.0+ Usage

August 1, 2025
SwiftUI

SwiftUIWheelPicker

Horizontal wheel picker for SwiftUI Requirements iOS 13.0+ Installation CocoaPods