import { DisplayDateResolution, Money, TimeZone } from '../model/CommonTypes.ts';

export declare const formatUtil: {
    /**
     * 개행 문자('\r', '\n')를 '<br/>' 태그로 변경한다.
     * @param str 변경할 String
     * @return 개행문자가 '<br/>'로 변경된 String
     */
    escapeNewLine(str?: string): string;
    /**
     * `str` 안의 `&<>"'` 문자를 escape 처리한다.
     * @param str 변경할 String
     */
    escapeHtml(str?: string): string;
    /**
     * String 을 개행 문자('\r', '\n') 기준으로 나눈다.
     * @param str
     * @return 개행문자로 나누어진 string 의 array
     */
    splitNewLine(str?: string): Array<string>;
    /**
     * ISO8601 형식의 string 을 주어진 format 으로 변환한다.
     * @param utcDate
     * @param format
     * @param displayTimeZone
     */
    formatDateString(utcDate?: string, format?: string | DisplayDateResolution, displayTimeZone?: TimeZone): string;
    /**
     * 숫자에 구분점을 넣는다. 소수점 이하가 있는 경우도 처리한다.
     * * 12345 -> '12,345'
     * * 12345.12345 -> '12,345.12345'
     * * 0 -> '0'
     * * undefined -> null
     * * null -> null
     *
     * @param value
     * @return
     */
    formatNumber(value?: number | string | null): string | null;
    formatNumberByCode(value?: number | string | null, locale?: string | 'ko-KR'): string | null;
    /**
     * 통화단위와 표시위치를 받아 출력한다
     * @param value 값 또는 Money 객체
     * @param currencyUnit 통화단위 (Money 객체인 경우 무시됨)
     * @param prefix true 이면 withUnit을 앞에 붙이고, false 이면 뒤에 붙인다.
     */
    formatPrice(value?: number | string | Money | null, currencyUnit?: string | '', prefix?: boolean): string | null;
    /**
     * rate 를 받아 percent 를 출력한다.
     * * 0.1 -> 10%
     * * 0.55 -> 55%
     * * 0.551 -> 55.1%
     * @param value 비율 값
     * @param withUnit true 이면 % 를 붙이고, false 이면 붙이지 않는다.
     * @param decimalPlace 소숫점 n번째에서 반올림한다.
     */
    formatPercent(value?: number | string | null, withUnit?: boolean, decimalPlace?: number): string | null;
    /**
     * 신용카드번호를 4자리 단위로 나누어 구분자를 넣는다.
     * @param value
     * @param separator 구분자
     */
    formatCreditCardNo(value: string, separator?: string): string | undefined;
    /**
     *  `HTML`태그가 포함된 문자열에서 text 만 남긴다.
     *  @param textIncludedHTMLElement HTML 태그를 포함하는 문자열
     *  @return HTML 태그가 제거된 문자열
     */
    toPlainText(textIncludedHTMLElement?: string): string;
};