商品倒计时 for Swift

因公司项目添加商品倒计时需求,故针对商品倒计时模块做了个Demo,也是对自己的总结;

经过370041534群里的朋友提醒,既然是cell上有多个倒计时,可使用一个定时器控制cell上所有的倒计时,在这里感谢这位朋友,并针对此问题进行了优化。

效果图

废话不多说先放一个效果图


效果图

实现步骤

基础实现

  1. 获取当前系统时间
// 获取当前时区的Date
static func getCurrentDate() -> Date {
    let nowDate = Date()
    let zone = NSTimeZone.system
    let interval = zone.secondsFromGMT(for: nowDate)
    let localeDate = nowDate.addingTimeInterval(TimeInterval(interval))
    return localeDate
 }
  1. 与服务器协商到期时间通过时间戳的方法返回,我们需要把时间戳转换成Date
// 时间戳转换成Date
func timestampWithDate() -> Date {
    let date = Date.init(timeIntervalSince1970: self)
    let zone = NSTimeZone.system
    let interval = zone.secondsFromGMT(for: date)
    let localeDate = date.addingTimeInterval(TimeInterval(interval))
    return localeDate
}
  1. 计算差值
    查看文档可通过日历类NSCalendardateComponents方法获取两个日期的差值,正好符合我们的需求。

The result of calculating the difference from start to end.

/// Returns the difference between two dates.
///
/// - parameter components: Which components to compare.
/// - parameter start: The starting date.
/// - parameter end: The ending date.
/// - returns: The result of calculating the difference from start to end.
public func dateComponents(_ components: Set<Calendar.Component>, from start: Date, to end: Date) -> DateComponents

这里需要注意components参数,如果传[.year, .month, .day, .hour, .minute, .second]是算差多少年月日时分秒。
需求只要获取差值的时分秒,故只传[ .hour, .minute, .second]即可,代码如下:

// 获取当前时间
let nowDate = Date.getCurrentDate()
// 获取结束时间
let endDate = endTime.timestampWithDate()
    
let calendar = NSCalendar.current
// The result of calculating the difference from start to end.
let components = calendar.dateComponents([.hour, .minute, .second], from: nowDate, to: endDate)
    
guard let hour = components.hour,
    let minute = components.minute,
    let second = components.second else { return }
    
print("差值为:\(hour)时\(minute)分\(second)秒")
  1. 通过定时器动态进行倒计时
    此处通过isStartTimer判断是否需要执行定时器,目的是为实现多cell下一个定时器操作多个倒计时,具体请继续往下看:
// 便利构造器
convenience init(frame: CGRect, isStartTimer:Bool = true) {
    self.init(frame: frame)
    self.isStartTimer = isStartTimer
}

// 结束时间(传递接口返回的时间戳)
open var endTime:Double? {
    didSet {
        if isStartTimer == true {
            if codeTimer != nil { return }
            
            let queue = DispatchQueue.global()
            codeTimer = DispatchSource.makeTimerSource(queue: queue)
            codeTimer?.schedule(wallDeadline: .now(), repeating: .seconds(1))
            codeTimer?.setEventHandler { [weak self] in
                DispatchQueue.main.async(execute: {
                    self?.refreshTime()
                })
            }
            codeTimer?.resume()
        } else {
            refreshTime()
        }
    }
}
    
// 主要实现计算时间差值方法
func refreshTime() {
    guard let endTime = endTime else { return }
    
    // 获取当前时间
    let nowDate = Date.getCurrentDate()
    // 获取结束时间
    let endDate = endTime.timestampWithDate()
    
    let calendar = NSCalendar.current
    // The result of calculating the difference from start to end.
    let components = calendar.dateComponents([.hour, .minute, .second], from: nowDate, to: endDate)
    
    guard let hour = components.hour,
        let minute = components.minute,
        let second = components.second else { return }
    
    if hour < 0 || minute < 0 || second < 0  {
        removeTimer()
        hourLabel.text = "00"
        minuteLabel.text = "00"
        secondLabel.text = "00"
    } else {
        hourLabel.text = "\(hour.keepInt())"
        minuteLabel.text = "\(minute.keepInt())"
        secondLabel.text = "\(second.keepInt())"
    }
}
    
// MARK: - 移除Timer
fileprivate func removeTimer() {
    if codeTimer != nil {
        codeTimer?.cancel()
        codeTimer = nil
    }
}

初始化时传入true or false,默认true,用于页面只有一个定时器的情况,如只需要一个定时器单独创建。

列表下一个定时器控制多个倒计时

想要实现一个定时器控制多个倒计时,我们需要获取UITableViewvisibleCells属性,通过查看文档此属性是获取UITableView的当前显示cell。
这样我们就可以创建一个定时器,并在定时器方法中便利UITableView中当前显示的cell,并给与赋值。
实现代码如下:

convenience init(tableView: UITableView, dateArray: [Double]) {
    self.init()
    
    self.tableView = tableView
    self.dateArray = dateArray
    
    setCountDown()
}
    
// MARK: - 定时器
func setCountDown() {
    if codeTimer != nil { return }
    
    let queue = DispatchQueue.global()
    codeTimer = DispatchSource.makeTimerSource(queue: queue)
    codeTimer?.schedule(wallDeadline: .now(), repeating: .seconds(1))
    codeTimer?.setEventHandler { [weak self] in
        DispatchQueue.main.async(execute: {
            guard let cells = self?.tableView?.visibleCells else { return }
            guard let dateArray = self?.dateArray else { return }
            for cell in cells {
                guard let cell = cell as? TableViewCell else { return }
                cell.dateView.endTime = dateArray[cell.tag]
            }
        })
    }
    codeTimer?.resume()
}

这样我们只要在初始化TableView后,执行convenience init(tableView: UITableView, dateArray: [Double])即可。

到目前为止自测过程中还遇到一个问题,快速滑动时时间会错乱。
分析了下发现是因为定时器每秒执行,快速滑动UITableView时页面数据并未刷新导致重用了。。。
思考了下,在TableView重用池中重新赋值,之后定时器方法会自动触发,可能有更好的方法实现,欢迎指点。
实现代码如下:

func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    let cell = tableView.dequeueReusableCell(withIdentifier: TableViewCell.tableViewCellReuse) as! TableViewCell
    cell.tag = indexPath.row
    // 重用池方法赋值,防止滑动时数据错乱
    cell.dateView.endTime = dateArray[indexPath.row]
    return cell
}

针对防用户修改时间,导致倒计时时间错误问题,后续会进行更新

完整Demo

传送门

推荐阅读更多精彩内容