Перечисление CellFormat

По умолчанию при создании документа всем ячейкам присваивается формат «Общий». Полный список форматов представлен в таблице. Перечисление CellFormat используется в методах Cell.getFormat() и Cell.setFormat(), а также в поле PivotTableValueField.cellNumberFormat.

Значение	Описание
CellFormat.General	Формат ячейки «Общий». В этом формате в ячейке отображаются первые 9 символов числа, остальные доступны для просмотра в строке формул. Для дробных чисел в формате «Общий» незначащие нули в дробной части не отображаются. Числа, состоящие более чем из 12 символов, переводятся в экспоненциальную форму после завершения ввода в ячейку.
CellFormat.Percentage	Формат ячейки «Процентный». Этот формат используется для представления чисел как процентов. При применении формата «Процентный» введенное число умножается на 100 и обозначается знаком «%».
CellFormat.Number	Формат ячейки «Числовой». Если в ячейке с форматом «Числовой» содержится дробное число, то можно указать количество знаков, отображаемых в данном числе после разделителя.
CellFormat.Text	Формат ячейки «Текстовый».
CellFormat.Currency	Формат ячейки «Денежный». Этот формат используется для представления чисел со знаком или кодом валюты.
CellFormat.Accounting	Формат ячейки «Финансовый». Этот формат применяется для чисел, используемых в бухгалтерских документах. В формате «Финансовый» введенное число автоматически дополняется названием валюты, которая соответствует настройкам системы компьютера. Отрицательные числа в формате «Финансовый» заключаются в круглые скобки в ячейке, а в строке формул остаются в том виде, в котором они были введены.
CellFormat.Date	Формат ячейки «Дата». Этот формат автоматически присваивается числам, введенным в определенном виде, например, ДД.ММ.ГГГГ.
CellFormat.Time	Формат ячейки «Время». Этот формат автоматически присваивается числам, введенным в определенном виде, например, ЧЧ:ММ.
CellFormat.DateTime	Формат ячейки «Дата + Время»
CellFormat.Fraction	Формат ячейки «Дробный». Этот формат используется для представления дробных чисел в виде обыкновенных дробей (то есть дробная часть заменяется на числитель и знаменатель).
CellFormat.Scientific	Формат ячейки «Экспоненциальный». Экспоненциальный (или научный) формат используется для представления больших чисел в короткой форме. Все введенные числа длиной более 12 символов автоматически переводятся в этот формат. В ячейке число в формате «Экспоненциальный» представлено следующим образом: - целая часть, всегда состоящая из одной цифры; - разделитель целой и дробной части; - дробная часть, по умолчанию состоящая из двух цифр; - показатель степени числа 10 в виде E<знак показателя степени> <показатель степени>.
CellFormat.Custom	Пользовательский формат.

Использование данных значений позволяет установить желаемый формат. При этом будут использованы параметры формата по умолчанию.

Примеры использования

 Table firstSheet = document.getBlocks().getTable("Лист1");
 Cell cell = firstSheet.getCell("B1");
 cell.setFormat(CellFormat.General);
 cell = firstSheet.getCell("B2");
 cell.setFormat(CellFormat.Percentage);
 cell = firstSheet.getCell("B3");
 cell.setFormat(CellFormat.Number);

Результат

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