mirror of
https://github.com/openjdk/jdk.git
synced 2025-08-27 06:45:07 +02:00
8231186: Replace html tag <code>foo</code> with javadoc tag {@code foo} in java.base
Minor coding style update of javadoc tag in any file in java.base Reviewed-by: bchristi, lancea
This commit is contained in:
Julia Boes
parent
13d0bac294
commit
d15a57b842
139 changed files with 3499 additions and 3499 deletions
|
|
@ -48,7 +48,7 @@ import sun.util.calendar.BaseCalendar;
|
|||
import sun.util.calendar.Gregorian;
|
||||
|
||||
/**
|
||||
* <code>SimpleTimeZone</code> is a concrete subclass of <code>TimeZone</code>
|
||||
* {@code SimpleTimeZone} is a concrete subclass of {@code TimeZone}
|
||||
* that represents a time zone for use with a Gregorian calendar.
|
||||
* The class holds an offset from GMT, called <em>raw offset</em>, and start
|
||||
* and end rules for a daylight saving time schedule. Since it only holds
|
||||
|
|
@ -57,7 +57,7 @@ import sun.util.calendar.Gregorian;
|
|||
* #setStartYear setStartYear} method can specify the year when the daylight
|
||||
* saving time schedule starts in effect.
|
||||
* <p>
|
||||
* To construct a <code>SimpleTimeZone</code> with a daylight saving time
|
||||
* To construct a {@code SimpleTimeZone} with a daylight saving time
|
||||
* schedule, the schedule can be described with a set of rules,
|
||||
* <em>start-rule</em> and <em>end-rule</em>. A day when daylight saving time
|
||||
* starts or ends is specified by a combination of <em>month</em>,
|
||||
|
|
@ -81,7 +81,7 @@ import sun.util.calendar.Gregorian;
|
|||
* or after which the rule is applied, and <em>day-of-week</em> to a negative {@link
|
||||
* Calendar#DAY_OF_WEEK DAY_OF_WEEK} field value. For example, to specify the
|
||||
* second Sunday of April, set <em>month</em> to {@link Calendar#APRIL APRIL},
|
||||
* <em>day-of-month</em> to 8, and <em>day-of-week</em> to <code>-</code>{@link
|
||||
* <em>day-of-month</em> to 8, and <em>day-of-week</em> to {@code -}{@link
|
||||
* Calendar#SUNDAY SUNDAY}.</li>
|
||||
*
|
||||
* <li><b>Day of week on or before day of month</b><br>
|
||||
|
|
@ -89,7 +89,7 @@ import sun.util.calendar.Gregorian;
|
|||
* <em>day-of-month</em> and <em>day-of-week</em> to a negative value. For
|
||||
* example, to specify the last Wednesday on or before the 21st of March, set
|
||||
* <em>month</em> to {@link Calendar#MARCH MARCH}, <em>day-of-month</em> is -21
|
||||
* and <em>day-of-week</em> is <code>-</code>{@link Calendar#WEDNESDAY WEDNESDAY}. </li>
|
||||
* and <em>day-of-week</em> is {@code -}{@link Calendar#WEDNESDAY WEDNESDAY}. </li>
|
||||
*
|
||||
* <li><b>Last day-of-week of month</b><br>
|
||||
* To specify, the last day-of-week of the month, set <em>day-of-week</em> to a
|
||||
|
|
@ -139,7 +139,7 @@ import sun.util.calendar.Gregorian;
|
|||
* 3600000)
|
||||
* </code></pre>
|
||||
* These parameter rules are also applicable to the set rule methods, such as
|
||||
* <code>setStartRule</code>.
|
||||
* {@code setStartRule}.
|
||||
*
|
||||
* @since 1.1
|
||||
* @see Calendar
|
||||
|
|
@ -167,7 +167,7 @@ public class SimpleTimeZone extends TimeZone {
|
|||
* Constructs a SimpleTimeZone with the given base time zone offset from
|
||||
* GMT, time zone ID, and rules for starting and ending the daylight
|
||||
* time.
|
||||
* Both <code>startTime</code> and <code>endTime</code> are specified to be
|
||||
* Both {@code startTime} and {@code endTime} are specified to be
|
||||
* represented in the wall clock time. The amount of daylight saving is
|
||||
* assumed to be 3600000 milliseconds (i.e., one hour). This constructor is
|
||||
* equivalent to:
|
||||
|
|
@ -226,7 +226,7 @@ public class SimpleTimeZone extends TimeZone {
|
|||
* Constructs a SimpleTimeZone with the given base time zone offset from
|
||||
* GMT, time zone ID, and rules for starting and ending the daylight
|
||||
* time.
|
||||
* Both <code>startTime</code> and <code>endTime</code> are assumed to be
|
||||
* Both {@code startTime} and {@code endTime} are assumed to be
|
||||
* represented in the wall clock time. This constructor is equivalent to:
|
||||
* <pre><code>
|
||||
* SimpleTimeZone(rawOffset,
|
||||
|
|
@ -286,8 +286,8 @@ public class SimpleTimeZone extends TimeZone {
|
|||
* GMT, time zone ID, and rules for starting and ending the daylight
|
||||
* time.
|
||||
* This constructor takes the full set of the start and end rules
|
||||
* parameters, including modes of <code>startTime</code> and
|
||||
* <code>endTime</code>. The mode specifies either {@link #WALL_TIME wall
|
||||
* parameters, including modes of {@code startTime} and
|
||||
* {@code endTime}. The mode specifies either {@link #WALL_TIME wall
|
||||
* time} or {@link #STANDARD_TIME standard time} or {@link #UTC_TIME UTC
|
||||
* time}.
|
||||
*
|
||||
|
|
@ -301,7 +301,7 @@ public class SimpleTimeZone extends TimeZone {
|
|||
* @param startDayOfWeek The daylight saving time starting day-of-week.
|
||||
* See the class description for the special cases of this parameter.
|
||||
* @param startTime The daylight saving time starting time in the time mode
|
||||
* specified by <code>startTimeMode</code>.
|
||||
* specified by {@code startTimeMode}.
|
||||
* @param startTimeMode The mode of the start time specified by startTime.
|
||||
* @param endMonth The daylight saving time ending month. Month is
|
||||
* a {@link Calendar#MONTH MONTH} field
|
||||
|
|
@ -311,7 +311,7 @@ public class SimpleTimeZone extends TimeZone {
|
|||
* @param endDayOfWeek The daylight saving time ending day-of-week.
|
||||
* See the class description for the special cases of this parameter.
|
||||
* @param endTime The daylight saving ending time in time mode
|
||||
* specified by <code>endTimeMode</code>.
|
||||
* specified by {@code endTimeMode}.
|
||||
* @param endTimeMode The mode of the end time specified by endTime
|
||||
* @param dstSavings The amount of time in milliseconds saved during
|
||||
* daylight saving time.
|
||||
|
|
@ -369,7 +369,7 @@ public class SimpleTimeZone extends TimeZone {
|
|||
* Sets the daylight saving time start rule. For example, if daylight saving
|
||||
* time starts on the first Sunday in April at 2 am in local wall clock
|
||||
* time, you can set the start rule by calling:
|
||||
* <pre><code>setStartRule(Calendar.APRIL, 1, Calendar.SUNDAY, 2*60*60*1000);</code></pre>
|
||||
* <pre>{@code setStartRule(Calendar.APRIL, 1, Calendar.SUNDAY, 2*60*60*1000);}</pre>
|
||||
*
|
||||
* @param startMonth The daylight saving time starting month. Month is
|
||||
* a {@link Calendar#MONTH MONTH} field
|
||||
|
|
@ -380,8 +380,8 @@ public class SimpleTimeZone extends TimeZone {
|
|||
* See the class description for the special cases of this parameter.
|
||||
* @param startTime The daylight saving time starting time in local wall clock
|
||||
* time, which is local standard time in this case.
|
||||
* @throws IllegalArgumentException if the <code>startMonth</code>, <code>startDay</code>,
|
||||
* <code>startDayOfWeek</code>, or <code>startTime</code> parameters are out of range
|
||||
* @throws IllegalArgumentException if the {@code startMonth}, {@code startDay},
|
||||
* {@code startDayOfWeek}, or {@code startTime} parameters are out of range
|
||||
*/
|
||||
public void setStartRule(int startMonth, int startDay, int startDayOfWeek, int startTime)
|
||||
{
|
||||
|
|
@ -397,7 +397,7 @@ public class SimpleTimeZone extends TimeZone {
|
|||
/**
|
||||
* Sets the daylight saving time start rule to a fixed date within a month.
|
||||
* This method is equivalent to:
|
||||
* <pre><code>setStartRule(startMonth, startDay, 0, startTime)</code></pre>
|
||||
* <pre>{@code setStartRule(startMonth, startDay, 0, startTime)}</pre>
|
||||
*
|
||||
* @param startMonth The daylight saving time starting month. Month is
|
||||
* a {@link Calendar#MONTH MONTH} field
|
||||
|
|
@ -406,8 +406,8 @@ public class SimpleTimeZone extends TimeZone {
|
|||
* @param startTime The daylight saving time starting time in local wall clock
|
||||
* time, which is local standard time in this case.
|
||||
* See the class description for the special cases of this parameter.
|
||||
* @throws IllegalArgumentException if the <code>startMonth</code>,
|
||||
* <code>startDayOfMonth</code>, or <code>startTime</code> parameters are out of range
|
||||
* @throws IllegalArgumentException if the {@code startMonth},
|
||||
* {@code startDayOfMonth}, or {@code startTime} parameters are out of range
|
||||
* @since 1.2
|
||||
*/
|
||||
public void setStartRule(int startMonth, int startDay, int startTime) {
|
||||
|
|
@ -425,12 +425,12 @@ public class SimpleTimeZone extends TimeZone {
|
|||
* @param startDayOfWeek The daylight saving time starting day-of-week.
|
||||
* @param startTime The daylight saving time starting time in local wall clock
|
||||
* time, which is local standard time in this case.
|
||||
* @param after If true, this rule selects the first <code>dayOfWeek</code> on or
|
||||
* <em>after</em> <code>dayOfMonth</code>. If false, this rule
|
||||
* selects the last <code>dayOfWeek</code> on or <em>before</em>
|
||||
* <code>dayOfMonth</code>.
|
||||
* @throws IllegalArgumentException if the <code>startMonth</code>, <code>startDay</code>,
|
||||
* <code>startDayOfWeek</code>, or <code>startTime</code> parameters are out of range
|
||||
* @param after If true, this rule selects the first {@code dayOfWeek} on or
|
||||
* <em>after</em> {@code dayOfMonth}. If false, this rule
|
||||
* selects the last {@code dayOfWeek} on or <em>before</em>
|
||||
* {@code dayOfMonth}.
|
||||
* @throws IllegalArgumentException if the {@code startMonth}, {@code startDay},
|
||||
* {@code startDayOfWeek}, or {@code startTime} parameters are out of range
|
||||
* @since 1.2
|
||||
*/
|
||||
public void setStartRule(int startMonth, int startDay, int startDayOfWeek,
|
||||
|
|
@ -448,7 +448,7 @@ public class SimpleTimeZone extends TimeZone {
|
|||
* Sets the daylight saving time end rule. For example, if daylight saving time
|
||||
* ends on the last Sunday in October at 2 am in wall clock time,
|
||||
* you can set the end rule by calling:
|
||||
* <code>setEndRule(Calendar.OCTOBER, -1, Calendar.SUNDAY, 2*60*60*1000);</code>
|
||||
* {@code setEndRule(Calendar.OCTOBER, -1, Calendar.SUNDAY, 2*60*60*1000);}
|
||||
*
|
||||
* @param endMonth The daylight saving time ending month. Month is
|
||||
* a {@link Calendar#MONTH MONTH} field
|
||||
|
|
@ -460,8 +460,8 @@ public class SimpleTimeZone extends TimeZone {
|
|||
* @param endTime The daylight saving ending time in local wall clock time,
|
||||
* (in milliseconds within the day) which is local daylight
|
||||
* time in this case.
|
||||
* @throws IllegalArgumentException if the <code>endMonth</code>, <code>endDay</code>,
|
||||
* <code>endDayOfWeek</code>, or <code>endTime</code> parameters are out of range
|
||||
* @throws IllegalArgumentException if the {@code endMonth}, {@code endDay},
|
||||
* {@code endDayOfWeek}, or {@code endTime} parameters are out of range
|
||||
*/
|
||||
public void setEndRule(int endMonth, int endDay, int endDayOfWeek,
|
||||
int endTime)
|
||||
|
|
@ -478,7 +478,7 @@ public class SimpleTimeZone extends TimeZone {
|
|||
/**
|
||||
* Sets the daylight saving time end rule to a fixed date within a month.
|
||||
* This method is equivalent to:
|
||||
* <pre><code>setEndRule(endMonth, endDay, 0, endTime)</code></pre>
|
||||
* <pre>{@code setEndRule(endMonth, endDay, 0, endTime)}</pre>
|
||||
*
|
||||
* @param endMonth The daylight saving time ending month. Month is
|
||||
* a {@link Calendar#MONTH MONTH} field
|
||||
|
|
@ -487,8 +487,8 @@ public class SimpleTimeZone extends TimeZone {
|
|||
* @param endTime The daylight saving ending time in local wall clock time,
|
||||
* (in milliseconds within the day) which is local daylight
|
||||
* time in this case.
|
||||
* @throws IllegalArgumentException the <code>endMonth</code>, <code>endDay</code>,
|
||||
* or <code>endTime</code> parameters are out of range
|
||||
* @throws IllegalArgumentException the {@code endMonth}, {@code endDay},
|
||||
* or {@code endTime} parameters are out of range
|
||||
* @since 1.2
|
||||
*/
|
||||
public void setEndRule(int endMonth, int endDay, int endTime)
|
||||
|
|
@ -508,12 +508,12 @@ public class SimpleTimeZone extends TimeZone {
|
|||
* @param endTime The daylight saving ending time in local wall clock time,
|
||||
* (in milliseconds within the day) which is local daylight
|
||||
* time in this case.
|
||||
* @param after If true, this rule selects the first <code>endDayOfWeek</code> on
|
||||
* or <em>after</em> <code>endDay</code>. If false, this rule
|
||||
* selects the last <code>endDayOfWeek</code> on or before
|
||||
* <code>endDay</code> of the month.
|
||||
* @throws IllegalArgumentException the <code>endMonth</code>, <code>endDay</code>,
|
||||
* <code>endDayOfWeek</code>, or <code>endTime</code> parameters are out of range
|
||||
* @param after If true, this rule selects the first {@code endDayOfWeek} on
|
||||
* or <em>after</em> {@code endDay}. If false, this rule
|
||||
* selects the last {@code endDayOfWeek} on or before
|
||||
* {@code endDay} of the month.
|
||||
* @throws IllegalArgumentException the {@code endMonth}, {@code endDay},
|
||||
* {@code endDayOfWeek}, or {@code endTime} parameters are out of range
|
||||
* @since 1.2
|
||||
*/
|
||||
public void setEndRule(int endMonth, int endDay, int endDayOfWeek, int endTime, boolean after)
|
||||
|
|
@ -583,10 +583,10 @@ public class SimpleTimeZone extends TimeZone {
|
|||
* uses a default {@link GregorianCalendar} object as its
|
||||
* underlying calendar, such as for determining leap years. Do
|
||||
* not use the result of this method with a calendar other than a
|
||||
* default <code>GregorianCalendar</code>.
|
||||
* default {@code GregorianCalendar}.
|
||||
*
|
||||
* <p><em>Note: In general, clients should use
|
||||
* <code>Calendar.get(ZONE_OFFSET) + Calendar.get(DST_OFFSET)</code>
|
||||
* {@code Calendar.get(ZONE_OFFSET) + Calendar.get(DST_OFFSET)}
|
||||
* instead of calling this method.</em>
|
||||
*
|
||||
* @param era The era of the given date.
|
||||
|
|
@ -597,9 +597,9 @@ public class SimpleTimeZone extends TimeZone {
|
|||
* @param dayOfWeek The day-of-week of the given date.
|
||||
* @param millis The milliseconds in day in <em>standard</em> local time.
|
||||
* @return The milliseconds to add to UTC to get local time.
|
||||
* @throws IllegalArgumentException the <code>era</code>,
|
||||
* <code>month</code>, <code>day</code>, <code>dayOfWeek</code>,
|
||||
* or <code>millis</code> parameters are out of range
|
||||
* @throws IllegalArgumentException the {@code era},
|
||||
* {@code month}, {@code day}, {@code dayOfWeek},
|
||||
* or {@code millis} parameters are out of range
|
||||
*/
|
||||
public int getOffset(int era, int year, int month, int day, int dayOfWeek,
|
||||
int millis)
|
||||
|
|
@ -853,7 +853,7 @@ public class SimpleTimeZone extends TimeZone {
|
|||
}
|
||||
|
||||
/**
|
||||
* Returns a clone of this <code>SimpleTimeZone</code> instance.
|
||||
* Returns a clone of this {@code SimpleTimeZone} instance.
|
||||
* @return a clone of this instance.
|
||||
*/
|
||||
public Object clone()
|
||||
|
|
@ -872,11 +872,11 @@ public class SimpleTimeZone extends TimeZone {
|
|||
}
|
||||
|
||||
/**
|
||||
* Compares the equality of two <code>SimpleTimeZone</code> objects.
|
||||
* Compares the equality of two {@code SimpleTimeZone} objects.
|
||||
*
|
||||
* @param obj The <code>SimpleTimeZone</code> object to be compared with.
|
||||
* @return True if the given <code>obj</code> is the same as this
|
||||
* <code>SimpleTimeZone</code> object; false otherwise.
|
||||
* @param obj The {@code SimpleTimeZone} object to be compared with.
|
||||
* @return True if the given {@code obj} is the same as this
|
||||
* {@code SimpleTimeZone} object; false otherwise.
|
||||
*/
|
||||
public boolean equals(Object obj)
|
||||
{
|
||||
|
|
@ -894,9 +894,9 @@ public class SimpleTimeZone extends TimeZone {
|
|||
}
|
||||
|
||||
/**
|
||||
* Returns <code>true</code> if this zone has the same rules and offset as another zone.
|
||||
* Returns {@code true} if this zone has the same rules and offset as another zone.
|
||||
* @param other the TimeZone object to be compared with
|
||||
* @return <code>true</code> if the given zone is a SimpleTimeZone and has the
|
||||
* @return {@code true} if the given zone is a SimpleTimeZone and has the
|
||||
* same rules and offset as this one
|
||||
* @since 1.2
|
||||
*/
|
||||
|
|
@ -957,10 +957,10 @@ public class SimpleTimeZone extends TimeZone {
|
|||
|
||||
/**
|
||||
* The month in which daylight saving time starts. This value must be
|
||||
* between <code>Calendar.JANUARY</code> and
|
||||
* <code>Calendar.DECEMBER</code> inclusive. This value must not equal
|
||||
* <code>endMonth</code>.
|
||||
* <p>If <code>useDaylight</code> is false, this value is ignored.
|
||||
* between {@code Calendar.JANUARY} and
|
||||
* {@code Calendar.DECEMBER} inclusive. This value must not equal
|
||||
* {@code endMonth}.
|
||||
* <p>If {@code useDaylight} is false, this value is ignored.
|
||||
* @serial
|
||||
*/
|
||||
private int startMonth;
|
||||
|
|
@ -968,34 +968,34 @@ public class SimpleTimeZone extends TimeZone {
|
|||
/**
|
||||
* This field has two possible interpretations:
|
||||
* <dl>
|
||||
* <dt><code>startMode == DOW_IN_MONTH</code></dt>
|
||||
* <dt>{@code startMode == DOW_IN_MONTH}</dt>
|
||||
* <dd>
|
||||
* <code>startDay</code> indicates the day of the month of
|
||||
* <code>startMonth</code> on which daylight
|
||||
* {@code startDay} indicates the day of the month of
|
||||
* {@code startMonth} on which daylight
|
||||
* saving time starts, from 1 to 28, 30, or 31, depending on the
|
||||
* <code>startMonth</code>.
|
||||
* {@code startMonth}.
|
||||
* </dd>
|
||||
* <dt><code>startMode != DOW_IN_MONTH</code></dt>
|
||||
* <dt>{@code startMode != DOW_IN_MONTH}</dt>
|
||||
* <dd>
|
||||
* <code>startDay</code> indicates which <code>startDayOfWeek</code> in the
|
||||
* month <code>startMonth</code> daylight
|
||||
* {@code startDay} indicates which {@code startDayOfWeek} in the
|
||||
* month {@code startMonth} daylight
|
||||
* saving time starts on. For example, a value of +1 and a
|
||||
* <code>startDayOfWeek</code> of <code>Calendar.SUNDAY</code> indicates the
|
||||
* first Sunday of <code>startMonth</code>. Likewise, +2 would indicate the
|
||||
* {@code startDayOfWeek} of {@code Calendar.SUNDAY} indicates the
|
||||
* first Sunday of {@code startMonth}. Likewise, +2 would indicate the
|
||||
* second Sunday, and -1 the last Sunday. A value of 0 is illegal.
|
||||
* </dd>
|
||||
* </dl>
|
||||
* <p>If <code>useDaylight</code> is false, this value is ignored.
|
||||
* <p>If {@code useDaylight} is false, this value is ignored.
|
||||
* @serial
|
||||
*/
|
||||
private int startDay;
|
||||
|
||||
/**
|
||||
* The day of the week on which daylight saving time starts. This value
|
||||
* must be between <code>Calendar.SUNDAY</code> and
|
||||
* <code>Calendar.SATURDAY</code> inclusive.
|
||||
* <p>If <code>useDaylight</code> is false or
|
||||
* <code>startMode == DAY_OF_MONTH</code>, this value is ignored.
|
||||
* must be between {@code Calendar.SUNDAY} and
|
||||
* {@code Calendar.SATURDAY} inclusive.
|
||||
* <p>If {@code useDaylight} is false or
|
||||
* {@code startMode == DAY_OF_MONTH}, this value is ignored.
|
||||
* @serial
|
||||
*/
|
||||
private int startDayOfWeek;
|
||||
|
|
@ -1003,8 +1003,8 @@ public class SimpleTimeZone extends TimeZone {
|
|||
/**
|
||||
* The time in milliseconds after midnight at which daylight saving
|
||||
* time starts. This value is expressed as wall time, standard time,
|
||||
* or UTC time, depending on the setting of <code>startTimeMode</code>.
|
||||
* <p>If <code>useDaylight</code> is false, this value is ignored.
|
||||
* or UTC time, depending on the setting of {@code startTimeMode}.
|
||||
* <p>If {@code useDaylight} is false, this value is ignored.
|
||||
* @serial
|
||||
*/
|
||||
private int startTime;
|
||||
|
|
@ -1018,10 +1018,10 @@ public class SimpleTimeZone extends TimeZone {
|
|||
|
||||
/**
|
||||
* The month in which daylight saving time ends. This value must be
|
||||
* between <code>Calendar.JANUARY</code> and
|
||||
* <code>Calendar.UNDECIMBER</code>. This value must not equal
|
||||
* <code>startMonth</code>.
|
||||
* <p>If <code>useDaylight</code> is false, this value is ignored.
|
||||
* between {@code Calendar.JANUARY} and
|
||||
* {@code Calendar.UNDECIMBER}. This value must not equal
|
||||
* {@code startMonth}.
|
||||
* <p>If {@code useDaylight} is false, this value is ignored.
|
||||
* @serial
|
||||
*/
|
||||
private int endMonth;
|
||||
|
|
@ -1029,34 +1029,34 @@ public class SimpleTimeZone extends TimeZone {
|
|||
/**
|
||||
* This field has two possible interpretations:
|
||||
* <dl>
|
||||
* <dt><code>endMode == DOW_IN_MONTH</code></dt>
|
||||
* <dt>{@code endMode == DOW_IN_MONTH}</dt>
|
||||
* <dd>
|
||||
* <code>endDay</code> indicates the day of the month of
|
||||
* <code>endMonth</code> on which daylight
|
||||
* {@code endDay} indicates the day of the month of
|
||||
* {@code endMonth} on which daylight
|
||||
* saving time ends, from 1 to 28, 30, or 31, depending on the
|
||||
* <code>endMonth</code>.
|
||||
* {@code endMonth}.
|
||||
* </dd>
|
||||
* <dt><code>endMode != DOW_IN_MONTH</code></dt>
|
||||
* <dt>{@code endMode != DOW_IN_MONTH}</dt>
|
||||
* <dd>
|
||||
* <code>endDay</code> indicates which <code>endDayOfWeek</code> in th
|
||||
* month <code>endMonth</code> daylight
|
||||
* {@code endDay} indicates which {@code endDayOfWeek} in th
|
||||
* month {@code endMonth} daylight
|
||||
* saving time ends on. For example, a value of +1 and a
|
||||
* <code>endDayOfWeek</code> of <code>Calendar.SUNDAY</code> indicates the
|
||||
* first Sunday of <code>endMonth</code>. Likewise, +2 would indicate the
|
||||
* {@code endDayOfWeek} of {@code Calendar.SUNDAY} indicates the
|
||||
* first Sunday of {@code endMonth}. Likewise, +2 would indicate the
|
||||
* second Sunday, and -1 the last Sunday. A value of 0 is illegal.
|
||||
* </dd>
|
||||
* </dl>
|
||||
* <p>If <code>useDaylight</code> is false, this value is ignored.
|
||||
* <p>If {@code useDaylight} is false, this value is ignored.
|
||||
* @serial
|
||||
*/
|
||||
private int endDay;
|
||||
|
||||
/**
|
||||
* The day of the week on which daylight saving time ends. This value
|
||||
* must be between <code>Calendar.SUNDAY</code> and
|
||||
* <code>Calendar.SATURDAY</code> inclusive.
|
||||
* <p>If <code>useDaylight</code> is false or
|
||||
* <code>endMode == DAY_OF_MONTH</code>, this value is ignored.
|
||||
* must be between {@code Calendar.SUNDAY} and
|
||||
* {@code Calendar.SATURDAY} inclusive.
|
||||
* <p>If {@code useDaylight} is false or
|
||||
* {@code endMode == DAY_OF_MONTH}, this value is ignored.
|
||||
* @serial
|
||||
*/
|
||||
private int endDayOfWeek;
|
||||
|
|
@ -1064,15 +1064,15 @@ public class SimpleTimeZone extends TimeZone {
|
|||
/**
|
||||
* The time in milliseconds after midnight at which daylight saving
|
||||
* time ends. This value is expressed as wall time, standard time,
|
||||
* or UTC time, depending on the setting of <code>endTimeMode</code>.
|
||||
* <p>If <code>useDaylight</code> is false, this value is ignored.
|
||||
* or UTC time, depending on the setting of {@code endTimeMode}.
|
||||
* <p>If {@code useDaylight} is false, this value is ignored.
|
||||
* @serial
|
||||
*/
|
||||
private int endTime;
|
||||
|
||||
/**
|
||||
* The format of endTime, either <code>WALL_TIME</code>,
|
||||
* <code>STANDARD_TIME</code>, or <code>UTC_TIME</code>.
|
||||
* The format of endTime, either {@code WALL_TIME},
|
||||
* {@code STANDARD_TIME}, or {@code UTC_TIME}.
|
||||
* @serial
|
||||
* @since 1.3
|
||||
*/
|
||||
|
|
@ -1081,8 +1081,8 @@ public class SimpleTimeZone extends TimeZone {
|
|||
/**
|
||||
* The year in which daylight saving time is first observed. This is an {@link GregorianCalendar#AD AD}
|
||||
* value. If this value is less than 1 then daylight saving time is observed
|
||||
* for all <code>AD</code> years.
|
||||
* <p>If <code>useDaylight</code> is false, this value is ignored.
|
||||
* for all {@code AD} years.
|
||||
* <p>If {@code useDaylight} is false, this value is ignored.
|
||||
* @serial
|
||||
*/
|
||||
private int startYear;
|
||||
|
|
@ -1091,7 +1091,7 @@ public class SimpleTimeZone extends TimeZone {
|
|||
* The offset in milliseconds between this zone and GMT. Negative offsets
|
||||
* are to the west of Greenwich. To obtain local <em>standard</em> time,
|
||||
* add the offset to GMT time. To obtain local wall time it may also be
|
||||
* necessary to add <code>dstSavings</code>.
|
||||
* necessary to add {@code dstSavings}.
|
||||
* @serial
|
||||
*/
|
||||
private int rawOffset;
|
||||
|
|
@ -1122,26 +1122,26 @@ public class SimpleTimeZone extends TimeZone {
|
|||
* Variables specifying the mode of the start rule. Takes the following
|
||||
* values:
|
||||
* <dl>
|
||||
* <dt><code>DOM_MODE</code></dt>
|
||||
* <dt>{@code DOM_MODE}</dt>
|
||||
* <dd>
|
||||
* Exact day of week; e.g., March 1.
|
||||
* </dd>
|
||||
* <dt><code>DOW_IN_MONTH_MODE</code></dt>
|
||||
* <dt>{@code DOW_IN_MONTH_MODE}</dt>
|
||||
* <dd>
|
||||
* Day of week in month; e.g., last Sunday in March.
|
||||
* </dd>
|
||||
* <dt><code>DOW_GE_DOM_MODE</code></dt>
|
||||
* <dt>{@code DOW_GE_DOM_MODE}</dt>
|
||||
* <dd>
|
||||
* Day of week after day of month; e.g., Sunday on or after March 15.
|
||||
* </dd>
|
||||
* <dt><code>DOW_LE_DOM_MODE</code></dt>
|
||||
* <dt>{@code DOW_LE_DOM_MODE}</dt>
|
||||
* <dd>
|
||||
* Day of week before day of month; e.g., Sunday on or before March 15.
|
||||
* </dd>
|
||||
* </dl>
|
||||
* The setting of this field affects the interpretation of the
|
||||
* <code>startDay</code> field.
|
||||
* <p>If <code>useDaylight</code> is false, this value is ignored.
|
||||
* {@code startDay} field.
|
||||
* <p>If {@code useDaylight} is false, this value is ignored.
|
||||
* @serial
|
||||
* @since 1.1.4
|
||||
*/
|
||||
|
|
@ -1151,26 +1151,26 @@ public class SimpleTimeZone extends TimeZone {
|
|||
* Variables specifying the mode of the end rule. Takes the following
|
||||
* values:
|
||||
* <dl>
|
||||
* <dt><code>DOM_MODE</code></dt>
|
||||
* <dt>{@code DOM_MODE}</dt>
|
||||
* <dd>
|
||||
* Exact day of week; e.g., March 1.
|
||||
* </dd>
|
||||
* <dt><code>DOW_IN_MONTH_MODE</code></dt>
|
||||
* <dt>{@code DOW_IN_MONTH_MODE}</dt>
|
||||
* <dd>
|
||||
* Day of week in month; e.g., last Sunday in March.
|
||||
* </dd>
|
||||
* <dt><code>DOW_GE_DOM_MODE</code></dt>
|
||||
* <dt>{@code DOW_GE_DOM_MODE}</dt>
|
||||
* <dd>
|
||||
* Day of week after day of month; e.g., Sunday on or after March 15.
|
||||
* </dd>
|
||||
* <dt><code>DOW_LE_DOM_MODE</code></dt>
|
||||
* <dt>{@code DOW_LE_DOM_MODE}</dt>
|
||||
* <dd>
|
||||
* Day of week before day of month; e.g., Sunday on or before March 15.
|
||||
* </dd>
|
||||
* </dl>
|
||||
* The setting of this field affects the interpretation of the
|
||||
* <code>endDay</code> field.
|
||||
* <p>If <code>useDaylight</code> is false, this value is ignored.
|
||||
* {@code endDay} field.
|
||||
* <p>If {@code useDaylight} is false, this value is ignored.
|
||||
* @serial
|
||||
* @since 1.1.4
|
||||
*/
|
||||
|
|
@ -1180,7 +1180,7 @@ public class SimpleTimeZone extends TimeZone {
|
|||
* A positive value indicating the amount of time saved during DST in
|
||||
* milliseconds.
|
||||
* Typically one hour (3600000); sometimes 30 minutes (1800000).
|
||||
* <p>If <code>useDaylight</code> is false, this value is ignored.
|
||||
* <p>If {@code useDaylight} is false, this value is ignored.
|
||||
* @serial
|
||||
* @since 1.1.4
|
||||
*/
|
||||
|
|
@ -1260,17 +1260,17 @@ public class SimpleTimeZone extends TimeZone {
|
|||
* </dd>
|
||||
* <dt><b>1</b></dt>
|
||||
* <dd>
|
||||
* JDK 1.1.4 or later. Includes three new fields: <code>startMode</code>,
|
||||
* <code>endMode</code>, and <code>dstSavings</code>.
|
||||
* JDK 1.1.4 or later. Includes three new fields: {@code startMode},
|
||||
* {@code endMode}, and {@code dstSavings}.
|
||||
* </dd>
|
||||
* <dt><b>2</b></dt>
|
||||
* <dd>
|
||||
* JDK 1.3 or later. Includes two new fields: <code>startTimeMode</code>
|
||||
* and <code>endTimeMode</code>.
|
||||
* JDK 1.3 or later. Includes two new fields: {@code startTimeMode}
|
||||
* and {@code endTimeMode}.
|
||||
* </dd>
|
||||
* </dl>
|
||||
* When streaming out this class, the most recent format
|
||||
* and the highest allowable <code>serialVersionOnStream</code>
|
||||
* and the highest allowable {@code serialVersionOnStream}
|
||||
* is written.
|
||||
* @serial
|
||||
* @since 1.1.4
|
||||
|
|
@ -1625,16 +1625,16 @@ public class SimpleTimeZone extends TimeZone {
|
|||
* Save the state of this object to a stream (i.e., serialize it).
|
||||
*
|
||||
* @serialData We write out two formats, a JDK 1.1 compatible format, using
|
||||
* <code>DOW_IN_MONTH_MODE</code> rules, in the required section, followed
|
||||
* {@code DOW_IN_MONTH_MODE} rules, in the required section, followed
|
||||
* by the full rules, in packed format, in the optional section. The
|
||||
* optional section will be ignored by JDK 1.1 code upon stream in.
|
||||
* <p> Contents of the optional section: The length of a byte array is
|
||||
* emitted (int); this is 4 as of this release. The byte array of the given
|
||||
* length is emitted. The contents of the byte array are the true values of
|
||||
* the fields <code>startDay</code>, <code>startDayOfWeek</code>,
|
||||
* <code>endDay</code>, and <code>endDayOfWeek</code>. The values of these
|
||||
* the fields {@code startDay}, {@code startDayOfWeek},
|
||||
* {@code endDay}, and {@code endDayOfWeek}. The values of these
|
||||
* fields in the required section are approximate values suited to the rule
|
||||
* mode <code>DOW_IN_MONTH_MODE</code>, which is the only mode recognized by
|
||||
* mode {@code DOW_IN_MONTH_MODE}, which is the only mode recognized by
|
||||
* JDK 1.1.
|
||||
*/
|
||||
@java.io.Serial
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue