A TimeZonePicker UIViewController and SwiftUI View similar to the iOS Settings app. Search and select from a range of cities and countries to find your most suitable time zone.
To install it in your iOS project, install with CocoaPods
pod 'TimeZonePicker'To initialise a timeZonePicker you can use the class function getVC(withDelegate: TimeZonePickerDelegate) on the TimeZonePickerViewController as below:
let timeZonePicker = TimeZonePickerViewController.getVC(withDelegate: self)Then you can use the timeZonePicker as you would any UIViewController, for example:
present(timeZonePicker, animated: true, completion: nil)The TimeZonePickerDelegate currently has only one method that needs to be implemented:
func timeZonePicker(_ timeZonePicker: TimeZonePickerViewController, didSelectTimeZone timeZone: TimeZone)Once an item is selected from the table of cities/countries the above delegate method gets called, conveniently returning the TimeZonePickerViewController and the selected TimeZone. You can use the timeZonePicker to dismiss it here and the timeZone as you need it in your application. For example:
func timeZonePicker(_ timeZonePicker: TimeZonePickerViewController, didSelectTimeZone timeZone: TimeZone) {
timeZoneName.text = timeZone.identifier
timeZoneOffset.text = timeZone.abbreviation()
timeZonePicker.dismiss(animated: true, completion: nil)
}Please check the TimeZonePickerExample project for the above usage example. If you have any questions do not hesitate to get in touch with me.
In addition to the UIKit-based view controllers, there is also a SwiftUI View available, called TimeZonePreviewSelectionView.
To use TimeZonePicker in a SwiftUI app, include TimeZonePreviewSelectionView() in your View, and bind it to a CityCountryTimeZone variable, like so:
struct ContentView: View {
// variable storing the time zone data
@State var myTimeZone: CityCountryTimeZone = CityCountryTimeZone()
var body: some View {
VStack {
// Creates the time zone preview picker
TimeZonePreviewSelectionView(cityItem: self.$myTimeZone)
// Displays the selected time zone
Text("The selected time zone is \(self.myTimeZone.timeZoneName)")
}
}
}Note: So far, this has only been tested on macOS Catalina. It should work on iOS as well, but it is not guaranteed yet.
- iOS 8 or later.
- Swift 3
Copyright (c) 2017 Gligor Kotushevski
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.