Skip to content
A TimeZonePicker UIViewController similar to the iOS Settings app. Search and select from a range of cities and countries to find your most suitable time zone.
Branch: master
Clone or download
Latest commit 42b94ba Nov 22, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Classes updated podspec to version 1.2.0 and project to Swift 4 Nov 6, 2017
Resources adding a cancel button to dismiss the time picker controller Jul 19, 2017
Screenshots updated readme and added screenshots/preview Jul 19, 2017
TimeZonePickerExample updated podspec to version 1.2.0 and project to Swift 4 Nov 6, 2017
.gitignore updated gitignore to ignore Pods and related files Jul 19, 2017
.swift-version updated podspec to version 1.2.0 and project to Swift 4 Nov 6, 2017
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md Jul 21, 2017
LICENSE
README.md adding public bitrise app Nov 22, 2018
TimeZonePicker.podspec updated podspec to version 1.2.0 and project to Swift 4 Nov 6, 2017
bitrise.yml add bitrise.yml Nov 22, 2018

README.md

TimeZonePicker

Build Status codebeat badge Version License Platform

Buy Me a Coffee at ko-fi.com

A TimeZonePicker UIViewController similar to the iOS Settings app. Search and select from a range of cities and countries to find your most suitable time zone.

Screenshots

Installation

CocoaPods

To install it in your iOS project, install with CocoaPods

pod 'TimeZonePicker'

Usage

Basic Initialisation

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)

TimeZonePickerDelegate

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.

Requirements

  • iOS 8 or later.
  • Swift 3

License

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.
You can’t perform that action at this time.