Easy to use yet powerful Timer library. Keep your code clean
Timer is a free and open-source library dedicated for Swift that makes the process of handling timers easier and much cleaner.
- Improves code quality. Start timer using the
publish().start()
method. Stop the timer withstop()
. Simple as never. - Run your timer in both directions. Our Timer can operate in both modes (increasing or decreasing).
- Supports background mode. Don't worry about the timer when the app goes into the background. We handled it!
- And much more. Our library allows you to convert the current time to a string or to display the timer progress in no time.
Platforms | Minimum Swift Version |
---|---|
iOS 13+ | 5.0 |
iPadOS 13+ | 5.0 |
macOS 10.15+ | 5.0 |
Swift package manager is a tool for automating the distribution of Swift code and is integrated into the Swift compiler.
Once you have your Swift package set up, adding Timer as a dependency is as easy as adding it to the dependencies
value of your Package.swift
.
dependencies: [
.package(url: "https://github.com/Mijick/Timer", branch(“main”))
]
Cocoapods is a dependency manager for Swift and Objective-C Cocoa projects that helps to scale them elegantly.
Installation steps:
- Install CocoaPods 1.10.0 (or later)
- Generate CocoaPods for your project
pod init
- Add CocoaPods dependency into your
Podfile
pod 'MijickTimer'
- Install dependency and generate
.xcworkspace
file
pod install
- Use new XCode project file
.xcworkspace
Call the publish()
method that has three parameters:
- time - The number of seconds between firings of the timer.
- tolerance - The number of seconds after the update date that the timer may fire.
- currentTime - The current timer time.
try! MTimer.publish(every: 1, currentTime: $currentTime)
Start the timer using the start()
method. You can customise the start and end time using the parameters of this method.
try! MTimer
.publish(every: 1, currentTime: $currentTime)
.start(from: .init(minutes: 21, seconds: 37), to: .zero)
You can observe changes in both values by calling either of the methods
try! MTimer
.publish(every: 1, currentTime: $currentTime)
.bindTimerStatus(isTimerRunning: $isTimerRunning)
.bindTimerProgress(progress: $timerProgress)
.start(from: .init(minutes: 21, seconds: 37), to: .zero)
Timer can be stopped with stop()
method.
MTimer.stop()
- Once stopped, the timer can be resumed - simply use the
resume()
method.
try! MTimer.resume()
- To stop and reset the timer to its initial values, use the
reset()
method.
MTimer.reset()
You can convert the current MTime to String by calling the toString()
method. Use the formatter
parameter to customise the output.
currentTime.toString {
$0.unitsStyle = .full
$0.allowedUnits = [.hour, .minute]
return $0
}
Create a new instance of the timer and assign it to a new variable. Use the above functions directly with it
let newTimer = MTimer.createNewInstance()
try! newTimer
.publish(every: 1, currentTime: $currentTime)
.start()
newTimer.stop()
See for yourself how does it work by cloning project we created
Timer is released under the MIT license. See LICENSE for details.
PopupView - The most powerful popup library that allows you to present any popup
Navigattie - Easier and cleaner way of navigating through your app
CalendarView - Create your own calendar object in no time
GridView - Lay out your data with no effort