iztro-hook
iztro-hook cung cấp chức năng lập lá số và tính vận hạn của iztro dưới dạng React Hook. Dùng useIztro để lấy dữ liệu, sau đó tự thiết kế lá số, bảng hoặc bộ lọc. Để nhúng lá số tương tác có sẵn, hãy dùng react-iztro. Ngoài React, bạn có thể dùng iztro trực tiếp.
Cài đặt
npm install iztro iztro-hookCác ví dụ và tham số dưới đây dựa trên iztro-hook 1.3.5 và iztro 2.6.5.
Lấy lá số và vận hạn
Gọi useIztro ở cấp cao nhất của một thành phần hàm React hoặc một Hook tùy chỉnh. Ở lần kết xuất đầu tiên, cả astrolabe và horoscope đều có thể là undefined. Hãy kiểm tra dữ liệu đã sẵn sàng trước khi hiển thị kết quả.
import React from 'react';
import { useIztro } from 'iztro-hook';
export default function App() {
const { astrolabe, horoscope, setHoroscope } = useIztro({
birthday: '2000-8-16',
birthdayType: 'solar',
birthTime: 2,
gender: 'Nữ',
lang: 'vi-VN',
});
if (!astrolabe || !horoscope) {
return <p>Đang lập lá số…</p>;
}
return (
<section>
<p>Ngày sinh âm lịch: {astrolabe.lunarDate}</p>
<p>Ngày tra vận hạn: {horoscope.solarDate}</p>
<p>Can chi lưu niên: {horoscope.yearly.heavenlyStem}{horoscope.yearly.earthlyBranch}</p>
<button type="button" onClick={() => setHoroscope('2025-10-19', 2)}>
Xem vận hạn giờ Dần, ngày 19/10/2025
</button>
</section>
);
}Cuộn đến đây để tải ví dụ có thể chạy.
Tham số lập lá số
| Tham số | Kiểu | Mô tả |
|---|---|---|
birthday | string | Bắt buộc. Ngày sinh, ví dụ '2000-8-16'. birthdayType xác định ngày đó theo dương lịch hay âm lịch. |
birthdayType | 'solar' | 'lunar' | Bắt buộc. Dùng 'solar' cho dương lịch và 'lunar' cho âm lịch. |
birthTime | number | Bắt buộc. Chỉ số canh giờ lúc sinh, từ 0 đến 12. Ví dụ 2 là giờ Dần(寅時), 12 là giờ Tý muộn(晚子時). |
gender | GenderName | Bắt buộc. Với tiếng Việt, dùng 'Nam' hoặc 'Nữ'. |
isLeapMonth | boolean | Cho biết ngày sinh âm lịch có thuộc tháng nhuận hay không. Mặc định là false. |
fixLeap | boolean | Có áp dụng quy tắc điều chỉnh tháng nhuận khi lập lá số hay không. Mặc định là true. Xem astro.withOptions(). |
lang | Language | Ngôn ngữ của dữ liệu lá số và vận hạn. Khi được chỉ định, giá trị này được ưu tiên hơn options.language. |
astroType | AstroType | Loại lá số. 'heaven' là Thiên Bàn(天盤) mặc định, 'earth' là Địa Bàn(地盤) và 'human' là Nhân Bàn(人盤). |
options | Config | Cấu hình cho lá số hiện tại. Ví dụ { yearDivide: 'exact' } lấy Lập Xuân(立春) làm mốc chuyển năm. |
Nếu thông tin sinh đến từ biểu mẫu, hãy xác thực dữ liệu rồi mới kết xuất thành phần con gọi Hook. Nếu ngày sinh để trống hoặc không thể đọc được, Hook sẽ bỏ qua bước lập lá số và có thể vẫn hiển thị kết quả trước đó. Dữ liệu không hợp lệ khác có thể khiến iztro báo lỗi. Xem cấu hình lập lá số và kiểm tra đầu vào.
Giá trị trả về
| Trường | Mô tả |
|---|---|
astrolabe | Đối tượng FunctionalAstrolabe. Bạn có thể đọc dữ liệu như mười hai cung(十二宮) và các chính tinh(主星), hoặc gọi phương thức của đối tượng để tra cứu thêm. |
horoscope | Đối tượng FunctionalHoroscope, chứa kết quả Đại Hạn(大限), Tiểu Hạn(小限), Lưu Niên(流年), Lưu Nguyệt(流月), Lưu Nhật(流日) và Lưu Thì(流時). Kết quả ban đầu được tính theo ngày và canh giờ hiện tại tại địa phương. |
setHoroscope(date, hour?) | Cập nhật điều kiện tra vận hạn. date nhận chuỗi ngày dương lịch hoặc Date. hour nhận chỉ số canh giờ từ 0 đến 12. Khi bỏ qua hour, Hook quy đổi giờ địa phương của ngày đã truyền thành chỉ số canh giờ. |
setHoroscope trả về void. Đọc horoscope đã cập nhật ở lần kết xuất sau. Lệnh gọi chỉ đổi điều kiện tra vận hạn, còn thông tin sinh vẫn do đầu vào của Hook quyết định.