Cells
JsonHandler

JsonHandler — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss може експортувати дані листа у JSON за допомогою JsonHandler класу. Вихід представляє кожен рядок як JSON‑об’єкт, ключований заголовком стовпця, зібраний у масив.

Enumerations: aspose.cells_foss

from aspose.cells_foss import JsonHandler, JsonSaveOptions
from aspose.cells_foss import save_workbook_as_json

JsonSaveOptions

Параметри, які керують тим, як лист серіалізується у JSON.

Enumerations 

JsonSaveOptions()

Enumerations

JsonSaveOptions не має налаштовуваних властивостей. Передайте екземпляр до JsonHandler.save_json() для використання поведінки серіалізації за замовчуванням.

JsonHandler

JsonHandler містить лише статичні методи і ніколи не інстанціюється.

JsonHandler.save_json 

JsonHandler.save_json(workbook, file_path: str, options: JsonSaveOptions | None = None) -> None

Експортує перший лист у файл JSON за адресою file_path. Якщо options є None, за замовчуванням JsonSaveOptions використовуються.

JsonHandler.save_json_to_dict 

JsonHandler.save_json_to_dict(workbook, options: JsonSaveOptions | None = None) -> dict

Серіалізує робочий лист у Python dict (або list) і повертає його без запису у файл. Корисно для програмної пост-обробки.

Функція модуля

save_workbook_as_json 

save_workbook_as_json(workbook, file_path: str, options: JsonSaveOptions | None = None) -> None

Зручна обгортка навколо JsonHandler.save_json(workbook, file_path, options).

Enumerations

Наступний приклад записує таблицю продажів і експортує її у JSON‑файл з форматуванням дат у ISO.

from aspose.cells_foss import Workbook, JsonHandler, JsonSaveOptions
import datetime

wb = Workbook()
ws = wb.worksheets[0]
ws.name = "Sales"

# Header row
ws.cells["A1"].put_value("Date")
ws.cells["B1"].put_value("Product")
ws.cells["C1"].put_value("Amount")

# Data rows
ws.cells["A2"].put_value(datetime.date(2025, 1, 15))
ws.cells["B2"].put_value("Widget A")
ws.cells["C2"].put_value(1250.00)

ws.cells["A3"].put_value(datetime.date(2025, 1, 22))
ws.cells["B3"].put_value("Widget B")
ws.cells["C3"].put_value(840.50)

opts = JsonSaveOptions()

# Save to file
JsonHandler.save_json(wb, "sales.json", options=opts)

# Or retrieve as a Python dict
data = JsonHandler.save_json_to_dict(wb, options=opts)
print(data)

Приклад виводу (sales.json):

{
  "Sales": [
    {"Date": "2025-01-15", "Product": "Widget A", "Amount": 1250.0},
    {"Date": "2025-01-22", "Product": "Widget B", "Amount": 840.5}
  ]
}

Див. також

 Українська