{"id":46144647,"url":"https://github.com/ozzyczech/holidays-cs","last_synced_at":"2026-03-02T07:02:28.058Z","repository":{"id":232208802,"uuid":"783586270","full_name":"OzzyCzech/holidays-cs","owner":"OzzyCzech","description":"Public holidays, Easter, name days and important days in the Czech Republic.","archived":false,"fork":false,"pushed_at":"2025-11-20T09:40:46.000Z","size":501,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-11T04:34:44.284Z","etag":null,"topics":["czech","czech-republic","easter","easter-date","holidays","lib","library","name","nameday","namedays"],"latest_commit_sha":null,"homepage":"https://ozana.cz","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/OzzyCzech.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-04-08T07:24:27.000Z","updated_at":"2025-11-20T09:40:49.000Z","dependencies_parsed_at":"2024-05-14T08:39:57.076Z","dependency_job_id":"d374e709-caa1-4655-9d21-4d49a6e017f6","html_url":"https://github.com/OzzyCzech/holidays-cs","commit_stats":null,"previous_names":["ozzyczech/holidays-cs"],"tags_count":45,"template":false,"template_full_name":null,"purl":"pkg:github/OzzyCzech/holidays-cs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OzzyCzech%2Fholidays-cs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OzzyCzech%2Fholidays-cs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OzzyCzech%2Fholidays-cs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OzzyCzech%2Fholidays-cs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/OzzyCzech","download_url":"https://codeload.github.com/OzzyCzech/holidays-cs/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OzzyCzech%2Fholidays-cs/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29994618,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-02T01:47:34.672Z","status":"online","status_checked_at":"2026-03-02T02:00:07.342Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["czech","czech-republic","easter","easter-date","holidays","lib","library","name","nameday","namedays"],"created_at":"2026-03-02T07:02:22.367Z","updated_at":"2026-03-02T07:02:28.047Z","avatar_url":"https://github.com/OzzyCzech.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Holidays (cs)\n\n[![NPM Downloads](https://img.shields.io/npm/dm/holidays-cs?style=for-the-badge)](https://www.npmjs.com/package/holidays-cs)\n[![NPM Version](https://img.shields.io/npm/v/holidays-cs?style=for-the-badge)](https://www.npmjs.com/package/holidays-cs)\n[![NPM License](https://img.shields.io/npm/l/holidays-cs?style=for-the-badge)](https://github.com/OzzyCzech/holidays-cs/blob/main/LICENSE)\n[![Last Commit](https://img.shields.io/github/last-commit/OzzyCzech/holidays-cs?style=for-the-badge)](https://github.com/OzzyCzech/holidays-cs/commits/main)\n[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/OzzyCzech/holidays-cs/main.yml?style=for-the-badge)](https://github.com/OzzyCzech/holidays-cs/actions)\n\nPublic holidays and significant days in the Czech Republic.\n\n## Functions\n\nAll functions are available in the main module. You can import them like this:\n\n```javascript\nimport * as holidays from 'holidays-cs';\n```\n\n[Luxon](https://moment.github.io/luxon/) is used for date manipulation.\nYou can pass a `Date` object or a `DateTime` object to the functions.\nResponses are always `DateTime` objects. If you need a `Date` object,\nyou can use the `response.toJSDate()` method.\n\n## Czech public holidays\n\n```javascript\nimport {DateTime} from 'luxon';\nimport {isPublicHoliday, getPublicHoliday} from 'holidays-cs';\n\n// 1. january\nisPublicHoliday(DateTime.fromISO('2024-01-01')); // true\n\n// 2. january\nisPublicHoliday(DateTime.fromISO('2024-01-02')); // false\n\n// 17. november\nisPublicHoliday(DateTime.fromISO('2024-11-17')); // true\ngetPublicHoliday(DateTime.fromISO('2024-11-17')); // Den boje za svobodu a demokracii (1939 a 1989)\n```\n\nYou can get all public holidays for a given year:\n\n```javascript\nimport {getPublicHolidaysList} from 'holidays-cs';\n\ngetPublicHolidaysList(2024); // returns Map with all 13 holidays\n```\n\n### Shops status\n\nIn the Czech Republic, shops are closed on some public holidays.\n\n```javascript\nimport {DateTime} from 'luxon';\nimport {areShopsOpen, getShopsStatus} from 'holidays-cs';\n\n// 24. december 2024\nareShopsOpen(DateTime.fromISO('2024-12-24')); // true\n\n// 25. december 2024\ngetShopsStatus(DateTime.fromISO('2024-12-25')); // otevřeno do 12:00 \n\n// New Year's Day 2025\nareShopsOpen(DateTime.fromISO('2025-01-01')); // false\ngetShopsStatus(DateTime.fromISO('2025-01-01')); // zavřeno\n```\n\n## Czech significant days\n\nSignificant days are not public holidays, but they are important in the Czech Republic.\n\n```javascript\nimport {DateTime} from 'luxon';\nimport {isSignificantDay, getSignificantDay} from 'holidays-cs';\n\n// 16. jan 2024\nisSignificantDay(DateTime.fromISO('2024-01-16')); // true\ngetSignificantDay(DateTime.fromISO('2024-01-16')).name; // Den památky Jana Palacha\n```\n\nVisit the [significant days](https://cs.wikipedia.org/wiki/%C4%8Cesk%C3%BD_st%C3%A1tn%C3%AD_sv%C3%A1tek) page for more information.\n\n## Easter\n\n**Easter Monday** (_Velikonoční pondělí_) and **Good Friday** (_Velký pátek_)\nare public holidays in the Czech Republic.\n\n### Easter date\n\nLibrary can calculate the Easter date for a given year (it's Sunday):\n\n```javascript\nimport {getEaster} from 'holidays-cs';\n\ngetEaster(2024).toISODate(); // 2024-03-31\ngetEaster(2025).toISODate(); // 2025-04-20\n```\n\nNeed more? Check out the [Easter Date](https://github.com/OzzyCzech/easter-date) library.\n\n### Easter days\n\n```javascript\nimport {getGoodFriday, getHolySaturday, getEasterSunday, getEaster, getEasterMonday} from 'holidays-cs';\n\ngetGoodFriday(2024).toISODate(); // 2024-03-29\ngetHolySaturday(2024).toISODate(); // 2024-03-30\n\n// Easter Sunday and Easter are the same\ngetEasterSunday(2024).toISODate(); // 2024-03-31\ngetEaster(2024).toISODate(); // 2024-03-31\n\ngetEasterMonday(2024).toISODate(); // 2024-04-01\n```\n\nYou can also check if a given date is Good Friday, Holy Saturday, Easter Sunday or Easter Monday:\n\n```javascript\nimport {isGoodFriday, isHolySaturday, isEasterSunday, isEasterMonday} from 'holidays-cs';\nimport {DateTime} from 'luxon';\n\n\n// 29. march 2024 - Good Friday\nisGoodFriday(DateTime.fromISO('2024-03-29')); // true\n\n// 30. march 2024 - Holy Saturday\nisHolySaturday(DateTime.fromISO('2024-03-30')); // true\n\n// 31. march 2024 - Easter Sunday\nisEasterSunday(DateTime.fromISO('2024-03-31')); // true\n\n// 1. april 2024 - Easter Monday\nisEasterMonday(DateTime.fromISO('2024-04-01')); // true\n```\n\n### Holy Week\n\nYou can also check if given date is part of the Holy Week.\nHoly Week is the week before Easter plus Easter Monday.\nStarts with Palm Sunday and ends with Easter Monday.\n\n```javascript\nimport {isHolyWeek, getHollyWeekInterval} from 'holidays-cs';\n\n// 29. march 2024\nisHolyWeek(DateTime.fromISO('2024-03-29')); // true it's Good Friday\n\n// Get the Holy Week interval\ngetHollyWeekInterval(2024) // {start: DateTime, end: DateTime}\n```\n\nYou can also get the name of the day in the Holy Week:\n\n```javascript\nimport {DateTime} from 'luxon';\nimport {getEasterDayName} from 'holidays-cs';\n\ngetEasterDayName(DateTime.fromISO('2024-03-29')); // Velký pátek\n```\n\n## Get day metadata\n\nYou can get metadata for a given date:\n\n```javascript\nimport {DateTime} from 'luxon';\nimport {getDayMeta} from 'holidays-cs';\n\nconst meta = getDayMeta(DateTime.fromISO('2024-05-15'));\nmeta.isPublicHoliday; // false ...\n```\n\nThe metadata object looks like this:\n\n```typescript\nexport type SignificantDay = {\n  name: string;\n  description: string;\n  year?: number;\n};\n\nexport type EasterMetadata = {\n  name: string | undefined;\n  isGoodFriday: boolean;\n  isHolySaturday: boolean;\n  ieEasterSunday: boolean;\n  isEasterMonday: boolean;\n};\n\nexport type DayMetadata = {\n  // Significant days metadata\n  isSignificantDay: boolean;\n  significantDay?: SignificantDay;\n\n  // Public holidays metadata\n  isPublicHoliday: boolean;\n  publicHoliday?: string | undefined;\n\n  // Easter metadata\n  isHolyWeek: boolean;\n  easter?: EasterMetadata | undefined;\n\n  // Shops metadata\n  shops: {areOpen: boolean; status: string};\n};\n```\n\n## Credits\n\n- [Zákon č. 245/2000 Sb., o státních svátcích a národních svátcích České republiky](https://www.mpsv.cz/web/cz/zakon-c.-245-2000-sb.-ze-dne-29.-cervna-2000-)\n\n## License\n\n[MIT](./LICENSE)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fozzyczech%2Fholidays-cs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fozzyczech%2Fholidays-cs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fozzyczech%2Fholidays-cs/lists"}