About the Calendar Converter Tool

Back to Tool

When accuracy determines historical truth

"Three Copies, Seven Revisions" in History & Classical Chinese:
When One Hour's Difference Changes an Era

You're researching a stone inscription from the Lê Dynasty? You're translating a Tang poem mentioning the "Awakening of Insects" solar term? Or you're trying to pinpoint the exact date and time of an emperor's coronation?

If you're only using a mass-market "Perpetual Calendar" from a bookshop or consulting a random feng shui website, odds are you're off by an entire month.

1. The Time Zone Trap: GMT+7 and GMT+8

The biggest mistake in historical calendar research is assuming the Vietnamese Lunar Calendar and Chinese Lunar Calendar are identical.

In reality, since Vietnam (at 105°E longitude) and China (at 120°E longitude) differ by one hour, the lunar conjunction (moment the month begins) frequently falls on two different dates.

Classic Example: Lunar New Year 1985 (Year of the Ox)

Vietnam celebrated Tết a full month before China.

Consequence: If you're researching documents from this period using a Chinese calendar tool to convert Vietnamese historical dates, your entire dataset will be fundamentally wrong.

Test Case: June 25, 2006
• Vietnam: 1st day of 6th month, Year of the Dog (Bính Tuất)
• China: 30th day of 5th month, Year of the Dog (Bính Tuất)
→ Off by 1 day because lunar conjunction happens at 23:05 Vietnam Time

Technical Analysis: Why Vietnam and China Differ

🇻🇳 Vietnam (GMT+7) 🇨🇳 China (GMT+8)
Previous month conjunction (k) May 27, 2006 May 27, 2006
Next month conjunction (k+1) June 25, 2006 June 26, 2006
Month begins June 25 (month 6) May 27 (still month 5)
Resulting lunar date 1st/6/2006 30th/5/2006
🔬 Root Cause: Lunar conjunction (New Moon) occurs around 00:00-01:00 UTC on June 26, 2006.
  • GMT+7 (VN): 07:00-08:00 AM on June 25 → New month begins June 25
  • GMT+8 (CN): 08:00-09:00 AM on June 26 → New month begins June 26
Therefore, June 25, 2006 is the start of month 6 in Vietnam but still the end of month 5 in China!

👉 Our tool solves this: By applying separate calculation algorithms for Vietnam's and China's time zones, we restore historical accuracy to the timeline.

2. Solar Terms & the Subtlety of Classical Chinese

In Han-Nom literature, "Solar Terms" aren't just weather patterns—they're inspiration.

When Li Bai writes about the moon, or Nguyễn Trãi writes about grass and trees, they're immersed in a specific solar term (Beginning of Spring, Rain Water, Pure Brightness...).

  • Ordinary tools only calculate solar terms by average day (large errors)
  • Our Precision Lunar Tool: Uses the VSOP87 algorithm to calculate Sun Longitude (Ecliptic) in real time
  • You'll know the exact moment each solar term transitions, down to the minute
Why does this matter?

It helps scholars understand why ancient authors chose those exact words in that astronomical context. Classical literature is inseparable from astronomy!

3. The Can Chi System & Four Pillars: Keys to Decoding Ancient Texts

Determining the exact date like "Year of the Rat" (Giáp Tý) or the hour "Tiger Hour" (Bính Dần) is crucial for cross-referencing ancient documents (dating stone inscriptions, imperial decrees).

Many current tools incorrectly calculate Can Chi by simply looking them up in static tables.

The Correct Formula:

Our tool applies the Daoist algorithm for perfectly accurate Can Chi hour calculation:

Can(hour) = [Can(day) × 2 + Chi(hour)] mod 10

Example: Day "Ất Tỵ" (can=1), Hour "Rat" (chi=0)
→ Hour can = (1×2 + 0) mod 10 = 2 → "Bính Rat"

Essential support for Four Pillars charting or numerical cosmology research.

4. Proven Reliability: 108 Test Cases ✓

Unlike superstitious "lucky day" apps, this is a Scientific Tool with comprehensive automated testing:

✓ 108/108 PASSED Verified: Feb 2026

1. Standard Lunar New Year Dates (Golden Reference)

  • Lunar New Year 2024: 2/10 → 1st day of Dragon month ✓
  • Lunar New Year 2025: 1/29 → 1st day of Snake month ✓
  • Lunar New Year 2026: 2/17 → 1st day of Horse month ✓
  • Lunar New Year 1968: 1/29 ✓
  • Years 1980, 2012, 2020... ✓

2. Vietnam vs China Divergence

  • 6/25/2006: VN = 1/6, CN = 30/5 ✓
  • Automatic root cause detection (lunar conjunction offset) ✓

3. Vietnamese Zodiac (Cat vs Rabbit)

  • 2023: VN = Cat, CN = Rabbit ✓
  • Years 1963, 1975, 1987, 1999, 2011... ✓

4. Winter Solstice (Dongzhi)

  • 12/21-22 across centuries: 1950, 2000, 2024, 2025 ✓

5. Solar Term Start Points

  • Beginning of Spring (Feb 3-5): 2024, 2025, 2026 ✓
  • Spring Equinox (Mar 20-21): 2024, 2025 ✓

6. Leap Months

  • 2020: has leap month (month 4) ✓
  • 2023: has leap month (month 2) ✓
  • 2025: has leap month ✓

7. Historical Range (1850-2100)

  • 1850, 1900, 1950, 2000, 2050, 2100 ✓

8. Delta T (Time Difference)

  • 1900: ~-3s, 1950: ~29s, 2000: ~64s, 2020: ~69s ✓

9. Accurate Can Chi

  • 2024 = Year of the Dragon, 2025 = Year of the Snake, 2026 = Year of the Horse ✓
  • 1984 = Year of the Rat, 2000 = Year of the Dragon ✓

10. Vietnamese Historical Time Zones

  • Before 1960: North/South = UTC+7 ✓
  • 1960-1975: North = UTC+7, South = UTC+8 ✓
  • After 1975: Unified UTC+7 ✓

11. Advanced Solar Term API

  • 2/4/2026 = Beginning of Spring (start) ✓
  • Accurate to the minute ✓

12. Vietnam/China Comparison Debug

  • Automatic root cause detection ✓
  • Explains divergence reasons ✓
  • Accuracy: Based on celestial models from NASA Jean Meeus Ho Ngoc Duc
  • Transparency: Highlights differences between Vietnamese and Chinese calendars, enabling direct comparison
  • Deep Data: Supports queries stretching far into the past (1800-2200) – something paper calendars can't handle
  • Open Source Logic: Transparent algorithms that can be verified by the scientific community
Technologies Used:
Julian Day Number New Moon Calculation VSOP87 Sun Longitude Can Chi Algorithm 24 Solar Terms Leap Month Detection

5. 2026 Upgrade: True Solar Time & Historical Time Zones

The latest version of Quizzman Calendar Converter introduces cutting-edge features never before offered:

True Solar Time (Solar Noon)

Clock time (Hanoi, GMT+7) is mean solar time. In reality, the sun reaches its zenith about 7 minutes later than watch time in Hanoi, and about 4 minutes earlier in Ho Chi Minh City. This tool calculates this precise deviation based on longitude and the Equation of Time.

Vietnamese Historical Time Zones (1906-1975)

Supports 60+ Vietnamese cities with accurate time zones for each period: before 1906 (Local Solar Time), 1906-1942 (UTC+7), 1943-1945 (UTC+8/+9 during Japanese occupation), 1947-1954 (French UTC+8), and after 1975 (unified UTC+7).

New in v2.1: From 1954-1967, although North Vietnam officially used UTC+7, calendars were computed using astronomical tables from China's Purple Mountain Observatory (UTC+8). Decision 121-CP (1967) ended this practice, directly causing the famous 1968 Tết Mậu Thân date discrepancy between North and South.

Solar Month (Tianzhan Month)

For feng shui practitioners: Display the Can Chi of months based on solar terms (e.g., with the Beginning of Spring a new zodiacal month begins), completely separate from the everyday lunar calendar.

Rat Hour Variation Option

Resolves a millennia-long debate: Does the Rat Hour (11pm-1am) belong to today (Night Rat) or tomorrow (Day Rat)? You can choose your preferred tradition.

Integrated Bazi & Ziwei Astrology

This calendar tool is the foundation for Bazi (Four Pillars) and Ziwei (Purple Star) divination tools, ensuring accuracy for life charts based on correct time zones and lunar dates.

6. International Historical Time Zones (v2.1 — March 2026)

The engine now supports precise historical time zones for 6 international regions, based on IANA (Internet Assigned Numbers Authority) data — the global standard for time zone information:

Mainland China (Asia/Shanghai)

Local time before 1901. Shanghai DST 1919 & 1940-1949 (including continuous wartime DST 1942-1945). PRC national DST pilot 1986-1991.

Taiwan (Asia/Taipei)

Japanese rule UTC+9 period (1937-1945). 19 distinct DST years (1946-1961, 1974-1975, 1979) with exact IANA start/end dates.

Japan (Asia/Tokyo)

Local time before 1888. SCAP occupation DST 1948-1951 with per-year exact dates.

South Korea (Asia/Seoul)

5 historical periods: KST +8:30 (1908-1911), Japanese time +9 (1912-1945), +9 with DST (1945-1954), +8:30 with DST (1954-1961), +9 with Olympics DST (1987-1988).

United States & Canada

WWI DST (1918-1919), continuous War Time (1942-1945), EPAA energy crisis (1974), Uniform Time Act (1967-2006), and current rules (2007+). Supports 5 major US time zones.

"History demands accuracy. Language requires context. Don't let your research wash away simply because a calendar conversion tool got the dates wrong."

Who Should Use This Tool?

  • Han-Nom Scholars: Accurately determine the dating of ancient texts
  • Historians: Cross-reference historical events with accurate lunar calendars
  • Literature Students: Understand the astronomical context in classical writings
  • Classical Chinese Translators: Grasp the subtle nuances of solar terms in poetry
  • East Asian Culture Enthusiasts: Discover the calendrical differences between Vietnam and China

Accuracy Verification: When AI Generates Wrong Test Cases, the Engine Still Gets It Right

During quality assurance, we used Google Gemini to generate 12 edge-case test scenarios designed to challenge the engine in the most difficult situations: VN-CN lunar divergence, true solar time, solar terms, early/late Rat hour (Dạ Tý/Chính Tý), and leap months.

Result: 7 out of 12 cases initially FAILED. However, after debugging each case using astronomical formulas and verifying JDN (Julian Day Number) from the J2000.0 epoch, all 7 failures turned out to be caused by wrong expectations from Gemini — not engine bugs.

Gemini's errors included:
  • 1968: Gemini picked the wrong solar date (Feb 16 instead of Jan 29) — the engine correctly computed the New Moon for Tết Mậu Thân
  • 1972: Gemini claimed VN/CN divergence existed — a full-year scan confirmed zero divergence
  • 1984: Gemini confused Tết date (Feb 2) with the divergence start — actual divergence begins Nov 23, 1984
  • True Solar Time (HCM): Gemini used 110°E as the standard meridian — the correct value is 105°E (UTC+7 = 7×15°)
  • Day pillars Mar 24–25, 2026: Gemini provided wrong Earthly Branches (Tỵ/Ngọ) — JDN verification yields Dậu/Tuất
Results after correction:
• 31/31 edge cases PASS (expanded benchmark: historical timezones & VSOP87)
• 52/52 international cases PASS (v2.1: VN/CN/TW/JP/KR/US/CA, UTC±10, +8.5)
• 108/108 regression cases PASS (legacy test suite unaffected)
• Total: 191/191 test cases PASS — the engine is fully accurate
International Benchmark v2.1 — Key Findings:
  • Tết Mậu Thân 1968: North VN (UTC+7) = Jan 29, South VN (UTC+8) = Jan 30 — confirmed by ceasefire records
  • 1985 Divergence: VN Tết = Jan 21, CN Tết = Feb 20 — 1 full month apart due to different leap month placement (VN leap 2 vs CN leap 10)
  • Korea UTC+8:30 (1954–1961): Tết Giáp Ngọ 1954 at +8.5 = Feb 4 (China at +8 = Feb 3) — fractional offset creates real 1-day boundary shift
  • US West Coast (PST −8): Lunar New Year 2024 at PST = Feb 9 (VN/CN = Feb 10) — negative offset shifts Mùng 1 earlier
  • Edge cases: India (+5:30), Hawaii (−10), year 1900 — all computed correctly
Full list of 52 international test case dates

1. VN Tết Golden (8 cases):
10/02/2024 → Mùng 1 Giáp Thìn · 29/01/2025 → Mùng 1 Ất Tỵ · 17/02/2026 → Mùng 1 Bính Ngọ · 21/01/1985 → Mùng 1 Ất Sửu · 26/01/2009 → Mùng 1 Kỷ Sửu · 25/01/2020 → Mùng 1 Canh Tý · 16/02/1980 → Mùng 1 Canh Thân · 23/01/2012 → Mùng 1 Nhâm Thìn

2. Tết Mậu Thân 1968 (6 cases):
North (UTC+7): 29/01/1968 = Mùng 1 · 28/01 = 29th of Chạp
South (UTC+8): 30/01/1968 = Mùng 1 · 29/01 = 30th of Chạp (New Year's Eve)

3. North VN pre-1968 UTC+8 (4 cases):
01/06/1960 · 01/06/1965 · 01/06/1967 → all UTC+8 · 21/01/1966 North matches CN

4. 1985 Leap divergence (2 cases):
VN 15/04/1985 → leap month 2 · CN 15/12/1984 → leap month 10

5. China (5 cases):
20/02/1985 → CN Tết Ất Sửu · 21/01/1985 = 1/12 Giáp Tý (not yet Tết!) · 29/01/1987 · 10/02/2024 · 29/01/2025

6. Taiwan (2 cases):
29/01/1987 · 10/02/2024 → always matches CN

7. Japan UTC+9 (3 cases):
10/02/2024 · 29/01/2025 · 01/02/1870 (pre-Meiji)

8. Korea UTC+8:30 (7 cases):
03/02/1954 → 30th Chạp at +8.5 (Mùng 1 at +8!) · 04/02/1954 → KR Mùng 1 · 03/02/1954 → CN Mùng 1 at +8
24/01/1955 → KR Tết +8.5 · 15/07/1988 DST +10 · 29/01/2025 post-1961 +9

9. US West Coast PST −8 (3 cases):
09/02/2024 → Mùng 1 PST (1 day before VN!) · 10/02/2024 → Mùng 2 · 15/07/2024 PDT −7

10. US East Coast EST −5 (2 cases):
26/01/2009 · 29/01/2025 → matches VN

11. Canada (2 cases):
Vancouver 09/02/2024 PST · Toronto 29/01/2025 EST

12. Cross-country comparison (3 cases):
10/02/2024: VN=CN=Mùng 1, PST=Mùng 2 · 21/01/1985: VN Tết, CN not yet · 1968: North 29/01, South 30/01

13. Edge cases (5 cases):
India +5:30 29/01/2025 · Hawaii −10 29/01/2025 · 31/12/2024 → month 12 · 31/01/1900 → Tết Canh Tý · 29/02/2024 solar leap day

This demonstrates that even state-of-the-art AI systems like Gemini can produce incorrect astronomical data, while our engine relies on the Jean Meeus / Hồ Ngọc Đức algorithms and deterministic mathematical formulas — no guessing, no hallucination.

Ready to explore?

Open Calendar Converter

Completely free · No registration · Accurate down to the minute

#HanNom #VietnameseHistory #LunarCalendar #Astronomy #Quizzman #Research #CanChi #SolarTerms #Bazi