tinkoff-invest-api/cjs/helpers.js

Node.js SDK for Tinkoff Invest API

"use strict";
/**
 * Хелперы.
 * See: https://tinkoff.github.io/investAPI/faq_custom_types/
 */
var __importDefault = (this && this.__importDefault) || function (mod) {
    return (mod && mod.__esModule) ? mod : { "default": mod };
};
Object.defineProperty(exports, "__esModule", { value: true });
exports.Helpers = void 0;
const ms_1 = __importDefault(require("ms"));
const string_js_1 = require("./utils/string.js");
class Helpers {
    /**
     * Переводит число в Quotation.
     * Пример: 123.4 -> { units: 123, nano: 400000000 }
     */
    static toQuotation(value) {
        const sign = value < 0 ? -1 : 1;
        const absValue = Math.abs(value);
        const units = Math.floor(absValue);
        // Math.round нужен, чтобы не было чисел вида 10000000.00000227
        const nano = Math.round((absValue - units) * 1000000000);
        return {
            units: sign * units,
            nano: sign * nano,
        };
    }
    /**
     * Переводит число в MoneyValue { units, nano, currency }
     * Пример: (123.4, 'rub') -> { units: 123, nano: 400000000, currency: 'rub' }
     */
    static toMoneyValue(value, currency) {
        const { units, nano } = Helpers.toQuotation(value);
        return { units, nano, currency };
    }
    /**
     * Переводит MoneyValue в строку.
     * Пример: { units: 123, nano: 400000000, currency: 'rub' } -> '123.4 rub'
     */
    static toMoneyString(value) {
        return `${Helpers.toNumber(value)} ${value?.currency}`;
    }
    /**
     * Переводит Quotation или MoneyValue в число.
     * Пример: { units: 123, nano: 400000000 } -> 123.4
     */
    static toNumber(value) {
        return (value ? value.units + value.nano / 1000000000 : value);
    }
    /**
     * Возвращает интервал времени в формате { from, to } по заданному смещению и базовой дате.
     * Для смещения можно использовать кол-во миллисекунд или строку в формате из https://github.com/vercel/ms
     */
    static fromTo(offset, base = new Date()) {
        // Не использую StringValue, т.к. с ним больше мороки: нужно импортить при использовании итд.
        const offsetMs = typeof offset === 'string' ? (0, ms_1.default)(offset) : offset;
        const date = new Date(base.valueOf() + offsetMs);
        const [from, to] = offsetMs > 0 ? [base, date] : [date, base];
        return { from, to };
    }
    /**
     * Переводит значения констант в человеко-читаемые строки.
     * Пример: CandleInterval.CANDLE_INTERVAL_1_MIN -> '1_MIN'
     */
    static toHuman(value, values) {
        const str = values[value] || '';
        const commonPart = (0, string_js_1.getCommonPart)(values[0], values[1]);
        return str.replace(commonPart, '');
    }
}
exports.Helpers = Helpers;
//# sourceMappingURL=helpers.js.map