Список версий МТ

Главная

api.df

Форматирование данных

Methods

api.df.correctDateTime(checkValue, minValue, maxValue) → DateTime
api.df.dateTimeFromVariant(vdt) → Date
api.df.dateTimeIsNull(dt) → Boolean
api.df.dateTimeToString(dt) → String
api.df.dateTimeToUI(dt) → String
api.df.dateToUI(dt) → String
api.df.dateToUIGenitive(dt) → String
api.df.daysBetweenDates(begin, end) → Number
api.df.formatAmount(value, distributorId) → String
api.df.formatDiscount(value) → String
api.df.formatDouble(value, prec) → String
api.df.formatPercent(value) → String
api.df.formatPrice(value, distributorId) → String
api.df.formatQuantity(value, isReal, distributorId) → String
api.df.formatSurveyAnswer(value, distributorId) → String
api.df.pathToUri(path) → String
api.df.roundAmount(value, distributorId) → Number
api.df.roundDouble(value, prec) → Number
api.df.roundPrice(value, distributorId) → Number
api.df.roundQuantity(value, isReal, distributorId) → Number
api.df.roundWeight(value, distributorId) → Number
api.df.stringDateTime(dt, format) → String
api.df.timeToUI(dt) → String

Methods description

correctDateTime(checkValue, minValue, maxValue) → DateTime

Приведение даты и времени к доступному диапазону

Parameters:
Name Type Description
checkValue *

Корректируемая дата и время
minValue *

Минимальная дата и время
maxValue *

Максимальная дата и время
Return:
DateTime -

Дата и время скорректированная в соответствии с мин/макс значениями

dateTimeFromVariant(vdt) → Date

Попытаться преобразовать строку в дату

Parameters:
Name Type Description
vdt String

Преобразуемая строка
Return:
Date -

Дата и/или время. Если преобразование не удалось, вернется минимальная дата.
Example
// Вернет 21 ноября 2001 года 00:00:00
api.df.dateTimeFromVariant("21-11-2001")
// Вернет 4 января 2016 года 00:00:00
api.df.dateTimeFromVariant("2016.01.04")
// Вернет 6 октября 1992 года 11:31:24
api.df.dateTimeFromVariant("06.10.1992 11:31:24")
// Строка не может быть преобразована, вернет 1 января 1900 года 00:00:00
api.df.dateTimeFromVariant("random_string_not_date");

dateTimeIsNull(dt) → Boolean

Проверка даты и времени на валидность

Parameters:
Name Type Description
dt *

Дата и время
Return:
Boolean -

true - Дата и время не валидны, false - Дата и/или время валидны

dateTimeToString(dt) → String

Преобразовать дату и время в формат ISO

Parameters:
Name Type Description
dt *

Дата и время
Return:
String -

Дата и время в виде yyyy-MM-dd HH:mm:ss.zzz

dateTimeToUI(dt) → String

Преобразовать дату и время для вывода

Parameters:
Name Type Description
dt *

Дата и время
Return:
String -

Дата и время в виде dd.MM.yyyy hh:mm

dateToUI(dt) → String

Преобразовать дату для вывода

Parameters:
Name Type Description
dt *

Дата и время
Return:
String -

Дата в виде dd.MM.yyyy

dateToUIGenitive(dt) → String

Преобразовать дату для вывода в родительном падеже

Parameters:
Name Type Description
dt *

Дата и время
Return:
String -

Дата в родительном падеже (dd месяц yyyy)

daysBetweenDates(begin, end) → Number

Рассчитать количество дней до определенной даты если указан один параметр, то за begin берётся текущая дата

Parameters:
Name Type Argument Description
begin *

Начальная дата
end * optional 

Конечная дата
Return:
Number -

Число дней

formatAmount(value, distributorId) → String

Округлить и форматировать сумму. Число знаков после запятой берется из константы CountFiguresRoundPDASums. Если константа не задана у дистрибьютора - 6 знаков.

Parameters:
Name Type Argument Description
value Number

Сумма
distributorId ID optional 

Дистрибьютор, по которому будет определяться точность округления. По-умолчанию дистрибьютор маршрута.
Return:
String -

Форматированная сумма

formatDiscount(value) → String

Округлить до двух знаков после запятой и форматировать скидку

Parameters:
Name Type Description
value Number

Скидка
Return:
String -

Форматированная скидка

formatDouble(value, prec) → String

Округлить и форматировать число

Parameters:
Name Type Argument Default Description
value Number

Число
prec Number optional  2

Точность округления
Return:
String -

Форматированное число

formatPercent(value) → String

Округлить до двух знаков после запятой и форматировать проценты

Parameters:
Name Type Description
value Number

Проценты
Return:
String -

Форматированные проценты

formatPrice(value, distributorId) → String

Округлить и форматировать цену. Число знаков после запятой берется из константы CountFiguresRoundPDAPrice. Если константа не задана у дистрибьютора - 6 знаков.

Parameters:
Name Type Argument Description
value Number

Цена
distributorId ID optional 

Дистрибьютор, по которому будет определяться точность округления. По-умолчанию дистрибьютор маршрута.
Return:
String -

Форматированная цена

formatQuantity(value, isReal, distributorId) → String

Округлить и форматировать количество товара. Число знаков после запятой берется из константы CountFiguresRoundNumberGood. Если константа не задана у дистрибьютора - 6 знаков.

Parameters:
Name Type Argument Default Description
value Number

Количество товара
isReal Boolean optional  false

Вещественное или целое
distributorId ID optional 

Дистрибьютор, по которому будет определяться точность округления. По-умолчанию дистрибьютор маршрута.
Return:
String -

Форматированное количество товара

formatSurveyAnswer(value, distributorId) → String

Округлить и форматировать результат опроса. Число знаков после запятой берется из константы CountFiguresRoundInSurveyRows. Если константа не задана у дистрибьютора - 6 знаков.

Parameters:
Name Type Argument Description
value Number

Результат опроса
distributorId ID optional 

Дистрибьютор, по которому будет определяться точность округления. По-умолчанию дистрибьютор маршрута.
Return:
String -

Форматированный результат опроса

pathToUri(path) → String

Преобразовать путь (например, до файла) в URI

Parameters:
Name Type Description
path String

Путь
Return:
String -

URI

roundAmount(value, distributorId) → Number

Округлить сумму до числа знаков округления дистрибьютора. Число знаков после запятой берется из константы CountFiguresRoundPDASums. Если константа не задана у дистрибьютора - 6 знаков.

Parameters:
Name Type Argument Description
value Number

Сумма
distributorId ID optional 

Дистрибьютор, по которому будет определяться точность округления. По-умолчанию дистрибьютор маршрута.
Return:
Number -

Округленная сумма

roundDouble(value, prec) → Number

Округлить число с плавающей запятой до необходимого числа знаков округления

Parameters:
Name Type Argument Default Description
value Number

Число
prec Number optional  6

Число знаков после запятой
Return:
Number -

Округленное число

roundPrice(value, distributorId) → Number

Округлить цену до числа знаков округления дистрибьютора. Число знаков после запятой - большее значение из констант CountFiguresRoundPDACalculation или CountFiguresRoundPDAPrice. Если константа не задана у дистрибьютора - 6 знаков.

Parameters:
Name Type Argument Description
value Number

Цена
distributorId ID optional 

Дистрибьютор, по которому будет определяться точность округления. По-умолчанию дистрибьютор маршрута.
Return:
Number -

Округленная цена

roundQuantity(value, isReal, distributorId) → Number

Округлить количество до числа знаков округления дистрибьютора. Eсли isReal == true, число знаков после запятой - 0, иначе оно берется из константы CountFiguresRoundNumberGood. Если константа не задана у дистрибьютора - 6 знаков.

Parameters:
Name Type Argument Default Description
value Number

Количество
isReal Boolean optional  true

Признак делимых единиц измерения
distributorId ID optional 

Дистрибьютор, по которому будет определяться точность округления. По-умолчанию дистрибьютор маршрута.
Return:
Number -

Округленное количество

roundWeight(value, distributorId) → Number

Округлить вес до нуля знаков после запятой

Parameters:
Name Type Argument Description
value Number

Вес
distributorId ID optional 

Идентификатор дистрибьютора. По-умолчанию дистрибьютор маршрута.
Return:
Number -

Округленный вес

stringDateTime(dt, format) → String

Преобразовать дату и время в строку по заданному шаблону

Parameters:
Name Type Argument Description
dt Date

Дата и время
format String optional 

Формат преобразования; список шаблонов доступен по ссылке: http://doc.qt.io/qt-5/qdatetime.html#toString
Return:
String -

Строка с результатом преобразования

timeToUI(dt) → String

Преобразовать время для вывода

Parameters:
Name Type Description
dt *

Дата и время
Return:
String -

Время в виде hh:mm:ss.zzz