跳转至

日期工具

默认的时间格式

常量名
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)

获取本周开始(或结束)时间,周一是第一天

weekStartTimeweekEndTime 的默认时间格式是 FORMAT_YYYY_MM_DD_HH_MM_SS

// 返回 2023-05-29 14:18:08
DateUtils.weekStartTime()
// 返回 2023-06-04 14:18:08
DateUtils.weekEndTime()

获取本周开始(或结束)的时间,周日是第一天

getWeekStartTimegetWeekEndTime 的默认时间格式是 FORMAT_YYYY_MM_DD_HH_MM_SS

// 返回 2023-05-28 14:18:08
DateUtils.getWeekStartTime()
// 返回 2023-06-03 14:18:08
DateUtils.getWeekEndTime()