赞
踩
技术活,该赏
关注+一键三连(点赞,评论,收藏)再看,养成好习惯
看本篇文章前,建议先对java源码的日期和时间有一定的了解,如果不了解的话,可以先看这篇文章:
关联文章:
知其然,知其所以然
此博文的依据:hutool-5.6.5版本源码
<dependency>
<groupId>cn.hutool</groupId>
<artifactId>hutool-core</artifactId>
<version>5.6.5</version>
</dependency>
/**
* 获得年的部分
*
* @param date 日期
* @return 年的部分
*/
public static int year(Date date) {
return DateTime.of(date).year();
}
源码的**DateTime.of(date).year()**可拆解成两部分
/**
* 转换JDK date为 DateTime
*
* @param date JDK Date
* @return DateTime
*/
public static DateTime of(Date date) {
if (date instanceof DateTime) {
return (DateTime) date;
}
return new DateTime(date);
}
第二部分,
/**
* 获得年的部分
*
* @return 年的部分
*/
public int year() {
return getField(DateField.YEAR);
}
/**
* 获得日期的某个部分<br>
* 例如获得年的部分,则使用 getField(DatePart.YEAR)
*
* @param field 表示日期的哪个部分的枚举 {@link DateField}
* @return 某个部分的值
*/
public int getField(DateField field) {
return getField(field.getValue());
}
/**
* 获得日期的某个部分<br>
* 例如获得年的部分,则使用 getField(Calendar.YEAR)
*
* @param field 表示日期的哪个部分的int值 {@link Calendar}
* @return 某个部分的值
*/
public int getField(int field) {
return toCalendar().get(field);
}
从代码跟下来,可以发现会走到toCalendar().get(field)
/**
* 转换为Calendar, 默认 {@link Locale}
*
* @return {@link Calendar}
*/
public Calendar toCalendar() {
return toCalendar(Locale.getDefault(Locale.Category.FORMAT));
}
**toCalendar()**会得到Calendar,这会就好理解可以获取年了。
不止可以获取年,还可以获取年,月,日,时,分,秒。详细介绍可以看这里:万字博文教你搞懂java源码的日期和时间相关用法
/**
* 获得指定日期所属季度,从1开始计数
*
* @param date 日期
* @return 第几个季度
* @since 4.1.0
*/
public static int quarter(Date date) {
return DateTime.of(date).quarter();
}
源码的**DateTime.of(date).quarter()**可拆解成两部分
DateTime.of(date)上面有介绍了,这里就不水字了。
第二部分,month()获取DateTime对应的月份,然后再做了一个简单计算。
/**
* 获得当前日期所属季度,从1开始计数<br>
*
* @return 第几个季度 {@link Quarter}
*/
public int quarter() {
return month() / 3 + 1;
}
/**
* 获得月份,从0开始计数
*
* @return 月份
*/
public int month() {
return getField(DateField.MONTH);
}
/**
* 获得日期的某个部分<br>
* 例如获得年的部分,则使用 getField(DatePart.YEAR)
*
* @param field 表示日期的哪个部分的枚举 {@link DateField}
* @return 某个部分的值
*/
public int getField(DateField field) {
return getField(field.getValue());
}
getField方法上面有介绍了,这里就不水字了。
获得指定日期所属季度,返回的是季度枚举对象Quarter
/**
* 获得指定日期所属季度
*
* @param date 日期
* @return 第几个季度枚举
* @since 4.1.0
*/
public static Quarter quarterEnum(Date date) {
return DateTime.of(date).quarterEnum();
}
源码的**DateTime.of(date).quarterEnum()**可拆解成两部分
DateTime.of(date)上面有介绍了,这里就不水字了。
第二部分,quarter()上面有源码分析,结论是获取获得当前日期所属季度,从1开始计数
**Quarter.of(int)**就是把对应的数值转为对应的枚举Quarter
/**
* 获得当前日期所属季度<br>
*
* @return 第几个季度 {@link Quarter}
*/
public Quarter quarterEnum() {
return Quarter.of(quarter());
}
/**
* 获得月份,从0开始计数
*
* @param date 日期
* @return 月份,从0开始计数
*/
public static int month(Date date) {
return DateTime.of(date).month();
}
源码的**DateTime.of(date).month()**可拆解成两部分
DateTime.of(date)上面有介绍了,这里就不水字了。
第二部分,getField方法上面有介绍了,这里就不水字了。
/**
* 获得月份,从0开始计数
*
* @return 月份
*/
public int month() {
return getField(DateField.MONTH);
}
/**
* 获得月份
*
* @param date 日期
* @return {@link Month}
*/
public static Month monthEnum(Date date) {
return DateTime.of(date).monthEnum();
}
源码的**DateTime.of(date).monthEnum()**可拆解成两部分
DateTime.of(date)上面有介绍了,这里就不水字了。
第二部分,month()是获得月份,从0开始计数
**Month.of(int)**就是把对应的数值转为对应的枚举Month
/**
* 获得月份
*
* @return {@link Month}
*/
public Month monthEnum() {
return Month.of(month());
}
/**
* 获得指定日期是所在年份的第几周<br>
* 此方法返回值与一周的第一天有关,比如:<br>
* 2016年1月3日为周日,如果一周的第一天为周日,那这天是第二周(返回2)<br>
* 如果一周的第一天为周一,那这天是第一周(返回1)<br>
* 跨年的那个星期得到的结果总是1
*
* @param date 日期
* @return 周
* @see DateTime#setFirstDayOfWeek(Week)
*/
public static int weekOfYear(Date date) {
return DateTime.of(date).weekOfYear();
}
源码的**DateTime.of(date).weekOfYear()**可拆解成两部分
DateTime.of(date)上面有介绍了,这里就不水字了。
第二部分,getField方法上面有介绍了,这里就不水字了。
/**
* 获得指定日期是所在年份的第几周<br>
* 此方法返回值与一周的第一天有关,比如:<br>
* 2016年1月3日为周日,如果一周的第一天为周日,那这天是第二周(返回2)<br>
* 如果一周的第一天为周一,那这天是第一周(返回1)<br>
* 跨年的那个星期得到的结果总是1
*
* @return 周
* @see #setFirstDayOfWeek(Week)
*/
public int weekOfYear() {
return getField(DateField.WEEK_OF_YEAR);
}
/**
* 获得指定日期是这个日期所在月份的第几天<br>
*
* @param date 日期
* @return 天
*/
public static int dayOfMonth(Date date) {
return DateTime.of(date).dayOfMonth();
}
源码的**DateTime.of(date).year()**可拆解成两部分
DateTime.of(date)上面有介绍了,这里就不水字了。
第二部分,getField方法上面有介绍了,这里就不水字了。
/**
* 获得指定日期是这个日期所在月份的第几天,从1开始
*
* @return 天,1表示第一天
*/
public int dayOfMonth() {
return getField(DateField.DAY_OF_MONTH);
}
/**
* 获得指定日期是这个日期所在月份的第几天<br>
*
* @param date 日期
* @return 天
*/
public static int dayOfMonth(Date date) {
return DateTime.of(date).dayOfMonth();
}
源码的**DateTime.of(date).dayOfMonth()**可拆解成两部分
DateTime.of(date)上面有介绍了,这里就不水字了。
第二部分,getField方法上面有介绍了,这里就不水字了。
/**
* 获得指定日期是这个日期所在月份的第几天,从1开始
*
* @return 天,1表示第一天
*/
public int dayOfMonth() {
return getField(DateField.DAY_OF_MONTH);
}
/**
* 获得指定日期是这个日期所在年的第几天
*
* @param date 日期
* @return 天
* @since 5.3.6
*/
public static int dayOfYear(Date date) {
return DateTime.of(date).dayOfYear();
}
源码的**DateTime.of(date).dayOfYear()**可拆解成两部分
DateTime.of(date)上面有介绍了,这里就不水字了。
第二部分,getField方法上面有介绍了,这里就不水字了。
/**
* 获得指定日期是这个日期所在年份的第几天,从1开始
*
* @return 天,1表示第一天
* @since 5.3.6
*/
public int dayOfYear() {
return getField(DateField.DAY_OF_YEAR);
}
/**
* 获得指定日期是星期几,1表示周日,2表示周一
*
* @param date 日期
* @return 天
*/
public static int dayOfWeek(Date date) {
return DateTime.of(date).dayOfWeek();
}
源码的**DateTime.of(date).dayOfWeek()**可拆解成两部分
DateTime.of(date)上面有介绍了,这里就不水字了。
第二部分,getField方法上面有介绍了,这里就不水字了。
/**
* 获得指定日期是星期几,1表示周日,2表示周一
*
* @return 星期几
*/
public int dayOfWeek() {
return getField(DateField.DAY_OF_WEEK);
}
/**
* 获得指定日期是星期几
*
* @param date 日期
* @return {@link Week}
*/
public static Week dayOfWeekEnum(Date date) {
return DateTime.of(date).dayOfWeekEnum();
}
源码的**DateTime.of(date).dayOfWeekEnum()**可拆解成两部分
DateTime.of(date)上面有介绍了,这里就不水字了。
第二部分,dayOfWeek()是获得指定日期是星期几,1表示周日,2表示周一
**Week.of(int)**就是把对应的数值转为对应的枚举Week
/**
* 获得指定日期是星期几
*
* @return {@link Week}
*/
public Week dayOfWeekEnum() {
return Week.of(dayOfWeek());
}
/**
* 获得指定日期的小时数部分<br>
*
* @param date 日期
* @param is24HourClock 是否24小时制
* @return 小时数
*/
public static int hour(Date date, boolean is24HourClock) {
return DateTime.of(date).hour(is24HourClock);
}
源码的**DateTime.of(date).hour(is24HourClock)**可拆解成两部分
DateTime.of(date)上面有介绍了,这里就不水字了。
第二部分,getField方法上面有介绍了,这里就不水字了。
is24HourClock ? DateField.HOUR_OF_DAY : DateField.HOUR:is24HourClock 是否24小时制
DateField.HOUR_OF_DAY:小时,用于24小时制
DateField.HOUR:小时,用于12小时制
/**
* 获得指定日期的小时数部分<br>
*
* @param is24HourClock 是否24小时制
* @return 小时数
*/
public int hour(boolean is24HourClock) {
return getField(is24HourClock ? DateField.HOUR_OF_DAY : DateField.HOUR);
}
获得指定日期的分钟数部分<br>
例如:10:04:15.250 =》 4
/**
* 获得指定日期的分钟数部分<br>
* 例如:10:04:15.250 =》 4
*
* @param date 日期
* @return 分钟数
*/
public static int minute(Date date) {
return DateTime.of(date).minute();
}
源码的**DateTime.of(date).minute()**可拆解成两部分
DateTime.of(date)上面有介绍了,这里就不水字了。
第二部分,getField方法上面有介绍了,这里就不水字了。
/**
* 获得指定日期的分钟数部分<br>
* 例如:10:04:15.250 =》 4
*
* @return 分钟数
*/
public int minute() {
return getField(DateField.MINUTE);
}
/**
* 获得指定日期的秒数部分<br>
*
* @param date 日期
* @return 秒数
*/
public static int second(Date date) {
return DateTime.of(date).second();
}
源码的**DateTime.of(date).second()**可拆解成两部分
DateTime.of(date)上面有介绍了,这里就不水字了。
第二部分,getField方法上面有介绍了,这里就不水字了。
/**
* 获得指定日期的秒数部分<br>
*
* @return 秒数
*/
public int second() {
return getField(DateField.SECOND);
}
/**
* 获得指定日期的毫秒数部分<br>
*
* @param date 日期
* @return 毫秒数
*/
public static int millisecond(Date date) {
return DateTime.of(date).millisecond();
}
源码的**DateTime.of(date).millisecond()**可拆解成两部分
DateTime.of(date)上面有介绍了,这里就不水字了。
第二部分,getField方法上面有介绍了,这里就不水字了。
/**
* 获得指定日期的毫秒数部分<br>
*
* @return 毫秒数
*/
public int millisecond() {
return getField(DateField.MILLISECOND);
}
是否为上午
/**
* 是否为上午
*
* @param date 日期
* @return 是否为上午
*/
public static boolean isAM(Date date) {
return DateTime.of(date).isAM();
}
源码的**DateTime.of(date).isAM()**可拆解成两部分
DateTime.of(date)上面有介绍了,这里就不水字了。
第二部分,getField方法上面有介绍了,这里就不水字了。
做了一个判断Calendar.AM == getField(DateField.AM_PM)
/**
* 是否为上午
*
* @return 是否为上午
*/
public boolean isAM() {
return Calendar.AM == getField(DateField.AM_PM);
}
是否为下午
/**
* 是否为下午
*
* @param date 日期
* @return 是否为下午
*/
public static boolean isPM(Date date) {
return DateTime.of(date).isPM();
}
源码的**DateTime.of(date).isPM()**可拆解成两部分
DateTime.of(date)上面有介绍了,这里就不水字了。
第二部分,getField方法上面有介绍了,这里就不水字了。
做了一个判断Calendar.PM== getField(DateField.AM_PM)
/**
* 是否为下午
*
* @return 是否为下午
*/
public boolean isPM() {
return Calendar.PM == getField(DateField.AM_PM);
}
返回今年
/**
* @return 今年
*/
public static int thisYear() {
return year(date());
}
源码的**year(date())**可拆解成两部分
DateTime.date()
/**
* 当前时间,转换为{@link DateTime}对象
*
* @return 当前时间
*/
public static DateTime date() {
return new DateTime();
}
返回当前月份
/**
* @return 当前月份
*/
public static int thisMonth() {
return month(date());
}
源码的**month(date())**可拆解成两部分
DateTime.date()
/**
* 当前时间,转换为{@link DateTime}对象
*
* @return 当前时间
*/
public static DateTime date() {
return new DateTime();
}
返回当前月份
/**
* @return 当前月份 {@link Month}
*/
public static Month thisMonthEnum() {
return monthEnum(date());
}
源码的**monthEnum(date())**可拆解成两部分
DateTime.date()
/**
* 当前时间,转换为{@link DateTime}对象
*
* @return 当前时间
*/
public static DateTime date() {
return new DateTime();
}
返回当前日期所在年份的第几周
/**
* @return 当前日期所在年份的第几周
*/
public static int thisWeekOfYear() {
return weekOfYear(date());
}
源码的**weekOfYear(date())**可拆解成两部分
DateTime.date()
/**
* 当前时间,转换为{@link DateTime}对象
*
* @return 当前时间
*/
public static DateTime date() {
return new DateTime();
}
返回当前日期所在月份的第几周
/**
* @return 当前日期所在月份的第几周
*/
public static int thisWeekOfMonth() {
return weekOfMonth(date());
}
源码的**weekOfMonth(date())**可拆解成两部分
DateTime.date()
/**
* 当前时间,转换为{@link DateTime}对象
*
* @return 当前时间
*/
public static DateTime date() {
return new DateTime();
}
返回当前日期是这个日期所在月份的第几天
/**
* @return 当前日期是这个日期所在月份的第几天
*/
public static int thisDayOfMonth() {
return dayOfMonth(date());
}
源码的**dayOfMonth(date())**可拆解成两部分
DateTime.date()
/**
* 当前时间,转换为{@link DateTime}对象
*
* @return 当前时间
*/
public static DateTime date() {
return new DateTime();
}
返回当前日期是星期几
/**
* @return 当前日期是星期几
*/
public static int thisDayOfWeek() {
return dayOfWeek(date());
}
源码的**dayOfWeek(date())**可拆解成两部分
DateTime.date()
/**
* 当前时间,转换为{@link DateTime}对象
*
* @return 当前时间
*/
public static DateTime date() {
return new DateTime();
}
返回当前日期是星期几
/**
* @return 当前日期是星期几 {@link Week}
*/
public static Week thisDayOfWeekEnum() {
return dayOfWeekEnum(date());
}
源码的**dayOfWeekEnum(date())**可拆解成两部分
DateTime.date()
/**
* 当前时间,转换为{@link DateTime}对象
*
* @return 当前时间
*/
public static DateTime date() {
return new DateTime();
}
返回当前日期的小时数部分
/**
* @param is24HourClock 是否24小时制
* @return 当前日期的小时数部分<br>
*/
public static int thisHour(boolean is24HourClock) {
return hour(date(), is24HourClock);
}
源码的**hour(date(), is24HourClock)**可拆解成两部分
DateTime.date()
/**
* 当前时间,转换为{@link DateTime}对象
*
* @return 当前时间
*/
public static DateTime date() {
return new DateTime();
}
返回当前日期的分钟数部分
/**
* @return 当前日期的分钟数部分<br>
*/
public static int thisMinute() {
return minute(date());
}
源码的**minute(date())**可拆解成两部分
DateTime.date()
/**
* 当前时间,转换为{@link DateTime}对象
*
* @return 当前时间
*/
public static DateTime date() {
return new DateTime();
}
返回当前日期的秒数部分
/**
* @return 当前日期的秒数部分<br>
*/
public static int thisSecond() {
return second(date());
}
源码的**second(date())**可拆解成两部分
DateTime.date()
/**
* 当前时间,转换为{@link DateTime}对象
*
* @return 当前时间
*/
public static DateTime date() {
return new DateTime();
}
返回当前日期的毫秒数部分
/**
* @return 当前日期的毫秒数部分<br>
*/
public static int thisMillisecond() {
return millisecond(date());
}
源码的**millisecond(date())**可拆解成两部分
DateTime.date()
/**
* 当前时间,转换为{@link DateTime}对象
*
* @return 当前时间
*/
public static DateTime date() {
return new DateTime();
}
获得指定日期年份和季节<br>
格式:[20131]表示2013年第一季度
/**
* 获得指定日期年份和季节<br>
* 格式:[20131]表示2013年第一季度
*
* @param date 日期
* @return Quarter ,类似于 20132
*/
public static String yearAndQuarter(Date date) {
return yearAndQuarter(calendar(date));
}
源码的**yearAndQuarter(calendar(date))**可拆解成两部分
yearAndQuarter方法代码分析:
获取年份cal.get(Calendar.YEAR)
获取季度cal.get(Calendar.MONTH) / 3 + 1
然后通过StringBuilder拼接字符串
/**
* 获得指定日期年份和季度<br>
* 格式:[20131]表示2013年第一季度
*
* @param cal 日期
* @return 年和季度,格式类似于20131
*/
public static String yearAndQuarter(Calendar cal) {
return StrUtil.builder().append(cal.get(Calendar.YEAR)).append(cal.get(Calendar.MONTH) / 3 + 1).toString();
}
获得指定日期区间内的年份和季节<br>
/**
* 获得指定日期区间内的年份和季节<br>
*
* @param startDate 起始日期(包含)
* @param endDate 结束日期(包含)
* @return 季度列表 ,元素类似于 20132
*/
public static LinkedHashSet<String> yearAndQuarter(Date startDate, Date endDate) {
if (startDate == null || endDate == null) {
return new LinkedHashSet<>(0);
}
return yearAndQuarter(startDate.getTime(), endDate.getTime());
}
如上面代码所示,有个判空处理
然后,写了一个while循环,把符合条件的年份和季度存到LinkedHashSet里,存完一个年份和季度的字符串后,会给开始时间增加3个月,如果开始时间超出结束时间,让结束时间为开始时间,处理完后结束循环
/**
* 获得指定日期区间内的年份和季度<br>
*
* @param startDate 起始日期(包含)
* @param endDate 结束日期(包含)
* @return 季度列表 ,元素类似于 20132
* @since 4.1.15
*/
public static LinkedHashSet<String> yearAndQuarter(long startDate, long endDate) {
LinkedHashSet<String> quarters = new LinkedHashSet<>();
final Calendar cal = calendar(startDate);
while (startDate <= endDate) {
// 如果开始时间超出结束时间,让结束时间为开始时间,处理完后结束循环
quarters.add(yearAndQuarter(cal));
cal.add(Calendar.MONTH, 3);
startDate = cal.getTimeInMillis();
}
return quarters;
}
Copyright © 2003-2013 www.wpsshop.cn 版权所有,并保留所有权利。