pandas.Series.to_json

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

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

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

Параметры:

path_or_buf : string or file handle, optional Путь к файлу или объект. Если не указано, результат возвращается в виде строки. orient : string Указание ожидаемого формата строки JSON. Series По умолчанию ‘index’ Допустимые значения: {‘split’,’records’,’index’,’table’} DataFrame По умолчанию ‘columns’ Допустимые значения: {‘split’,’records’,’index’,’columns’,’values’,’table’} Формат строки JSON ‘split’ : похожий на словарь {‘index’ -> [индекс], ‘columns’ -> [колонки], ‘data’ -> [значения]} ‘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 : int, default 10 Количество десятичных знаков, используемых при кодировании значений с плавающей точкой. force_ascii : bool, default True Принудительно кодировать строку в ASCII. date_unit : string, default ‘ms’ (milliseconds) Единица времени для кодирования, управляет точностью метки времени и ISO8601. Одно из значений ‘s’, ‘ms’, ‘us’, ‘ns’ для секунды, миллисекунды, микросекунды и наносекунды соответственно. default_handler : callable, default None Обработчик для вызова, если объект не может быть преобразован в подходящий формат для JSON. Должен принять единственный аргумент, который является объектом для преобразования, и вернуть сериализуемый объект. lines : bool, default False Если ‘orient’ равно ‘records’, записывать строку JSON в формате с разделителями строк. Вызовет ValueError, если неверно задан ‘orient’, так как другие значения не являются списками. Новое в версии 0.19.0. compression : {‘infer’, ‘gzip’, ‘bz2’, ‘zip’, ‘xz’, None} Строка, представляющая сжатие, используемое в выходном файле, используется только когда первый аргумент является именем файла. По умолчанию сжатие выводится из имени файла. Новое в версии 0.21.0. Изменено в версии 0.24.0: Добавлен параметр ‘infer’ и установлено по умолчанию index : bool, default True Включать ли значения индекса в строку JSON. Не включая индексы (index=False) поддерживается только когда orient равен ‘split’ или ‘table’. Новое в версии 0.23.0.

Возвращает:

None или str Если path_or_buf равно None, возвращает результирующий формат JSON в виде строки. В противном случае возвращает None.

См. также

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 в формате 'records'. Обратите внимание, что метки индекса не сохраняются при этом кодировании.

>>> df.to_json(orient='records')
'[{"col 1":"a","col 2":"b"},{"col 1":"c","col 2":"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 в формате 'columns'.

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

Кодирование/декодирование DataFrame с помощью JSON в формате 'values'.

>>> df.to_json(orient='values')
'[["a","b"],["c","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"}]}'