Các chức năng cơ bản Chương trình VNCal hiển thị một tháng dương lịch với ngày âm lịch Việt Nam tương ứng. Với chương trình này, bạn có thể dễ dàng đổi ngày dương lịch ra ngày âm lịch và ngược lại. Ngoài ra, bạn có thể dùng chương trình để xem ngày, tính giờ; xem Can-Chi của ngày tháng âm lịch; tính giờ mặt trời mọc, lặn và giờ Chính Ngọ cho một địa điểm bất kỳ, so sánh âm lịch Việt Nam với âm lịch dùng tại các nước khác (Trung Quốc, Nhật Bản .), tính lịch âm cho một múi giờ bất kỳ v.v. Khi khởi động, chương trình sẽ hiển thị tháng hiện tại. Trong mỗi ô sẽ hiện ngày dương lịch và ngày âm tương ứng. Tên các Khí (Lập xuân, Thanh minh, Hạ chí .) cũng được hiện lên trong ngày Khí đó. Ngày âm lịch được in bằng màu xanh ở góc dưới bên phải trong ô. Tháng nhuận âm lịch được đánh dấu với chữ 'N' và hiển thị bằng màu đỏ, ví dụ như 12/2 N. Ngày hiện tại được thể hiện trên màu nền khác. Thông tin đầy đủ cho ngày này được in ở dưới cuối bảng: ngày tháng năm dương lịch, Can-Chi của ngày, tháng, năm âm lịch; trực, sao Nhị thập bát tú, sao Hoàng đạo và giờ hoàng đạo cho ngày tương ứng. Để xem thông tin về một ngày khác trong tháng, hãy nhấn chuột vào ô hiển thị ngày đó. Nền của ô đó sẽ chyển sang màu khác, và thông tin về ngày được chọn sẽ hiện lên ở cuối bảng. Để hiện tháng khác, bạn hãy chọn tháng và năm rồi gõ "Enter" hoặc bấm nút Display. Các năm trước Công nguyên (TCN) được nhập như sau: năm 1 TCN là 0, năm 2 TCN là -1, năm 3 TCN là -2 v.v. Các nút << và >> được dùng để chuyển sang tháng trước hoặc tháng sau. Bạn cũng có thể sử dụng các phím mũi tên ("arrow keys") để chọn một ngày khác, phím PgUp/PgDown để chuyển sang tháng trước/tháng sau và HOME/END để chuyển tới năm trước/năm sau. Để chuyển ngược trở lại ngày hiện tại hãy nhấn nút Today. Nếu bạn muốn in lịch tháng hay lịch năm, hãy sử dụng chức năng in của chương trình duyệt Web (browser) với chương trình lịch JavaScript. Cách tính âm lịch Việt Nam Âm lịch Việt Nam là một loại lịch thiên văn, có nguồn gốc từ Trung Quốc. Ngày tháng âm lịch được xác định dựa trên vị trí tương đối của mặt trời, mặt trăng và trái đất. Cách tính toán lịch khá phức tạp, bạn có thể tham khảo thêm tại đây: Cách tính âm lịch Việt Nam (in Vietnamese) | Rules of Vietnamese lunar calendar (in English) . Chương trình lịch ở trang này sử dụng các thuật toán trong cuốn sách "Calendrical Calculations" của Edward M. Reingold and Nachum Dershowitz để tính vị trí mặt trời, trái đất và mặt trăng. Từ các thông số này, ngày tháng âm lịch được xác định dựa trên các nguyên tắc tính âm lịch Việt Nam hiện đại theo Quyết định 121/CP ngày 08/08/1967 về việc "Tính lịch và quản lý lịch Nhà nước" (sửa đổi bổ sung trong Quyết định 134/2002/TTg ngày 14/10/2002 của Thủ tướng Chính phủ). Những quy tắc tính âm lịch hiện hành chỉ mới được áp dụng trong cả nước từ 1976. Nếu ta áp dụng các nguyên tắc này để tính lịch cho các năm trước 1976 thì sẽ có một chương trình lịch thiên văn. Tuy nhiên kết quả tính toán sẽ chênh lệch đôi chút so với lịch chính thức được dùng thời đó vì lịch chính thức dùng trước đây (lịch pháp định, lịch lịch sử) khác với âm lịch hiện đại ở 2 điểm cơ bản: (1) múi giờ dùng để tính lịch và (2) độ chính xác của các công thức thiên văn để tính vị trí của mặt trời và mặt trăng. Ví dụ, hiện nay âm lịch được tính cho múi giờ của Việt Nam (múi giờ thứ 7, GMT+7h) nhưng trước đây thường dùng múi giờ thứ 8 để tính. Xem Âm lịch Việt Nam qua các thời kỳ lịch sử để biết thêm chi tiết. Để tính âm lịch cho các năm từ 1975 về trước, chương trình âm lịch này đã phục chế âm lịch Việt Nam cho các thế kỷ trước dựa trên kết quả các công trình nghiên cứu của GS. Hoàng Xuân Hãn. Kết quả của lịch lịch sử đã được kiểm chứng cho các năm từ 1301 trở đi. Theo GS. Hoàng Xuân Hãn, trong quá khứ có hai quãng thời gian dài mà âm lịch Việt Nam có nhiều điểm khác biệt với âm lịch Trung Quốc: từ khoảng 1080 đến 1300 và từ 1645 đến 1812. Nguyên nhân chủ yếu là trong những giai đoạn này ở Trung Quốc đã cải cách lịch trong khi ở Việt Nam vẫn dùng phép lịch cũ để tính âm lịch. Từ 1968 trở đi Việt Nam tính âm lịch với múi giờ thứ 7 trong khi tại Trung Quốc người ta dùng múi giờ thứ 8, do đó âm lịch của hai nước thỉnh thoảng có khác biệt. Ví dụ năm 1984 lịch Việt Nam không có tháng nhuận trong khi lịch Trung Quốc nhuận tháng 10. (Từ 1968 đến 1975 miền Bắc Việt Nam dùng lịch âm tính với múi giờ thứ 7 trong khi ở miền Nam vẫn dùng âm lịch Trung Quốc, do vậy thỉnh thoảng có sự chênh lệch giữa lịch của hai miền.) Chương trình VNCal hiển thị thêm ngày âm theo lịch Trung Quốc nếu như lịch Việt Nam và lịch Trung Quốc khác nhau trong ngày đó. Ngày âm thứ hai này được in trong ngoặc vuông (VD: [28/1]) ở góc trên bên phải của ô hiện ngày. Ví dụ: xem lịch tháng 12 năm 1974. Trong ô hiện ngày 13/12/1974 có hai ngày âm lịch được thể hiện: 1/11 (góc dưới bên phải ô) và [30/10] (trong ngoặc vuông ở góc trên bên phải). Điều này có nghĩa là: ngày 13/12/1974 là ngày 1/11 âm lịch theo lịch dùng tại miền Bắc Việt Nam nhưng lại là ngày 30/10 theo lịch Trung Quốc (được dùng tại miền Nam.) Nếu bạn sinh ngày 15/11 năm Giáp Dần (1974) âm lịch thì ngày dương lịch tương ứng sẽ là 28/12/1974 nếu bạn sinh tại miền Nam, còn nếu bạn sinh tại miền Bắc thì ngày sinh theo dương lịch là 27/12/1974. Xem âm lịch các nước khác Âm lịch các nước Đông Á khác như Trung Quốc, Nhật Bản . được tính theo các nguyên tắc giống lịch Việt Nam nhưng sử dụng múi giờ khác: Trung Quốc dùng múi giờ thứ 8, Nhật Bản dùng múi giờ thứ 9 v.v. Để tính lịch âm cho các nước này bạn có thể dùng chức năng lịch thiên văn của chương trình (chọn "Astro Calendar" ở menu góc trên bên trái). Ở ô "GMT+" hãy điền số phút chênh lệch giữa GMT và múi giờ của nơi mà bạn muốn tính lịch rồi bấm "Display". Chẳng hạn, Việt Nam đi trước GMT 7h, như thế giờ Việt Nam nhanh hơn GMT 420 phút, ta sẽ điền số 420 vào ô "GMT+". Tương tự, để tính lịch Trung Quốc ta điền số 480; để tính âm lịch Nhật Bản điền 540. Ở những vùng mà giờ đi sau GMT ta sẽ điền một số âm vào ô "GMT+": với California phải điền -480 (vì múi giờ California là GMT-8h, tức là sau GMT 480 phút), ở Houston, TX điền -360. Công cụ lịch Với chức năng "Công cụ lịch" ta có thể tính toán nhiều thông số liên quan tới âm lịch: tất cả các ngày Tết trong 100 năm, các tháng nhuận, thời điểm Sóc, các Tiết/Khí, thời điểm mặt trời mọc/lặn . Sau khi chọn "Calendar Tool" bạn có thể chọn tháng, năm và sử dụng các chức năng sau: Lunar date/time: Tính ngày âm lịch cho ngày tháng và địa điểm đã chọn. Hiển thị thông tin chi tiết về ngày giờ âm lịch. Bạn có thể chọn một trong những địa điểm cho sẵn hoặc chọn "Location" là "(Custom)" và điền vĩ độ vào ô "Latitude" và kinh độ vào ô "Longitude". Chức năng này có tính chất thử nghiệm: ngày tháng âm lịch được tính phụ thuộc vào cả kinh và vĩ độ, do đó âm lịch cho một nơi ở bán cầu Nam sẽ chênh lệch 6 tháng so với một nơi cùng kinh độ nhưng ở bán cầu Bắc. Show Solar Terms: Tính các các thời điểm KHÍ (Trung khí và Tiết khí) cho năm đã chọn. Show New Moons: Tính các các thời điểm Sóc cho năm đã chọn. Ngày chứa điểm Sóc là ngày đầu tháng âm lịch. New Year's (Official): Tính ngày Tết theo lịch pháp định (lịch dùng chính thức tại Việt Nam) cho 100 năm kể từ năm đã chọn. New Year's (Astronomical): Tính ngày Tết theo lịch thiên văn cho 100 năm kể từ năm đã chọn. Cần chọn múi giờ để tính lịch thiên văn bằng cách chọn một địa điểm cho sẵn hoặc điền kinh độ vào ô "Longitude". Leap Months (Official): Tính tất cả các tháng nhuận theo lịch pháp định (lịch dùng chính thức tại Việt Nam) cho 100 năm kể từ năm đã chọn. Leap Months (Astronomical): Tính tất cả các tháng nhuận theo lịch thiên văn cho 100 năm kể từ năm đã chọn. Cần chọn múi giờ để tính lịch thiên văn bằng cách chọn một địa điểm cho sẵn hoặc điền kinh độ vào ô "Longitude". Sun Rise/Transit/Set: Tính thời điểm mặt trời mọc/lặn và giờ chính ngọ cho tháng và địa điểm đã chọn. Bạn có thể chọn một trong những địa điểm cho sẵn hoặc chọn "Location" là "(Custom)" và điền vĩ độ vào ô "Latitude" và kinh độ vào ô "Longitude". Sau khi chọn chức năng hãy nhấn "Compute". Ví dụ: để tính giờ chính ngọ cho tháng 5/2000 tại Cần Thơ, hãy chọn chức năng Sun Rise/Transit/Set, điền năm 2000, chọn tháng 5, chọn địa điểm ("Location") là "(Custom)" và điền tọa độ của Cần Thơ. Kinh tuyến và vĩ tuyến của Cần Thơ có thể tìm thấy dễ dàng trên Internet, . lịch và ngược lại. Ngoài ra, bạn có thể dùng chương trình để xem ngày, tính giờ; xem Can-Chi của ngày tháng âm lịch; tính giờ mặt trời mọc, lặn và giờ Chính. mỗi ô sẽ hiện ngày dương lịch và ngày âm tương ứng. Tên các Khí (Lập xuân, Thanh minh, Hạ chí .) cũng được hiện lên trong ngày Khí đó. Ngày âm lịch được