Âm Lịch

Mở lunar.afixer.app là thấy hôm nay: ngày âm, Can Chi của ngày, tháng và năm, tiết khí đang ở. Kế đó là lịch tháng, mỗi ô ghi kèm ngày âm. Ứng dụng không lưu ngày đang xem, nên lần nào mở ra cũng về hôm nay.

Thẻ ngày

Thẻ ở đầu trang tóm tắt ngày đang chọn:

• Ngày âm viết số lớn, kèm thứ, ngày dương, tháng âm và năm âm
• Can Chi của ngày, tháng và năm
• Tiết khí của ngày đó và ngày bắt đầu tiết, ví dụ «Tiết Sương giáng · từ 23/10»
• Nhãn ngày lễ, mùng 1, rằm, ngày ăn chay, và tháng đủ (30 ngày) hay thiếu (29 ngày)
• Giờ hoàng đạo: sáu giờ tốt trong ngày, giờ hiện tại được tô sáng khi xem hôm nay, kèm danh sách cả 12 giờ. Phần này tắt sẵn; bật trong Cài đặt → Bố cục.

Thẻ giữ nguyên kích thước với mọi ngày, nên bấm qua các ngày không làm nội dung trên trang xô lệch.

Lịch tháng

Lịch luôn có sáu hàng tuần, kể cả tháng chỉ cần năm hàng, để chiều cao không đổi khi chuyển tháng. Mỗi ô có ngày dương và ngày âm bên dưới; ô mùng 1 ghi thêm tháng âm (như 1/9). Chủ nhật và ngày nghỉ lễ in màu đỏ. Chấm xanh dương đánh dấu ngày bắt đầu một tiết khí, chấm xanh lá đánh dấu ngày ăn chay; trên màn hình rộng, tên tiết khí hiện thành chữ. Dòng dưới tên tháng cho biết tháng dương đó trải qua những tháng âm nào, ví dụ «Âm lịch: tháng 8 – 9, năm Bính Ngọ».

Chuyển tháng bằng nút ‹ ›, ô chọn tháng và năm, vuốt ngang trên điện thoại, nút «Hôm nay», hoặc bàn phím khi đang ở trong lịch:

Phím	Tác dụng
← →	Ngày trước, ngày sau
↑ ↓	Tuần trước, tuần sau
Home End	Đầu tuần, cuối tuần
Page Up Page Down	Tháng trước, tháng sau
Shift + Page Up Page Down	Năm trước, năm sau

Lịch có các năm từ 1900 đến 2100.

Đổi ngày Âm – Dương

Ô đổi ngày có hai chiều, Dương → Âm và Âm → Dương. Ngày âm nhập bằng các ô ngày, tháng, năm riêng và một ô đánh dấu tháng nhuận, chỉ bật được khi năm đó nhuận vào tháng đã chọn. Nhập một ngày không có, như ngày 30 của tháng thiếu, thì ứng dụng báo tháng đó chỉ có 29 ngày. Kết quả ghi kèm Can Chi của ngày, và nút «Xem trên lịch» mở lịch tới ngày đó; còn khi đang gõ, lịch đứng yên.

Ứng dụng đã cài có lối tắt «Đổi ngày Âm – Dương» trên biểu tượng, mở thẳng tới ô này.

Ngày lễ và đếm ngược

Ngày nghỉ lễ in đỏ trên lịch: Tết Dương lịch (1/1), Ngày Thống nhất (30/4), Quốc tế Lao động (1/5), Quốc khánh (2/9), Ngày Văn hoá (24/11), Giao thừa, mùng 1 đến mùng 4 Tết và Giỗ Tổ Hùng Vương (10/3 âm lịch).

Các ngày lễ khác hiện thành nhãn trong thẻ ngày: Quốc tế Phụ nữ (8/3), Quốc tế Thiếu nhi (1/6), Phụ nữ Việt Nam (20/10), Nhà giáo Việt Nam (20/11), Giáng sinh (25/12), Tết Nguyên Tiêu (15/1 âm lịch), Tết Hàn thực (3/3), Lễ Phật đản (15/4), Tết Đoan ngọ (5/5), Lễ Vu Lan (15/7), Tết Trung thu (15/8) và Ông Công Ông Táo (23/12).

Thẻ đếm ngược bật trong Cài đặt → Đếm ngược. Thẻ có thể đếm tới ngày lễ gần nhất, liệt kê tất cả ngày lễ sắp tới, hoặc đếm tới một ngày cố định: Tết Dương lịch, Tết Nguyên Đán, Giỗ Tổ Hùng Vương, Ngày Thống nhất, Quốc khánh hoặc Ngày Văn hoá. Ngày lễ âm lịch ghi kèm ngày âm. Trong phút cuối, thẻ đếm từng giây; tới ngày thì hiện «Hôm nay».

Ngày ăn chay và lời nhắc

Bật ngày ăn chay trong Cài đặt → Lịch và chọn lệ:

Lệ	Ngày âm lịch trong tháng
2 ngày	mùng 1, rằm
4 ngày	mùng 1, 14, rằm, cuối tháng
6 ngày	mùng 1, 8, 14, rằm, 23, cuối tháng
10 ngày	mùng 1, 8, 14, rằm, 18, 23, 24 và 3 ngày cuối tháng

Ngày cuối tháng là 29 hay 30 tuỳ tháng thiếu hay đủ. Ngày ăn chay có chấm xanh lá trên lịch và nhãn trong thẻ ngày.

Bật «Nhắc ngày ăn chay» để nhận thông báo đẩy, kể cả khi đã đóng trang. Chọn giờ nhắc (mặc định 6:00) và nhắc trong ngày hay trước một ngày. Thông báo có dạng «Hôm nay ăn chay 24/10/2026 (15/09/2026)»; khi nhiều ngày chay liền nhau, chỉ ngày đầu được nhắc, kèm số ngày liên tiếp. Ứng dụng đặt sẵn lời nhắc cho 365 ngày tới và làm mới mỗi lần mở, nên trình duyệt nào không mở lại Âm Lịch trong một năm thì hết nhắc.

Thông báo đi qua Web Push bằng pushkeep, dịch vụ đẩy thông báo tự host tại pushkeep.afixer.app. Trên iPhone và iPad, thông báo chỉ hoạt động sau khi đã thêm Âm Lịch vào màn hình chính (iOS 16.4 trở lên).

Múi giờ

Ngày âm phụ thuộc múi giờ, vì mùng 1 là ngày có trăng mới theo giờ địa phương. Lịch Việt Nam tính theo UTC+7, lịch Trung Quốc theo UTC+8, nên có năm hai lịch lệch nhau: Tết Ất Sửu 1985 ở Việt Nam là 21/1, sớm hơn Trung Quốc một tháng.

Trong Cài đặt → Lịch có thể chọn Việt Nam, Singapore, Nhật Bản, Sydney, Paris, London, New York, Los Angeles, múi giờ của máy, hoặc một múi nguyên giờ bất kỳ từ UTC−12 đến UTC+14. Khi chọn múi khác Việt Nam, thẻ ngày ghi rõ múi đang dùng.

Tuỳ chỉnh giao diện

• Chủ đề tự động theo máy, sáng hoặc tối
• Năm màu chủ đạo: Vàng kim, Ngọc bích, Chàm, Sen hồng, Mực tàu
• Bốn cỡ chữ từ Nhỏ tới Rất lớn, tính trên cỡ chữ đã chỉnh trong trình duyệt
• Kiểu số cổ điển (có chân) hoặc hiện đại, thẻ ngày nổi bật hoặc tối giản
• Khoảng cách thoáng hoặc gọn, tuần bắt đầu từ thứ Hai hoặc Chủ nhật
• Trên điện thoại, thẻ ngày hoặc lịch tháng nằm trên
• Ẩn hoặc hiện giờ hoàng đạo và ô đổi ngày

Các lựa chọn được áp dụng trước khi trang hiện ra, nên giao diện tối không loé trắng lúc mở.

Cài lên máy, dùng khi không có mạng

Âm Lịch là một Progressive Web App. Trên Android và Chrome máy tính, banner «Thêm Âm Lịch vào máy» có nút cài một chạm; trên iPhone, banner chỉ cách thêm vào màn hình chính. Nút cài cũng nằm trong Cài đặt → Ứng dụng.

Sau lần mở đầu tiên, toàn bộ ứng dụng được lưu trong máy và dùng được khi mất mạng. Khi có bản mới, ứng dụng hiện «Đã có phiên bản mới — Tải lại» và chờ bạn bấm, không tự tải lại trang.

Trợ năng

Chữ đạt độ tương phản WCAG AA ở mọi chủ đề và màu chủ đạo. Lịch tháng dùng cấu trúc lưới cho trình đọc màn hình, mỗi ô có nhãn tiếng Việt đầy đủ. Lịch dùng được hoàn toàn bằng bàn phím, và hiệu ứng chuyển tháng tắt khi máy bật chế độ giảm chuyển động.

Độ chính xác

Ngày âm được tính theo thuật toán của Hồ Ngọc Đức, dựa trên các công thức thiên văn gần đúng của Jean Meeus, cho các năm 1900–2100. Bộ kiểm thử so từng ngày với hai bảng độc lập: bảng lịch Việt Nam của Hồ Ngọc Đức (UTC+7, từ 1968 tới 2100) và bảng của Đài Thiên văn Hồng Kông (UTC+8, từ 1901 tới 2100). Chỗ khác được chấp nhận là vài tháng có thời điểm trăng mới cách nửa đêm chưa tới 7 phút, khi sai số vài phút của công thức có thể đẩy mùng 1 sang ngày kế bên.

Trước năm 1968, lịch chính thức của Việt Nam dùng bảng tính theo UTC+8. Âm Lịch tính theo UTC+7 cho mọi năm, nên khoảng 25 tháng trong giai đoạn 1903–1967 lệch với lịch in thời đó.

Bản viết lại tháng 10/2026 sửa một số lỗi tính từ bản trước, đều do bộ kiểm thử phát hiện: bảng giờ hoàng đạo sai ở 11 trên 12 chi của ngày; tháng 11 và tháng nhuận sai ở các năm 1995, 2014, 2052 và 2090; tháng thiếu bị tính thành 30 ngày, nên ngày chay cuối tháng của tháng thiếu không hiện và không được nhắc.

Dữ liệu

Cài đặt và lựa chọn giao diện lưu trong trình duyệt; ngày đang xem không được lưu. Khi bật lời nhắc, trình duyệt đăng ký với pushkeep và gửi lên lịch nhắc: giờ gửi, tiêu đề và nội dung từng thông báo. Tắt thông báo thì đăng ký đó bị xoá. Trang có bật Cloudflare Web Analytics.

Âm Lịch viết bằng JavaScript thuần, không framework, không bước build, không thư viện nào ngoài SDK của pushkeep, và chạy dưới dạng file tĩnh trên Cloudflare.