CustomBusinessDay
=================

.. cpp:class:: pandas::CustomBusinessDay

   pandas C++ class.

Example
-------

.. code-block:: cpp

   #include <pandas/pandas.h>
   using namespace pandas;

   // Use CustomBusinessDay
   CustomBusinessDay obj;
   // ... operations ...

Constructors
------------

.. list-table::
   :widths: 55 25 20
   :header-rows: 1

   * - Signature
     - Location
     - Example
   * - ``CustomBusinessDay(int n, bool normalize, uint8_t weekmask, const std::set<int64_t>& holidays)``
     - pd_dateoffset.h:1748
     - :ref:`View <example-custombusinessday-custombusinessday-0>`

Aggregation
-----------

.. list-table::
   :widths: 40 20 15 25
   :header-rows: 1

   * - Signature
     - Return Type
     - Location
     - Example
   * - ``numpy::datetime64 apply(const numpy::datetime64& dt) const override``
     - numpy::datetime64
     - pd_dateoffset.h:1770
     - :ref:`View <example-custombusinessday-apply-1>`

Comparison
----------

.. list-table::
   :widths: 40 20 15 25
   :header-rows: 1

   * - Signature
     - Return Type
     - Location
     - Example
   * - ``bool equals(const DateOffset& other) const override``
     - bool
     - pd_dateoffset.h:1754
     - :ref:`View <example-custombusinessday-equals-2>`

Type Checking
-------------

.. list-table::
   :widths: 40 20 15 25
   :header-rows: 1

   * - Signature
     - Return Type
     - Location
     - Example
   * - ``bool is_business_day(int64_t epoch_seconds) const``
     - bool
     - pd_dateoffset.h:1760
     - 
   * - ``bool is_calendar_offset() const override``
     - bool
     - pd_dateoffset.h:1768
     - 
   * - ``bool is_on_offset(const numpy::datetime64& dt) const override``
     - bool
     - pd_dateoffset.h:1785
     - :ref:`View <example-custombusinessday-is_on_offset-3>`

Other Methods
-------------

.. list-table::
   :widths: 40 20 15 25
   :header-rows: 1

   * - Signature
     - Return Type
     - Location
     - Example
   * - ``static int64_t epoch_day(int64_t epoch_seconds)``
     - static int64_t
     - pd_dateoffset.h:1718
     - 
   * - ``std::string freqstr() const override``
     - std::string
     - pd_dateoffset.h:1766
     - :ref:`View <example-custombusinessday-freqstr-4>`
   * - ``const std::set<int64_t>& holidays() const``
     - const std::set<int64_t>&
     - pd_dateoffset.h:1752
     - 
   * - ``std::string name() const override``
     - std::string
     - pd_dateoffset.h:1767
     - :ref:`View <example-custombusinessday-name-5>`
   * - ``static uint8_t parse_weekmask(const std::string& wm)``
     - static uint8_t
     - pd_dateoffset.h:1725
     - 
   * - ``uint8_t weekmask() const``
     - uint8_t
     - pd_dateoffset.h:1751
     - :ref:`View <example-custombusinessday-weekmask-6>`


Code Examples
-------------

The following examples are extracted from the test suite.

.. _example-custombusinessday-custombusinessday-0:

.. dropdown:: CustomBusinessDay (pd_test_5_all.cpp:124147)
   :class-title: example-dropdown

   .. code-block:: cpp
      :linenos:
      :lineno-start: 124137
      :emphasize-lines: 11

          if (subclass == "Second")                return pandas::Second(n).repr();
          if (subclass == "Week")                  return pandas::Week(n).repr();
          if (subclass == "MonthEnd")              return pandas::MonthEnd(n).repr();
          if (subclass == "MonthBegin")            return pandas::MonthBegin(n).repr();
          if (subclass == "Milli")                 return pandas::Milli(n).repr();
          if (subclass == "Micro")                 return pandas::Micro(n).repr();
          if (subclass == "Nano")                  return pandas::Nano(n).repr();
          if (subclass == "BusinessMonthEnd")      return pandas::BusinessMonthEnd(n).repr();
          if (subclass == "BusinessMonthBegin")    return pandas::BusinessMonthBegin(n).repr();
          if (subclass == "BusinessHour")          return pandas::BusinessHour(n).repr();
          if (subclass == "CustomBusinessDay")     return pandas::CustomBusinessDay(n).repr();
          if (subclass == "CustomBusinessHour")    return pandas::CustomBusinessHour(n).repr();
          if (subclass == "YearEnd")               return pandas::YearEnd(n, false, anchor_value).repr();
          if (subclass == "YearBegin")             return pandas::YearBegin(n, false, anchor_value).repr();
          if (subclass == "QuarterEnd")            return pandas::QuarterEnd(n, false, anchor_value).repr();
          if (subclass == "QuarterBegin")          return pandas::QuarterBegin(n, false, anchor_value).repr();
          if (subclass == "BQuarterEnd")           return pandas::BQuarterEnd(n, false, anchor_value).repr();
          if (subclass == "BQuarterBegin")         return pandas::BQuarterBegin(n, false, anchor_value).repr();
          if (subclass == "BYearEnd")              return pandas::BYearEnd(n, false, anchor_value).repr();
          if (subclass == "BYearBegin")            return pandas::BYearBegin(n, false, anchor_value).repr();
          throw std::runtime_error("unknown subclass: " + subclass);

.. _example-custombusinessday-apply-1:

.. dropdown:: apply (pd_test_1_all.cpp:11244)
   :class-title: example-dropdown

   .. code-block:: cpp
      :linenos:
      :lineno-start: 11234
      :emphasize-lines: 11

              void pd_test_func_apply_dataframe_apply_axis0() {
                  std::cout << "========= DataFrame apply axis=0 ======================";
      
                  std::map<std::string, std::vector<double>> data = {
                      {"A", {1.0, 2.0, 3.0}},
                      {"B", {4.0, 5.0, 6.0}}
                  };
                  pandas::DataFrame df(data);
      
                  // apply axis=0 applies function to each column
                  auto result = df.apply([](const std::vector<double>& col) {
                      return std::accumulate(col.begin(), col.end(), 0.0);
                  }, 0);
      
                  bool passed = true;
      
                  // Plan F·dtype: axis=0 reduce now returns a single "result" column
                  // with the original column names ("A", "B") as the row index.
                  // Sum of A: 1+2+3=6, Sum of B: 4+5+6=15
                  const auto& result_col = result["result"];
                  double sum_a = std::stod(result_col.get_value_str(0));

.. _example-custombusinessday-equals-2:

.. dropdown:: equals (pd_test_1_all.cpp:5866)
   :class-title: example-dropdown

   .. code-block:: cpp
      :linenos:
      :lineno-start: 5856
      :emphasize-lines: 11

          std::cout << "========= equals ======================================";
      
          pandas::CategoricalArray arr1({"a", "b", "a"});
          pandas::CategoricalArray arr2({"a", "b", "a"});
          pandas::CategoricalArray arr3({"a", "b", "c"});
      
          pandas::CategoricalIndex idx1(arr1);
          pandas::CategoricalIndex idx2(arr2);
          pandas::CategoricalIndex idx3(arr3);
      
          bool passed = (idx1.equals(idx2) && !idx1.equals(idx3));
          if (!passed) {
              std::cout << "  [FAIL] : in pd_test_categorical_index_equals()" << std::endl;
              throw std::runtime_error("pd_test_categorical_index_equals failed");
          }
      
          std::cout << " -> tests passed" << std::endl;
      }
      
      void pd_test_categorical_index_identical() {
          std::cout << "========= identical ===================================";

.. _example-custombusinessday-is_on_offset-3:

.. dropdown:: is_on_offset (pd_test_3_all.cpp:18263)
   :class-title: example-dropdown

   .. code-block:: cpp
      :linenos:
      :lineno-start: 18253
      :emphasize-lines: 11

      
      void pd_test_business_day_offset() {
          std::cout << "========= BusinessDay offset ===========================";
      
          pandas::BusinessDay offset(1);
          if (offset.freqstr() != "B") {
              std::cout << "  [FAIL] : BusinessDay freqstr() failed" << std::endl;
              throw std::runtime_error("pd_test_business_day_offset: freqstr() failed");
          }
      
          // Test is_on_offset (Friday = weekday)
          numpy::datetime64 friday("2020-01-17");  // Friday
          if (!offset.is_on_offset(friday)) {
              std::cout << "  [FAIL] : BusinessDay is_on_offset(Friday) failed" << std::endl;
              throw std::runtime_error("pd_test_business_day_offset: is_on_offset(Friday) failed");
          }
      
          // Test is_on_offset (Saturday = weekend)
          numpy::datetime64 saturday("2020-01-18");  // Saturday
          if (offset.is_on_offset(saturday)) {
              std::cout << "  [FAIL] : BusinessDay is_on_offset(Saturday) should be false" << std::endl;

.. _example-custombusinessday-freqstr-4:

.. dropdown:: freqstr (pd_test_1_all.cpp:2671)
   :class-title: example-dropdown

   .. code-block:: cpp
      :linenos:
      :lineno-start: 2661
      :emphasize-lines: 11

              }
      
              pandas::PeriodDtype dtype_y("Y");
              if (dtype_y.name() != "period[Y]") {
                  std::cout << "  [FAIL] : dtype_y.name() should be 'period[Y]'" << std::endl;
                  throw std::runtime_error("pd_test_period_array_freq_validation failed: dtype name Y");
              }
      
              // Test frequency string
              pandas::PeriodArray arr(std::vector<std::string>{"2024-01-15"}, "D");
              if (arr.freqstr() != "D") {
                  std::cout << "  [FAIL] : arr.freqstr() should be 'D'" << std::endl;
                  throw std::runtime_error("pd_test_period_array_freq_validation failed: freqstr");
              }
      
              std::cout << " -> tests passed" << std::endl;
          }
      
          void pd_test_period_array_year_month_quarter() {
              std::cout << "========= PeriodArray: year/month/quarter components ======================= ";
      

.. _example-custombusinessday-name-5:

.. dropdown:: name (pd_test_1_all.cpp:295)
   :class-title: example-dropdown

   .. code-block:: cpp
      :linenos:
      :lineno-start: 285
      :emphasize-lines: 11

                  throw std::runtime_error("pd_test_boolean_array_reductions failed: mean");
              }
      
              std::cout << " -> tests passed" << std::endl;
          }
      
          void pd_test_boolean_array_dtype() {
              std::cout << "========= BooleanArray: dtype ======================= ";
      
              pandas::BooleanArray arr;
              if (arr.dtype().name() != "boolean") {
                  std::cout << "  [FAIL] : in pd_test_boolean_array_dtype() : dtype name should be 'boolean'" << std::endl;
                  throw std::runtime_error("pd_test_boolean_array_dtype failed: dtype name");
              }
      
              if (arr.dtype().kind() != "b") {
                  std::cout << "  [FAIL] : in pd_test_boolean_array_dtype() : dtype kind should be 'b'" << std::endl;
                  throw std::runtime_error("pd_test_boolean_array_dtype failed: dtype kind");
              }
      
              std::cout << " -> tests passed" << std::endl;

.. _example-custombusinessday-weekmask-6:

.. dropdown:: weekmask (pd_test_3_all.cpp:1377)
   :class-title: example-dropdown

   .. code-block:: cpp
      :linenos:
      :lineno-start: 1367
      :emphasize-lines: 11

              true,
              "business_dates"
          );
      
          // Should have business days (Mon-Fri = 5 days in this range)
          if (result.size() < 1) {
              std::cout << "  [FAIL] : in pd_test_3_all_bdate_range() : expected at least 1 business day" << std::endl;
              throw std::runtime_error("pd_test_3_all_bdate_range failed: no days returned");
          }
      
          // Test with custom weekmask (exclude Fridays)
          pandas::DatetimeIndex result2 = pandas::bdate_range(
              "2024-01-01",
              "2024-01-07",  // Full week
              std::nullopt,
              "B",
              std::nullopt,
              true,
              "custom_days",
              "Mon Tue Wed Thu"  // No Fri, Sat, Sun
          );