anitimejs/timejs/number.d.ts

Thư viện xử lý chuỗi số và thời gian trong JavaScript/Typescript

export type separatorType = "." | "," | "/" | ":" | "-" | "_" | "+";
export type NumberParseOptions = {
    /**
     * Định dạng của chuỗi đầu vào (nếu là string)
     * - 'default': phân tích chuỗi theo định dạng mặc định
     * - 'eu': phân tích theo định dạng châu Âu (dấu phẩy là dấu thập phân)
     * - 'custom': cho phép tùy chỉnh decimalSeparator và thousandSeparator
     */
    format?: 'default' | 'eu' | 'custom';
    /**
     * Ký tự phân cách phần thập phân trong chuỗi đầu vào
     */
    decimalSeparator?: string;
    /**
     * Ký tự phân cách hàng nghìn trong chuỗi đầu vào
     */
    thousandSeparator?: string;
};
export type NumberFormatOptions = {
    /**
     * Ký tự phân cách hàng nghìn trong kết quả
     */
    separator?: separatorType;
    /**
     * Kích thước nhóm chữ số (mặc định là 3)
     */
    groupSize?: number;
    /**
     * Chuyển đổi số thành chữ
     */
    toWords?: boolean;
    /**
     * Định dạng số dạng ngắn gọn (1k, 1M, 1B)
     */
    compact?: boolean;
    /**
     * Số chữ số thập phân cần hiển thị
     */
    decimals?: number;
    /**
     * Làm tròn số thập phân
     * - 'round': làm tròn thông thường (5 trở lên làm tròn lên)
     * - 'floor': luôn làm tròn xuống
     * - 'ceil': luôn làm tròn lên
     */
    rounding?: 'round' | 'floor' | 'ceil';
    /**
     * Hiển thị dấu + cho số dương
     */
    showPositiveSign?: boolean;
    /**
     * Ký tự phân cách phần thập phân trong kết quả
     */
    decimalSeparator?: string;
    /**
     * Định dạng là tiền tệ
     */
    currency?: string;
    /**
     * Vị trí ký hiệu tiền tệ ('prefix' hoặc 'suffix')
     */
    currencyPosition?: 'prefix' | 'suffix';
    /**
     * Phân tích chuỗi đầu vào
     */
    parseOptions?: NumberParseOptions;
};
export declare const numbers: (input: number | string, options?: NumberFormatOptions) => string | number;