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

MijickPopups Hero

Popups Alerts Resizable Sheets Banners

August 27, 2025
SwiftUI

SwiftUI Tooltip

This package provides you with an easy way to show tooltips over any SwiftUI view, since Apple does not provide ...

August 27, 2025
SwiftUI
Uncategorized

SimpleToast for SwiftUI

SimpleToast is a simple, lightweight, flexible and easy to use library to show toasts / popup notifications inside iOS or ...

August 27, 2025
SwiftUI

SSToastMessage

Create Toast Views with Minimal Effort in SwiftUI Using SSToastMessage. SSToastMessage enables you to effortlessly add toast notifications, alerts, and ...

August 27, 2025
SwiftUI

ToastUI

A simple way to show toast in SwiftUI Getting Started • Documentation • Change Log