chrono icon indicating copy to clipboard operation
chrono copied to clipboard

Add “China Working Days Only” Repeat Option (Exclude Chinese Public Holidays)

Open m8458246 opened this issue 9 months ago • 1 comments

Background & Motivation

Currently Chrono supports repeat options like “Every Day,” “Weekdays (Mon–Fri),” and “Weekends.” However, for users in China it’s desirable to also skip alarms on national public holidays (e.g. Spring Festival, National Day), even when they fall on a weekday.

Use case: Avoid being disturbed by alarms during official holidays when you’re off work or traveling.

Goal: Provide an option that only triggers alarms on true Chinese working days.

Proposed Solution

  1. New Repeat Option

Add a “China Working Days Only” (or “Chinese Business Days”) entry alongside the existing repeat presets.

  1. Holiday Data Source

Integrate an open-source Chinese holiday library (for example, holiday-cn).

Alternatively, support a configurable API (e.g. Alibaba Cloud Holiday API) for fetching the official holiday calendar.

  1. Trigger Logic

When “China Working Days Only” is selected, compute the next alarm dates:

If the date is a Monday–Friday and not listed as a public holiday, schedule the alarm.

Otherwise, skip to the next eligible date.

  1. UI/UX

In the Repeat dialog, display the new option with a clear label or icon.

Optionally provide a “Holiday List Sync” toggle in Settings to keep holiday data up to date (manual or automatic).

Acceptance Criteria

  • A “China Working Days Only” option appears in the Repeat settings.
  • Alarms set with this option fire only on weekdays that are not official Chinese public holidays.
  • Holiday data can be updated via a built-in mechanism (manual refresh or scheduled sync).

Additional Context

Chinese public holidays typically include New Year’s Day, Spring Festival, Tomb-Sweeping Day, Labor Day, Dragon Boat Festival, Mid-Autumn Festival, National Day, etc., and the exact dates (including any “make-up” weekends) vary each year. Please include both English and Simplified Chinese labels if localization files are used.

Thank you for your hard work on Chrono! This feature will help Chinese users keep their alarms precise and hassle-free.

m8458246 avatar May 29 '25 02:05 m8458246

It is best to display this option only when the language is Chinese, but this function is really important for Chinese.

fdfvrgsergvxnjkdgbbn avatar Oct 04 '25 17:10 fdfvrgsergvxnjkdgbbn