日期工具¶
默认的时间格式¶
| 常量名 | 值 |
|---|---|
| FORMAT_YYYYhMMhDD | yyyy-MM-dd |
| FORMAT_YYYY_MM_DD_HH_MM_SS | yyyy-MM-dd HH:mm:ss |
| FORMAT_YYYY_MM | yyyy-MM |
| FORMAT_YYYY | yyyy |
| FORMAT_HH_MM | HH:mm |
| FORMAT_HH_MM_SS | HH:mm:ss |
| FORMAT_MM_SS | mm:ss |
| FORMAT_MM_DD_HH_MM | MM-dd HH:mm |
| FORMAT_MM_DD_HH_MM_SS | MM-dd HH:mm:ss |
| FORMAT_YYYY_MM_DD_HH_MM | yyyy-MM-dd HH:mm |
| FORMAT_YYYY2MM2DD | yyyy.MM.dd |
| FORMAT_YYYY2MM2DD_HH_MM | yyyy.MM.dd HH:mm |
| FORMAT_MMCDDC_HH_MM | MM月dd日 HH:mm |
| FORMAT_MMCDDC | MM月dd日 |
| FORMAT_YYYYCMMCDDC | yyyy年MM月dd日 |
支持的时区¶
| 常量名 | 值 |
|---|---|
| GMT_PLUS_ZONE | GMT+00:00 |
| GMT_PLUS_ONE | GMT+01:00 |
| GMT_PLUS_TWO | GMT+02:00 |
| GMT_PLUS_THREE | GMT+03:00 |
| GMT_PLUS_FOUR | GMT+04:00 |
| GMT_PLUS_FIVE | GMT+05:00 |
| GMT_PLUS_SIX | GMT+06:00 |
| GMT_PLUS_SEVEN | GMT+07:00 |
| GMT_PLUS_EIGHT | GMT+08:00 |
| GMT_PLUS_NINE | GMT+09:00 |
| GMT_PLUS_TEN | GMT+10:00 |
| GMT_PLUS_ELEVEN | GMT+11:00 |
| GMT_PLUS_TWELVE | GMT+12:00 |
| GMT_MINUS_ONE | GMT-01:00 |
| GMT_MINUS_TWO | GMT-02:00 |
| GMT_MINUS_THREE | GMT-03:00 |
| GMT_MINUS_FOUR | GMT-04:00 |
| GMT_MINUS_FIVE | GMT-05:00 |
| GMT_MINUS_SIX | GMT-06:00 |
| GMT_MINUS_SEVEN | GMT-07:00 |
| GMT_MINUS_EIGHT | GMT-08:00 |
| GMT_MINUS_NINE | GMT-09:00 |
| GMT_MINUS_TEN | GMT-10:00 |
| GMT_MINUS_ELEVEN | GMT-11:00 |
| GMT_MINUS_TWELVE | GMT-12:00 |
按照指定格式获取当前时间¶
getCurrentTime 会按照指定格式输出当前的时间。
// 返回 14:18 作为dateString的值
DateUtils.getCurrentTime(DateUtils.FORMAT_HH_MM))
获取当前时间之前或之后的天数的时间¶
getDayBeforeOrAfterCurrentTime 会获取当前时间之前或之后的天数，并按照指定格式的时间。
// 返回 05-28 14:18:08
DateUtils.getDayBeforeOrAfterCurrentTime(DateUtils.FORMAT_MM_DD_HH_MM_SS,-2)
获取设备当前所在时区¶
添加： Version 0.5.3 更新： Version 1.5.2
// 返回 GMT+00:00
val timezome = DateUtils.getCurrentTimeZone(DateUtils.SHORT)
根据给定的时间字符串和格式获取 Date 对象¶
val date: Date = DateUtils.datetimeFromString("14:18", FORMAT_HH_MM)
将给定的 Date 解析为时间字符串¶
// 获取一个Date对象
val date: Date = DateUtils.datetimeFromString("14:18", DateUtils.FORMAT_HH_MM)
// 返回 14:18:00
DateUtils.datetimeToString(date, DateUtils.FORMAT_HH_MM_SS)
根据给定的时区和时间格式返回对应的字符串¶
dateTimeToGMT 默认情况下，按照 yyyy-MM-dd HH:mm:ss 和当前所处的时区获取字符串。
// 返回 2023-05-30 14:18:08
DateUtils.dateTimeToGMT()
// 返回 2023.05.30 20:18
DateUtils.dateTimeToGMT(DateUtils.GMT_PLUS_SIX,DateUtils.FORMAT_YYYY2MM2DD_HH_MM)
根据给定的 UTC 时间和格式解析出当前时间¶
dateTimeFromGMT 会根据给定的时间返回当前设备所在时区的时间，并按照对应的格式返回。
// 返回 15:01
DateUtils.dateTimeFromGMT("07:01",DateUtils.FORMAT_HH_MM)
获取本周开始(或结束)时间，周一是第一天¶
weekStartTime 和 weekEndTime 的默认时间格式是 FORMAT_YYYY_MM_DD_HH_MM_SS 。
// 返回 2023-05-29 14:18:08
DateUtils.weekStartTime()
// 返回 2023-06-04 14:18:08
DateUtils.weekEndTime()
获取本周开始(或结束)的时间，周日是第一天¶
getWeekStartTime 和 getWeekEndTime 的默认时间格式是 FORMAT_YYYY_MM_DD_HH_MM_SS 。
// 返回 2023-05-28 14:18:08
DateUtils.getWeekStartTime()
// 返回 2023-06-03 14:18:08
DateUtils.getWeekEndTime()