Префикс Dr.MissMr.Mrs.Prof.Rev.

Имя

Фамилия

Контактный номер

Почта для связи

Название компании

вебсайт компании

Вы уже покупали у нас?

Хотите также запросить расценки?

Согласие

Я согласен с политикой конфиденциальности.

Tutorial — документация openpyxl 3.

Установка

Установите openpyxl с помощью pip. Желательно делать это в Python virtualenv без системных пакетов:

 $ pip install openpyxl
 

Примечание

Существует поддержка популярной библиотеки lxml, которая будет использоваться, если она установлен. Это особенно полезно при создании больших файлов.

Предупреждение

Чтобы иметь возможность включать изображения (jpeg, png, bmp,…) в файл openpyxl, вам также понадобится библиотека «pillow», которую можно установить с помощью:

 $ pip install Pillow
 

или просмотрите https://pypi.python.org/pypi/Pillow/, выберите последнюю версию и перейдите к нижней части страницы для двоичных файлов Windows.

Работа с проверкой

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

$ pip install -e hg+https://foss.heptapod.net/openpyxl/openpyxl/@3. 1#egg=openpyxl
 

Создать книгу

Нет необходимости создавать файл в файловой системе, чтобы начать работу с openpyxl. Просто импортируйте класс Workbook и начните работу:

 >>> from openpyxl import Workbook
>>> wb = рабочая книга ()
 

Рабочая книга всегда создается как минимум с одним рабочим листом. Вы можете получить его по используя свойство Workbook.active :

 >>> ws = wb.active
 

Примечание

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

Вы можете создавать новые рабочие листы с помощью метода Workbook.create_sheet() :

 >>> ws1 = wb.create_sheet("Mysheet") # вставить в конец (по умолчанию)
# или
>>> ws2 = wb.create_sheet("Mysheet", 0) # вставить в первую позицию
# или
>>> ws3 = wb.create_sheet("Mysheet", -1) # вставить в предпоследнюю позицию
 

Листам автоматически присваивается имя при их создании. Они нумеруются последовательно (Лист, Лист1, Лист2, …). Вы можете изменить это имя в любое время с помощью свойства Worksheet.title :

 ws.title = "Новый заголовок"
 

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

 >>> ws3 = wb["Новый заголовок"]
 

Вы можете просмотреть имена всех рабочих листов рабочей книги с помощью Workbook.sheetname атрибут

 >>> print(wb.имя_листа)
['Лист2', 'Новый заголовок', 'Лист1']
 

Вы можете перебирать рабочие листы

 >>> для листа в wb:
... печать (лист.название)
 

Вы можете создавать копии листов в одной книге :

Workbook.copy_worksheet() метод:

 >>> source = wb.active
>>> target = wb.copy_worksheet(источник)
 

Примечание

Только ячейки (включая значения, стили, гиперссылки и комментарии) и определенные атрибуты рабочего листа (включая размеры, формат и свойства) копируются. Все остальные атрибуты книги/листа не копируются — например. Изображения, графики.

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

Игра с данными

Доступ к одной ячейке

Теперь мы знаем, как получить рабочий лист, мы можем начать изменять содержимое ячеек. К ячейкам можно обращаться напрямую как к ключам рабочего листа:

 >>> c = ws['A4']
 

Это вернет ячейку на A4 или создаст ее, если она еще не существует. Значения могут быть назначены напрямую:

 >>> ws['A4'] = 4
 

Существует также метод Worksheet.cell() .

Это обеспечивает доступ к ячейкам с использованием записи строки и столбца:

 >>> d = ws.cell(строка=4, столбец=2, значение=10)
 

Примечание

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

Предупреждение

Из-за этой функции прокрутка ячеек вместо доступа к ним напрямую создаст их все в памяти, даже если вы не присвоите им значение.

Что-то вроде

 >>> для x в диапазоне (1,101):
... для y в диапазоне (1101):
... ws.cell (строка = x, столбец = y)
 

создаст в памяти 100×100 ячеек, ни за что.

Доступ ко многим ячейкам

Доступ к диапазонам ячеек можно получить с помощью нарезки:

 >>> cell_range = ws['A1':'C2']
 

Диапазоны строк или столбцов можно получить аналогично:

 >>> colC = ws['C']
>>> col_range = ws['C:D']
>>> строка10 = ws[10]
>>> row_range = ws[5:10]
 

Вы также можете использовать метод Worksheet.iter_rows() :

 >>> для строки в ws.iter_rows(min_row=1, max_col=3, max_row=2):
... для ячейки в строке:
... печать (ячейка)
<Ячейка Лист1.A1>
<Ячейка Лист1.B1>
<Ячейка Лист1.C1>
<Ячейка Лист1.A2>
<Ячейка Лист1.B2>
<Ячейка Лист1. C2>
 

Аналогично метод Worksheet.iter_cols() вернет столбцы:

 >>> для столбца в ws.iter_cols(min_row=1, max_col=3, max_row=2):
... для ячейки в столбце:
... печать (ячейка)
<Ячейка Лист1.A1>
<Ячейка Лист1.A2>
<Ячейка Лист1.B1>
<Ячейка Лист1.B2>
<Ячейка Лист1.C1>
<Ячейка Лист1.C2>
 

Примечание

Из соображений производительности метод Worksheet.iter_cols() недоступен в режиме только для чтения.

Если вам нужно перебрать все строки или столбцы файла, вы можете вместо этого использовать Worksheet.rows свойство:

 >>> ws = wb.active
>>> ws['C9'] = 'привет, мир'
>>> кортеж(ws.rows)
((, , ),
(, , ),
(, , ),
(, , ),
(, , ),
(, , ),
( A7>, , ),
(, , ),
(<Сотовый лист.A9>, , ))
 

или свойство Worksheet.columns :

 >>> tuple(ws.columns)
((,
<Сотовый лист.A2>,
<Сотовый лист.A3>,
<Сотовый лист.A4>,
<Сотовый лист.A5>,
<Сотовый лист.A6>,
...
<Сотовый лист.B7>,
<Сотовый лист.B8>,
<Сотовый лист.B9>),
(,
<Сотовый лист.C2>,
<Сотовый лист.C3>,
<Сотовый лист.C4>,
<Сотовый лист.C5>,
<Сотовый лист.C6>,
<Сотовый лист.C7>,
<Сотовый лист.C8>,
<Сотовый лист.C9>))
 

Примечание

Из соображений производительности свойство Worksheet.columns недоступно в режиме только для чтения.

Только значения

Если вам нужны только значения из рабочего листа, вы можете использовать свойство Worksheet.values ​​. Это перебирает все строки на листе, но возвращает только значения ячеек:

 для строки в ws.values:
   для значения в строке:
     печать (значение)
 

Оба Worksheet. iter_rows() и Worksheet.iter_cols() может возьмите параметр values_only , чтобы вернуть только значение ячейки:

 >>> для строки в ws.iter_rows(min_row=1, max_col=3, max_row=2, values_only=True):
... печать (строка)
(Нет, Нет, Нет)
(Нет, Нет, Нет)
 

Хранилище данных

Когда у нас есть ячейка , мы можем присвоить ей значение:

 >>> c.value = 'hello, world'
>>> печать (c.значение)
'Привет, мир'
>>> d.значение = 3,14
>>> печать (d.значение)
3.14
 

Сохранение в файл

Самый простой и безопасный способ сохранить книгу — использовать Workbook.save() метод объекта Workbook :

 >>> wb = Workbook()
>>> wb.save('балансы.xlsx')
 

Предупреждение

Эта операция перезапишет существующие файлы без предупреждения.

Примечание

Расширение имени файла не обязательно должно быть xlsx или xlsm, хотя у вас может быть некоторые проблемы с открытием его непосредственно с помощью другого приложения, если вы этого не сделаете. используйте официальное расширение.

Поскольку файлы OOXML в основном представляют собой ZIP-файлы, вы также можете открыть их с помощью любимый менеджер ZIP-архивов.

При необходимости можно указать атрибут wb.template=True , чтобы сохранить книгу как шаблон:

 >>> wb = load_workbook('document.xlsx')
>>> wb.template = Истина
>>> wb.save('document_template.xltx')
 

Сохранение в виде потока

Если вы хотите сохранить файл в виде потока, т.е. при использовании веб-приложения таких как Pyramid, Flask или Django, вы можете просто предоставить NamedTemporaryFile() :

 >>> из импорта временного файла NamedTemporaryFile
>>> из рабочей книги импорта openpyxl
>>> wb = рабочая книга ()
>>> с NamedTemporaryFile() как tmp:
        wb.save(tmp.имя)
        tmp.seek(0)
        поток = tmp.read()
 

Предупреждение

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

Примечание

Не удастся выполнить следующее:

 >>> wb = load_workbook('document.xlsx')
>>> # Нужно сохранить с расширением *.xlsx
>>> wb.save('new_document.xlsm')
>>> # MS Excel не может открыть документ
>>>
>>> # или
>>>
>>> # Нужно указать атрибут keep_vba=True
>>> wb = load_workbook('document.xlsm')
>>> wb.save('new_document.xlsm')
>>> # MS Excel не открывает документ
>>>
>>> # или
>>>
>>> wb = load_workbook('document.xltm', keep_vba=True)
>>> # Если нам нужен шаблон документа, то мы должны указать расширение *.xltm.
>>> wb.save('new_document.xlsm')
>>> # MS Excel не открывает документ
 

Загрузка из файла

Вы можете использовать openpyxl.load_workbook() , чтобы открыть существующую книгу:

 >>> from openpyxl import load_workbook
>>> wb = load_workbook (имя файла = 'empty_book.xlsx')
>>> sheet_ranges = wb['имена диапазонов']
>>> print(sheet_ranges['D18'].value)
3
 

Примечание

В load_workbook можно использовать несколько флагов.

• data_only определяет, имеют ли ячейки с формулами

формула (по умолчанию) или значение, сохраненное при последнем чтении листа Excel.

• keep_vba управляет сохранением каких-либо элементов Visual Basic или

нет (по умолчанию). Если они сохранены, они по-прежнему не редактируются.

• только для чтения открывает книги в режиме только для чтения. Это использует гораздо меньше

памяти и быстрее, но не все функции доступны (диаграммы, изображения, и т.д.)

• rich_text управляет форматированием расширенного текста в ячейках

сохранен. По умолчанию Ложь .

• keep_links определяет, являются ли кэшированные данные из внешних книг

сохранен.

Предупреждение

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