G-Fantastic/falcon

Common libraries for Java

📚falcon

Falcon是一个强大的Java工具类库，提供了多种便捷的工具类，帮助开发者更方便的处理时间，UUID，集合等。

• 💡不可变且线程安全的时间处理类DateTime<T>，提供统一的时间API
  • 🔺强大的时间处理API
    • 自动识别解析多种时间格式串
    • 指定时间单位的取整操作（四舍五入、向上/下取整）
    • 时间偏移（指定时间单位的增减）
    • 计算两个时间间隔
    • 时间格式化
    • 获取并格式化周信息
    • 各种时间类的互相转换
  • 🔺支持多种时间类型：Date, Calendar, LocalDateTime, ZonedDateTime, OffsetDateTime, Instant
• 💡便捷的秒表Stopwatch工具类，方便测试各个代码片段或任意多个连续代码片段的执行时间
• 💡带时间的UUID工具类，生成的UUID以时间为前缀，更易于阅读，且具有一定的顺序
• 💡系统变量及Java环境变量工具类OS
• 💡兼容Java 8及Java 9+模块化系统
• ……

🛠️Environment（开发环境）

• JDK 9.0.4 （兼容Java 8及Java 9+模块化系统）
• Apache maven 3.6.1

💿集成方式（兼容Java 8及Java 9+）

Maven

<dependency>
  <groupId>com.iofairy</groupId>
  <artifactId>falcon</artifactId>
  <version>0.5.2</version>
</dependency>

Gradle

implementation 'com.iofairy:falcon:0.5.2'

🗺️使用指南（User Guide）

• 强大的时间处理API
  • 自动识别时间字符串
  • 时间取整操作
  • 时间偏移(时间加减)
  • 计算两个时间间隔
• 秒表Stopwatch
• 带时间的UUIDTimedUUID

📘强大的时间处理API

自动识别时间字符串

DateTime<Date> dt00 = DateTime.parseDate("2022-8-01 10:5:15", TZ.UTC);
DateTime<Date> dt01 = DateTime.parseDate("2022/8/01T10:5:15.987");
DateTime<Date> dt02 = DateTime.parseDate("2022");
DateTime<Date> dt03 = DateTime.parseDate("999");
DateTime<Date> dt04 = DateTime.parseDate("2点5分", TZ.NEW_YORK);
DateTime<Date> dt05 = DateTime.parseDate("20220810T170650666");
DateTime<LocalDateTime> dt06 = DateTime.parse("2022-8-01 10:5:15");
DateTime<LocalDateTime> dt07= DateTime.parse("2022-8-01T10:5:15.987");
DateTime<LocalDateTime> dt08 = DateTime.parse("2022");
DateTime<LocalDateTime> dt09 = DateTime.parse("999");
DateTime<LocalDateTime> dt10 = DateTime.parse("10点5分");
DateTime<LocalDateTime> dt11 = DateTime.parse("2022-8-01T10:5:15.98");
DateTime<LocalDateTime> dt12 = DateTime.parse("202208");
DateTime<LocalDateTime> dt13 = DateTime.parse("20220810");
DateTime<LocalDateTime> dt14 = DateTime.parse("20220810170650");
DateTime<LocalDateTime> dt15 = DateTime.parse("20220810170650666");

System.out.println(dt00.dtDetail());    // 2022-08-01 18:05:15.000000000 [Asia/Shanghai +08:00 GMT+8 星期一]
System.out.println(dt01.dtDetail());    // 2022-08-01 10:05:15.987000000 [Asia/Shanghai +08:00 GMT+8 星期一]
System.out.println(dt02.dtDetail());    // 2022-01-01 00:00:00.000000000 [Asia/Shanghai +08:00 GMT+8 星期六]
System.out.println(dt03.dtDetail());    // 0999-01-01 00:00:00.000000000 [Asia/Shanghai +08:05 GMT+8:05:43 星期二]
System.out.println(dt04.dtDetail());    // 1970-01-01 15:05:00.000000000 [Asia/Shanghai +08:00 GMT+8 星期四]
System.out.println(dt05.dtDetail());    // 2022-08-10 17:06:50.666000000 [Asia/Shanghai +08:00 GMT+8 星期三]
System.out.println(dt06.dtDetail());    // 2022-08-01 10:05:15.000000000 [星期一]
System.out.println(dt07.dtDetail());    // 2022-08-01 10:05:15.987000000 [星期一]
System.out.println(dt08.dtDetail());    // 2022-01-01 00:00:00.000000000 [星期六]
System.out.println(dt09.dtDetail());    // 0999-01-01 00:00:00.000000000 [星期二]
System.out.println(dt10.dtDetail());    // 1970-01-01 10:05:00.000000000 [星期四]
System.out.println(dt11.dtDetail());    // 2022-08-01 10:05:15.980000000 [星期一]
System.out.println(dt12.dtDetail());    // 2022-08-01 00:00:00.000000000 [星期一]
System.out.println(dt13.dtDetail());    // 2022-08-10 00:00:00.000000000 [星期三]
System.out.println(dt14.dtDetail());    // 2022-08-10 17:06:50.000000000 [星期三]
System.out.println(dt15.dtDetail());    // 2022-08-10 17:06:50.666000000 [星期三]

时间取整操作

/*
 各种原始时间类型
 */
LocalDateTime ldt = LocalDateTime.of(2022, 2, 27, 8, 0, 10, 100);
ZonedDateTime zdt = ldt.atZone(TZ.DEFAULT_ZONE);
Instant instant = zdt.toInstant();
OffsetDateTime odt = zdt.toOffsetDateTime();
Calendar calendar = Calendar.getInstance();
calendar.setTime(Date.from(zdt.toInstant()));
Date date = calendar.getTime();
/*
 将各种原始时间转换为 DateTime 类型
 */
DateTime<LocalDateTime> dt1 = DateTime.of(ldt);     // 2022-02-27 08:00:10.000
DateTime<ZonedDateTime> dt2 = DateTime.of(zdt);     // 2022-02-27 08:00:10.000
DateTime<Instant> dt3 = DateTime.of(instant);       // 2022-02-27 08:00:10.000
DateTime<OffsetDateTime> dt4 = DateTime.of(odt);    // 2022-02-27 08:00:10.000
DateTime<Calendar> dt5 = DateTime.of(calendar);     // 2022-02-27 08:00:10.000
DateTime<Date> dt6 = DateTime.of(date);             // 2022-02-27 08:00:10.000
/*
 各种时间类型取整操作
 */
System.out.println(dt1.round(ChronoUnit.DAYS, RoundingDT.FLOOR));       // 2022-02-27 00:00:00.000
System.out.println(dt2.round(ChronoUnit.DAYS, RoundingDT.CEILING));     // 2022-02-28 00:00:00.000
System.out.println(dt3.round(ChronoUnit.MONTHS, RoundingDT.HALF_UP));   // 2022-03-01 00:00:00.000
System.out.println(dt4.round(ChronoUnit.MINUTES, RoundingDT.CEILING));  // 2022-02-27 08:01:00.000
System.out.println(dt5.round(ChronoUnit.HOURS, RoundingDT.CEILING));    // 2022-02-27 09:00:00.000
System.out.println(dt6.round(ChronoUnit.HOURS, RoundingDT.HALF_UP));    // 2022-02-27 08:00:00.000

时间偏移(时间加减)

/*
 各种原始时间类型
 */
LocalDateTime ldt = LocalDateTime.of(2022, 2, 27, 8, 0, 10, 100);
ZonedDateTime zdt = ldt.atZone(TZ.DEFAULT_ZONE);
Instant instant = zdt.toInstant();
OffsetDateTime odt = zdt.toOffsetDateTime();
Calendar calendar = Calendar.getInstance();
calendar.setTime(Date.from(zdt.toInstant()));
Date date = calendar.getTime();
/*
 将各种时间转换为 DateTime 类型
 */
DateTime<LocalDateTime> dt1 = DateTime.of(ldt);     // 2022-02-27 08:00:10.000
DateTime<ZonedDateTime> dt2 = DateTime.of(zdt);     // 2022-02-27 08:00:10.000
DateTime<Instant> dt3 = DateTime.of(instant);       // 2022-02-27 08:00:10.000
DateTime<OffsetDateTime> dt4 = DateTime.of(odt);    // 2022-02-27 08:00:10.000
DateTime<Calendar> dt5 = DateTime.of(calendar);     // 2022-02-27 08:00:10.000
DateTime<Date> dt6 = DateTime.of(date);             // 2022-02-27 08:00:10.000
/*
 各种时间类型偏移（加减）操作
 */
System.out.println(dt1.minusHours(5).plusDays(2));  // 2022-03-01 03:00:10.000
System.out.println(dt2.minusMillis(-10000));    // 2022-02-27 08:00:20.000
System.out.println(dt3.plusDays(2));            // 2022-03-01 08:00:10.000
System.out.println(dt4.plusMonths(1));          // 2022-03-27 08:00:10.000
System.out.println(dt5.plusDays(-5));           // 2022-02-22 08:00:10.000
System.out.println(dt6.minusMinutes(100));      // 2022-02-27 06:20:10.000

计算两个时间间隔

LocalDateTime fromLDT = LocalDateTime.of(2020, 8, 15, 10, 56, 43, 10000000);
DateTime<Date> toDT = DateTime.parseDate("2022/06/20 20:10:56.200");
SignedInterval interval1 = SignedInterval.between(toDT, fromLDT);
Interval interval2 = Interval.between(fromLDT, toDT);
System.out.println(interval1);      // -1年-10月-5天-9时-14分-13秒-190毫秒
System.out.println(interval2);      // 1年10月5天9时14分13秒190毫秒

📘秒表Stopwatch

秒表Stopwatch：方便测试各个代码片段或任意多个连续代码片段的执行时间。一个独立的秒表从运行开始到结束之前，便具有分段记录、持续记录与实时记录的功能
秒表中的标记Stopwatch.mark()：可在每个代码片段（业务）开始或结束时打个标记。 一方面是代码片段（业务）间的分界点；同时，也类似于savepoint（保存点），保存当时的时间

Stopwatch stopwatch = Stopwatch.run();
// >> 开始业务1
Try.sleep(1000);  // ... 执行一些操作
// << 结束业务1
System.out.println("秒表总耗时：" + stopwatch);                                    // 秒表总耗时：1.011(秒)
System.out.println("秒表距离上次标记处耗时1：" + stopwatch.elapsedlastString());    // 秒表距离上次标记处耗时1：1.023(秒)

stopwatch.mark();  // 业务2开始时打个标记
// >> 开始业务2
Try.sleep(500);  // ... 执行一些操作
// << 结束业务2
System.out.println("秒表总耗时：" + stopwatch);                                    // 秒表总耗时：1.525(秒)
System.out.println("秒表距离上次标记处耗时2：" + stopwatch.elapsedlastString());    // 秒表距离上次标记处耗时2：502.751(毫秒)

stopwatch.mark();  // 业务3开始时打个标记
// >> 开始业务3
Try.sleep(1500);  // ... 执行一些操作
// << 结束业务3
System.out.println("秒表总耗时：" + stopwatch);                                    // 秒表总耗时：3.037(秒)
System.out.println("秒表距离上次标记处耗时3：" + stopwatch.elapsedlastString());    // 秒表距离上次标记处耗时3：1.511(秒)
stopwatch.mark();  // 业务结束时打个标记

// 业务1开始到业务3完成所耗时间
System.out.println("业务1开始到业务3完成所耗时间：" + stopwatch.elapsed(0, 3));     // 业务1开始到业务3完成所耗时间：3.037(秒)

📘带时间的UUIDTimedUUID

Java自带的UUID虽然保证了唯一性，但是随机生成的，不具有顺序性，导致索引效率较低。TimedUUID自带时间前缀，记录着UUID创建时间，具有一定的顺序。且可以根据业务需要，自定义生成的UUID的长度。

System.out.println(TimedUUID.getId());      // 240405235228529AA2MAHS8RK
System.out.println(TimedUUID.shortId());    // 0240405235228775AA217NW1DG
System.out.println(TimedUUID.linedId());    // 20240405235228775_A6Q78Q5APB
System.out.println(TimedUUID.mediumId());   // 20240405235228775AAAM11V01R39B
System.out.println(TimedUUID.longId());     // 20240405235228775AA8I2VMXBLLO4YO

设置自定义的默认的 TimedUUID，默认的 TimedUUID 一旦设置后，无法变更。

TimedUUID timedUUID = TimedUUID.of(0, 2, 28, 3);
TimedUUID.setDefaultId(timedUUID);
/*
 通过 TimedUUID.getId() 生成默认的 TimedUUID
 */
System.out.println(TimedUUID.getId());      // 0240406090446301AA681BIC7X36
System.out.println(TimedUUID.getId());      // 0240406090446516AACH9UFLLY3K
System.out.println(TimedUUID.getId());      // 0240406090446516AA76G2DGIJRL

System.out.println(timedUUID.randomId());   // 0240406091858617AA35GU5O5GKG

⭐点个赞哟

如果你喜欢 Falcon，感觉 Falcon 帮助到了你，可以点右上角 Star 支持一下哦，感谢感谢！

Copyright

Copyright (C) 2021 iofairy, https://github.com/iofairy/falcon

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.