Skip to content
Trong trang này

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 ​

sh
npm install iztro iztro-hook

Cá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ả.

tsx
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ểuMô tả
birthdaystringBắ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.
birthTimenumberBắ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(晚子時).
genderGenderNameBắt buộc. Với tiếng Việt, dùng 'Nam' hoặc 'Nữ'.
isLeapMonthbooleanCho biết ngày sinh âm lịch có thuộc tháng nhuận hay không. Mặc định là false.
fixLeapbooleanCó á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().
langLanguageNgô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.
astroTypeAstroTypeLoại lá số. 'heaven' là Thiên Bàn(天盤) mặc định, 'earth' là Địa Bàn(地盤) và 'human' là Nhân Bàn(人盤).
optionsConfigCấ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ườngMô 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.

Mã nguồn trên GitHub · npm