Java Calendar所有方法
getInstance
public static synchronized Calendar getInstance()用缺省时区和语言环境获得一个日历。
返回值:一个 Calendar。
getInstance
public static synchronized Calendar getInstance(TimeZone zone)用给定时区和缺省语言环境获得一个日历。
参数:zone - 给定的时区。
返回值:一个 Calendar。
getInstance
public static synchronized Calendar getInstance(Locale aLocale)用缺省时区和给定语言环境获得一个日历。
参数:aLocale - 给定的语言环境。
返回值:一个 Calendar。
getInstance
public static synchronized Calendar getInstance(TimeZone zone, Locale aLocale)用给的时区和给定语言环境获得一个日历。
参数:zone - 给定的时区。aLocale - 给定的语言环境。
返回值:一个 Calendar。
getAvailableLocales
public static synchronized Locale[] getAvailableLocales()获得安装 Calendars 的语言环境集合。
返回值:安装 Calendars 的语言环境集合。
computeTime
protected abstract void computeTime()
将日历的时间域作为毫秒值转换为 UTC。
computeFields
protected abstract void computeFields()将 UTC 作为毫秒值转换为时间域值。 允许使时间域值与日历设置的新时间同步。 开始不重新计算该时间;为了重新计算时间和域,调用 complete方法。
参见:complete
getTime
public final Date getTime()获得日历的当前时间。
返回值:当前的时间。
setTime
public final void setTime(Date date)用给定的 Date 设置 Calendar 的当前时间。
参数:date - 给定的 Date。
getTimeInMillis
protected long getTimeInMillis()获得日历的作为长整型的当前时间。
返回值:当前时间,作为从开始时间的 UTC 毫秒值。
setTimeInMillis
protected void setTimeInMillis(long millis)用给定的长整数设置 Calendar 的当前时间。
参数:date - 新时间,从开始时间的 UTC 毫秒时间。
get
public final int get(int field)获得给定时间域的值。
参数:field - 给定的时间域。
返回值:给定的时间域值。
internalGet
protected final int internalGet(int field)获取给定时间域的值。 这是子类的一个内部快速时间域值 getter。
参数:field - 给定的时间域。
返回值:给定的时间域值。
set
public final void set(int field, int value)用给定的值设置时间域。
参数:field - 给定的时间域。value - 要设置的给定时间域的值。
set
public final void set(int year, int month, int date)设置年、月、日期域的数值。 保留其它域上次的值。 如果不需要保留,首先调用 clear。
参数:year - 用于设置 YEAR 时间域的值。month - 用于设置 MONTH 时间域的值。 Month 值以 0 开始。 例如,0 代表一月。date - 用于设置 DATE 时间域的值。
set
public final void set(int year, int month, int date, int hour, int minute)设置年、月、日期、时和分域的数值。 保留其它域上次的值。 如果不需要保留,首先调用 clear。
参数:year - 用于设置 YEAR 时间域的值。month - 用于设置 MONTH 时间域的值。 Month 值以 0 开始。 例如,0 代表一月。date - 用于设置 DATE 时间域的值。hour - 用于设置 HOUR 时间域的值。minute - 用于设置 MINUTE 时间域的值。
set
public final void set(int year, int month, int date, int hour, int minute, int second)设置年、月、日期、时、分和秒域的数值。 保留其它域上次的值。 如果不需要保留,首先调用 clear。
参数:year - 用于设置 YEAR 时间域的值。month - 用于设置 MONTH 时间域的值。 Month 值以 0 开始。 例如,0 代表一月。date - 用于设置 DATE 时间域的值。hour - 用于设置 HOUR 时间域的值。minute - 用于设置 MINUTE 时间域的值。second - 用于设置 SECOND 时间域的值。
clear
public final void clear()将所有时间域值清零。
clear
public final void clear(int field)将给定的时间域值清零。
参数:field - 要清零的时间域。
isSet
public final boolean isSet(int field)确定给定的时间域是否设置了数值。
返回值:如果给定的时间域设置了数值则返回 true;否则返回 false。
complete
protected void complete()填充时间域列表中所有未设置的域。
equals
public abstract boolean equals(Object obj)比较该日历和指定的对象。 当且仅当参数不为 null 而是与该对象描述同一日历的 Calendar 对象,结果为 true。
参数:obj - 比较的对象。
返回值:如果对象相同则为 true,否则为 false。
覆盖:类 Object 中的 equals
before
public abstract boolean before(Object when)比较时间域记录。 等价于比较转换到 UTC 的结果。
参数:when - 与该 Calendar 比较的 Calendar。
返回值:如果当前时间在 Calendar when 的时间之前则为 true;否则为 false。
after
public abstract boolean after(Object when)比较时间域记录。 等价于比较转换到 UTC 的结果。
参数:when - 与该 Calendar 比较的 Calendar。
返回值:如果该日历的当前时间在 Calendar when 的时间之后则为 true;否则为 false。
add
public abstract void add(int field, int amount)日期的计算功能。 按照日历的规则,将指定 ( 带符号的 ) 数量的时间添加到给定的时间域。 例如,从日历的当前时间减 5 ,可调用:
add(Calendar.DATE, -5)。
参数:field - 时间域。amount - 添加到该域的日期和时间的数量。
roll
public abstract void roll(int field, boolean up)时间域滚动功能。 在给定的时间域上 ( 向上 / 向下 ) 滚动一个单个的时间单元。 例如,为了将当前日期向上滚动一天,可调用:
roll(Calendar.DATE, true)。 当在年或 Calendar.YEAR 域滚动时,年值将在 1 和调用 getMaximum(Calendar.YEAR) 的返回值之间滚动。 当在月或 Calendar.MONTH 域滚动时,其它的域,例如日期,可能会发生冲突需要改变。 例如,将日期 01/31/96 滚动一月结果是 03/02/96。 当在小时域或 Calendar.HOUR_OF_DAY 域滚动,小时值将在范围 0 到 23 之间滚动,它以 0 开始。
参数:field - 时间域。up - 指明指定时间域值向上还是向下滚动。 如果向上滚动用 true ,否则用 false。
setTimeZone
public void setTimeZone(TimeZone value)用给定的时区值设置时区。
参数:value - 给定的时区。
getTimeZone
public TimeZone getTimeZone()获得时区。
返回值:与日历相应的时区对象。
setLenient
public void setLenient(boolean lenient)指明对日期/时间的解释是否是宽松的。 在宽松的解释下,一个诸如 "February 942, 1996" 的日期将被看作与1996 年 2 月后的第 941 天等价。 在严格的解释下,这样的日期将引起抛出异常。
参见:setLenient
isLenient
public boolean isLenient()指明对日期/时间的解释是否是宽松的。
setFirstDayOfWeek
public void setFirstDayOfWeek(int value)设置一周的第一天;例如在美国为 Sunday,在法国为 Monday。
参数:value - 一周给定的第一天。
getFirstDayOfWeek
public int getFirstDayOfWeek()获得一周的第一天;例如在美国为 Sunday,在法国为 Monday。
返回值:一周的第一天。
setMinimalDaysInFirstWeek
public void setMinimalDaysInFirstWeek(int value)设置该年中第一个星期所需要的最少的天数,例如,如果定义第一个星期包含一年第一个月的第一天,用值 1 调用该方法。如果它必须是一个完整的星期,使用 7 调用该方法。
参数:value - 给定的一年中第一个星期要求的最少天数。
getMinimalDaysInFirstWeek
public int getMinimalDaysInFirstWeek()获得该年中第一个星期所需要的最少的天数,例如,如果第一个星期定义为包含一年第一个月的第一天,getMinimalDaysInFirstWeek 返回 1。如果要求的最少天数必须是一个完整的星期,getMinimalDaysInFirstWeek 返回 7。
返回值:一年中第一个星期要求的最少天数。
getMinimum
public abstract int getMinimum(int field)获得给定时间域最小值。 例如对于格里高里 DAY_OF_MONTH 为 1。
参数:field - 给定的时间域。
返回值:给定时间域最小值。
getMaximum
public abstract int getMaximum(int field)获得给定时间域最大值。 例如对于 Gregorian DAY_OF_MONTH 为 31。
参数:field - 给定的时间域。
返回值:给定时间域最大值。
getGreatestMinimum
public abstract int getGreatestMinimum(int field)获得给定域变化时的最高的最小值。 否则与 getMinimum() 相同。对格里高里日历没有区别。
参数:field - 给定的时间域。
返回值:给定时间域最高的最小值。
getLeastMaximum
public abstract int getLeastMaximum(int field)获得给定域变化时的最低的最大值。 否则与 getMaximum() 相同。例如对于格里高里日历 DAY_OF_MONTH 为 28。
参数:field - 给定的时间域。
返回值:定时间域最低的最大值。
clone
public Object clone()覆盖 Cloneable
覆盖:类 Object 中的 clone
toString
public String toString()返回日历的字符串表示。
返回值:日历的字符串表示。
覆盖:类 Object 中的 toString
版权声明:本文为JAVASCHOOL原创文章,未经本站允许不得转载。