ktime

项目介绍

本库是从实际项目中提取的一个强大优雅的轻量级时间库。

本库特点:

1. 简单优雅，时间api和基础加减语法一致。
2. 轻量，0依赖，只要求最基础的jdk8 + kotlin1.2，其中kotlin也可以不依赖而只使用java开发，但单纯使用java开发则无法使用本库带来的优雅语法的特性了。
3. 项目默认使用maven打包,由于0依赖特性,甚至可以直接将时间库源文件复制到自己的项目中使用。
4. 支持 java.util.Date 系列日期和时间、JDK8的新版LocalDateTime系列日期和时间，并且支持自己拓展其他日期、时间类型。

使用说明

1. Dates对象：获取昨日、今日、明日零点的日期、时间戳。
2. DateTimes对象：对java.util.Date系列日期、时间进行格式化以及字符串解析。
3. 计算器拓展支持：java.util.Date、java.sql.Date、Timestamp、Time、LocalDateTime、LocalDate、LocalTime，其中，java.util.Date、java.sql.Date、Timestamp由于其可继承特性，它们的对应计算器也继承自它们，因此这几个类的时间计算支持连续加减。
4. 拓展属性：cDay、cMonth、cDay、cHour、cMinute、cSecond、cMilli、cNano 等方法,用于获取支持计算年、月、日、时、分、秒、毫秒、纳秒的计算器对象。
5. 拓展方法：withDate、withTime 等方法,用于指定一个日期、时间对象的日期或时间部分。
6. 拓展伪构造函数:Timestamp、Date、Time已快速出构造一个当前日期、时间的java.util.Date下的子类对象。

示范

import org.junit.Test
import yu.com.time.*
import java.time.temporal.ChronoUnit
import java.util.*


/**
 * 使用例子
 * created zpf on 2018/10/24 0024
 */
class Example {

    @Test
    fun example() {
        println("1.当前时间:java旧版 vs 时间库")
        println(Date())
        println(Timestamp())

        println("2.时间增减(获取去年):java旧版 vs 时间库")
        println(java.sql.Timestamp.valueOf(Date().toLocalDateTime().minusYears(1)))
        println(Timestamp().cYear - 1)

        println("3.时间间隔天数(现在和去年之间):java旧版 vs 时间库")
        val now = Timestamp()   //现在
        val lastYear = Timestamp().cYear - 1  //去年
        println(lastYear.toLocalDateTime().until(now.toLocalDateTime(), ChronoUnit.DAYS))
        println(now.cDay - lastYear)

        println("4.指定日期部分:今年2月1日12点")
        println(now.withDate(null, 2, 1).withTime(12))
    }
}

运行效果

参与贡献

1. Fork 本项目
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request

码云特技

1. 使用 Readme_XXX.md 来支持不同的语言，例如 Readme_en.md, Readme_zh.md
2. 码云官方博客 blog.gitee.com
3. 你可以 https://gitee.com/explore 这个地址来了解码云上的优秀开源项目
4. GVP 全称是码云最有价值开源项目，是码云综合评定出的优秀开源项目
5. 码云官方提供的使用手册 https://gitee.com/help
6. 码云封面人物是一档用来展示码云会员风采的栏目 https://gitee.com/gitee-stars/