BUG: fix to_json serialization for Period objects

Author: xiaohuanlin

doc/source/whatsnew/v3.0.0.rst

@@ -788,6 +788,7 @@ I/O
 - Bug in :meth:`read_stata` where the missing code for double was not recognised for format versions 105 and prior (:issue:`58149`)
 - Bug in :meth:`set_option` where setting the pandas option ``display.html.use_mathjax`` to ``False`` has no effect (:issue:`59884`)
 - Bug in :meth:`to_excel` where :class:`MultiIndex` columns would be merged to a single row when ``merge_cells=False`` is passed (:issue:`60274`)
+- Bug in :meth:`to_json` period dtype was not being converted to string (:issue:`55490`)
 
 Period
 ^^^^^^

pandas/_libs/src/vendored/ujson/python/objToJSON.c

@@ -62,6 +62,7 @@ int object_is_series_type(PyObject *obj);
 int object_is_index_type(PyObject *obj);
 int object_is_nat_type(PyObject *obj);
 int object_is_na_type(PyObject *obj);
+int object_is_offset_type(PyObject *obj);
 
 typedef struct __NpyArrContext {
   PyObject *array;
@@ -927,6 +928,12 @@ static int Dir_iterNext(JSOBJ _obj, JSONTypeContext *tc) {
       continue;
     }
 
+    // Skip the 'base' attribute for BaseOffset objects
+    if (object_is_offset_type(obj) && strcmp(attrStr, "base") == 0) {
+      Py_DECREF(attr);
+      continue;
+    }
+
     itemValue = PyObject_GetAttr(obj, attrName);
     if (itemValue == NULL) {
       PyErr_Clear();

pandas/_libs/src/vendored/ujson/python/ujson.c

@@ -74,6 +74,7 @@ typedef struct {
   PyObject *type_index;
   PyObject *type_nat;
   PyObject *type_na;
+  PyObject *type_offset;
 } modulestate;
 
 #define modulestate(o) ((modulestate *)PyModule_GetState(o))
@@ -211,6 +212,26 @@ int object_is_na_type(PyObject *obj) {
   }
   return result;
 }
+
+int object_is_offset_type(PyObject *obj) {
+  PyObject *module = PyState_FindModule(&moduledef);
+  if (module == NULL)
+    return 0;
+  modulestate *state = modulestate(module);
+  if (state == NULL)
+    return 0;
+  PyObject *type_offset = state->type_offset;
+  if (type_offset == NULL) {
+    PyErr_Clear();
+    return 0;
+  }
+  int result = PyObject_IsInstance(obj, type_offset);
+  if (result == -1) {
+    PyErr_Clear();
+    return 0;
+  }
+  return result;
+}
 #else
 /* Used in objToJSON.c */
 int object_is_decimal_type(PyObject *obj) {
@@ -345,6 +366,27 @@ int object_is_na_type(PyObject *obj) {
   return result;
 }
 
+int object_is_offset_type(PyObject *obj) {
+  PyObject *module = PyImport_ImportModule("pandas._libs.tslibs.offsets");
+  if (module == NULL) {
+    PyErr_Clear();
+    return 0;
+  }
+  PyObject *type_offset = PyObject_GetAttrString(module, "BaseOffset");
+  if (type_offset == NULL) {
+    Py_DECREF(module);
+    PyErr_Clear();
+    return 0;
+  }
+  int result = PyObject_IsInstance(obj, type_offset);
+  if (result == -1) {
+    Py_DECREF(module);
+    Py_DECREF(type_offset);
+    PyErr_Clear();
+    return 0;
+  }
+  return result;
+}
 #endif
 
 static int module_traverse(PyObject *m, visitproc visit, void *arg) {
@@ -354,6 +396,7 @@ static int module_traverse(PyObject *m, visitproc visit, void *arg) {
   Py_VISIT(modulestate(m)->type_index);
   Py_VISIT(modulestate(m)->type_nat);
   Py_VISIT(modulestate(m)->type_na);
+  Py_VISIT(modulestate(m)->type_offset);
   return 0;
 }
 
@@ -364,6 +407,7 @@ static int module_clear(PyObject *m) {
   Py_CLEAR(modulestate(m)->type_index);
   Py_CLEAR(modulestate(m)->type_nat);
   Py_CLEAR(modulestate(m)->type_na);
+  Py_CLEAR(modulestate(m)->type_offset);
   return 0;
 }
 
@@ -434,6 +478,16 @@ PyMODINIT_FUNC PyInit_json(void) {
   } else {
     PyErr_Clear();
   }
+
+  PyObject *mod_offset = PyImport_ImportModule("pandas._libs.tslibs.offsets");
+  if (mod_offset) {
+    PyObject *type_offset = PyObject_GetAttrString(mod_offset, "BaseOffset");
+    assert(type_offset != NULL);
+    modulestate(module)->type_offset = type_offset;
+
+    Py_DECREF(mod_offset);
+  }
+
 #endif
 
   /* Not vendored for now

pandas/tests/io/json/test_pandas.py

@@ -2079,6 +2079,21 @@ def e(self):
         series = Series([_TestObject(a=1, b=2, _c=3, d=4)])
         assert json.loads(series.to_json()) == {"0": {"a": 1, "b": 2, "d": 4}}
 
+    def test_to_json_with_period(self):
+        # GH55490
+        ser = Series(pd.period_range(start=2021, freq="Y", periods=1))
+        result = ser.to_json()
+        expected = (
+            '{"0":{"day":31,"day_of_week":4,"day_of_year":365,"dayofweek":4,'
+            '"dayofyear":365,"days_in_month":31,"daysinmonth":31,"end_time":1640995199999,'
+            '"freq":{"freqstr":"YE-DEC","kwds":{"month":12},"month":12,"n":1,'
+            '"name":"YE-DEC","normalize":false,"rule_code":"YE-DEC"},'
+            '"freqstr":"Y-DEC","hour":0,"is_leap_year":false,"minute":0,'
+            '"month":12,"ordinal":51,"quarter":4,"qyear":2021,"second":0,'
+            '"start_time":1609459200000,"week":52,"weekday":4,"weekofyear":52,"year":2021}}'
+        )
+        assert result == expected
+
     @pytest.mark.parametrize(
         "data,expected",
         [