Класс SimpleTimeZone

public static final int WALL_TIME

Начиная с:

1.4

См. также:

• Значения константных полей

public static final int STANDARD_TIME

Начиная с:

1.4

См. также:

• Значения константных полей

public static final int UTC_TIME

Начиная с:

1.4

См. также:

• Значения константных полей

public SimpleTimeZone(int rawOffset, String ID)

Параметры:

rawOffset — смещение базового часового пояса относительно GMT в миллисекундах.

ID — название часового пояса, присваиваемое этому экземпляру.

public SimpleTimeZone(int rawOffset, String ID, int startMonth, int startDay, int startDayOfWeek, int startTime, int endMonth, int endDay, int endDayOfWeek, int endTime)

    SimpleTimeZone(rawOffset,
                   ID,
                   startMonth,
                   startDay,
                   startDayOfWeek,
                   startTime,
                   SimpleTimeZone.WALL_TIME,
                   endMonth,
                   endDay,
                   endDayOfWeek,
                   endTime,
                   SimpleTimeZone.WALL_TIME,
                   3600000)

Параметры:

rawOffset — заданное смещение базового часового пояса относительно GMT.

ID — идентификатор часового пояса, присваиваемый этому объекту.

startMonth — месяц начала перехода на летнее время. Месяц — это значение поля MONTH (нумерация начинается с 0, например, 0 — январь).

startDay — день месяца, в который начинается переход на летнее время. Особые случаи этого параметра описаны в описании класса.

startDayOfWeek — день недели начала перехода на летнее время. Особые случаи этого параметра описаны в описании класса.

startTime — время начала перехода на летнее время по местным настенным часам (в миллисекундах от начала суток); в данном случае это местное стандартное время.

endMonth — месяц окончания перехода на летнее время. Месяц — это значение поля MONTH (нумерация начинается с 0, например, 9 — октябрь).

endDay — день месяца, в который заканчивается переход на летнее время. Особые случаи этого параметра описаны в описании класса.

endDayOfWeek — день недели окончания перехода на летнее время. Особые случаи этого параметра описаны в описании класса.

endTime — время окончания перехода на летнее время по местным настенным часам (в миллисекундах от начала суток); в данном случае это местное летнее время.

Вызывает исключение:

IllegalArgumentException — если параметры месяца, дня, дня недели или времени выходят за допустимые пределы для правила начала или окончания

public SimpleTimeZone(int rawOffset, String ID, int startMonth, int startDay, int startDayOfWeek, int startTime, int endMonth, int endDay, int endDayOfWeek, int endTime, int dstSavings)

    SimpleTimeZone(rawOffset,
                   ID,
                   startMonth,
                   startDay,
                   startDayOfWeek,
                   startTime,
                   SimpleTimeZone.WALL_TIME,
                   endMonth,
                   endDay,
                   endDayOfWeek,
                   endTime,
                   SimpleTimeZone.WALL_TIME,
                   dstSavings)

Параметры:

rawOffset — заданное смещение базового часового пояса относительно GMT.

ID — идентификатор часового пояса, присваиваемый этому объекту.

startMonth — месяц начала перехода на летнее время. Месяц — это значение поля MONTH (нумерация начинается с 0, например, 0 — январь).

startDay — день месяца, в который начинается переход на летнее время. Особые случаи этого параметра описаны в описании класса.

startDayOfWeek — день недели начала перехода на летнее время. Особые случаи этого параметра описаны в описании класса.

startTime — время начала перехода на летнее время по местным настенным часам; в данном случае это местное стандартное время.

endMonth — месяц окончания перехода на летнее время. Месяц — это значение поля MONTH (нумерация начинается с 0, например, 9 — октябрь).

endDay — день месяца, в который заканчивается переход на летнее время. Особые случаи этого параметра описаны в описании класса.

endDayOfWeek — день недели окончания перехода на летнее время. Особые случаи этого параметра описаны в описании класса.

endTime — время окончания перехода на летнее время по местным настенным часам; в данном случае это местное летнее время.

dstSavings — величина сдвига во время перехода на летнее время в миллисекундах.

Вызывает исключение:

IllegalArgumentException — если параметры месяца, дня, дня недели или времени выходят за допустимые пределы для правила начала или окончания

Начиная с:

1.2

public SimpleTimeZone(int rawOffset, String ID, int startMonth, int startDay, int startDayOfWeek, int startTime, int startTimeMode, int endMonth, int endDay, int endDayOfWeek, int endTime, int endTimeMode, int dstSavings)

Параметры:

rawOffset — заданное смещение базового часового пояса относительно GMT.

ID — идентификатор часового пояса, присваиваемый этому объекту.

startMonth — месяц начала перехода на летнее время. Месяц — это значение поля MONTH (нумерация начинается с 0, например, 0 — январь).

startDay — день месяца, в который начинается переход на летнее время. Особые случаи этого параметра описаны в описании класса.

startDayOfWeek — день недели начала перехода на летнее время. Особые случаи этого параметра описаны в описании класса.

startTime — время начала перехода на летнее время в режиме времени, заданном параметром startTimeMode.

startTimeMode — режим времени начала, заданный параметром startTime.

endMonth — месяц окончания перехода на летнее время. Месяц — это значение поля MONTH (нумерация начинается с 0, например, 9 — октябрь).

endDay — день месяца, в который заканчивается переход на летнее время. Особые случаи этого параметра описаны в описании класса.

endDayOfWeek — день недели окончания перехода на летнее время. Особые случаи этого параметра описаны в описании класса.

endTime — время окончания перехода на летнее время в режиме времени, заданном параметром endTimeMode.

endTimeMode — режим времени окончания, заданный параметром endTime

dstSavings — величина сдвига во время перехода на летнее время в миллисекундах.

Вызывает исключение:

IllegalArgumentException — если параметры месяца, дня, дня недели, режима времени или времени выходят за допустимые пределы для правила начала или окончания либо если значение режима времени недопустимо.

Начиная с:

1.4

См. также:

• WALL_TIME
• STANDARD_TIME
• UTC_TIME

public void setStartYear(int year)

Параметры:

year — год начала перехода на летнее время.

public void setStartRule(int startMonth, int startDay, int startDayOfWeek, int startTime)

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

Параметры:

startMonth — месяц начала перехода на летнее время. Месяц — это значение поля MONTH (нумерация начинается с 0, например, 0 — январь).

startDay — день месяца, в который начинается переход на летнее время. Особые случаи этого параметра описаны в описании класса.

startDayOfWeek — день недели начала перехода на летнее время. Особые случаи этого параметра описаны в описании класса.

startTime — время начала перехода на летнее время по местным настенным часам; в данном случае это местное стандартное время.

Вызывает исключение:

IllegalArgumentException — если параметры startMonth, startDay, startDayOfWeek или startTime выходят за допустимые пределы

public void setStartRule(int startMonth, int startDay, int startTime)

setStartRule(startMonth, startDay, 0, startTime)

Параметры:

startMonth — месяц начала перехода на летнее время. Месяц — это значение поля MONTH (нумерация начинается с 0, например, 0 — январь).

startDay — день месяца, в который начинается переход на летнее время.

startTime — время начала перехода на летнее время по местным настенным часам; в данном случае это местное стандартное время. Особые случаи этого параметра описаны в описании класса.

Вызывает исключение:

IllegalArgumentException — если параметры startMonth, startDayOfMonth или startTime выходят за допустимые пределы

Начиная с:

1.2

public void setStartRule(int startMonth, int startDay, int startDayOfWeek, int startTime, boolean after)

Параметры:

startMonth — месяц начала перехода на летнее время. Месяц — это значение поля MONTH (нумерация начинается с 0, например, 0 — январь).

startDay — день месяца, в который начинается переход на летнее время.

startDayOfWeek — день недели начала перехода на летнее время.

startTime — время начала перехода на летнее время по местным настенным часам; в данном случае это местное стандартное время.

after — если значение true, правило выбирает первый dayOfWeek в указанную дату или после dayOfMonth. Если значение false, правило выбирает последний dayOfWeek в указанную дату или до dayOfMonth.

Вызывает исключение:

IllegalArgumentException — если параметры startMonth, startDay, startDayOfWeek или startTime выходят за допустимые пределы

Начиная с:

1.2

public void setEndRule(int endMonth, int endDay, int endDayOfWeek, int endTime)

Параметры:

endMonth — месяц окончания перехода на летнее время. Месяц — это значение поля MONTH (нумерация начинается с 0, например, 9 — октябрь).

endDay — день месяца, в который заканчивается переход на летнее время. Особые случаи этого параметра описаны в описании класса.

endDayOfWeek — день недели окончания перехода на летнее время. Особые случаи этого параметра описаны в описании класса.

endTime — время окончания перехода на летнее время по местным настенным часам (в миллисекундах от начала суток); в данном случае это местное летнее время.

Вызывает исключение:

IllegalArgumentException — если параметры endMonth, endDay, endDayOfWeek или endTime выходят за допустимые пределы

public void setEndRule(int endMonth, int endDay, int endTime)

setEndRule(endMonth, endDay, 0, endTime)

Параметры:

endMonth — месяц окончания перехода на летнее время. Месяц — это значение поля MONTH (нумерация начинается с 0, например, 9 — октябрь).

endDay — день месяца, в который заканчивается переход на летнее время.

endTime — время окончания перехода на летнее время по местным настенным часам (в миллисекундах от начала суток); в данном случае это местное летнее время.

Вызывает исключение:

IllegalArgumentException — если параметры endMonth, endDay или endTime выходят за допустимые пределы

Начиная с:

1.2

public void setEndRule(int endMonth, int endDay, int endDayOfWeek, int endTime, boolean after)

Параметры:

endMonth — месяц окончания перехода на летнее время. Месяц — это значение поля MONTH (нумерация начинается с 0, например, 9 — октябрь).

endDay — день месяца, в который заканчивается переход на летнее время.

endDayOfWeek — день недели окончания перехода на летнее время.

endTime — время окончания перехода на летнее время по местным настенным часам (в миллисекундах от начала суток); в данном случае это местное летнее время.

after — если значение true, правило выбирает первый endDayOfWeek в указанную дату или после endDay. Если значение false, правило выбирает последний endDayOfWeek в указанную дату или до endDay месяца.

Вызывает исключение:

IllegalArgumentException — если параметры endMonth, endDay, endDayOfWeek или endTime выходят за допустимые пределы

Начиная с:

1.2

public int getOffset(long date)

Переопределяет:

getOffset в классе TimeZone

Параметры:

date — момент времени, для которого определяется смещение часового пояса

Возвращает:

величину в миллисекундах, которую нужно прибавить к UTC, чтобы получить местное время.

Начиная с:

1.4

См. также:

• Calendar.ZONE_OFFSET
• Calendar.DST_OFFSET

public int getOffset(int era, int year, int month, int day, int dayOfWeek, int millis)

Определено в:

getOffset в классе TimeZone

Параметры:

era — эра заданной даты.

year — год заданной даты.

month — месяц заданной даты. Нумерация месяцев начинается с 0, например, 0 — январь.

day — день месяца заданной даты.

dayOfWeek — день недели заданной даты.

millis — миллисекунды от начала суток по местному стандартному времени.

Возвращает:

Количество миллисекунд, которое нужно прибавить к UTC, чтобы получить местное время.

Вызывает исключение:

IllegalArgumentException — если параметры era, month, day, dayOfWeek или millis выходят за допустимые пределы

См. также:

• Calendar.ZONE_OFFSET
• Calendar.DST_OFFSET

public int getRawOffset()

Определено в:

getRawOffset в классе TimeZone

Возвращает:

значение смещения относительно GMT в миллисекундах

См. также:

• setRawOffset(int)

public void setRawOffset(int offsetMillis)

Определено в:

setRawOffset в классе TimeZone

Параметры:

offsetMillis — заданное базовое смещение часового пояса относительно GMT.

См. также:

• getRawOffset()

public void setDSTSavings(int millisSavedDuringDST)

Параметры:

millisSavedDuringDST — количество миллисекунд, на которое время опережает стандартное, когда действуют правила перехода на летнее время. Положительное число, обычно один час (3600000).

Начиная с:

1.2

См. также:

• getDSTSavings()

public int getDSTSavings()

Переопределяет:

getDSTSavings в классе TimeZone

Возвращает:

количество миллисекунд, на которое время опережает стандартное, когда действуют правила перехода на летнее время, или 0 (ноль), если в этом часовом поясе не используется летнее время.

Начиная с:

1.2

См. также:

• setDSTSavings(int)

public boolean useDaylightTime()

Определено в:

useDaylightTime в классе TimeZone

Возвращает:

true, если в этом часовом поясе используется летнее время; в противном случае — false.

См. также:

• TimeZone.inDaylightTime(Date)
• Calendar.DST_OFFSET

public boolean observesDaylightTime()

Переопределяет:

observesDaylightTime в классе TimeZone

Возвращает:

true, если в этом SimpleTimeZone соблюдается переход на летнее время; в противном случае — false.

Начиная с:

1.7

См. также:

• TimeZone.useDaylightTime()
• TimeZone.inDaylightTime(Date)
• Calendar.DST_OFFSET

public boolean inDaylightTime(Date date)

Определено в:

inDaylightTime в классе TimeZone

Требования к реализации:

Реализация по умолчанию выбрасывает NullPointerException, если date имеет значение null

Параметры:

date — заданная дата.

Возвращает:

true, если на заданную дату действует летнее время; в противном случае — false.

Вызывает исключение:

NullPointerException — этот метод может выбросить NullPointerException, если date имеет значение null

public Object clone()

Переопределяет:

clone в классе TimeZone

Возвращает:

копию этого экземпляра.

См. также:

• Cloneable

public int hashCode()

Переопределяет:

hashCode в классе Object

Возвращает:

хеш-код этого объекта

См. также:

• Object.equals(java.lang.Object)
• System.identityHashCode(Object)

public boolean equals(Object obj)

Переопределяет:

equals в классе Object

Параметры:

obj — объект SimpleTimeZone, с которым выполняется сравнение.

Возвращает:

True, если заданный obj совпадает с этим объектом SimpleTimeZone; в противном случае — false.

См. также:

• Object.hashCode()
• HashMap

public boolean hasSameRules(TimeZone other)

Переопределяет:

hasSameRules в классе TimeZone

Параметры:

other — объект TimeZone, с которым выполняется сравнение

Возвращает:

true, если заданный часовой пояс является SimpleTimeZone и имеет те же правила и смещение, что и этот

Начиная с:

1.2

public String toString()

Переопределяет:

toString в классе Object

Возвращает:

строковое представление этого часового пояса.