DateSuger 0.1.1

DateSuger 0.1.1

测试已测试
语言语言 SwiftSwift
许可 MIT
发布最后发布2015年12月
SPM支持SPM

DanisFabric 维护。



DateSuger 0.1.1

  • DanisFabric

logo

DateSuger

DateSuger 是一个优化 Cocoa 时间、日期使用方式的组件。Cocoa 的 NSDate、NSDateComponent,NSCalendar 等类提供了极其强大的日期处理功能,但是使用起来却十分繁琐。DateSuger 就是基于 Swift2.0 语言的,对日期处理逻辑的一系列语法糖。

要求

  • iOS8 +
  • Swift 2.0 +

安装

手动

直接将 Source 目录下的 Swift 文件导入到工程中。

使用

日期编辑

我们想获得当前时间十天后的 NSDate 对象,在 Cocoa 中是这么做的:

let date1 = NSDate()
let components = NSDateComponents()
components.day = 10
let calenar = NSCalendar(calendarIdentifier: NSCalendarIdentifierGregorian)
let date2 = calenar?.dateByAddingComponents(components, toDate: date1, options: [])

在 DateSuger 中一句话就可以代替:

let date3 = NSDate().dateByAddingDays(10)

还想更简单吗?还能这样:

let date4 = NSDate() + .Day(10)

这样相比于传统的 Cocoa 接口,更加易用且容易理解。计算 1 年零 3 个月之后:

let date5 = NSDate() + .Year(1) + .Month(3)

就是这么简单~

日期信息

如果我们要知道今天是几月,或是星期几,传统代码如下:

let calendar = NSCalendar(calendarIdentifier: NSCalendarIdentifierGregorian)
let components = calendar?.components([.Weekday,.Month], fromDate: NSDate())
let weekday = components?.weekday
let month = components?.month

通过 DateSuger 可以直接从 NSDate 实例中获取

let weekday = NSDate().weekday

支持的日期信息有:

Era
Year
Month
Day
Hour
Minute
Second
Quarter
Weekday
WeekdayOridinal
WeekOfMonth
WeekOfYear
DayOfYear

其他信息判断

DateSuger 支持对一些常用信息的判断,以下为实例代码展示:

let v1 = NSDate().isInLeapYear          // 判断是否是闰年
let v2 = NSDate().isToday               // 判断是否是今天
let v3 = NSDate().isTomorrow            // 判断是否是明天
let v4 = NSDate().isYesterday           // 判断是否是昨天
let v5 = NSDate().isSameDay(someDate)   // 判断是否和某日期在同一天

快速创建 NSDate

能够通过指定年、月、日、小时、分钟、秒来创建 NSDate

let date1 = NSDate.dateWithYear(2015, month: 3, day: 
let date2 = NSDate.dateWithYear(2015, month: 3, day: 28, hour: 3, minute: 12, second: 12)

日期比较

能够直接通过操作符来比较 NSDate,这样是否方便了很多

if date1 > date2 {
    //...
}
if date1 >= date2 {
    //...
}
if date1 == date2 {
    //...
}

许可

The MIT License (MIT)

版权所有 © 2015 DanisFabric

特此授予任何获得本软件及其相关文档副本(“软件”)的人免费使用该软件的权利,包括但不限于使用、复制、修改、合并、发布、分发、转让和/或销售该软件副本的权利,并允许任何人将软件提供给他人,让他们可以使用,但应遵守以下条件

本版权声明和许可声明应包含在本软件的副本或主要部分中。

本软件按“现状”提供,没有任何形式的保证,无论是明示的还是暗示的,包括但不限于对适销性、特定用途适用性和非侵权的保证。在任何情况下,作者或版权所有者不应对任何索赔、损害或其他责任负责,无论是基于合同的、侵权或其他方式,此类索赔、损害或其他责任源自、因于或与本软件或使用或操作本软件有关。