PyPI - cnexchcal - Versions diffs - 0.2.0__py3-none-any.whl - Mend

cnexchcal 0.2.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

cnexchcal/__init__.py +179 -0
cnexchcal/asset/extra_holidays.csv +4 -0
cnexchcal/asset/festivals.csv +259 -0
cnexchcal/asset/quasi_holidays.csv +154 -0
cnexchcal/asset/weekend_workdays.csv +153 -0
cnexchcal-0.2.0.dist-info/METADATA +104 -0
cnexchcal-0.2.0.dist-info/RECORD +10 -0
cnexchcal-0.2.0.dist-info/WHEEL +5 -0
cnexchcal-0.2.0.dist-info/licenses/LICENSE +21 -0
cnexchcal-0.2.0.dist-info/top_level.txt +1 -0

cnexchcal/__init__.py ADDED Viewed

@@ -0,0 +1,179 @@
+from importlib.resources import files   # for external files
+import polars as pl
+from datetime import date, timedelta
+with files('cnexchcal').joinpath('asset', 'festivals.csv').open('rb') as f:
+    festivals = pl.read_csv(
+        f,
+        skip_rows = 2,
+        try_parse_dates = True
+    )
+with files('cnexchcal').joinpath('asset', 'quasi_holidays.csv').open('rb') as f:
+    quasiholidays = pl.read_csv(
+        f,
+        skip_rows = 2,
+        try_parse_dates = True
+    )
+with files('cnexchcal').joinpath('asset', 'weekend_workdays.csv').open('rb') as f:
+    weekendworkdays = pl.read_csv(
+        f,
+        skip_rows = 2,
+        try_parse_dates = True
+    )
+ymin = festivals.get_column('date').dt.year().min()
+ymax = festivals.get_column('date').dt.year().max()
+dmin = date(ymin, 1, 1)
+dmax = date(ymax, 12, 31)
+class ExchCal():
+    def __init__(self):
+        self.holiday_ennames = ("New Year's Day", "Spring Festival", "Tomb-sweeping Day", "Labour Day", "Dragon Boat Festival",
+                                "National Day", "Mid-autumn Festival")
+        self.holiday_cnnames = ('元旦', '春节', '清明', '劳动节', '端午', '国庆节', '中秋节')
+        # 2024-11-12 国务院发布: 自 2025-01-01 起，春节和劳动节各增加1天
+        self.nholidays = {
+            'before2025': (1, 3, 1, 1, 1, 3, 1),   # 11 dates total
+            'since2025': (1, 4, 1, 2, 1, 3, 1)   # 13 dates total
+        }
+        self.special_holiday = {'enname': 'Anti-Fascist 70th Day',
+                                'cnname': '中国人民抗日战争暨世界反法西斯战争胜利70周年纪念日',
+                                'nholidays': 1
+                               }   # extra holiday only for exchanges
+    def isholiday(self, d: date | str) -> bool:
+        '''
+        If d is a holiday (legal festival, quasi-holiday, weekends not work)
+        **Parameters**
+        - d: date or date string with format 'yyyy-mm-dd'
+        **Returns**: bool
+        **Example**
+        from cnexchcal import ExchCal
+        cal = ExchCal()
+        cal.isholiday('2026-01-02')  # True, extra holiday on Friday
+        cal.isholiday('2026-01-04')  # False, Sunday, swap with extra holiday on 2026-01-02 (Friday)
+        '''
+        if isinstance(d, str):
+            d = date.fromisoformat(d)
+        assert dmin <= d <= dmax, 'd is out of range'
+        res = ((d.weekday() in (5, 6)) and \
+               (d not in weekendworkdays.get_column('date'))) or \
+              (d in festivals.get_column('date')) or \
+              (d in quasiholidays.get_column('date'))
+        return res
+    def isworkday(self, d: date | str) -> bool:
+        '''
+        If d is a workday (regular workday and weekend workday)
+        **Parameters**
+        - d: date or date string with format 'yyyy-mm-dd'
+        **Returns**: bool
+        **Example**
+        from cnexchcal import ExchCal
+        cal = ExchCal()
+        cal.isworkday('2026-01-04')  # True, Sunday, swap with extra holiday on 2026-01-02 (Friday)
+        '''
+        return not self.isholiday(d)
+    def issession(self, d: date | str) -> bool:
+        '''
+        If d is a trading date of exchanges in China mainland. On weekend workday, exchanges are closed.
+        **Parameters**
+        - d: date or date string with format 'yyyy-mm-dd'
+        **Returns**: bool
+        **Example**
+        from cnexchcal import ExchCal
+        cal = ExchCal()
+        cal.issession('2026-01-04')  # False, Sunday, but is workday
+        '''
+        if isinstance(d, str):
+             d = date.fromisoformat(d)
+        assert dmin <= d <= dmax, 'd is out of range'
+        closed = (d.weekday() in (5, 6)) or \
+                 (d in festivals.get_column('date')) or \
+                 (d in quasiholidays.get_column('date')) or \
+                 (d == date(2024, 2, 9))   # special holiday
+        return not closed
+    def nextsession(self, d: date | str) -> date:
+        '''
+        Next trading day from a given date d. If d itself is a trading day, return d itself
+        **Parameters**
+        - d: date or date string with format 'yyyy-mm-dd'
+        **Returns**: date
+        **Example**
+        from cnexchcal import ExchCal
+        cal = ExchCal()
+        cal.nextsession('2025-12-31')  # 2026-01-05
+        '''
+        if isinstance(d, str):
+             d = date.fromisoformat(d)
+        assert dmin <= d <= dmax, 'd is out of range'
+        i = 0
+        while (dd := d + timedelta(days = i)) < dmax:
+            if self.issession(dd):
+                return dd
+            i += 1
+        raise ValueError('next session is out of range')
+    def previoussession(self, d: date | str) -> date:
+        '''
+        Previous trading date. If d itself is a trading day, return d itself
+        **Parameters**
+        - d: date or date string with format 'yyyy-mm-dd'
+        **Returns**: date
+        **Example**
+        from cnexchcal import ExchCal
+        cal = ExchCal()
+        cal.previoussession('2026-01-05')  # 2025-12-31
+        '''
+        if isinstance(d, str):
+            d = date.fromisoformat(d)
+        assert dmin <= d <= dmax, 'd is out of range'
+        i = 0
+        while (dd := d - timedelta(days = i)) > dmin:
+            if self.issession(dd):
+                return dd
+            i += 1
+        raise ValueError('previous session is out of range')
+    def trade_date_range(self, d1: date | str, d2: date | str, closed: str = 'both') -> list[date]:
+        '''
+        all trading days between d1 and d2
+        **Parameters**
+        - d1, d2: date or date string with format 'yyyy-mm-dd'
+        - closed: 'both', 'left' or 'right'
+        **Returns**: list of date
+        **Example**
+        from cnexchcal import ExchCal
+        cal = ExchCal()
+        cal.trade_date_range('2025-12-29', '2026-01-05', closed = 'left')
+        '''
+        if isinstance(d1, str):
+            d1 = date.fromisoformat(d1)
+        if isinstance(d2, str):
+            d2 = date.fromisoformat(d2)
+        if d1 > d2:
+            d1, d2 = d2, d1
+        assert closed.lower() in ('both', 'left', 'right'), 'value of closed can ONLY be one of "both", "left" or "right"'
+        if closed == 'left':
+            d2 -= timedelta(days = 1)
+        elif closed == 'right':
+            d1 += timedelta(days = 1)
+        assert dmin <= d1 <= dmax, 'd1 is out of range'
+        assert dmin <= d2 <= dmax, 'd2 is out of range'
+        return [d for d in pl.date_range(d1, d2, eager = True) if self.issession(d)]
+    def next_nth_tradingday(self, d: date | str, n: int) -> date:
+        '''
+        Next n-th trading day after the given date d. d itself can be a non-trading day
+        **Parameters**
+        - d: date or date string with format 'yyyy-mm-dd'
+        - n: int
+        **Returns**: date
+        **Example**
+        from cnexchcal import ExchCal
+        cal = ExchCal()
+        cal.next_nth_tradingday('2025-12-31', 3)
+        '''
+        if isinstance(d, str):
+            d = date.fromisoformat(d)
+        i, j = 0, 1
+        while i < n:
+            dd = d + timedelta(days = j)
+            if self.issession(dd):
+                i += 1
+            j += 1
+        return (d + timedelta(days = j - 1))

cnexchcal/asset/extra_holidays.csv ADDED Viewed

@@ -0,0 +1,4 @@
+不属于调休而形成的周末工作日、交易所额外放假; weekday: 0 (Sun), 1 (Mon), ... 6 (Sat)
+数据来源: 交易所官网; 如上交所于 2023-12-26 发布了 2024 年休市安排
+date,week_day,enname,cnname
+2024-02-09,5,Spring Festival,春节

cnexchcal/asset/festivals.csv ADDED Viewed

@@ -0,0 +1,259 @@
+pure holidays since year 2004, excluding weekends and in-lieu days (双休日调休形成的 quasi holidays); weekday: 0 (Sun), 1 (Mon), ... 6 (Sat)
+holiday schedule will update in Nov. each year
+date,week_day,enname,cnname
+2004-01-01,4,New Year's Day,元旦
+2004-01-22,4,Spring Festival,春节
+2004-01-23,5,Spring Festival,春节
+2004-01-26,1,Spring Festival,春节
+2004-05-03,1,Labour Day,劳动节
+2004-05-04,2,Labour Day,劳动节
+2004-05-05,3,Labour Day,劳动节
+2004-10-01,5,National Day,国庆节
+2004-10-04,1,National Day,国庆节
+2004-10-05,2,National Day,国庆节
+2005-01-03,1,New Year's Day,元旦
+2005-02-09,3,Spring Festival,春节
+2005-02-10,4,Spring Festival,春节
+2005-02-11,5,Spring Festival,春节
+2005-05-02,1,Labour Day,劳动节
+2005-05-03,2,Labour Day,劳动节
+2005-05-04,3,Labour Day,劳动节
+2005-10-03,1,National Day,国庆节
+2005-10-04,2,National Day,国庆节
+2005-10-05,3,National Day,国庆节
+2006-01-02,1,New Year's Day,元旦
+2006-01-03,2,New Year's Day,元旦
+2006-01-30,1,Spring Festival,春节
+2006-01-31,2,Spring Festival,春节
+2006-02-01,3,Spring Festival,春节
+2006-05-01,1,Labour Day,劳动节
+2006-05-02,2,Labour Day,劳动节
+2006-05-03,3,Labour Day,劳动节
+2006-10-02,1,National Day,国庆节
+2006-10-03,2,National Day,国庆节
+2006-10-04,3,National Day,国庆节
+2007-01-01,1,New Year's Day,元旦
+2007-02-19,1,Spring Festival,春节
+2007-02-20,2,Spring Festival,春节
+2007-02-21,3,Spring Festival,春节
+2007-05-01,2,Labour Day,劳动节
+2007-05-02,3,Labour Day,劳动节
+2007-05-03,4,Labour Day,劳动节
+2007-10-01,1,National Day,国庆节
+2007-10-02,2,National Day,国庆节
+2007-10-03,3,National Day,国庆节
+2008-01-01,2,New Year's Day,元旦
+2008-02-06,3,Spring Festival,春节
+2008-02-07,4,Spring Festival,春节
+2008-02-08,5,Spring Festival,春节
+2008-04-04,5,Tomb-sweeping Day,清明
+2008-05-01,4,Labour Day,劳动节
+2008-06-09,1,Dragon Boat Festival,端午
+2008-09-15,1,Mid-autumn Festival,中秋
+2008-10-01,3,National Day,国庆节
+2008-10-02,4,National Day,国庆节
+2008-10-03,5,National Day,国庆节
+2009-01-01,4,New Year's Day,元旦
+2009-01-26,1,Spring Festival,春节
+2009-01-27,2,Spring Festival,春节
+2009-01-28,3,Spring Festival,春节
+2009-04-06,1,Tomb-sweeping Day,清明
+2009-05-01,5,Labour Day,劳动节
+2009-05-28,4,Dragon Boat Festival,端午
+2009-10-01,4,National Day,国庆节
+2009-10-02,5,National Day,国庆节
+2009-10-05,1,National Day,国庆节
+2009-10-06,2,National Day,国庆节
+2010-01-01,5,New Year's Day,元旦
+2010-02-15,1,Spring Festival,春节
+2010-02-16,2,Spring Festival,春节
+2010-02-17,3,Spring Festival,春节
+2010-04-05,1,Tomb-sweeping Day,清明
+2010-05-03,1,Labour Day,劳动节
+2010-06-16,3,Dragon Boat Festival,端午
+2010-09-22,3,Mid-autumn Festival,中秋
+2010-10-01,5,National Day,国庆节
+2010-10-04,1,National Day,国庆节
+2010-10-05,2,National Day,国庆节
+2011-01-03,1,New Year's Day,元旦
+2011-02-02,3,Spring Festival,春节
+2011-02-03,4,Spring Festival,春节
+2011-02-04,5,Spring Festival,春节
+2011-04-05,2,Tomb-sweeping Day,清明
+2011-05-02,1,Labour Day,劳动节
+2011-06-06,1,Dragon Boat Festival,端午
+2011-09-12,1,Mid-autumn Festival,中秋
+2011-10-03,1,National Day,国庆节
+2011-10-04,2,National Day,国庆节
+2011-10-05,3,National Day,国庆节
+2012-01-02,1,New Year's Day,元旦
+2012-01-23,1,Spring Festival,春节
+2012-01-24,2,Spring Festival,春节
+2012-01-25,3,Spring Festival,春节
+2012-04-04,3,Tomb-sweeping Day,清明
+2012-05-01,2,Labour Day,劳动节
+2012-06-22,5,Dragon Boat Festival,端午
+2012-10-01,1,National Day,国庆节
+2012-10-02,2,National Day,国庆节
+2012-10-03,3,National Day,国庆节
+2012-10-04,4,National Day,国庆节
+2013-01-01,2,New Year's Day,元旦
+2013-02-11,1,Spring Festival,春节
+2013-02-12,2,Spring Festival,春节
+2013-02-13,3,Spring Festival,春节
+2013-04-04,4,Tomb-sweeping Day,清明
+2013-05-01,3,Labour Day,劳动节
+2013-06-12,3,Dragon Boat Festival,端午
+2013-09-19,4,Mid-autumn Festival,中秋
+2013-10-01,2,National Day,国庆节
+2013-10-02,3,National Day,国庆节
+2013-10-03,4,National Day,国庆节
+2014-01-01,3,New Year's Day,元旦
+2014-01-31,5,Spring Festival,春节
+2014-02-03,1,Spring Festival,春节
+2014-02-04,2,Spring Festival,春节
+2014-04-07,1,Tomb-sweeping Day,清明
+2014-05-01,4,Labour Day,劳动节
+2014-06-02,1,Dragon Boat Festival,端午
+2014-09-08,1,Mid-autumn Festival,中秋
+2014-10-01,3,National Day,国庆节
+2014-10-02,4,National Day,国庆节
+2014-10-03,5,National Day,国庆节
+2015-01-01,4,New Year's Day,元旦
+2015-02-18,3,Spring Festival,春节
+2015-02-19,4,Spring Festival,春节
+2015-02-20,5,Spring Festival,春节
+2015-04-06,1,Tomb-sweeping Day,清明
+2015-05-01,5,Labour Day,劳动节
+2015-06-22,1,Dragon Boat Festival,端午
+2015-09-03,4,Anti-Fascist 70th Day,中国人民抗日战争暨世界反法西斯战争胜利70周年纪念日
+2015-10-01,4,National Day,国庆节
+2015-10-02,5,National Day,国庆节
+2015-10-05,1,National Day,国庆节
+2015-10-06,2,National Day,国庆节
+2016-01-01,5,New Year's Day,元旦
+2016-02-08,1,Spring Festival,春节
+2016-02-09,2,Spring Festival,春节
+2016-02-10,3,Spring Festival,春节
+2016-04-04,1,Tomb-sweeping Day,清明
+2016-05-02,1,Labour Day,劳动节
+2016-06-09,4,Dragon Boat Festival,端午
+2016-09-15,4,Mid-autumn Festival,中秋
+2016-10-03,1,National Day,国庆节
+2016-10-04,2,National Day,国庆节
+2016-10-05,3,National Day,国庆节
+2017-01-02,1,New Year's Day,元旦
+2017-01-27,5,Spring Festival,春节
+2017-01-30,1,Spring Festival,春节
+2017-01-31,2,Spring Festival,春节
+2017-04-04,2,Tomb-sweeping Day,清明
+2017-05-01,1,Labour Day,劳动节
+2017-05-30,2,Dragon Boat Festival,端午
+2017-10-02,1,National Day,国庆节
+2017-10-03,2,National Day,国庆节
+2017-10-04,3,Mid-autumn Festival,中秋
+2017-10-05,4,National Day,国庆节
+2018-01-01,1,New Year's Day,元旦
+2018-02-15,4,Spring Festival,春节
+2018-02-16,5,Spring Festival,春节
+2018-04-05,4,Tomb-sweeping Day,清明
+2018-05-01,2,Labour Day,劳动节
+2018-06-18,1,Dragon Boat Festival,端午
+2018-09-24,1,Mid-autumn Festival,中秋
+2018-10-01,1,National Day,国庆节
+2018-10-02,2,National Day,国庆节
+2018-10-03,3,National Day,国庆节
+2019-01-01,2,New Year's Day,元旦
+2019-02-05,2,Spring Festival,春节
+2019-02-06,3,Spring Festival,春节
+2019-02-07,4,Spring Festival,春节
+2019-04-05,5,Tomb-sweeping Day,清明
+2019-05-01,3,Labour Day,劳动节
+2019-06-07,5,Dragon Boat Festival,端午
+2019-09-13,5,Mid-autumn Festival,中秋
+2019-10-01,2,National Day,国庆节
+2019-10-02,3,National Day,国庆节
+2019-10-03,4,National Day,国庆节
+2020-01-01,3,New Year's Day,元旦
+2020-01-24,5,Spring Festival,春节
+2020-01-27,1,Spring Festival,春节
+2020-01-28,2,Spring Festival,春节
+2020-01-30,4,Spring Festival,春节
+2020-01-31,5,Spring Festival,春节
+2020-04-06,1,Tomb-sweeping Day,清明
+2020-05-01,5,Labour Day,劳动节
+2020-06-25,4,Dragon Boat Festival,端午
+2020-10-01,4,National Day,国庆节
+2020-10-02,5,National Day,国庆节
+2020-10-05,1,National Day,国庆节
+2020-10-06,2,National Day,国庆节
+2021-01-01,5,New Year's Day,元旦
+2021-02-11,4,Spring Festival,春节
+2021-02-12,5,Spring Festival,春节
+2021-02-15,1,Spring Festival,春节
+2021-04-05,1,Tomb-sweeping Day,清明
+2021-05-03,1,Labour Day,劳动节
+2021-06-14,1,Dragon Boat Festival,端午
+2021-09-21,2,Mid-autumn Festival,中秋
+2021-10-01,5,National Day,国庆节
+2021-10-04,1,National Day,国庆节
+2021-10-05,2,National Day,国庆节
+2022-01-03,1,New Year's Day,元旦
+2022-01-31,1,Spring Festival,春节
+2022-02-01,2,Spring Festival,春节
+2022-02-02,3,Spring Festival,春节
+2022-04-05,2,Tomb-sweeping Day,清明
+2022-05-02,1,Labour Day,劳动节
+2022-06-03,5,Dragon Boat Festival,端午
+2022-09-12,1,Mid-autumn Festival,中秋
+2022-10-03,1,National Day,国庆节
+2022-10-04,2,National Day,国庆节
+2022-10-05,3,National Day,国庆节
+2023-01-02,1,New Year's Day,元旦
+2023-01-23,1,Spring Festival,春节
+2023-01-24,2,Spring Festival,春节
+2023-01-25,3,Spring Festival,春节
+2023-04-05,3,Tomb-sweeping Day,清明
+2023-05-01,1,Labour Day,劳动节
+2023-06-22,4,Dragon Boat Festival,端午
+2023-09-29,5,Mid-autumn Festival,中秋
+2023-10-02,1,National Day,国庆节
+2023-10-03,2,National Day,国庆节
+2023-10-04,3,National Day,国庆节
+2024-01-01,1,New Year's Day,元旦
+2024-02-12,1,Spring Festival,春节
+2024-02-13,2,Spring Festival,春节
+2024-02-14,3,Spring Festival,春节
+2024-04-04,4,Tomb-sweeping Day,清明
+2024-05-01,3,Labour Day,劳动节
+2024-06-10,1,Dragon Boat Festival,端午
+2024-09-17,2,Mid-autumn Festival,中秋
+2024-10-01,2,National Day,国庆节
+2024-10-02,3,National Day,国庆节
+2024-10-03,4,National Day,国庆节
+2025-01-01,3,New Year's Day,元旦
+2025-01-28,2,Spring Festival,春节
+2025-01-29,3,Spring Festival,春节
+2025-01-30,4,Spring Festival,春节
+2025-01-31,5,Spring Festival,春节
+2025-04-04,5,Tomb-sweeping Day,清明
+2025-05-01,4,Labour Day,劳动节
+2025-05-02,5,Labour Day,劳动节
+2025-06-02,1,Dragon Boat Festival,端午
+2025-10-01,3,National Day,国庆节
+2025-10-02,4,National Day,国庆节
+2025-10-03,5,National Day,国庆节
+2025-10-06,1,Mid-autumn Festival,中秋
+2026-01-01,4,New Year's Day,元旦
+2026-02-16,1,Spring Festival,春节
+2026-02-17,2,Spring Festival,春节
+2026-02-18,3,Spring Festival,春节
+2026-02-19,4,Spring Festival,春节
+2026-04-06,1,Tomb-sweeping Day,清明
+2026-05-01,5,Labour Day,劳动节
+2026-05-04,1,Labour Day,劳动节
+2026-06-19,5,Dragon Boat Festival,端午
+2026-09-25,5,Mid-autumn Festival,中秋
+2026-10-01,4,National Day,国庆节
+2026-10-02,5,National Day,国庆节
+2026-10-05,1,National Day,国庆节

cnexchcal/asset/quasi_holidays.csv ADDED Viewed

@@ -0,0 +1,154 @@
+quasi-holidays (由双休日调休形成、于非双休日的准假日) since year 2004; weekday: 0 (Sun), 1 (Mon), ... 6 (Sat)
+节假日安排由国务院发布，一般每年11月前后发布，请及时更新数据
+date,week_day,enname,cnname
+2004-01-27,2,Spring Festival,春节
+2004-01-28,3,Spring Festival,春节
+2004-05-06,4,Labour Day,劳动节
+2004-05-07,5,Labour Day,劳动节
+2004-10-06,3,National Day,国庆节
+2004-10-07,4,National Day,国庆节
+2005-02-14,1,Spring Festival,春节
+2005-02-15,2,Spring Festival,春节
+2005-05-05,4,Labour Day,劳动节
+2005-05-06,5,Labour Day,劳动节
+2005-10-06,4,National Day,国庆节
+2005-10-07,5,National Day,国庆节
+2006-02-02,4,Spring Festival,春节
+2006-02-03,5,Spring Festival,春节
+2006-05-04,4,Labour Day,劳动节
+2006-05-05,5,Labour Day,劳动节
+2006-10-05,4,National Day,国庆节
+2006-10-06,5,National Day,国庆节
+2007-01-02,2,New Year's Day,元旦
+2007-01-03,3,New Year's Day,元旦
+2007-02-22,4,Spring Festival,春节
+2007-02-23,5,Spring Festival,春节
+2007-05-04,5,Labour Day,劳动节
+2007-05-07,1,Labour Day,劳动节
+2007-10-04,4,National Day,国庆节
+2007-10-05,5,National Day,国庆节
+2007-12-31,1,New Year's Day,元旦
+2008-02-11,1,Spring Festival,春节
+2008-02-12,2,Spring Festival,春节
+2008-05-02,5,Labour Day,劳动节
+2008-09-29,1,National Day,国庆节
+2008-09-30,2,National Day,国庆节
+2009-01-02,5,New Year's Day,元旦
+2009-01-29,4,Spring Festival,春节
+2009-01-30,5,Spring Festival,春节
+2009-05-29,5,Dragon Boat Festival,端午
+2009-10-07,3,National Day,国庆节
+2009-10-08,4,National Day,国庆节
+2010-02-18,4,Spring Festival,春节
+2010-02-19,5,Spring Festival,春节
+2010-06-14,1,Dragon Boat Festival,端午
+2010-06-15,2,Dragon Boat Festival,端午
+2010-09-23,4,Mid-autumn Festival,中秋
+2010-09-24,5,Mid-autumn Festival,中秋
+2010-10-06,3,National Day,国庆节
+2010-10-07,4,National Day,国庆节
+2011-02-07,1,Spring Festival,春节
+2011-02-08,2,Spring Festival,春节
+2011-04-04,1,Tomb-sweeping Day,清明
+2011-10-06,4,National Day,国庆节
+2011-10-07,5,National Day,国庆节
+2012-01-03,2,New Year's Day,元旦
+2012-01-26,4,Spring Festival,春节
+2012-01-27,5,Spring Festival,春节
+2012-04-02,1,Tomb-sweeping Day,清明
+2012-04-03,2,Tomb-sweeping Day,清明
+2012-04-30,1,Labour Day,劳动节
+2012-10-05,5,National Day,国庆节
+2013-01-02,3,New Year's Day,元旦
+2013-01-03,4,New Year's Day,元旦
+2013-02-14,4,Spring Festival,春节
+2013-02-15,5,Spring Festival,春节
+2013-04-05,5,Tomb-sweeping Day,清明
+2013-04-29,1,Labour Day,劳动节
+2013-04-30,2,Labour Day,劳动节
+2013-06-10,1,Dragon Boat Festival,端午
+2013-06-11,2,Dragon Boat Festival,端午
+2013-09-20,5,Mid-autumn Festival,中秋
+2013-10-04,5,National Day,国庆节
+2013-10-07,1,National Day,国庆节
+2014-02-05,3,Spring Festival,春节
+2014-02-06,4,Spring Festival,春节
+2014-05-02,5,Labour Day,劳动节
+2014-10-06,1,National Day,国庆节
+2014-10-07,2,National Day,国庆节
+2015-01-02,5,New Year's Day,元旦
+2015-02-23,1,Spring Festival,春节
+2015-02-24,2,Spring Festival,春节
+2015-09-04,5,Anti-Fascist 70th Day,中国人民抗日战争暨世界反法西斯战争胜利70周年纪念日
+2015-10-07,3,National Day,国庆节
+2016-02-11,4,Spring Festival,春节
+2016-02-12,5,Spring Festival,春节
+2016-06-10,5,Dragon Boat Festival,端午
+2016-09-16,5,Mid-autumn Festival,中秋
+2016-10-06,4,National Day,国庆节
+2016-10-07,5,National Day,国庆节
+2017-02-01,3,Spring Festival,春节
+2017-02-02,4,Spring Festival,春节
+2017-04-03,1,Tomb-sweeping Day,清明
+2017-05-29,1,Dragon Boat Festival,端午
+2017-10-06,5,National Day,国庆节
+2018-02-19,1,Spring Festival,春节
+2018-02-20,2,Spring Festival,春节
+2018-02-21,3,Spring Festival,春节
+2018-04-06,5,Tomb-sweeping Day,清明
+2018-04-30,1,Labour Day,劳动节
+2018-10-04,4,National Day,国庆节
+2018-10-05,5,National Day,国庆节
+2018-12-31,1,New Year's Day,元旦
+2019-02-04,1,Spring Festival,春节
+2019-02-08,5,Spring Festival,春节
+2019-05-02,4,Labour Day,劳动节
+2019-05-03,5,Labour Day,劳动节
+2019-10-04,5,National Day,国庆节
+2019-10-07,1,National Day,国庆节
+2020-01-29,3,Spring Festival,春节
+2020-05-04,1,Labour Day,劳动节
+2020-05-05,2,Labour Day,劳动节
+2020-06-26,5,Dragon Boat Festival,端午
+2020-10-07,3,National Day,国庆节
+2020-10-08,4,National Day,国庆节
+2021-02-16,2,Spring Festival,春节
+2021-02-17,3,Spring Festival,春节
+2021-05-04,2,Labour Day,劳动节
+2021-05-05,3,Labour Day,劳动节
+2021-09-20,1,Mid-autumn Festival,中秋
+2021-10-06,3,National Day,国庆节
+2021-10-07,4,National Day,国庆节
+2022-02-03,4,Spring Festival,春节
+2022-02-04,5,Spring Festival,春节
+2022-04-04,1,Tomb-sweeping Day,清明
+2022-05-03,2,Labour Day,劳动节
+2022-05-04,3,Labour Day,劳动节
+2022-10-06,4,National Day,国庆节
+2022-10-07,5,National Day,国庆节
+2023-01-26,4,Spring Festival,春节
+2023-01-27,5,Spring Festival,春节
+2023-05-02,2,Labour Day,劳动节
+2023-05-03,3,Labour Day,劳动节
+2023-06-23,5,Dragon Boat Festival,端午
+2023-10-05,4,National Day,国庆节
+2023-10-06,5,National Day,国庆节
+2024-02-15,4,Spring Festival,春节
+2024-02-16,5,Spring Festival,春节
+2024-04-05,5,Tomb-sweeping Day,清明
+2024-05-02,4,Labour Day,劳动节
+2024-05-03,5,Labour Day,劳动节
+2024-09-16,1,Mid-autumn Festival,中秋
+2024-10-04,5,National Day,国庆节
+2024-10-07,1,National Day,国庆节
+2025-02-03,1,Spring Festival,春节
+2025-02-04,2,Spring Festival,春节
+2025-05-05,1,Labour Day,劳动节
+2025-10-07,2,National Day,国庆节
+2025-10-08,3,National Day,国庆节
+2026-01-02,5,New Year's Day,元旦
+2026-02-20,5,Spring Festival,春节
+2026-02-23,1,Spring Festival,春节
+2026-05-05,2,Labour Day,劳动节
+2026-10-06,2,National Day,国庆节
+2026-10-07,3,National Day,国庆节

cnexchcal/asset/weekend_workdays.csv ADDED Viewed

@@ -0,0 +1,153 @@
+workdays in weekends (双休日调休形成的于双休日工作的工作日) since year 2004; weekday: 0 (Sun), 1 (Mon), ... 6 (Sat)
+节假日安排由国务院发布，一般每年11月前后发布，请及时更新数据
+date,week_day,enname,cnname
+2004-01-17,6,Spring Festival,春节
+2004-01-18,0,Spring Festival,春节
+2004-05-08,6,Labour Day,劳动节
+2004-05-09,0,Labour Day,劳动节
+2004-10-09,6,National Day,国庆节
+2004-10-10,0,National Day,国庆节
+2005-02-05,6,Spring Festival,春节
+2005-02-06,0,Spring Festival,春节
+2005-04-30,6,Labour Day,劳动节
+2005-05-08,0,Labour Day,劳动节
+2005-10-08,6,National Day,国庆节
+2005-10-09,0,National Day,国庆节
+2006-01-28,6,Spring Festival,春节
+2006-02-05,0,Spring Festival,春节
+2006-04-29,6,Labour Day,劳动节
+2006-04-30,0,Labour Day,劳动节
+2006-09-30,6,National Day,国庆节
+2006-10-08,0,National Day,国庆节
+2006-12-30,6,New Year's Day,元旦
+2006-12-31,0,New Year's Day,元旦
+2007-02-17,6,Spring Festival,春节
+2007-02-25,0,Spring Festival,春节
+2007-04-28,6,Labour Day,劳动节
+2007-04-29,0,Labour Day,劳动节
+2007-09-29,6,National Day,国庆节
+2007-09-30,0,National Day,国庆节
+2007-12-29,6,New Year's Day,元旦
+2008-02-02,6,Spring Festival,春节
+2008-02-03,0,Spring Festival,春节
+2008-05-04,0,Labour Day,劳动节
+2008-09-27,6,National Day,国庆节
+2008-09-28,0,National Day,国庆节
+2009-01-04,0,New Year's Day,元旦
+2009-01-24,6,Spring Festival,春节
+2009-02-01,0,Spring Festival,春节
+2009-05-31,0,Dragon Boat Festival,端午
+2009-09-27,0,National Day,国庆节
+2009-10-10,6,National Day,国庆节
+2010-02-20,6,Spring Festival,春节
+2010-02-21,0,Spring Festival,春节
+2010-06-12,6,Dragon Boat Festival,端午
+2010-06-13,0,Dragon Boat Festival,端午
+2010-09-19,0,Mid-autumn Festival,中秋
+2010-09-25,6,Mid-autumn Festival,中秋
+2010-09-26,0,National Day,国庆节
+2010-10-09,6,National Day,国庆节
+2011-01-30,0,Spring Festival,春节
+2011-02-12,6,Spring Festival,春节
+2011-04-02,6,Tomb-sweeping Day,清明
+2011-10-08,6,National Day,国庆节
+2011-10-09,0,National Day,国庆节
+2011-12-31,6,New Year's Day,元旦
+2012-01-21,6,Spring Festival,春节
+2012-01-29,0,Spring Festival,春节
+2012-03-31,6,Tomb-sweeping Day,清明
+2012-04-01,0,Tomb-sweeping Day,清明
+2012-04-28,6,Labour Day,劳动节
+2012-09-29,6,National Day,国庆节
+2013-01-05,6,New Year's Day,元旦
+2013-01-06,0,New Year's Day,元旦
+2013-02-16,6,Spring Festival,春节
+2013-02-17,0,Spring Festival,春节
+2013-04-07,0,Tomb-sweeping Day,清明
+2013-04-27,6,Labour Day,劳动节
+2013-04-28,0,Labour Day,劳动节
+2013-06-08,6,Dragon Boat Festival,端午
+2013-06-09,0,Dragon Boat Festival,端午
+2013-09-22,0,Mid-autumn Festival,中秋
+2013-09-29,0,National Day,国庆节
+2013-10-12,6,National Day,国庆节
+2014-01-26,0,Spring Festival,春节
+2014-02-08,6,Spring Festival,春节
+2014-05-04,0,Labour Day,劳动节
+2014-09-28,0,National Day,国庆节
+2014-10-11,6,National Day,国庆节
+2015-01-04,0,New Year's Day,元旦
+2015-02-15,0,Spring Festival,春节
+2015-02-28,6,Spring Festival,春节
+2015-09-06,0,Anti-Fascist 70th Day,中国人民抗日战争暨世界反法西斯战争胜利70周年纪念日
+2015-10-10,6,National Day,国庆节
+2016-02-06,6,Spring Festival,春节
+2016-02-14,0,Spring Festival,春节
+2016-06-12,0,Dragon Boat Festival,端午
+2016-09-18,0,Mid-autumn Festival,中秋
+2016-10-08,6,National Day,国庆节
+2016-10-09,0,National Day,国庆节
+2017-01-22,0,Spring Festival,春节
+2017-02-04,6,Spring Festival,春节
+2017-04-01,6,Tomb-sweeping Day,清明
+2017-05-27,6,Dragon Boat Festival,端午
+2017-09-30,6,National Day,国庆节
+2018-02-11,0,Spring Festival,春节
+2018-02-24,6,Spring Festival,春节
+2018-04-08,0,Tomb-sweeping Day,清明
+2018-04-28,6,Labour Day,劳动节
+2018-09-29,6,National Day,国庆节
+2018-09-30,0,National Day,国庆节
+2018-12-29,6,New Year's Day,元旦
+2019-02-02,6,Spring Festival,春节
+2019-02-03,0,Spring Festival,春节
+2019-04-28,0,Labour Day,劳动节
+2019-05-05,0,Labour Day,劳动节
+2019-09-29,0,National Day,国庆节
+2019-10-12,6,National Day,国庆节
+2020-01-19,0,Spring Festival,春节
+2020-04-26,0,Labour Day,劳动节
+2020-05-09,6,Labour Day,劳动节
+2020-06-28,0,Dragon Boat Festival,端午
+2020-09-27,0,National Day,国庆节
+2020-10-10,6,National Day,国庆节
+2021-02-07,0,Spring Festival,春节
+2021-02-20,6,Spring Festival,春节
+2021-04-25,0,Labour Day,劳动节
+2021-05-08,6,Labour Day,劳动节
+2021-09-18,6,Mid-autumn Festival,中秋
+2021-09-26,0,National Day,国庆节
+2021-10-09,6,National Day,国庆节
+2022-01-29,6,Spring Festival,春节
+2022-01-30,0,Spring Festival,春节
+2022-04-02,6,Tomb-sweeping Day,清明
+2022-04-24,0,Labour Day,劳动节
+2022-05-07,6,Labour Day,劳动节
+2022-10-08,6,National Day,国庆节
+2022-10-09,0,National Day,国庆节
+2023-01-28,6,Spring Festival,春节
+2023-01-29,0,Spring Festival,春节
+2023-04-23,0,Labour Day,劳动节
+2023-05-06,6,Labour Day,劳动节
+2023-06-25,0,Dragon Boat Festival,端午
+2023-10-07,6,National Day,国庆节
+2023-10-08,0,National Day,国庆节
+2024-02-04,0,Spring Festival,春节
+2024-02-18,0,Spring Festival,春节
+2024-04-07,0,Tomb-sweeping Day,清明
+2024-04-28,0,Labour Day,劳动节
+2024-05-11,6,Labour Day,劳动节
+2024-09-14,6,Mid-autumn Festival,中秋
+2024-09-29,0,National Day,国庆节
+2024-10-12,6,National Day,国庆节
+2025-01-26,0,Spring Festival,春节
+2025-02-08,6,Spring Festival,春节
+2025-04-27,0,Labour Day,劳动节
+2025-09-28,0,National Day,国庆节
+2025-10-11,6,National Day,国庆节
+2026-01-04,0,New Year's Day,元旦
+2026-02-14,6,Spring Festival,春节
+2026-02-28,6,Spring Festival,春节
+2026-05-09,6,Labour Day,劳动节
+2026-09-20,0,National Day,国庆节
+2026-10-10,6,National Day,国庆节

cnexchcal-0.2.0.dist-info/METADATA ADDED Viewed

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: cnexchcal
+Version: 0.2.0
+Summary: Exchange Calendars: issession, trade_date_range
+Author-email: rhozhang <rhozhang@163.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/rhozhang/cnexchcal
+Project-URL: Issues, https://github.com/rhozhang/cnexchcal/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: polars
+Dynamic: license-file
+# Holidays in China
+## Background
+We classify calendar days into:
+- regular workdays
+- regular weekends (Saturday and Sunday) not working
+- festivals: true or legal holidays
+- quasi-holidays: extra holidays swapped with weekend workdays
+- weekend workdays：workdays in weekends for swapped extra holidays
+For example, 2025-12-31 (Wednesday) is a regular workday.
+2025-01-01 (Thursday) is a festival holiday (New Year)
+2025-01-02 (Friday) is a quasi-holiday, though we need not to work on this day, but we need to work on 2026-01-04 (Sunday) to swap with this extra holiday.
+2025-01-03 (Saturday) is a regular weekend.
+2025-01-04 (Sunday) is a weekend workday. Though it a weekend, but we to work on this day to swap with extra extra holiday on 2025-01-02.
+On weekend workdays, exchanges in China mainland are closed, although they are workdays.
+In November each year, the state council of China announces the holiday arrangement for next year. Please update the holiday data accordingly.
+## cnexchcal Package
+This package provides a class to handle holidays and trading days in China mainland since year 2004. We does not touch holidays before 2004.
+### Installation
+```
+pip install cnexchcal
+```
+### Usage
+**Instantiation**:
+```
+from cnexchcal import ExchCal
+cal = ExchCal()
+```
+To return holiday names in Chinese or English
+```
+cal.holiday_cnnames
+cal.holiday_ennames
+```
+To determine if a given date is a holiday or workday, uese:
+```
+cal.isholiday('2026-01-04')   # False
+cal.isworkday('2026-01-04')   # True
+```
+To determine if a given date is a trading day:
+```
+cal.issession('2026-01-04')   # False
+```
+To get the previous trading day, use:
+```
+cal.previoussession('2026-01-04')   # 2025-12-31
+```
+To get the next trading day, use:
+```
+cal.nextsession('2026-01-01')   # 2026-01-05
+```
+To get the n-th trading day after a given date, use:
+```
+cal.next_nth_tradingday('2026-01-01', 3)   # 2026-01-07
+```
+To get all trading dates between two given dates, use:
+```
+cal.trade_date_range('2025-12-20', '2026-02-28')
+```

cnexchcal-0.2.0.dist-info/RECORD ADDED Viewed

@@ -0,0 +1,10 @@
+cnexchcal/__init__.py,sha256=20gXKRE8QFFrJiIDsI7GQgzXgRTXvMAWHpbWd_sPRxs,7233
+cnexchcal/asset/extra_holidays.csv,sha256=RVzbjvBiAjzNWG9WWJ2WF6P3yMBglIGfqPIRrIogvQM,260
+cnexchcal/asset/festivals.csv,sha256=KidVzbPPvzLujmLPZ6SNEwhSjkBZFHfANK7YrgPpjmA,9617
+cnexchcal/asset/quasi_holidays.csv,sha256=R51aum52Nk0by95_D_BVIsnQ7igqNQgZRjcTEG4jC6g,5775
+cnexchcal/asset/weekend_workdays.csv,sha256=Tab-jOsJqknLHSONVcQXwV4sudDuhThIWDOjfZR66Fw,5745
+cnexchcal-0.2.0.dist-info/licenses/LICENSE,sha256=JFbY5Il4KtG4sBGRX8oWh0NWBLINbIQ4-OyMypndAsY,1065
+cnexchcal-0.2.0.dist-info/METADATA,sha256=QSJMb5Xw3huKARsqj75EE27fmnqpYZ4iINv3WyM5HPI,2687
+cnexchcal-0.2.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+cnexchcal-0.2.0.dist-info/top_level.txt,sha256=_Lq7KZO5X7tbgt1izKmLVgbuC4hXXFZSNRMZT8McTKE,10
+cnexchcal-0.2.0.dist-info/RECORD,,

cnexchcal-0.2.0.dist-info/WHEEL ADDED Viewed

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any

cnexchcal-0.2.0.dist-info/licenses/LICENSE ADDED Viewed

@@ -0,0 +1,21 @@
+MIT License
+Copyright (c) 2025 RhoZhang
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cnexchcal-0.2.0.dist-info/top_level.txt ADDED Viewed

	@@ -0,0 +1 @@
1	+ cnexchcal