Field Detail

• public static final String dateFmt

  时间格式：yyyy-MM-dd

• public static final String datetimeFmt

  时间格式：yyyy-MM-dd HH:mm

• public static final String monthFmt

  时间格式：yyyy-MM

• public static final String msOfficeDatetimeFmt

  时间格式：yyyy-MM-dd'T'HH:mm:ss

• public static final String timeFmt

  时间格式：HH:mm

Method Detail

• static Integer ages(Date birthdate)

  计算年龄

  Parameters:

  birthdate - 出生日期

• static Boolean containsTime(Date datetime)

  日期是否包含了小时/分钟/秒/毫秒，即是否精确到了时间

• static Date convertSqlDate(Object date)

  将对象转换成日期类型，主要用于转换sql返回的日期类型

  Returns:

  Parameters:

  date

• static int daysBetween(Date startDate, Date endDate)

  计算两个日期之间的天数

  Returns:

  相差的天数

  Parameters:

  startdate - 开始日期（含）

  enddate - 结束日期（不含）

• static Date firstDayOfMonth(Date day, Integer offset = 0)

  获得月初1号的日期

  Parameters:

  offset - 月的偏差，比如 -1 为上月1号

  Since:

  4.8

• static Date firstDayOfWeek(Date day, Integer offset = 0, int firstDay = Calendar.MONDAY)

  获得周的第一天（默认为周一）的日期

  Returns:

  周一0点

  Parameters:

  day - 要计算的日期

  offset - 周的偏差，比如 -1 为上周一，2为下下周一

  firstDay - 每周的第一天，默认为周一（Calendar.MONDAY）

• static Date firstDayOfYear(Date day, Integer offset = 0)

  获得年初1月1号的日期

  Parameters:

  offset - 年的偏差，比如 -1 为去年1月1号

  Since:

  4.8

• static String format(Date date, String format, String defaultVal = "")

  按照自定义个格式格式化日期。

  如果日期或格式为空，则返回defaultVal，默认为空字符串。

  Parameters:

  date - 需要格式化的日期

  format - 格式化的形式，如"yyyy-MM-dd"

  defaultVal

• static String formatDate(Date day)

  格式化日期

  Returns:

  格式化后的日期字符串（yyyy-MM-dd）

  Parameters:

  day - 需要格式化的日期

• static String formatDatetime(Date datetime)

  格式化时间

  Returns:

  格式化后的时间字符串（yyyy-MM-dd HH:mm）

  Parameters:

  datetime - 需要格式化的时间

• static String formatMSOfficeDatetime(Date datetime)

  格式化时间（微软Office）

  Returns:

  格式化后的时间字符串（yyyy-MM-dd'T'HH:mm:ss）

  Parameters:

  datetime - 需要格式化的时间

• static String formatMonth(Date month)

  格式化月份

  Returns:

  格式化后的月份字符串（yyyy-MM）

  Parameters:

  month - 需要格式化的月份

• static String formatTime(Date datetime)

  格式化时间

  Returns:

  格式化后的时间字符串（HH:mm）

  Parameters:

  datetime - 需要格式化的时间

• static String formatUptime(Number uptime)

  格式化已启动时间

  Returns:

  形如 ““1 day, 54 min”” 或 “3 days, 3:54” 的字符串

  Parameters:

  uptime - 启动至今的秒数

• static Integer getSeason(Date date)

  根据时间获取季度

  Returns:

  返回 1~4 的数字，分别表示第 1～4 季度

• static Map getWeekInfo(Date date = null, int firstDay = Calendar.SATURDAY)

  获得日期所对应该年的周信息

  Returns:

  [year:年份，week：第几周，weekOfMonth: 本月的第几周，startDate：本周的开始日期，endDate：本周的结束日期]

  Parameters:

  date - 日期，默认取当前日期

  firstDay - 每周的第一天，默认为周一（Calendar.MONDAY）

• static int hoursBetween(Date startDate, Date endDate)

  计算两个日期之间的小时数

  Returns:

  相差的小时数

  Parameters:

  startdate - 开始日期（含）

  enddate - 结束日期（不含）

• static boolean inMonth(Date day, Date month)

  判断日期是否在某个月份之中

  Returns:

  true/false

  Parameters:

  day - 需要判断的日期

  month - 月份

• static Date lastDayOfMonth(Date day, Integer offset = 0)

  获得月底最后一天的日期

  Parameters:

  offset - 月的偏差，比如 -1 为上月最后一天

  Since:

  4.8

• static Date lastDayOfWeek(Date day, Integer offset = 0, int firstDay = Calendar.MONDAY)

  获得周的最后一天（默认为周日）的日期

  Returns:

  周日0点

  Parameters:

  day - 要计算的日期

  offset - 周的偏差，比如 -1 为上周日，2为下下周日

  firstDay - 周的第一天，默认为 Calendar.MONDAY

• static Date lastDayOfYear(Date day, Integer offset = 0)

  获得年底最后一天的日期

  Parameters:

  offset - 年的偏差，比如 -1 为去年最后一天

  Since:

  4.8

• static int monthesBetween(Date startDate, Date endDate)

  计算两个精度为月的日期之间的月数

  Returns:

  相差的月数。
  注意：由于精度为月，因此如果开始日期和结束日期正好为上个月的最后一天和本月第一天，仍然会返回1。

  Parameters:

  startdate - 开始日期

  enddate - 结束日期

• static Date nextMonth(Date month, Boolean keepEndOfMonth = false)

  根据月份取下个月

  Returns:

  下个月的一日

  Parameters:

  month - 月份

  keepEndOfMonth - 返回结果不超过下个月的月底。如3月31日的nextMonth为4月30日，否则为5月1日。默认为否。

• static Date nextYear(Date year, Boolean keepEndOfMonth = false)

  根据年度取下一年

  Returns:

  下一年的这一天

  Parameters:

  year - 年度

  keepEndOfMonth - 返回结果不超过下年同月的月底。如闰年2016年2月29日的nextYear为2017年2月28日，否则为3月1日。默认为否。

• static Date parse(String date, String format, Date defaultVal = null)

  按照自定义格式解析日期字符串。

  如果字符串或格式为空，或者解析失败，则返回defaultVal，默认为null。

  Parameters:

  date - 日期字符串

  format - 日期格式，如"yyyy-MM-dd"

  defaultVal

• static Date parse(String date)

  解析字符串为日期

  Returns:

  解析后的日期

  Parameters:

  date - 需要解析的字符串

• @Deprecated static Date parseDate(String date)

  同 parse(String Date)

• static TimeZone parseTimeZone(String date)

  解析时间字符串中的时区后缀（Z、+N、-N）

• static Date preMonth(Date month, Boolean keepEndOfMonth = false)

  根据月份取上个月

  Returns:

  上个月

  Parameters:

  month - 月份

  keepEndOfMonth - 返回结果不超过上个月的月底。如3月31日的preMonth为2月28或29日，否则为3月2日。默认为否。

• static Date toDay(Date datetime)

  将时间的精度转换为日期（小时、分钟、秒等都设为0）

  Returns:

  转换后的日期

  Parameters:

  datetime - 需要转换的时间

• static Date toMonday(Date datetime, int firstDay = Calendar.MONDAY)

  将时间转换为精度为日期的周一

  Returns:

  转换后的日期

  Parameters:

  datetime - 需要转换的时间

  firstDay - 每周的第一天，默认为周一（Calendar.MONDAY）

• static Date toMonth(Date datetime)

  将时间转换为月份（精度）

  Returns:

  转换后的月份

  Parameters:

  datetime - 需要转换的时间

• static javax.xml.datatype.XMLGregorianCalendar toXMLGregorianCalendar(Date date)

  转换成 XMLGregorianCalendar 类型。常用于 WebService Client。

  throws:

  Exception

• static Date toYear(Date datetime)

  将时间转换为年份（精度）

  Returns:

  转换后的年份的1月1日0时

  Parameters:

  datetime - 需要转换的时间

• static Date toZDate(Date date)

  转换为时区为 Z 的时间。

  比如当前时区为+8，则转换后的时间会小8小时。

• static Date today()

  今天

• static Integer year()

  今年