Add the Chinese lunar calendar to Google, Apple or Outlook Calendar
Last checked · calculated, then checked against the Hong Kong Observatory tables
These are calendar files (.ics) you can import into Google Calendar, Apple Calendar or Outlook, one file per Gregorian year from 2020 to 2035. One file adds Chinese New Year, the traditional festivals and the 24 solar terms; the other adds the lunar date to every day of the year. The dates are the same as on the lunar calendar pages of this site and are free to use.
Download the 2027 files
What is in each file
- Festivals and solar terms: Chinese New Year, the Lantern, Qingming, Dragon Boat, Qixi, Hungry Ghost, Mid-Autumn, Double Ninth, Dongzhi and Laba festivals that fall in that Gregorian year, and the 24 solar terms with their exact moment in the event description.
- Lunar date for every day: each day shows its lunar month and day, such as "Lunar 8/15" (the 15th day of the 8th month); the first day of a month reads "Lunar 8th month begins", and days in a leap month are marked "L" (for example "Lunar L6/3").
- All events are all-day events on the China Standard Time (UTC+8) date and are set to show as free, so they don't block your schedule.
How to import
- Google Calendar (on a computer): Settings (gear icon) > Settings > Import & export. Select the file, choose a calendar under "Add to calendar", then click Import.
- Apple Calendar on a Mac: File, then Import, and choose the file.
- iPhone or iPad: tap a file link in Safari, then tap Add All and choose a calendar.
- Outlook on the web: Add calendar > Upload from file, then browse to the file, choose a calendar and select Import.
Tip: create a separate calendar first (for example "Chinese calendar") and import into it, so you can hide or delete all the events at once.
All years
FAQ
How do I add the Chinese lunar calendar to Google Calendar?
Download a file below on a computer, open Google Calendar, go to Settings, then Import & export, choose the file and the calendar to add it to, and select Import. Google Calendar can import .ics files only on the web, not in its phone app; once imported, the events also appear on your phone.
Do the files update by themselves?
No. An imported file is copied into your calendar once. Each file covers one calendar (Gregorian) year, so download the next year's file when you need it. If a date in our data is ever corrected, we'll post the corrected file here.
Why are the events all-day, with no time?
They are all-day events dated by China Standard Time (UTC+8), so a festival stays on its date wherever you are. The solar term events give the exact time in China Standard Time in their description; outside China that moment can fall on the previous or next local day.
Where do the dates come from?
From the same calculation as the rest of this site: astronomical algorithms for the new moons and solar terms, with every day from 1901 to 2100 compared against the Hong Kong Observatory's Gregorian-Lunar Calendar Conversion Table.
How do I remove the events later?
Import the file into a calendar of its own (for example a new calendar named "Chinese calendar"). Deleting that calendar removes all the imported events at once.
Dates are calculated with astronomical algorithms in China Standard Time (UTC+8) and checked against the Hong Kong Observatory, Gregorian-Lunar Calendar Conversion Table. See also the 24 solar terms and festival dates.