最近项目中用到了不少定时器，不管是订单确认、订单支付以及验证码等都会用到倒计时，所以就重新的封装了一个比较好用的，方便使用。天生愚钝的我可能写的没有那么完美，希望各位大神看后能给出指导的建议，包括有什么新的需求可以添加的，我好加以修改。
说多了都是废话，直接上图，你能用到并且能够看上才是真理。
Timer.gif
下面我来简单的说一下如何使用这个定时器：
1.0 创建
@objc enum TYCountDownLabelType: Int {
case defaultType // 倒计时
case incrementTimeType // 递增时间
}
// 方式一
let timerL = TYTimerLabel(label: timerLabel) // 默认倒计时
// 方式二
let timerL = TYTimerLabel(label: timerLabel, type: .defaultType) // .defaultType为倒计时
// 方式三
let timerL = TYTimerLabel(frame: .zero, label: timerLabel, type: .incrementTimeType) // .incrementTimeType递增时间
2.0 属性
// 是否开始倒计时
var counting: Bool = false
// 倒计时结束是否重置时间
var isResetTime: Bool = false
// 时间格式类型
fileprivate var _timeFormat: String?
var timeFormat: String? {
get {
if _timeFormat == nil || (_timeFormat?.count ?? 0) == 0 {
_timeFormat = defaultTimeFormatter
}
return _timeFormat
} set {
_timeFormat = newValue
self.dateFormatter?.dateFormat = _timeFormat
self.renewalLabel()
}
}
// dateFormatter
fileprivate var _dateFormatter: DateFormatter?
fileprivate var dateFormatter: DateFormatter? {
get {
if _dateFormatter == nil {
_dateFormatter = DateFormatter.init()
/**
**不同地区有不同的日期格式。使用这个方法的目的：得到指定地区指定日期字段的一个合适的格式
**en_US(United States) : MM/dd/YYYY, HH:mm:ss; en_GB(United Kingdom): dd/MM/YYYY, HH:mm:ss; zh_CN(中国): YYYY/MM/dd HH:mm:ss
**/
_dateFormatter?.locale = Locale(identifier: "en_GB")
/**
**时区: 任何时区都以GMT为准
** iOS中的时间类NSDate所获取到的时间, 都是相对于GMT的
**/
_dateFormatter?.timeZone = TimeZone(identifier: "GMT")
_dateFormatter?.dateFormat = self.timeFormat
}
return _dateFormatter
} set {
_dateFormatter = newValue
}
}
3.0 方法
// 开启定时器
timerL.start()
// 暂停定时器
timerL.pause()
// 重置定时器
timerL.reset()
// 通过传入时间间隔来设定倒计时的具体时间
timerL.countDownTimeWithTimeInterval(timeInterval: 60) // 设计倒计时一分钟
// 通过传入的Date来设定倒计时的具体时间
timerL.countDownTimeWithDate(date: dateTime ?? Date())
// 通过传入的时间间隔设置递增时间的初始时间，默认是0:0:0
timerL.incrementTimeWithTimeInterval(interval: 60) // 从一分钟开始
// 获取已经过去的时间
let consumeTime = timerL.etConsumeTime()
// 获取剩余的倒计时时间
let countDownResidueTime = timerL.residueTime()
// 获取倒计时的总时间
let countDownTime = timerL.getCountDownTime()
3.0 代理
/// 自定义代理
@objc protocol TYCountDownLabelTypeDelegate: NSObjectProtocol {
/**
** 方法: 根据参数的判断, 更改label的样式等(根据自己的需求)
** 参数label: 用来展示定时器输出文字的label
** 参数time: 对于倒计时来说就是当前剩余的时间间隔, 对于递增时间来说就是当前增加到的时间间隔
**/
@objc optional func changeTimerLabelAttrAtTime(label: UILabel, time: TimeInterval, type: TYCountDownLabelType)
/**
** 方法: 自定义label文字的输出格式
** 参数label: 用来展示定时器输出文字的label
** 参数time: 对于倒计时来说就是当前剩余的时间间隔, 对于递增时间来说就是当前增加到的时间间隔
** 返回值: 自定义的字符串
**/
@objc optional func customTextToDisplayAtTime(label: UILabel, time: TimeInterval) -> String?
/**
** 方法: 自定义label文字的输出格式
** 参数label: 用来展示定时器输出文字的label
** 参数time: 倒计时的总时间间隔
**/
@objc optional func countDownTimeOver(label: UILabel, time: TimeInterval)
}
使用起来也是非常的方便，你可以根据你们产品的具体的需求来自定义定时器的样式，根据后台给你们返回的数据的类型来具体的使用。我写一个简单的使用例子：
a. 创建定时器
// MARK: 创建定时器Label
func createTimerLabel() {
let dateFormatter = DateFormatter()
let time = "2018-11-29 12:32:25" // 这里自定义
dateFormatter.dateFormat = "yyy-MM-dd HH:mm:ss"
let dateTime = dateFormatter.date(from: time)
timer = TYTimerLabel.init(label: timerLabel, type: .defaultType)
timer?.countDownTimeWithDate(date: dateTime ?? Date())
// timer?.countDownTimeWithTimeInterval(timeInterval: 60)
timer?.timeFormat = "HH:mm:ss"
timer?.isResetTime = true
timer?.delegate = self
incrementTimer = TYTimerLabel.init(label: incrementTimerLabel, type: .incrementTimeType)
incrementTimer?.incrementTimeWithTimeInterval(interval: 0)
incrementTimer?.timeFormat = "HH:mm:ss SS"
incrementTimer?.delegate = self
}
b. 开始、暂停、重置按钮的实现（不需要按钮的话直接start()开启）
// MARK: 开启定时器
@objc private func startBtnAction(btn: UIButton) {
if btn.tag == 1 {
timer?.start()
} else {
incrementTimer?.start()
}
}
// MARK: 暂停定时器
@objc private func stopBtnAction(btn: UIButton) {
if btn.tag == 2 {
timer?.pause()
} else {
incrementTimer?.pause()
}
}
// MARK: 重置定时器
@objc private func resetBtnAction(btn: UIButton) {
if btn.tag == 3 {
timer?.reset()
} else {
incrementTimer?.reset()
}
}
c.代理方法的实现(产品有特殊的需求)
extension TYTimerViewController: TYCountDownLabelTypeDelegate {
// MARK: 自定义label的样式
func changeTimerLabelAttrAtTime(label: UILabel, time: TimeInterval, type: TYCountDownLabelType) {
if label == timerLabel {
if time < 55 {
label.textColor = .red
} else {
label.textColor = .white
}
}
}
// MARK: 自定义文字输出内容
func customTextToDisplayAtTime(label: UILabel, time: TimeInterval) -> String? {
if type == "custom" {
let hours = Int(time / 3600)
let minutes = Int((time - Double(hours * 3600)) / 60)
let seconds = Int(time - Double(hours * 3600) - Double(minutes * 60))
return "\(hours)" + "h" + "\(minutes)" + "min" + "\( seconds)" + "s"
} else {
return nil
}
}
// MARK: 倒计时结束
func countDownTimeOver(label: UILabel, time: TimeInterval) {
label.text = "game over"
}
}
屏幕快照 2018-11-29 下午3.25.18.png
屏幕快照 2018-11-29 下午3.26.24.png
