java.util.SimpleTimeZone Maven / Gradle / Ivy

If 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 Calendar.SUNDAY and * Calendar.SATURDAY inclusive. *

If useDaylight is false or * endMode == DAY_OF_MONTH, this value is ignored. * @serial */ private int endDayOfWeek; /** * 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 endTimeMode. *

If useDaylight is false, this value is ignored. * @serial */ private int endTime; /** * The format of endTime, either WALL_TIME, STANDARD_TIME, or UTC_TIME. * @serial * @since 1.3 */ private int endTimeMode; /** * The year in which daylight saving time is first observed. This is an AD * value. If this value is less than 1 then daylight saving time is observed * for all AD years. *

If useDaylight is false, this value is ignored. * @serial */ private int startYear; /** * The offset in milliseconds between this zone and GMT. Negative offsets * are to the west of Greenwich. To obtain local standard time, * add the offset to GMT time. To obtain local wall time it may also be * necessary to add dstSavings. * @serial */ private int rawOffset; /** * A boolean value which is true if and only if this zone uses daylight * saving time. If this value is false, several other fields are ignored. * @serial */ private boolean useDaylight; /** * This field was serialized in JDK 1.1, so we have to keep it that way * to maintain serialization compatibility. However, there's no need to * recreate the array each time we create a new time zone. * @serial An array of bytes containing the values {31, 28, 31, 30, 31, 30, * 31, 31, 30, 31, 30, 31}. This is ignored as of the Java 2 platform v1.2, however, it must * be streamed out for compatibility with JDK 1.1. */ private final byte[] monthLength = null; /** * Variables specifying the mode of the start rule. Takes the following * values: *

*

DOM_MODE

*

* Exact day of week; e.g., March 1. *

*

DOW_IN_MONTH_MODE

*

* Day of week in month; e.g., last Sunday in March. *

*

DOW_GE_DOM_MODE

*

* Day of week after day of month; e.g., Sunday on or after March 15. *

*

DOW_LE_DOM_MODE

*

* Day of week before day of month; e.g., Sunday on or before March 15. *

*

If useDaylight is false, this value is ignored. * @serial * @since 1.1.4 */ private int startMode; /** * Variables specifying the mode of the end rule. Takes the following * values: *

*

DOM_MODE

*

* Exact day of week; e.g., March 1. *

*

DOW_IN_MONTH_MODE

*

* Day of week in month; e.g., last Sunday in March. *

*

DOW_GE_DOM_MODE

*

* Day of week after day of month; e.g., Sunday on or after March 15. *

*

DOW_LE_DOM_MODE

*

* Day of week before day of month; e.g., Sunday on or before March 15. *

*

If useDaylight is false, this value is ignored. * @serial * @since 1.1.4 */ private int endMode; /** * A positive value indicating the amount of time saved during DST in * milliseconds. * Typically one hour (3600000); sometimes 30 minutes (1800000). *

If useDaylight is false, this value is ignored. * @serial * @since 1.1.4 */ private int dstSavings; /** * The version of the serialized data on the stream. Possible values: *

*

0 or not present on stream

*

* JDK 1.1.3 or earlier. *

*

1

*

* JDK 1.1.4 or later. Includes three new fields: startMode, * endMode, and dstSavings. *

*

2

*

* JDK 1.3 or later. Includes two new fields: startTimeMode * and endTimeMode. *

*

     *     SimpleTimeZone(rawOffset,
     *                    ID,
     *                    startMonth,
     *                    startDay,
     *                    startDayOfWeek,
     *                    startTime,
     *                    SimpleTimeZone.{@link #WALL_TIME},
     *                    endMonth,
     *                    endDay,
     *                    endDayOfWeek,
     *                    endTime,
     *                    SimpleTimeZone.{@link #WALL_TIME},
     *                    3600000)
     * 

     *     SimpleTimeZone(rawOffset,
     *                    ID,
     *                    startMonth,
     *                    startDay,
     *                    startDayOfWeek,
     *                    startTime,
     *                    SimpleTimeZone.{@link #WALL_TIME},
     *                    endMonth,
     *                    endDay,
     *                    endDayOfWeek,
     *                    endTime,
     *                    SimpleTimeZone.{@link #WALL_TIME},
     *                    dstSavings)
     * 

setStartRule(Calendar.APRIL, 1, Calendar.SUNDAY, 2*60*60*1000);

setStartRule(startMonth, startDay, 0, startTime)

setEndRule(endMonth, endDay, 0, endTime)

Note: In general, clients should use * Calendar.get(ZONE_OFFSET) + Calendar.get(DST_OFFSET) * instead of calling this method. * * @param era The era of the given date. * @param year The year in the given date. * @param month The month in the given date. Month is 0-based. e.g., * 0 for January. * @param day The day-in-month of the given date. * @param dayOfWeek The day-of-week of the given date. * @param millis The milliseconds in day in standard local time. * @return The milliseconds to add to UTC to get local time. * @exception IllegalArgumentException the era, * month, day, dayOfWeek, * or millis parameters are out of range */ public int getOffset(int era, int year, int month, int day, int dayOfWeek, int millis) { return 0; } /** * Gets the GMT offset for this time zone. * @return the GMT offset value in milliseconds * @see #setRawOffset */ public int getRawOffset() { return 0; } /** * Sets the base time zone offset to GMT. * This is the offset to add to UTC to get local time. * @see #getRawOffset */ public void setRawOffset(int offsetMillis) { } /** * Sets the amount of time in milliseconds that the clock is advanced * during daylight saving time. * @param millisSavedDuringDST the number of milliseconds the time is * advanced with respect to standard time when the daylight saving time rules * are in effect. A positive number, typically one hour (3600000). * @see #getDSTSavings * @since 1.2 */ public void setDSTSavings(int millisSavedDuringDST) { } /** * Returns the amount of time in milliseconds that the clock is * advanced during daylight saving time. * * @return the number of milliseconds the time is advanced with * respect to standard time when the daylight saving rules are in * effect, or 0 (zero) if this time zone doesn't observe daylight * saving time. * * @see #setDSTSavings * @since 1.2 */ public int getDSTSavings() { return 0; } /** * Queries if this time zone uses daylight saving time. * @return true if this time zone uses daylight saving time; * false otherwise. */ public boolean useDaylightTime() { return false; } /** * Queries if the given date is in daylight saving time. * @return true if daylight saving time is in effective at the * given date; false otherwise. */ public boolean inDaylightTime(Date date) { return false; } /** * Returns a clone of this SimpleTimeZone instance. * @return a clone of this instance. */ public Object clone() { return null; } /** * Generates the hash code for the SimpleDateFormat object. * @return the hash code for this object */ public synchronized int hashCode() { return 0; } /** * Compares the equality of two SimpleTimeZone objects. * * @param obj The SimpleTimeZone object to be compared with. * @return True if the given obj is the same as this * SimpleTimeZone object; false otherwise. */ public boolean equals(Object obj) { return false; } /** * Returns true if this zone has the same rules and offset as another zone. * @param other the TimeZone object to be compared with * @return true if the given zone is a SimpleTimeZone and has the * same rules and offset as this one * @since 1.2 */ public boolean hasSameRules(TimeZone other) { return false; } /** * Returns a string representation of this time zone. * @return a string representation of this time zone. */ public String toString() { return null; } /** * Reconstitute this object from a stream (i.e., deserialize it). * * We handle both JDK 1.1 * binary formats and full formats with a packed byte array. */ private void readObject(ObjectInputStream stream) throws IOException, ClassNotFoundException { } /** * 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 * 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. *