pandas.Series.to_json

Series.to_json(path_or_buf=None, orient=None, date_format=None, double_precision=10, force_ascii=True, date_unit='ms', default_handler=None, lines=False) [source]

Преобразование объекта в строку JSON.

Обратите внимание, что NaN и None будут преобразованы в null, а объекты datetime — в метки временных меток UNIX.

Параметры:

path_or_buf : путь или буфер для записи результирующей строки если значение None, то возвращается StringIO с преобразованной строкой orient : строка Series по умолчанию ‘index’ разрешённые значения: {‘split’,’records’,’index’} DataFrame по умолчанию ‘columns’ разрешённые значения: {‘split’,’records’,’index’,’columns’,’values’} Формат строки JSON split : словарь типа {индекс -> [индекс], столбцы -> [столбцы], данные -> [значения]} records : список типа [{столбец -> значение}, ... , {столбец -> значение}] index : словарь типа {индекс -> {столбец -> значение}} columns : словарь типа {столбец -> {индекс -> значение}} values : только массив значений table : словарь типа {‘схема’: {схема}, ‘данные’: {данные}} описывающий данные, а компонент данных похож на orient='records'. Изменено в версии 0.20.0. date_format : {None, ‘epoch’, ‘iso’} Тип преобразования даты. epoch = эпоха миллисекунды, iso = ISO8601. Значение по умолчанию зависит от orient. Для orient=’table’, значение по умолчанию ‘iso’. Для всех других ориентаций значение по умолчанию ‘epoch’. double_precision : количество десятичных знаков для использования при кодировании значений с плавающей точкой, значение по умолчанию 10. force_ascii : принудительно кодировать строку в ASCII, значение по умолчанию True. date_unit : строка, значение по умолчанию ‘ms’ (миллисекунды) Единица времени для кодирования, управляет точностью временных меток и ISO8601. Одно из значений ‘s’, ‘ms’, ‘us’, ‘ns’ соответственно для секунды, миллисекунды, микросекунды и наносекунды. default_handler : вызываемый объект, значение по умолчанию None Обработчик, который вызывается, если объект не может быть преобразован в подходящий формат для JSON. Должен принимать один аргумент, который является объектом для преобразования, и возвращать сериализуемый объект. lines : логическое значение, значение по умолчанию False Если ‘orient’ равен ‘records’, то выводится JSON в формате, разделённом по строкам. Будет выброшено исключение ValueError, если неправильно указано ‘orient’, так как другие значения не являются похожими на список. Добавлено в версии 0.19.0.

Возвращаемое значение:

тот же тип, что и входной объект, с отфильтрованной осью информации

См. также

pd.read_json

Примеры

>>> df = pd.DataFrame([['a', 'b'], ['c', 'd']],
...                   index=['row 1', 'row 2'],
...                   columns=['col 1', 'col 2'])
>>> df.to_json(orient='split')
'{"columns":["col 1","col 2"],
  "index":["row 1","row 2"],
  "data":[["a","b"],["c","d"]]}'

Кодирование/декодирование DataFrame с использованием форматированного JSON 'index'.

>>> df.to_json(orient='index')
'{"row 1":{"col 1":"a","col 2":"b"},"row 2":{"col 1":"c","col 2":"d"}}'

Кодирование/декодирование DataFrame с использованием форматированного JSON 'records'. Обратите внимание, что метки индекса не сохраняются при этом кодировании.

>>> df.to_json(orient='records')
'[{"col 1":"a","col 2":"b"},{"col 1":"c","col 2":"d"}]'

Кодирование со схемой таблицы

>>> df.to_json(orient='table')
'{"schema": {"fields": [{"name": "index", "type": "string"},
                        {"name": "col 1", "type": "string"},
                        {"name": "col 2", "type": "string"}],
             "primaryKey": "index",
             "pandas_version": "0.20.0"},
  "data": [{"index": "row 1", "col 1": "a", "col 2": "b"},
           {"index": "row 2", "col 1": "c", "col 2": "d"}]}'