Spec-Zone .ru
спецификации, руководства, описания, API
|
public class SimpleTimeZone extends TimeZone
SimpleTimeZone
конкретный подкласс TimeZone
это представляет часовой пояс для использования с Григорианским календарем. class содержит смещение от GMT, названного необработанным смещением, и запустите и закончите правила для расписания летнего времени. Так как это только содержит единственные значения для каждого, это не может обработать исторические изменения в смещении от GMT и расписания перехода на летнее время, за исключением того, что setStartYear
метод может определить год, когда расписание летнего времени запускается в действительности. Создать a SimpleTimeZone
с расписанием летнего времени расписание может быть описано с рядом правил, запускать-правилом и правилом конца. День, когда летнее время запускается или концы, определяется комбинацией месяца, дня-месячного, и дневных-недельного значений. Значение месяца представляется Календарем MONTH
значение поля, такой как Calendar.MARCH
. Дневное-недельного значение представляется Календарем DAY_OF_WEEK
значение, такой как SUNDAY
. Значения комбинаций значения следующие.
MARCH
, день-месячного к 1, и день-недельного к 0.DAY_OF_WEEK
значение поля. Например, чтобы определить второе воскресенье апреля, установите месяц в APRIL
, день-месячного к 8, и день-недельного к -
SUNDAY
.MARCH
, день-месячного-21, и день-недельного -
WEDNESDAY
. DAY_OF_WEEK
значение и день-месячного к-1. Например, чтобы определить в прошлое воскресенье октября, установите месяц в OCTOBER
, день-недельного к SUNDAY
и день-месячного к-1. WALL_TIME
, STANDARD_TIME
и UTC_TIME
. Например, если концы летнего времени в 2:00 в стене показывают время, она может быть определена 7200000 миллисекунд в WALL_TIME
режим. В этом случае, стена показывают время для средств правила конца та же самая вещь как летнее время. Следующее является примерами параметров для того, чтобы создать объекты часового пояса.
// Base GMT offset: -8:00
// DST starts: at 2:00am in standard time
// on the first Sunday in April
// DST ends: at 2:00am in daylight time
// on the last Sunday in October
// Save: 1 hour
SimpleTimeZone(-28800000,
"America/Los_Angeles",
Calendar.APRIL, 1, -Calendar.SUNDAY,
7200000,
Calendar.OCTOBER, -1, Calendar.SUNDAY,
7200000,
3600000)
// Base GMT offset: +1:00
// DST starts: at 1:00am in UTC time
// on the last Sunday in March
// DST ends: at 1:00am in UTC time
// on the last Sunday in October
// Save: 1 hour
SimpleTimeZone(3600000,
"Europe/Paris",
Calendar.MARCH, -1, Calendar.SUNDAY,
3600000, SimpleTimeZone.UTC_TIME,
Calendar.OCTOBER, -1, Calendar.SUNDAY,
3600000, SimpleTimeZone.UTC_TIME,
3600000)
Эти правила параметра также применимы к методам правила набора, такой как setStartRule
.Calendar
, GregorianCalendar
, TimeZone
, Сериализированная ФормаМодификатор и Тип | Поле и Описание |
---|---|
static int |
STANDARD_TIME
Постоянный для режима запуска или время окончания, определенное как стандартное время.
|
static int |
UTC_TIME
Постоянный для режима запуска или время окончания, определенное как UTC.
|
static int |
WALL_TIME
Постоянный для режима запуска или время окончания, определенное как стена, показывают время.
|
Конструктор и Описание |
---|
SimpleTimeZone(int rawOffset, String ID)
Создает SimpleTimeZone с данным смещением зоны норматива времени от GMT и ID часового пояса без расписания летнего времени.
|
SimpleTimeZone(int rawOffset, String ID, int startMonth, int startDay, int startDayOfWeek, int startTime, int endMonth, int endDay, int endDayOfWeek, int endTime)
Создает SimpleTimeZone с данным смещением зоны норматива времени от GMT, ID часового пояса, и управляет для запуска и окончания летнего времени.
|
SimpleTimeZone(int rawOffset, String ID, int startMonth, int startDay, int startDayOfWeek, int startTime, int endMonth, int endDay, int endDayOfWeek, int endTime, int dstSavings)
Создает SimpleTimeZone с данным смещением зоны норматива времени от GMT, ID часового пояса, и управляет для запуска и окончания летнего времени.
|
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)
Создает SimpleTimeZone с данным смещением зоны норматива времени от GMT, ID часового пояса, и управляет для запуска и окончания летнего времени.
|
Модификатор и Тип | Метод и Описание |
---|---|
Объект |
clone()
Возвращает клона этого
SimpleTimeZone экземпляр. |
boolean |
equals(Object obj)
Сравнивает равенство два
SimpleTimeZone объекты. |
int |
getDSTSavings()
Возвращает количество времени в миллисекундах, что часы совершенствуются в течение летнего времени.
|
int |
getOffset(int era, int year, int month, int day, int dayOfWeek, int millis)
Возвращает различие в миллисекундах между местным временем и UTC, принимая во внимание и необработанное смещение и эффект перехода на летнее время, для указанной даты и время.
|
int |
getOffset(long date)
Возвращает смещение этого часового пояса от UTC в данное время.
|
int |
getRawOffset()
Смещали GMT для этого часового пояса.
|
int |
hashCode()
Генерирует хэш-код для объекта SimpleDateFormat.
|
boolean |
hasSameRules(TimeZone other)
Возвраты
true если у этой зоны есть те же самые правила и смещение как другая зона. |
boolean |
inDaylightTime(Date date)
Запросы, если данная дата находится в летнее время.
|
boolean |
observesDaylightTime()
Возвраты
true если это SimpleTimeZone наблюдает Летнее время. |
void |
setDSTSavings(int millisSavedDuringDST)
Устанавливает количество времени в миллисекундах, что часы совершенствуются в течение летнего времени.
|
void |
setEndRule(int endMonth, int endDay, int endTime)
Устанавливает правило конца летнего времени к фиксированной дате в течение месяца.
|
void |
setEndRule(int endMonth, int endDay, int endDayOfWeek, int endTime)
Устанавливает правило конца летнего времени.
|
void |
setEndRule(int endMonth, int endDay, int endDayOfWeek, int endTime, boolean after)
Устанавливает правило конца летнего времени к буднему дню прежде или после данной даты в течение месяца, например, первого понедельника на или после 8-ого.
|
void |
setRawOffset(int offsetMillis)
Устанавливает смещение зоны норматива времени в GMT.
|
void |
setStartRule(int startMonth, int startDay, int startTime)
Наборы летнее время запускают правило к фиксированной дате в течение месяца.
|
void |
setStartRule(int startMonth, int startDay, int startDayOfWeek, int startTime)
Наборы летнее время запускают правило.
|
void |
setStartRule(int startMonth, int startDay, int startDayOfWeek, int startTime, boolean after)
Наборы летнее время запускают правило к буднему дню прежде или после данной даты в течение месяца, например, первого понедельника на или после 8-ого.
|
void |
setStartYear(int year)
Устанавливает начальный год летнего времени.
|
Строка |
toString()
Возвращает строковое представление этого часового пояса.
|
boolean |
useDaylightTime()
Запросы, если этот часовой пояс использует летнее время.
|
getAvailableIDs, getAvailableIDs, getDefault, getDisplayName, getDisplayName, getDisplayName, getDisplayName, getID, getTimeZone, getTimeZone, setDefault, setID, toZoneId
public static final int WALL_TIME
public static final int STANDARD_TIME
public static final int UTC_TIME
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)
startTime
и endTime
определяются, чтобы быть представленными в стене, показывают время. Количество перехода на летнее время, как предполагается, является 3600000 миллисекунд (то есть, один час). Этот конструктор эквивалентен:
SimpleTimeZone(rawOffset,
ID,
startMonth,
startDay,
startDayOfWeek,
startTime,
SimpleTimeZone.WALL_TIME
,
endMonth,
endDay,
endDayOfWeek,
endTime,
SimpleTimeZone.WALL_TIME
,
3600000)
rawOffset
- Данное смещение зоны норматива времени от GMT.ID
- ID часового пояса, который дается этому объекту.startMonth
- Начальный месяц летнего времени. Месяц является a MONTH
значение поля (на основе 0. например, 0 на январь).startDay
- День месяца, на котором запускается летнее время. См. описание class для особых случаев этого параметра.startDayOfWeek
- Начальный день-недельного летнего времени. См. описание class для особых случаев этого параметра.startTime
- Время начала летнего времени в локальной стене показывает время (в миллисекундах в течение дня), который является локальным стандартным временем в этом случае.endMonth
- Летнее время конечный месяц. Месяц является a MONTH
значение поля (на основе 0. например, 9 на октябрь).endDay
- День месяца, на котором заканчивается летнее время. См. описание class для особых случаев этого параметра.endDayOfWeek
- Летнее время конечный день-недельного. См. описание class для особых случаев этого параметра.endTime
- Время окончания перехода на летнее время в локальной стене показывает время, (в миллисекундах в течение дня), который является локальным летним временем в этом случае.IllegalArgumentException
- если месяц, день, dayOfWeek, или параметры времени испытывают недостаток диапазона для правила конца или запускаpublic SimpleTimeZone(int rawOffset, String ID, int startMonth, int startDay, int startDayOfWeek, int startTime, int endMonth, int endDay, int endDayOfWeek, int endTime, int dstSavings)
startTime
и endTime
как предполагается, представляются в стене, показывают время. Этот конструктор эквивалентен:
SimpleTimeZone(rawOffset,
ID,
startMonth,
startDay,
startDayOfWeek,
startTime,
SimpleTimeZone.WALL_TIME
,
endMonth,
endDay,
endDayOfWeek,
endTime,
SimpleTimeZone.WALL_TIME
,
dstSavings)
rawOffset
- Данное смещение зоны норматива времени от GMT.ID
- ID часового пояса, который дается этому объекту.startMonth
- Начальный месяц летнего времени. Месяц является a MONTH
значение поля (на основе 0. например, 0 на январь).startDay
- День месяца, на котором запускается летнее время. См. описание class для особых случаев этого параметра.startDayOfWeek
- Начальный день-недельного летнего времени. См. описание class для особых случаев этого параметра.startTime
- Время начала летнего времени в локальной стене показывает время, которое является локальным стандартным временем в этом случае.endMonth
- Летнее время конечный месяц. Месяц является a MONTH
значение поля (на основе 0. например, 9 на октябрь).endDay
- День месяца, на котором заканчивается летнее время. См. описание class для особых случаев этого параметра.endDayOfWeek
- Летнее время конечный день-недельного. См. описание class для особых случаев этого параметра.endTime
- Время окончания перехода на летнее время в локальной стене показывает время, которое является локальным летним временем в этом случае.dstSavings
- В течение летнего времени сохраняется количество времени в миллисекундах.IllegalArgumentException
- если месяц, день, dayOfWeek, или параметры времени испытывают недостаток диапазона для правила конца или запуска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)
startTime
и endTime
. Режим определяет также wall time
или standard time
или UTC time
.rawOffset
- Данное смещение зоны норматива времени от GMT.ID
- ID часового пояса, который дается этому объекту.startMonth
- Начальный месяц летнего времени. Месяц является a MONTH
значение поля (на основе 0. например, 0 на январь).startDay
- День месяца, на котором запускается летнее время. См. описание class для особых случаев этого параметра.startDayOfWeek
- Начальный день-недельного летнего времени. См. описание class для особых случаев этого параметра.startTime
- Время начала летнего времени в режиме времени, определенном startTimeMode
.startTimeMode
- Режим времени запуска определяется startTime.endMonth
- Летнее время конечный месяц. Месяц является a MONTH
значение поля (на основе 0. например, 9 на октябрь).endDay
- День месяца, на котором заканчивается летнее время. См. описание class для особых случаев этого параметра.endDayOfWeek
- Летнее время конечный день-недельного. См. описание class для особых случаев этого параметра.endTime
- Время окончания перехода на летнее время в режиме времени времени, определенном endTimeMode
.endTimeMode
- Режим времени окончания определяется endTimedstSavings
- В течение летнего времени сохраняется количество времени в миллисекундах.IllegalArgumentException
- если месяц, день, dayOfWeek, время больше, или параметры времени испытывают недостаток диапазона для запуска или правила конца, или если значение режима времени недопустимо.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
- Начальный месяц летнего времени. Месяц является a MONTH
значение поля (на основе 0. например, 0 на январь).startDay
- День месяца, на котором запускается летнее время. См. описание class для особых случаев этого параметра.startDayOfWeek
- Начальный день-недельного летнего времени. См. описание class для особых случаев этого параметра.startTime
- Время начала летнего времени в локальной стене показывает время, которое является локальным стандартным временем в этом случае.IllegalArgumentException
- если startMonth
, startDay
, startDayOfWeek
, или startTime
параметры испытывают недостаток диапазонаpublic void setStartRule(int startMonth, int startDay, int startTime)
setStartRule(startMonth, startDay, 0, startTime)
startMonth
- Начальный месяц летнего времени. Месяц является a MONTH
значение поля (на основе 0. например, 0 на январь).startDay
- День месяца, на котором запускается летнее время.startTime
- Время начала летнего времени в локальной стене показывает время, которое является локальным стандартным временем в этом случае. См. описание class для особых случаев этого параметра.IllegalArgumentException
- если startMonth
, startDayOfMonth
, или startTime
параметры испытывают недостаток диапазонаpublic void setStartRule(int startMonth, int startDay, int startDayOfWeek, int startTime, boolean after)
startMonth
- Начальный месяц летнего времени. Месяц является a MONTH
значение поля (на основе 0. например, 0 на январь).startDay
- День месяца, на котором запускается летнее время.startDayOfWeek
- Начальный день-недельного летнего времени.startTime
- Время начала летнего времени в локальной стене показывает время, которое является локальным стандартным временем в этом случае.after
- Если это правда, это правило выбирает первое dayOfWeek
на или после dayOfMonth
. Если ложь, это правило выбирает последнее dayOfWeek
на или прежде
dayOfMonth
.IllegalArgumentException
- если startMonth
, startDay
, startDayOfWeek
, или startTime
параметры испытывают недостаток диапазонаpublic void setEndRule(int endMonth, int endDay, int endDayOfWeek, int endTime)
setEndRule(Calendar.OCTOBER, -1, Calendar.SUNDAY, 2*60*60*1000);
endMonth
- Летнее время конечный месяц. Месяц является a MONTH
значение поля (на основе 0. например, 9 на октябрь).endDay
- День месяца, на котором заканчивается летнее время. См. описание class для особых случаев этого параметра.endDayOfWeek
- Летнее время конечный день-недельного. См. описание class для особых случаев этого параметра.endTime
- Время окончания перехода на летнее время в локальной стене показывает время, (в миллисекундах в течение дня), который является локальным летним временем в этом случае.IllegalArgumentException
- если endMonth
, endDay
, endDayOfWeek
, или endTime
параметры испытывают недостаток диапазонаpublic void setEndRule(int endMonth, int endDay, int endTime)
setEndRule(endMonth, endDay, 0, endTime)
endMonth
- Летнее время конечный месяц. Месяц является a MONTH
значение поля (на основе 0. например, 9 на октябрь).endDay
- День месяца, на котором заканчивается летнее время.endTime
- Время окончания перехода на летнее время в локальной стене показывает время, (в миллисекундах в течение дня), который является локальным летним временем в этом случае.IllegalArgumentException
- endMonth
, endDay
, или endTime
параметры испытывают недостаток диапазонаpublic void setEndRule(int endMonth, int endDay, int endDayOfWeek, int endTime, boolean after)
endMonth
- Летнее время конечный месяц. Месяц является a MONTH
значение поля (на основе 0. например, 9 на октябрь).endDay
- День месяца, на котором заканчивается летнее время.endDayOfWeek
- Летнее время конечный день-недельного.endTime
- Время окончания перехода на летнее время в локальной стене показывает время, (в миллисекундах в течение дня), который является локальным летним временем в этом случае.after
- Если это правда, это правило выбирает первое endDayOfWeek
на или после endDay
. Если ложь, это правило выбирает последнее endDayOfWeek
на или прежде endDay
из месяца.IllegalArgumentException
- endMonth
, endDay
, endDayOfWeek
, или endTime
параметры испытывают недостаток диапазонаpublic int getOffset(long date)
getOffset
в class TimeZone
date
- время, в которое находится смещение часового поясаCalendar.ZONE_OFFSET
, Calendar.DST_OFFSET
public int getOffset(int era, int year, int month, int day, int dayOfWeek, int millis)
GregorianCalendar
возразите как его базовый календарь, такой что касается определения високосных годов. Не используйте результат этого метода с календарем кроме значения по умолчанию GregorianCalendar
. Отметьте: Вообще, клиенты должны использовать Calendar.get(ZONE_OFFSET) + Calendar.get(DST_OFFSET)
вместо того, чтобы вызвать этот метод.
getOffset
в class TimeZone
era
- Эра данной даты.year
- Год в данной дате.month
- Месяц в данной дате. Месяц на основе 0. например, 0 на январь.day
- День-в-месячном данной даты.dayOfWeek
- День-недельного данной даты.millis
- Миллисекунды в день в стандартное местное время.IllegalArgumentException
- era
, month
, day
, dayOfWeek
, или millis
параметры испытывают недостаток диапазонаCalendar.ZONE_OFFSET
, Calendar.DST_OFFSET
public int getRawOffset()
getRawOffset
в class TimeZone
setRawOffset(int)
public void setRawOffset(int offsetMillis)
setRawOffset
в class TimeZone
offsetMillis
- данное смещение зоны норматива времени к GMT.getRawOffset()
public void setDSTSavings(int millisSavedDuringDST)
millisSavedDuringDST
- число миллисекунд, время совершенствуется относительно стандартного времени, когда правила летнего времени в действительности. Положительное число, обычно один час (3600000).getDSTSavings()
public int getDSTSavings()
getDSTSavings
в class TimeZone
setDSTSavings(int)
public boolean useDaylightTime()
useDaylightTime
в class TimeZone
TimeZone.inDaylightTime(Date)
, Calendar.DST_OFFSET
public boolean observesDaylightTime()
true
если это SimpleTimeZone
наблюдает Летнее время. Этот метод эквивалентен useDaylightTime()
.observesDaylightTime
в class TimeZone
true
если это SimpleTimeZone
наблюдает Летнее время; false
иначе.TimeZone.useDaylightTime()
, TimeZone.inDaylightTime(Date)
, Calendar.DST_OFFSET
public boolean inDaylightTime(Date date)
inDaylightTime
в class TimeZone
date
- данная Дата.public Object clone()
SimpleTimeZone
экземпляр.public int hashCode()
hashCode
в class Object
Object.equals(java.lang.Object)
, System.identityHashCode(java.lang.Object)
public boolean equals(Object obj)
SimpleTimeZone
объекты.equals
в class Object
obj
- SimpleTimeZone
объект быть по сравнению с.obj
то же самое как это SimpleTimeZone
объект; ложь иначе.Object.hashCode()
, HashMap
public boolean hasSameRules(TimeZone other)
true
если у этой зоны есть те же самые правила и смещение как другая зона.hasSameRules
в class TimeZone
other
- TimeZone возражают, чтобы быть по сравнению сtrue
если данная зона является SimpleTimeZone и имеет те же самые правила и смещение как этот
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92