Spec-Zone.ru › OpenJDK 27

Класс перечисления SignStyle

java.lang.Object
java.lang.Enum<SignStyle>
java.time.format.SignStyle
Все реализуемые интерфейсы:
Serializable, Comparable<SignStyle>, Constable
public enum SignStyle extends Enum<SignStyle>
Перечисление способов обработки положительного/отрицательного знака.

Механизм форматирования позволяет управлять положительными и отрицательными знаками чисел с помощью этого перечисления. Описание использования см. в DateTimeFormatterBuilder.

Требования к реализации:
Это неизменяемое и потокобезопасное перечисление.
Начиная с версии:
1.8

Краткое описание вложенных классов

Вложенные классы/интерфейсы, объявленные в классе Enum

Enum.EnumDesc<E>
Модификатор и тип Класс Описание
static final class  Enum.EnumDesc<E extends Enum<E>>
номинальный дескриптор константы enum.

Краткое описание констант перечисления

Константа перечисления Описание
ALWAYS
Стиль, при котором знак выводится всегда; для нуля выводится «+».
EXCEEDS_PAD
Стиль, при котором знак выводится всегда, если значение превышает ширину заполнения.
NEVER
Стиль, при котором знак не выводится, выводится только абсолютное значение.
NORMAL
Стиль, при котором знак выводится, только если значение отрицательное.
NOT_NEGATIVE
Стиль, запрещающий отрицательные значения и вызывающий исключение при выводе.

Краткое описание методов

Модификатор и тип Метод Описание
static SignStyle valueOf(String name)
Возвращает константу перечисления этого класса с указанным именем.
static SignStyle[] values()
Возвращает массив, содержащий константы этого класса перечисления в порядке их объявления.

Методы, объявленные в классе Enum

clone, compareTo, describeConstable, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf
Модификатор и тип Метод Описание
protected final Object clone()
Выбрасывает CloneNotSupportedException.
final int compareTo(SignStyle o)
Сравнивает это перечисление с указанным объектом для определения порядка.
final Optional<Enum.EnumDesc<SignStyle>> describeConstable()
Возвращает дескриптор перечисления EnumDesc для этого экземпляра, если его можно создать, или пустой объект Optional, если создать его нельзя.
final boolean equals(Object other)
Возвращает true, если указанный объект равен этой константе перечисления.
protected final void finalize()
Устарело, подлежит удалению: этот элемент API может быть удален в будущей версии.
Метод завершения объявлен устаревшим и подлежит удалению.
final Class<SignStyle> getDeclaringClass()
Возвращает объект Class, соответствующий типу перечисления этой константы.
final int hashCode()
Возвращает хеш-код этой константы перечисления.
final String name()
Возвращает имя этой константы перечисления точно в том виде, в котором оно указано в объявлении перечисления.
final int ordinal()
Возвращает порядковый номер этой константы перечисления (ее позицию в объявлении перечисления, где первой константе присваивается номер 0).
String toString()
Возвращает имя этой константы перечисления, указанное в объявлении.
static <T extends Enum<T>>
T
valueOf(Class<T> enumClass, String name)
Возвращает константу указанного класса перечисления с указанным именем.

Методы, объявленные в классе Object

getClass, notify, notifyAll, wait, wait, wait
Модификатор и тип Метод Описание
final Class<?> getClass()
Возвращает класс среды выполнения этого Object.
final void notify()
Пробуждает один поток, ожидающий на мониторе этого объекта.
final void notifyAll()
Пробуждает все потоки, ожидающие на мониторе этого объекта.
final void wait()
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
final void wait(long timeoutMillis)
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного периода реального времени.
final void wait(long timeoutMillis, int nanos)
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного периода реального времени.

Подробное описание констант перечисления

NORMAL

public static final SignStyle NORMAL
Стиль, при котором знак выводится, только если значение отрицательное.

При строгом разборе отрицательный знак будет принят, а положительный — отклонен. При нестрогом разборе принимается любой знак.

ALWAYS

public static final SignStyle ALWAYS
Стиль, при котором знак выводится всегда; для нуля выводится «+».

При строгом разборе отсутствие знака будет отклонено. При нестрогом разборе принимается любой знак, а отсутствие знака трактуется как положительное число.

NEVER

public static final SignStyle NEVER
Стиль, при котором знак не выводится, выводится только абсолютное значение.

При строгом разборе любой знак будет отклонен. При нестрогом разборе принимается любой знак, если ширина не фиксирована.

NOT_NEGATIVE

public static final SignStyle NOT_NEGATIVE
Стиль, запрещающий отрицательные значения и вызывающий исключение при выводе.

При строгом разборе любой знак будет отклонен. При нестрогом разборе принимается любой знак, если ширина не фиксирована.

EXCEEDS_PAD

public static final SignStyle EXCEEDS_PAD
Стиль, при котором знак всегда выводится, если значение превышает ширину заполнения. Для отрицательного значения всегда выводится знак «-».

При строгом разборе знак будет отклонен, если ширина заполнения не превышена. При нестрогом разборе принимается любой знак, а отсутствие знака трактуется как положительное число.

Подробное описание методов

values

public static SignStyle[] values()
Возвращает массив, содержащий константы этого класса перечисления в порядке их объявления.
Возвращает:
массив, содержащий константы этого класса перечисления в порядке их объявления

valueOf

public static SignStyle valueOf(String name)
Возвращает константу перечисления этого класса с указанным именем. Строка должна точно совпадать с идентификатором, использованным для объявления константы перечисления в этом классе. (Лишние пробельные символы не допускаются.)
Параметры:
name — имя возвращаемой константы перечисления.
Возвращает:
константу перечисления с указанным именем
Выбрасывает:
IllegalArgumentException — если в этом классе перечисления нет константы с указанным именем
NullPointerException — если аргумент равен null

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, концептуальные обзоры, определения терминов, обходные решения и рабочие примеры кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторское право © 1993, 2026, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API