Time is a Swift package that makes it easy to perform robust and type-safe date and time calculations.

Working with calendars can be extremely complicated and error-prone. Time solves these problems by clarifying concepts and restricting improper usage through type-safe APIs.

Installing


Time can be installed like any other Swift package. Add this to the dependencies section of your Package.swift:

.package(url: “https://github.com/davedelong/time”, from: “1.0.0”)

Platform Support


Time requires Swift 5.7 or later, as well as macOS 13/iOS 16 (or equivalent) or later. Core parts of the library are built on Swift’s Duration type, which was introduced in macOS 13/iOS 16.

Documentation


Time‘s extensive documentation is hosted at the Swift Package Index.

Additionally, an “Examples” folder in this repository contains code illustrating how to use core parts of the library.

The Basics


Here’s the TL;DR of the documentation:

  • If you want to know what time it is, you need the device’s RegionalClock, which you get by using Clocks.system.

  • RegionalClock tells you the current time. For example, .today will give you the current calendar day. .currentMinute will give you the current time, accurate down to the minute level.

  • Each of these returned values has methods to retrieve more- and less- precise values. For example, today.hours will give you a sequence of all the “Hour” values in the day.

  • These values can be formatted into human-readable strings via their .format(...) methods.

For additional information, refer to the documentation and included examples.

GitHub


View Github

#calendar #calendars #date #date-formatting #date-time #datetime #swift #time #timezone
YOU MIGHT ALSO LIKE...
MijickPopups Hero

  Popups Alerts Resizable Sheets Banners

SwiftUI Tooltip

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

SimpleToast for SwiftUI

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

SSToastMessage

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

ToastUI

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