io.polaris.core.time

类 Calendars

java.lang.Object

io.polaris.core.time.Calendars

所有已实现的接口:

DateConsts

public class Calendars
extends Object
implements DateConsts

从以下版本开始:

May 30, 2024

作者:

Qt

字段概要

从接口继承的字段 io.polaris.core.time.DateConsts

PATTERN_HH_MM_SS, PATTERN_HH_MM_SS_SSS, PATTERN_HHMMSS, PATTERN_HHMMSSSSS, PATTERN_YYYY_MM_DD, PATTERN_YYYY_MM_DD_HH_MM_SS, PATTERN_YYYY_MM_DD_HH_MM_SS_SSS, PATTERN_YYYYMMDD, PATTERN_YYYYMMDDHHMMSS, PATTERN_YYYYMMDDHHMMSSSSS

构造器概要

构造器

构造器和说明
Calendars()

方法概要

限定符和类型	方法和说明
static Calendar	add(Calendar calendar, CalAllField field, int amount) 给指定日历增加指定字段的值
static Calendar	add(Calendar calendar, int field, int amount) 给指定日历增加指定字段的值
static Date	add(Date date, CalAllField field, int amount) 给指定日期增加指定字段的值
static Date	add(Date date, int field, int amount) 给指定日期增加指定字段的值
static Calendar	addDays(Calendar calendar, int amount) 给指定日历增加天数
static Date	addDays(Date date, int amount) 给指定日期增加天数
static Calendar	addHours(Calendar calendar, int amount) 给指定日历增加小时数
static Date	addHours(Date date, int amount) 给指定日期增加小时数
static Calendar	addMilliseconds(Calendar calendar, int amount) 给指定日历增加毫秒数
static Date	addMilliseconds(Date date, int amount) 给指定日期增加毫秒数
static Calendar	addMinutes(Calendar calendar, int amount) 给指定日历增加分钟数
static Date	addMinutes(Date date, int amount) 给指定日期增加分钟数
static Calendar	addMonths(Calendar calendar, int amount) 给指定日历增加月数
static Date	addMonths(Date date, int amount) 给指定日期增加月数
static Calendar	addSeconds(Calendar calendar, int amount) 给指定日历增加秒数
static Date	addSeconds(Date date, int amount) 给指定日期增加秒数
static Calendar	addWeeks(Calendar calendar, int amount) 给指定日历增加周数
static Date	addWeeks(Date date, int amount) 给指定日期增加周数
static Calendar	addYears(Calendar calendar, int amount) 给指定日历增加年数
static Date	addYears(Date date, int amount) 给指定日期增加年数
static Calendar	ceil(Calendar cal, CalStdField field) 获取指定字段的向上取整值
static Calendar	ceil(Calendar cal, int field) 获取指定字段的向上取整值 field 取值范围： Calendar.YEAR, Calendar.MONTH, Calendar.DAY_OF_MONTH, Calendar.HOUR_OF_DAY, Calendar.HOUR, Calendar.MINUTE, Calendar.SECOND, Calendar.MILLISECOND
static Calendar	floor(Calendar cal, CalStdField field) 获取指定字段的向下取整值
static Calendar	floor(Calendar cal, int field) 获取指定字段的向下取整值 field 取值范围： Calendar.YEAR, Calendar.MONTH, Calendar.DAY_OF_MONTH, Calendar.HOUR_OF_DAY, Calendar.HOUR, Calendar.MINUTE, Calendar.SECOND, Calendar.MILLISECOND
static String	format(String format, Calendar calendar) 格式化日期
static String	formatDefault(Calendar calendar) 使用默认格式格式化日期
static int	get(Calendar calendar, CalAllField field) 获取日历指定字段的值
static int	get(Calendar calendar, int field) 获取日历指定字段的值
static int	get(Date date, CalAllField field) 获取日期指定字段的值
static int	get(Date date, int field) 获取日期指定字段的值
static int	getDay(Calendar calendar) 获取日历的天数
static int	getDay(Date date) 获取日期的天数
static int	getHour(Calendar calendar) 获取日历的小时数
static int	getHour(Date date) 获取日期的小时数
static int	getMillisecond(Calendar calendar) 获取日历的毫秒数
static int	getMillisecond(Date date) 获取日期的毫秒数
static int	getMinute(Calendar calendar) 获取日历的分钟数
static int	getMinute(Date date) 获取日期的分钟数
static int	getMonth(Calendar calendar) 获取日历的月份
static int	getMonth(Date date) 获取日期的月份
static int	getSecond(Calendar calendar) 获取日历的秒数
static int	getSecond(Date date) 获取日期的秒数
static int	getYear(Calendar calendar) 获取日历的年份
static int	getYear(Date date) 获取日期的年份
static boolean	isSameDay(Calendar cal1, Calendar cal2) 判断两个日历对象是否表示同一天
static boolean	isSameDay(Date date1, Date date2) 判断两个日期对象是否表示同一天
static boolean	isSameInstant(Calendar cal1, Calendar cal2) 判断两个日历对象是否表示同一时刻
static boolean	isSameInstant(Date date1, Date date2) 判断两个日期对象是否表示同一时刻
static Calendar	parse(String val) 使用默认格式解析日期字符串为日历对象
static Calendar	parse(String format, String calendar) 解析日期字符串为日历对象
static Calendar	round(Calendar cal, CalStdField field) 获取指定字段的四舍五入值
static Calendar	round(Calendar cal, int field) 获取指定字段的四舍五入值 field 取值范围： Calendar.YEAR, Calendar.MONTH, Calendar.DAY_OF_MONTH, Calendar.HOUR_OF_DAY, Calendar.HOUR, Calendar.MINUTE, Calendar.SECOND, Calendar.MILLISECOND
static Calendar	set(Calendar calendar, CalAllField field, int amount) 设置日历指定字段的值
static Calendar	set(Calendar calendar, int field, int amount) 设置日历指定字段的值
static Calendar	setDay(Calendar calendar, int amount) 设置日历的天数
static Date	setDay(Date date, int amount) 设置日期的天数
static Calendar	setHour(Calendar calendar, int amount) 设置日历的小时数
static Date	setHour(Date date, int amount) 设置日期的小时数
static Calendar	setMillisecond(Calendar calendar, int amount) 设置日历的毫秒数
static Date	setMillisecond(Date date, int amount) 设置日期的毫秒数
static Calendar	setMinute(Calendar calendar, int amount) 设置日历的分钟数
static Date	setMinute(Date date, int amount) 设置日期的分钟数
static Calendar	setMonth(Calendar calendar, int amount) 设置日历的月份
static Date	setMonth(Date date, int amount) 设置日期的月份
static Calendar	setSecond(Calendar calendar, int amount) 设置日历的秒数
static Date	setSecond(Date date, int amount) 设置日期的秒数
static Calendar	setYear(Calendar calendar, int amount) 设置日历的年份
static Date	setYear(Date date, int amount) 设置日期的年份
static Calendar	toCalendar(Date date) 将日期转换为日历对象
static Calendar	toCalendar(Date date, TimeZone tz) 将日期转换为指定时区的日历对象

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

Calendars

public Calendars()

方法详细资料

format

public static String format(String format,
                            Calendar calendar)

格式化日期

参数:

format - 日期格式

calendar - 日历对象

返回:

格式化后的日期字符串

formatDefault

public static String formatDefault(Calendar calendar)

使用默认格式格式化日期

参数:

calendar - 日历对象

返回:

格式化后的日期字符串

parse

public static Calendar parse(@Nonnull
                             String format,
                             @Nonnull
                             String calendar)

解析日期字符串为日历对象

参数:

format - 日期格式

calendar - 日期字符串

返回:

解析后的日历对象

parse

public static Calendar parse(@Nonnull
                             String val)

使用默认格式解析日期字符串为日历对象

参数:

val - 日期字符串

返回:

解析后的日历对象

toCalendar

public static Calendar toCalendar(@Nonnull
                                  Date date)

将日期转换为日历对象

参数:

date - 日期对象

返回:

转换后的日历对象

toCalendar

public static Calendar toCalendar(@Nonnull
                                  Date date,
                                  TimeZone tz)

将日期转换为指定时区的日历对象

参数:

date - 日期对象

tz - 时区

返回:

转换后的日历对象

isSameDay

public static boolean isSameDay(@Nonnull
                                Calendar cal1,
                                @Nonnull
                                Calendar cal2)

判断两个日历对象是否表示同一天

参数:

cal1 - 日历对象1

cal2 - 日历对象2

返回:

是否为同一天

isSameDay

public static boolean isSameDay(@Nonnull
                                Date date1,
                                @Nonnull
                                Date date2)

判断两个日期对象是否表示同一天

参数:

date1 - 日期对象1

date2 - 日期对象2

返回:

是否为同一天

isSameInstant

public static boolean isSameInstant(@Nonnull
                                    Date date1,
                                    @Nonnull
                                    Date date2)

判断两个日期对象是否表示同一时刻

参数:

date1 - 日期对象1

date2 - 日期对象2

返回:

是否为同一时刻

isSameInstant

public static boolean isSameInstant(@Nonnull
                                    Calendar cal1,
                                    @Nonnull
                                    Calendar cal2)

判断两个日历对象是否表示同一时刻

参数:

cal1 - 日历对象1

cal2 - 日历对象2

返回:

是否为同一时刻

ceil

public static Calendar ceil(Calendar cal,
                            int field)

获取指定字段的向上取整值

field 取值范围： Calendar.YEAR, Calendar.MONTH, Calendar.DAY_OF_MONTH, Calendar.HOUR_OF_DAY, Calendar.HOUR, Calendar.MINUTE, Calendar.SECOND, Calendar.MILLISECOND

参数:

cal - 日历对象

field - 需要向上取整的字段

返回:

向上取整后的日历对象

ceil

public static Calendar ceil(Calendar cal,
                            CalStdField field)

获取指定字段的向上取整值

参数:

cal - 日历对象

field - 需要向上取整的字段枚举

返回:

向上取整后的日历对象

floor

public static Calendar floor(Calendar cal,
                             int field)

获取指定字段的向下取整值

field 取值范围： Calendar.YEAR, Calendar.MONTH, Calendar.DAY_OF_MONTH, Calendar.HOUR_OF_DAY, Calendar.HOUR, Calendar.MINUTE, Calendar.SECOND, Calendar.MILLISECOND

参数:

cal - 日历对象

field - 需要向下取整的字段

返回:

向下取整后的日历对象

floor

public static Calendar floor(Calendar cal,
                             CalStdField field)

获取指定字段的向下取整值

参数:

cal - 日历对象

field - 需要向下取整的字段

返回:

向下取整后的日历对象

round

public static Calendar round(Calendar cal,
                             int field)

获取指定字段的四舍五入值

field 取值范围： Calendar.YEAR, Calendar.MONTH, Calendar.DAY_OF_MONTH, Calendar.HOUR_OF_DAY, Calendar.HOUR, Calendar.MINUTE, Calendar.SECOND, Calendar.MILLISECOND

参数:

cal - 日历对象

field - 需要四舍五入的字段

返回:

四舍五入后的日历对象

round

public static Calendar round(Calendar cal,
                             CalStdField field)

获取指定字段的四舍五入值

参数:

cal - 日历对象

field - 需要四舍五入的字段

返回:

四舍五入后的日历对象

addYears

public static Date addYears(@Nonnull
                            Date date,
                            int amount)

给指定日期增加年数

参数:

date - 日期对象

amount - 增加的年数

返回:

增加年数后的日期对象

addMonths

public static Date addMonths(@Nonnull
                             Date date,
                             int amount)

给指定日期增加月数

参数:

date - 日期对象

amount - 增加的月数

返回:

增加月数后的日期对象

addWeeks

public static Date addWeeks(@Nonnull
                            Date date,
                            int amount)

给指定日期增加周数

参数:

date - 日期对象

amount - 增加的周数

返回:

增加周数后的日期对象

addDays

public static Date addDays(@Nonnull
                           Date date,
                           int amount)

给指定日期增加天数

参数:

date - 日期对象

amount - 增加的天数

返回:

增加天数后的日期对象

addHours

public static Date addHours(@Nonnull
                            Date date,
                            int amount)

给指定日期增加小时数

参数:

date - 日期对象

amount - 增加的小时数

返回:

增加小时数后的日期对象

addMinutes

public static Date addMinutes(@Nonnull
                              Date date,
                              int amount)

给指定日期增加分钟数

参数:

date - 日期对象

amount - 增加的分钟数

返回:

增加分钟数后的日期对象

addSeconds

public static Date addSeconds(@Nonnull
                              Date date,
                              int amount)

给指定日期增加秒数

参数:

date - 日期对象

amount - 增加的秒数

返回:

增加秒数后的日期对象

addMilliseconds

public static Date addMilliseconds(@Nonnull
                                   Date date,
                                   int amount)

给指定日期增加毫秒数

参数:

date - 日期对象

amount - 增加的毫秒数

返回:

增加毫秒数后的日期对象

add

public static Date add(@Nonnull
                       Date date,
                       CalAllField field,
                       int amount)

给指定日期增加指定字段的值

参数:

date - 日期对象

field - 日历字段

amount - 增加的数量

返回:

增加字段值后的日期对象

add

public static Date add(@Nonnull
                       Date date,
                       int field,
                       int amount)

给指定日期增加指定字段的值

参数:

date - 日期对象

field - 日历字段

amount - 增加的数量

返回:

增加字段值后的日期对象

addYears

public static Calendar addYears(@Nonnull
                                Calendar calendar,
                                int amount)

给指定日历增加年数

参数:

calendar - 日历对象

amount - 增加的年数

返回:

增加年数后的日历对象

addMonths

public static Calendar addMonths(@Nonnull
                                 Calendar calendar,
                                 int amount)

给指定日历增加月数

参数:

calendar - 日历对象

amount - 增加的月数

返回:

增加月数后的日历对象

addWeeks

public static Calendar addWeeks(@Nonnull
                                Calendar calendar,
                                int amount)

给指定日历增加周数

参数:

calendar - 日历对象

amount - 增加的周数

返回:

增加周数后的日历对象

addDays

public static Calendar addDays(@Nonnull
                               Calendar calendar,
                               int amount)

给指定日历增加天数

参数:

calendar - 日历对象

amount - 增加的天数

返回:

增加天数后的日历对象

addHours

public static Calendar addHours(@Nonnull
                                Calendar calendar,
                                int amount)

给指定日历增加小时数

参数:

calendar - 日历对象

amount - 增加的小时数

返回:

增加小时数后的日历对象

addMinutes

public static Calendar addMinutes(@Nonnull
                                  Calendar calendar,
                                  int amount)

给指定日历增加分钟数

参数:

calendar - 日历对象

amount - 增加的分钟数

返回:

增加分钟数后的日历对象

addSeconds

public static Calendar addSeconds(@Nonnull
                                  Calendar calendar,
                                  int amount)

给指定日历增加秒数

参数:

calendar - 日历对象

amount - 增加的秒数

返回:

增加秒数后的日历对象

addMilliseconds

public static Calendar addMilliseconds(@Nonnull
                                       Calendar calendar,
                                       int amount)

给指定日历增加毫秒数

参数:

calendar - 日历对象

amount - 增加的毫秒数

返回:

增加毫秒数后的日历对象

add

public static Calendar add(@Nonnull
                           Calendar calendar,
                           CalAllField field,
                           int amount)

给指定日历增加指定字段的值

参数:

calendar - 日历对象

field - 日历字段

amount - 增加的数量

返回:

增加字段值后的日历对象

add

public static Calendar add(@Nonnull
                           Calendar calendar,
                           int field,
                           int amount)

给指定日历增加指定字段的值

参数:

calendar - 日历对象

field - 日历字段

amount - 增加的数量

返回:

增加字段值后的日历对象

setYear

public static Date setYear(@Nonnull
                           Date date,
                           int amount)

设置日期的年份

参数:

date - 日期对象

amount - 年份值

返回:

设置年份后的日期对象

setMonth

public static Date setMonth(@Nonnull
                            Date date,
                            int amount)

设置日期的月份

参数:

date - 日期对象

amount - 月份值

返回:

设置月份后的日期对象

setDay

public static Date setDay(@Nonnull
                          Date date,
                          int amount)

设置日期的天数

参数:

date - 日期对象

amount - 天数值

返回:

设置天数后的日期对象

setHour

public static Date setHour(@Nonnull
                           Date date,
                           int amount)

设置日期的小时数

参数:

date - 日期对象

amount - 小时值

返回:

设置小时数后的日期对象

setMinute

public static Date setMinute(@Nonnull
                             Date date,
                             int amount)

设置日期的分钟数

参数:

date - 日期对象

amount - 分钟值

返回:

设置分钟数后的日期对象

setSecond

public static Date setSecond(@Nonnull
                             Date date,
                             int amount)

设置日期的秒数

参数:

date - 日期对象

amount - 秒数值

返回:

设置秒数后的日期对象

setMillisecond

public static Date setMillisecond(@Nonnull
                                  Date date,
                                  int amount)

设置日期的毫秒数

参数:

date - 日期对象

amount - 毫秒值

返回:

设置毫秒数后的日期对象

setYear

public static Calendar setYear(@Nonnull
                               Calendar calendar,
                               int amount)

设置日历的年份

参数:

calendar - 日历对象

amount - 年份值

返回:

设置年份后的日历对象

setMonth

public static Calendar setMonth(@Nonnull
                                Calendar calendar,
                                int amount)

设置日历的月份

参数:

calendar - 日历对象

amount - 月份值

返回:

设置月份后的日历对象

setDay

public static Calendar setDay(@Nonnull
                              Calendar calendar,
                              int amount)

设置日历的天数

参数:

calendar - 日历对象

amount - 天数值

返回:

设置天数后的日历对象

setHour

public static Calendar setHour(@Nonnull
                               Calendar calendar,
                               int amount)

设置日历的小时数

参数:

calendar - 日历对象

amount - 小时值

返回:

设置小时数后的日历对象

setMinute

public static Calendar setMinute(@Nonnull
                                 Calendar calendar,
                                 int amount)

设置日历的分钟数

参数:

calendar - 日历对象

amount - 分钟值

返回:

设置分钟数后的日历对象

setSecond

public static Calendar setSecond(@Nonnull
                                 Calendar calendar,
                                 int amount)

设置日历的秒数

参数:

calendar - 日历对象

amount - 秒数值

返回:

设置秒数后的日历对象

setMillisecond

public static Calendar setMillisecond(@Nonnull
                                      Calendar calendar,
                                      int amount)

设置日历的毫秒数

参数:

calendar - 日历对象

amount - 毫秒值

返回:

设置毫秒数后的日历对象

set

public static Calendar set(@Nonnull
                           Calendar calendar,
                           CalAllField field,
                           int amount)

设置日历指定字段的值

参数:

calendar - 日历对象

field - 日历字段

amount - 字段值

返回:

设置字段值后的日历对象

set

public static Calendar set(@Nonnull
                           Calendar calendar,
                           int field,
                           int amount)

设置日历指定字段的值

参数:

calendar - 日历对象

field - 日历字段

amount - 字段值

返回:

设置字段值后的日历对象

getYear

public static int getYear(@Nonnull
                          Date date)

获取日期的年份

参数:

date - 日期对象

返回:

年份值

getMonth

public static int getMonth(@Nonnull
                           Date date)

获取日期的月份

参数:

date - 日期对象

返回:

月份值

getDay

public static int getDay(@Nonnull
                         Date date)

获取日期的天数

参数:

date - 日期对象

返回:

天数值

getHour

public static int getHour(@Nonnull
                          Date date)

获取日期的小时数

参数:

date - 日期对象

返回:

小时值

getMinute

public static int getMinute(@Nonnull
                            Date date)

获取日期的分钟数

参数:

date - 日期对象

返回:

分钟值

getSecond

public static int getSecond(@Nonnull
                            Date date)

获取日期的秒数

参数:

date - 日期对象

返回:

秒数值

getMillisecond

public static int getMillisecond(@Nonnull
                                 Date date)

获取日期的毫秒数

参数:

date - 日期对象

返回:

毫秒值

get

public static int get(@Nonnull
                      Date date,
                      CalAllField field)

获取日期指定字段的值

参数:

date - 日期对象

field - 日历字段

返回:

字段值

get

public static int get(@Nonnull
                      Date date,
                      int field)

获取日期指定字段的值

参数:

date - 日期对象

field - 日历字段

返回:

字段值

getYear

public static int getYear(@Nonnull
                          Calendar calendar)

获取日历的年份

参数:

calendar - 日历对象

返回:

年份值

getMonth

public static int getMonth(@Nonnull
                           Calendar calendar)

获取日历的月份

参数:

calendar - 日历对象

返回:

月份值

getDay

public static int getDay(@Nonnull
                         Calendar calendar)

获取日历的天数

参数:

calendar - 日历对象

返回:

天数值

getHour

public static int getHour(@Nonnull
                          Calendar calendar)

获取日历的小时数

参数:

calendar - 日历对象

返回:

小时值

getMinute

public static int getMinute(@Nonnull
                            Calendar calendar)

获取日历的分钟数

参数:

calendar - 日历对象

返回:

分钟值

getSecond

public static int getSecond(@Nonnull
                            Calendar calendar)

获取日历的秒数

参数:

calendar - 日历对象

返回:

秒数值

getMillisecond

public static int getMillisecond(@Nonnull
                                 Calendar calendar)

获取日历的毫秒数

参数:

calendar - 日历对象

返回:

毫秒值

get

public static int get(@Nonnull
                      Calendar calendar,
                      CalAllField field)

获取日历指定字段的值

参数:

calendar - 日历对象

field - 日历字段

返回:

字段值

get

public static int get(@Nonnull
                      Calendar calendar,
                      int field)

获取日历指定字段的值

参数:

calendar - 日历对象

field - 日历字段

返回:

字段值