Chinese Calendar Algorithm - Year 1901 to 2100 - v4.16, by Herong Yang
How to Use Chinese Calendar Program
This section describes how to use the Chinese calendar program, ChineseCalendar.java, to calculate Chinese calendar elements of a given date, or generating formatted text based calendar for a given month or year.
The Chinese calendar program, ChineseCalendar.java, described in the previous section can be used for 3 purposes:
1. Calculating Chinese calendar elements for any given Gregorian calendar date between year 1901 and year 2100. The command line syntax is: "java ChineseCalendar day yyyy mm dd". For example:
> java ChineseCalendar day 2050 4 1 Gregorian Year: 2050 Gregorian Month: 4 (April) Gregorian Date: 1 Is Leap Year: false Day of Year: 91 Day of Week: 6 (Friday) Chinese Year: 4747 Heavenly Stem: 7 (Metal) Earthly Branch: 7 (Horse) Chinese Month: 3 Chinese Date: 10 Sectional Term: April 4 (Qingming) Principle Term: April 20 (Guyu) Chinese New Year: February 11, 2051 (year of Metal-Sheep)
2. Generating a formatted text based Chinese calendar for any given Gregorian calendar month between year 1901 and year 2100. The command line syntax is: "java ChineseCalendar month yyyy mm". For example:
herong> java ChineseCalendar month 2050 4
Gregorian Year: 2050
February
Sun Mon Tue Wed Thu Fri Sat
1/10 2/11 ST 1 4/13 5/14
6/15 7/16 8/17 9/18 10/19 11/20 12/21
13/22 14/23 15/24 16/25 17/26 PT 1 19/28
20/29 CM 2 22/ 2 23/ 3 24/ 4 25/ 5 26/ 6
27/ 7 28/ 8
3. Generating a formatted text based Chinese calendar for any given Gregorian calendar year between year 1901 and year 2100. The command line syntax is: "java ChineseCalendar year yyyy". For example:
herong> java ChineseCalendar year 2050
Gregorian Calendar Year: 2050
Chinese Calendar Year: 4747 (Metal-Horse)
January February
Sun Mon Tue Wed Thu Fri Sat Sun Mon Tue Wed Thu Fri Sat
1/ 8 1/10 2/11 ST 1 4/13 5/14
2/ 9 3/10 4/11 ST12 6/13 7/14 8/15 6/15 7/16 8/17 9/18 10/19 11/20 12/21
9/16 10/17 11/18 12/19 13/20 14/21 15/22 13/22 14/23 15/24 16/25 17/26 PT 1 19/28
16/23 17/24 18/25 19/26 PT12 21/28 22/29 20/29 CM 2 22/ 2 23/ 3 24/ 4 25/ 5 26/ 6
CM 1 24/ 2 25/ 3 26/ 4 27/ 5 28/ 6 29/ 7 27/ 7 28/ 8
30/ 8 31/ 9
March April
Sun Mon Tue Wed Thu Fri Sat Sun Mon Tue Wed Thu Fri Sat
1/ 9 2/10 3/11 4/12 ST 2 1/10 2/11
6/14 7/15 8/16 9/17 10/18 11/19 12/20 3/12 ST 3 5/14 6/15 7/16 8/17 9/18
13/21 14/22 15/23 16/24 17/25 18/26 19/27 10/19 11/20 12/21 13/22 14/23 15/24 16/25
PT 2 21/29 22/30 CM 3 24/ 2 25/ 3 26/ 4 17/26 18/27 19/28 PT 3 *CM 3 22/ 2 23/ 3
27/ 5 28/ 6 29/ 7 30/ 8 31/ 9 24/ 4 25/ 5 26/ 6 27/ 7 28/ 8 29/ 9 30/10
May June
Sun Mon Tue Wed Thu Fri Sat Sun Mon Tue Wed Thu Fri Sat
1/11 2/12 3/13 4/14 ST 4 6/16 7/17 1/12 2/13 3/14 4/15
8/18 9/19 10/20 11/21 12/22 13/23 14/24 ST 5 6/17 7/18 8/19 9/20 10/21 11/22
15/25 16/26 17/27 18/28 19/29 20/30 PT 4 12/23 13/24 14/25 15/26 16/27 17/28 18/29
22/ 2 23/ 3 24/ 4 25/ 5 26/ 6 27/ 7 28/ 8 CM 5 20/ 2 PT 5 22/ 4 23/ 5 24/ 6 25/ 7
29/ 9 30/10 31/11 26/ 8 27/ 9 28/10 29/11 30/12
July August
Sun Mon Tue Wed Thu Fri Sat Sun Mon Tue Wed Thu Fri Sat
1/13 2/14 1/14 2/15 3/16 4/17 5/18 6/19
3/15 4/16 5/17 6/18 ST 6 8/20 9/21 ST 7 8/21 9/22 10/23 11/24 12/25 13/26
10/22 11/23 12/24 13/25 14/26 15/27 16/28 14/27 15/28 16/29 CM 7 18/ 2 19/ 3 20/ 4
17/29 18/30 CM 6 20/ 2 21/ 3 PT 6 23/ 5 21/ 5 22/ 6 PT 7 24/ 8 25/ 9 26/10 27/11
24/ 6 25/ 7 26/ 8 27/ 9 28/10 29/11 30/12 28/12 29/13 30/14 31/15
31/13
September October
Sun Mon Tue Wed Thu Fri Sat Sun Mon Tue Wed Thu Fri Sat
1/16 2/17 3/18 1/16
4/19 5/20 6/21 ST 8 8/23 9/24 10/25 2/17 3/18 4/19 5/20 6/21 7/22 ST 9
11/26 12/27 13/28 14/29 15/30 CM 8 17/ 2 9/24 10/25 11/26 12/27 13/28 14/29 15/30
18/ 3 19/ 4 20/ 5 21/ 6 22/ 7 PT 8 24/ 9 CM 9 17/ 2 18/ 3 19/ 4 20/ 5 21/ 6 22/ 7
25/10 26/11 27/12 28/13 29/14 30/15 PT 9 24/ 9 25/10 26/11 27/12 28/13 29/14
30/15 31/16
November December
Sun Mon Tue Wed Thu Fri Sat Sun Mon Tue Wed Thu Fri Sat
1/17 2/18 3/19 4/20 5/21 1/18 2/19 3/20
6/22 ST10 8/24 9/25 10/26 11/27 12/28 4/21 5/22 6/23 ST11 8/25 9/26 10/27
13/29 CM10 15/ 2 16/ 3 17/ 4 18/ 5 19/ 6 11/28 12/29 13/30 CM11 15/ 2 16/ 3 17/ 4
20/ 7 21/ 8 PT10 23/10 24/11 25/12 26/13 18/ 5 19/ 6 20/ 7 21/ 8 PT11 23/10 24/11
27/14 28/15 29/16 30/17 25/12 26/13 27/14 28/15 29/16 30/17 31/18
##/## - Gregorian date/Chinese date, (*)CM## - (Leap) Chinese month first day
ST## - Sectional term, PT## - Principle term
Table of Contents
Chinese Calendar Background Information
►Chinese Calendar Algorithm and Program
The Gregorian Calendar Algorithm
The Chinese Calendar Algorithm
Chinese Calendar Program in java
►How to Use Chinese Calendar Program
Chinese Calendar Format and Notations
Corrections on the Astronomical Data
Chinese Calendars: Year 1901 to 1910
Chinese Calendars: Year 1911 to 1920
Chinese Calendars: Year 1921 to 1930
Chinese Calendars: Year 1931 to 1940
Chinese Calendars: Year 1941 to 1950
Chinese Calendars: Year 1951 to 1960
Chinese Calendars: Year 1961 to 1970
Chinese Calendars: Year 1971 to 1980
Chinese Calendars: Year 1981 to 1990
Chinese Calendars: Year 1991 to 2000
Chinese Calendars: Year 2001 to 2010
Chinese Calendars: Year 2011 to 2020
Chinese Calendars: Year 2021 to 2030
Chinese Calendars: Year 2031 to 2040
Chinese Calendars: Year 2041 to 2050
Chinese Calendars: Year 2051 to 2060
Chinese Calendars: Year 2061 to 2070
Chinese Calendars: Year 2071 to 2080
Chinese Calendars: Year 2081 to 2090