Định nghĩa kiểu dữ liệu ​

Lời mở đầu ​

Trang này mô tả các kiểu dữ liệu trong iztro. Các kiểu dữ liệu quốc tế hóa được định nghĩa trong i18n, còn các kiểu khác nằm trong types.

Bạn có thể nhập các kiểu dữ liệu quốc tế hóa bằng đoạn mã sau:

import { HeavenlyStemName } from "iztro/lib/i18n";

Để nhập các kiểu dữ liệu khác, hãy dùng:

import { Palace } from "iztro/lib/data/types";

Các kiểu dữ liệu đa ngôn ngữ ​

Để hỗ trợ đầu vào và đầu ra đa ngôn ngữ, iztro định nghĩa tên gọi bằng nhiều ngôn ngữ cho các tham số và kết quả. Bạn có thể nhập giá trị bằng bất kỳ ngôn ngữ được hỗ trợ nào; ví dụ, HeavenlyStemName chấp nhận 甲, 갑 hoặc jia.

Ví dụ, khi gọi getHoroscopeStar(), bạn có thể truyền tên thiên can（天干） và địa chi（地支） bằng tiếng Trung làm đối số:

import { getHoroscopeStar } from "iztro/lib/star";

getHoroscopeStar("甲", "子", "decadal");

Bạn cũng có thể truyền tên gọi bằng ngôn ngữ khác được hỗ trợ, hoặc kết hợp nhiều ngôn ngữ trong cùng một lần gọi:

import { getHoroscopeStar } from "iztro/lib/star";

getHoroscopeStar("갑", "zi", "decadal");

Dù đầu vào dùng ngôn ngữ nào, kết quả vẫn được xuất thống nhất bằng ngôn ngữ bạn chọn. Hãy đặt ngôn ngữ đầu ra trước khi gọi phương thức:

import { setLanguage } from "iztro/lib/i18n";

setLanguage("ko-KR");

const horoscopeStar = getHoroscopeStar("甲", "zi", "decadal");

Lúc này, kết quả đầu ra của horoscopeStar sẽ là tiếng Hàn.

[
  [
    {
      "name": "록존(십년)",
      "type": "lucun",
      "scope": "decadal"
    },
    {
      "name": "천마(십년)",
      "type": "tianma",
      "scope": "decadal"
    }
  ],
  [
    {
      "name": "경양(십년)",
      "type": "tough",
      "scope": "decadal"
    },
    {
      "name": "홍란(십년)",
      "type": "flower",
      "scope": "decadal"
    }
  ],
  [],
  [
    {
      "name": "문창(십년)",
      "type": "soft",
      "scope": "decadal"
    }
  ],
  [],
  [
    {
      "name": "천월(십년)",
      "type": "soft",
      "scope": "decadal"
    }
  ],
  [],
  [
    {
      "name": "문곡(십년)",
      "type": "soft",
      "scope": "decadal"
    },
    {
      "name": "천희(십년)",
      "type": "flower",
      "scope": "decadal"
    }
  ],
  [],
  [],
  [],
  [
    {
      "name": "천괴(십년)",
      "type": "soft",
      "scope": "decadal"
    },
    {
      "name": "타라(십년)",
      "type": "tough",
      "scope": "decadal"
    }
  ]
]

HeavenlyStemName ​

Định nghĩa tên gọi của mười thiên can（十天干）.

EarthlyBranchName ​

Định nghĩa mười hai địa chi（十二地支）. Địa chi Ngọ（午） và thiên can Mậu（戊） đều có cách phiên âm thông thường là “wu”. Để tránh trùng tên khi xử lý đầu vào đa ngôn ngữ, thư viện biểu thị địa chi Ngọ（午） bằng tên woo.

PalaceName ​

Định nghĩa Tên của các cung（宮位） trong Tử Vi Đẩu Số（紫微斗數）.

Brightness ​

Định nghĩa độ sáng của sao（星曜）.

Mutagen ​

Xác định tên của sao tứ hóa（四化星） trong Tử Vi Đẩu Số（紫微斗數）

StarName ​

Định nghĩa tên các sao（星曜） trong Tử Vi Đẩu Số（紫微斗數）, bao gồm cả lưu diệu（流曜）.

FiveElementsClassName ​

Xác định tên của Cục ngũ hành（五行局） trong Tử Vi Đẩu Số（紫微斗數）

GenderName ​

Xác định tên của giới tính

Các kiểu dữ liệu dùng chung ​

Language ​

export type Language = `zh-CN` | `zh-TW` | `en-US` | `ko-KR` | `ja-JP` | `vi-VN`;

ngôn ngữ được hỗ trợ đã được xác định. Các ngôn ngữ hiện được hỗ trợ là:

• zh-CN: Tiếng Trung giản thể
• zh-TW: Tiếng Trung phồn thể
• en-US：English
• ko-KR：한국어
• ja-JP: Tiếng Nhật
• vi-VN: Tiếng Việt

Scope ​

export type Scope = "origin" | "decadal" | "yearly";

Định nghĩa phạm vi áp dụng của sao（星曜） để phân biệt sao bản mệnh（本命星曜） với lưu diệu（流曜）:

• origin: sao bản mệnh（本命星曜）
• decadal: sao đại hạn（大限星曜）
• yearly: sao lưu niên（流年星曜）

StarType ​

export type StarType =
  | "major"
  | "soft"
  | "tough"
  | "adjective"
  | "flower"
  | "helper"
  | "lucun"
  | "tianma";

Định nghĩa loại của sao（星曜）. Dù sao đào hoa（桃花星） và Giải Thần（解神） (bao gồm Niên Giải（年解）) thuộc tạp diệu（雜曜）, chúng có ý nghĩa riêng trong luận giải lá số nên được phân loại riêng. Hai phụ tinh Lộc Tồn（祿存） và Thiên Mã（天馬） cũng có vai trò đặc biệt, nên mỗi sao được xếp vào một nhóm riêng:

• major: chính tinh（主星）
• soft: cát tinh（吉星）
• tough: sát tinh（煞星）
• adjective: tạp diệu（雜曜）
• flower: sao đào hoa（桃花）
• helper：Giải Thần（解神）
• lucun：Lộc Tồn（祿存）
• tianma：Thiên Mã（天馬）

Sao（星曜） ​

Star ​

export type Star = {
  name: StarName;
  type: StarType;
  scope: Scope;
  brightness?: Brightness;
  mutagen?: Mutagen;
};

Định nghĩa cấu trúc dữ liệu cho đối tượng sao（星曜）.

Cung（宮位） ​

SoulAndBody ​

export type SoulAndBody = {
  soulIndex: number;
  bodyIndex: number;
  heavenlyStemOfSoul: HeavenlyStemName;
  earthlyBranchOfSoul: EarthlyBranchName;
};

Định nghĩa thông tin vị trí của cung Mệnh（命宮） và cung Thân（身宮）.

Palace ​

export type Palace = {
  name: PalaceName;
  isBodyPalace: boolean;
  isOriginalPalace: boolean;
  heavenlyStem: HeavenlyStemName;
  earthlyBranch: EarthlyBranchName;
  majorStars: Star[];
  minorStars: Star[];
  adjectiveStars: Star[];
  changsheng12: StarName;
  boshi12: StarName;
  jiangqian12: StarName;
  suiqian12: StarName;
  decadal: Decadal;
  ages: number[];
};

Định nghĩa cấu trúc dữ liệu cho đối tượng cung（宮位）.

SurroundedPalaces ​

export type SurroundedPalaces = {
  target: IFunctionalPalace;
  opposite: IFunctionalPalace;
  wealth: IFunctionalPalace;
  career: IFunctionalPalace;
};

Định nghĩa cấu trúc dữ liệu cho đối tượng tam phương tứ chính（三方四正）.

Vận hạn（運限） ​

HoroscopeItem ​

export type HoroscopeItem = {
  index: number;
  name: string;
  heavenlyStem: HeavenlyStemName;
  earthlyBranch: EarthlyBranchName;
  palaceNames: PalaceName[];
  mutagen: StarName[];
  stars?: Star[][];
};

Định nghĩa cấu trúc dữ liệu cho đối tượng vận hạn（運限）.

Decadal ​

export type Decadal = {
  range: [number, number];
  heavenlyStem: HeavenlyStemName;
  earthlyBranch: EarthlyBranchName;
};

Định nghĩa dữ liệu Đại Hạn（大限） của lá số. Kiểu này chủ yếu được dùng trong Palace.

DecadalHoroscope ​

export type DecadalHoroscope = HoroscopeItem & {
  palaceName: PalaceName;
  ageRange: [number, number];
  yearRange: [number, number];
};

Định nghĩa một mục trong danh sách đại hạn（大限） do decadalList() trả về.

Loại này cũng chứa tất cả các thuộc tính của HoroscopeItem.

YearlyHoroscope ​

export type YearlyHoroscope = HoroscopeItem & {
  age: number;
  year: number;
};

Định nghĩa một mục trong danh sách lưu niên（流年） do yearlyList() trả về.

Loại này cũng chứa tất cả các thuộc tính của HoroscopeItem.

MonthlyHoroscope ​

export type MonthlyHoroscope = YearlyHoroscope & {
  month: number;
  isLeapMonth: boolean;
  part: 'normal' | 'first' | 'second';
  dayRange: [number, number];
};

Định nghĩa một mục trong danh sách lưu nguyệt（流月） do monthlyList() trả về.

Loại này chứa tất cả các thuộc tính của cả YearlyHoroscope và HoroscopeItem.

Horoscope ​

export type Horoscope = {
  lunarDate: string;
  solarDate: string;
  decadal: HoroscopeItem;
  age: {
    index: number;
    nominalAge: number;
  };
  yearly: HoroscopeItem & {
    yearlyDecStar: {
      jiangqian12: StarName[];
      suiqian12: StarName[]
      }
    };
  monthly: HoroscopeItem;
  daily: HoroscopeItem;
  hourly: HoroscopeItem;
};

Định nghĩa đối tượng vận hạn（運限）, bao gồm dữ liệu Đại Hạn（大限）, Lưu Niên（流年）, Lưu Nguyệt（流月）, Lưu Nhật（流日） và Lưu Thì（流時）.

Lá số（星盤） ​

Astrolabe ​

export type Astrolabe = {
  gender: GenderName;
  solarDate: string;
  lunarDate: string;
  chineseDate: string;
  rawDates: {
    lunarDate: LunarDate;
    chineseDate: HeavenlyStemAndEarthlyBranchDate;
  };
  time: string;
  timeRange: string;
  sign: string;
  zodiac: string;
  earthlyBranchOfSoulPalace: EarthlyBranchName;
  earthlyBranchOfBodyPalace: EarthlyBranchName;
  soul: StarName;
  body: StarName;
  fiveElementsClass: FiveElementsClassName;
  palaces: IFunctionalPalace[];
};

Định nghĩa cấu trúc dữ liệu cho đối tượng lá số（星盤）.

Cấu hình và trình cắm ^2.3.0 ​

ConfigMutagens ​

Xác định tham số tứ hóa（四化） trong cấu hình chung.

type ConfigMutagens = Partial<Record<HeavenlyStemName, StarName[]>>;

ConfigBrightness ​

Xác định tham số độ sáng trong cấu hình chung.

type ConfigBrightness = Partial<Record<StarName, Brightness[]>>;

Config ​

Định nghĩa đối tượng cấu hình tính toán lá số. Dùng astro.config() để đặt giá trị mặc định cho các lá số được tạo sau đó, hoặc withOptions({ config }) để chỉ ghi đè cấu hình của lá số đang tạo. Các lá số đã tạo vẫn giữ cấu hình tại thời điểm tạo (^2.6.2).

type Config = {
  // 星曜四化配置
  mutagens?: ConfigMutagens;
  // 星曜亮度配置
  brightness?: ConfigBrightness;
  // 年分割点配置
  yearDivide?: 'normal' | 'exact';
  // 运限分割点配置（^v2.4.3）
  horoscopeDivide?: 'normal' | 'exact';
  // 小限分割点配置，normal为以自然年分界，birthday为生日分界（^v2.4.5）
  // 默认为 normal
  ageDivide?: 'normal' | 'birthday';
  // 晚子时配置，current 时晚子时算当日，forward 时晚子时算次日（^v2.5.2）
  // 默认为 forward
  dayDivide?: 'current' | 'forward';
  // 安星方法，default 为通行版本，zhongzhou 为中州派版本（^v2.5.0）
  // 默认为 default
  algorithm?: 'default' | 'zhongzhou';
};

Với yearDivide và horoscopeDivide, giá trị normal lấy mồng một tháng Giêng âm lịch làm mốc chuyển năm, còn exact lấy tiết Lập Xuân（立春） làm mốc.

dayDivide chỉ quyết định giờ Tý muộn（晚子時）(timeIndex bằng 12) được tính vào ngày nào: forward tính vào ngày hôm sau, còn current tính vào ngày hiện tại.

AstroType ^2.5.0 ​

Định nghĩa kiểu lá số của phái Trung Châu（中州派）.

type AstroType = 'heaven' | 'earth' | 'human';

Plugin ​

Định nghĩa kiểu trình cắm. Thực chất, một trình cắm là một hàm.

type Plugin = () => void;