Проект представляет собой мощную и элегантную легковесную библиотеку времени, созданную на основе реальных проектов.

Особенности библиотеки:

• простота и элегантность: API времени и базовая арифметика совпадают;
• лёгкость: библиотека не имеет зависимостей, для работы требуется только JDK 8 и Kotlin 1.2. Kotlin можно не использовать, а писать код на Java, но в этом случае нельзя будет воспользоваться преимуществами элегантного синтаксиса библиотеки;
• проект по умолчанию использует Maven для упаковки. Благодаря отсутствию зависимостей можно просто скопировать исходные файлы библиотеки в свой проект;
• поддерживает java.util.Date — серию дат и времени, новую версию LocalDateTime JDK 8, а также позволяет расширять другие типы дат и времени.

Использование:

1. Объекты Dates: получение вчерашней, сегодняшней и завтрашней даты и времени в виде временных меток.
2. Объекты DateTimes: форматирование и анализ строк для дат и времён из серии java.util.Date.
3. Поддержка расширенных вычислений: java.util.Date, java.sql.Date, Timestamp, Time, LocalDateTime, LocalDate, LocalTime. Поскольку эти классы могут наследоваться, их соответствующие вычислители также наследуются от них, поэтому время этих классов может быть последовательно сложено или вычтено.
4. Расширенные свойства: методы cDay, cMonth, cDay, cHour, cMinute, cSecond, cMilli, cNano используются для получения вычислителей с поддержкой лет, месяцев, дней, часов, минут, секунд, миллисекунд и наносекунд.
5. Расширенные методы: withDate и withTime используются для указания даты или времени объекта даты.
6. Псевдоконструкторы: быстрые конструкторы объектов подклассов java.util.Date для текущей даты и времени Timestamp, Date и Time.

Пример использования:

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

/**
 * Пример использования
 * Создано zpf 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. Указание части даты: 1 февраля текущего года в 12 часов")
        println(now.withDate(null, 2, 1).withTime(12))
    }
}

Результаты выполнения:

Участие и вклад:

1. Fork этого проекта.
2. Создать ветку Feat_xxx.
3. Отправить код.
4. Создать Pull Request.

Дополнительные сведения о Code Cloud:

1. Используйте Readme_XXX.md для поддержки разных языков, например Readme_en.md, Readme_zh.md.
2. Официальный блог Code Cloud: blog.gitee.com.
3. Вы можете посетить этот адрес, чтобы узнать об отличных проектах с открытым исходным кодом на Code Cloud: https://gitee.com/explore.
4. GVP — это аббревиатура от «Наиболее ценные проекты с открытым исходным кодом Code Cloud», которая является коллекцией выдающихся проектов с открытым исходным кодом, отобранных Code Cloud.
5. Официальное руководство по использованию Code Cloud: https://gitee.com/help.
6. Лица Code Cloud — это серия, демонстрирующая стиль участников Code Cloud: https://gitee.com/gitee-stars/.