Подробное описание

Апи для работы с утилитарными методами приведения и преобразования величин и структур

api.df

Открытые члены
	correctDateTime (checkValue, minValue, maxValue, format)
	Приведение даты и времени к доступному диапазону Подробнее...

	dateTimeFromVariant (vdt)
	Попытаться преобразовать строку в дату Подробнее...

	dateTimeIsNull (dt)
	Проверить валидность даты и времени Подробнее...

	dateTimeToString (dt)
	Получить дату и время в формате "yyyy-MM-dd HH:mm:ss.zzz". Подробнее...

	dateToUIGenitive (dt)
	Получить только дату в родительном падеже (пример: 15 июля 2008) Подробнее...

	daysBetweenDates (begin, end)
	Рассчитать количество дней до определенной даты. Если указан один параметр, то возвращает количество дней от указанной даты до сегодняшнего дня. Подробнее...

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

	formatDate (dt)
	Преобразовать дату для вывода Подробнее...

	formatDateTime (dt)
	Преобразовать дату и время для вывода Подробнее...

	formatDiscount (value)
	Округлить до двух знаков после запятой и форматировать скидку Подробнее...

	formatDouble (value, prec)
	Округлить и форматировать число Подробнее...

	formatPercent (value)
	Округлить до двух знаков после запятой и форматировать проценты Подробнее...

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

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

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

	formatTime (dt)
	Преобразовать время для вывода Подробнее...

	idIsValid (id)
	Проверить валидность идентификатора Подробнее...

	monthName (monthNumber, isShort)
	Возвращает наименование месяца по его порядковому номеру в полной или короткой форме (январь/янв) Подробнее...

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

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

	roundDouble (value, prec)
	Округлить число с плавающей запятой до необходимого числа знаков округления Подробнее...

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

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

	roundWeight (value, distributorId)
	Округлить вес до третьего знака после запятой Подробнее...

	stringDateTime (dt, format)
	Преобразовать дату и время в строку по заданному шаблону Подробнее...

Методы

correctDateTime (checkValue, minValue, maxValue, format)

struct DateTimeFormat * correctDateTime	(	checkValue	,
		minValue	,
		maxValue	,
		format
	)

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

Аргументы

checkValue	[DateTime] - Корректируемая дата и время
minValue	[DateTime] - Минимальная дата и время
maxValue	[DateTime] - Максимальная дата и время
format	[DateTimeFormat] optional - Формат для обработки

Возвращает: DateTime - Дата и время скорректированная в соответствии с мин/макс значениями

dateTimeFromVariant (vdt)

dateTimeFromVariant ( vdt )

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

Аргументы

vdt	[String] - Преобразуемая строка

Возвращает: Date - Дата и/или время. Если преобразование не удалось, вернется минимальная дата

// Вернет 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)

dateTimeIsNull ( dt )

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

Аргументы

dt	[DateTime] - Дата и время

Возвращает: Boolean - Признак валидности даты и времени

dateTimeToString (dt)

dateTimeToString ( dt )

Получить дату и время в формате "yyyy-MM-dd HH:mm:ss.zzz".

Аргументы

dt	[DateTime] - Дата и время

Возвращает: String - Форматированные дата и время

dateToUIGenitive (dt)

dateToUIGenitive ( dt )

Получить только дату в родительном падеже (пример: 15 июля 2008)

Аргументы

dt	[Date] - Дата и время

Возвращает: String - Дата в родительном падеже

daysBetweenDates (begin, end)

daysBetweenDates	(	begin	,
		end
	)

Рассчитать количество дней до определенной даты. Если указан один параметр, то возвращает количество дней от указанной даты до сегодняшнего дня.

Аргументы

begin	[Date] - Первая дата
end	[Date] optional - Вторая дата

Возвращает: Number - Число дней

formatAmount (value, distributorId)

formatAmount	(	value	,
		distributorId
	)

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

Аргументы

value	[Number] - Сумма
distributorId	[ID] optional - Дистрибьютор, для которого будет определяться точность округления (по умолчанию дистрибьютор маршрута)

Возвращает: String - Форматированное значение

formatDate (dt)

formatDate ( dt )

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

Аргументы

dt	[DateTime] - Строка даты со временем

Возвращает: String - Дата в формате "dd.MM.yyyy"

formatDateTime (dt)

formatDateTime ( dt )

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

Аргументы

dt	[DateTime] - Строка даты со временем

Возвращает: String - Дата в формате "dd.MM.yyyy hh:mm"

formatDiscount (value)

formatDiscount ( value )

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

Аргументы

value [Number] - Скидка

Возвращает: String - Форматированное значение

formatDouble (value, prec)

formatDouble	(	value	,
		prec
	)

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

Аргументы

value	[Number] - Число для обработки
prec	[Number] optional - Число знаков после запятой для округления (по умолчанию = 2)

Возвращает: String - Форматированное значение

formatPercent (value)

formatPercent ( value )

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

Аргументы

value [Number] - Процент

Возвращает: String - Форматированное значение

formatPrice (value, distributorId)

formatPrice	(	value	,
		distributorId
	)

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

Аргументы

value	[Number] - Цена
distributorId	[ID] optional - Дистрибьютор, для которого будет определяться точность округления (по умолчанию дистрибьютор маршрута)

Возвращает: String - Форматированное значение

formatQuantity (value, isReal, distributorId)

formatQuantity	(	value	,
		isReal	,
		distributorId
	)

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

Аргументы

value	[Number] - Количество товара
isReal	[Boolean] optional - Признак дробного количества (по умолчанию false)
distributorId	[ID] optional - Дистрибьютор, по которому будет определяться точность округления (по умолчанию дистрибьютор маршрута)

Возвращает: String - Форматированное значение

formatSurveyAnswer (value, distributorId)

formatSurveyAnswer	(	value	,
		distributorId
	)

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

Аргументы

value	[Number] - Результат опроса
distributorId	[ID] optional - Дистрибьютор, для которого будет определяться точность округления (по умолчанию дистрибьютор маршрута)

Возвращает: String - Форматированное значение

formatTime (dt)

formatTime ( dt )

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

Аргументы

dt	[DateTime] - Строка даты со временем

Возвращает: String - Время в формате "hh:mm:ss.zzz"

idIsValid (id)

idIsValid ( id )

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

Аргументы

id	[ID] - Идентификатор

Возвращает: Boolean - Признак валидного идентификатора

monthName (monthNumber, isShort)

monthName	(	monthNumber	,
		isShort
	)

Возвращает наименование месяца по его порядковому номеру в полной или короткой форме (январь/янв)

Аргументы

monthNumber	[Number] - Порядковый номер месяца
isShort	[Boolean] optional - Укороченная ли форма вывода. По умолчанию false

Возвращает: String

pathToUri (path)

pathToUri ( path )

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

Аргументы

path	[String]- Путь

Возвращает: String - Преобразованный путь

roundAmount (value, distributorId)

roundAmount	(	value	,
		distributorId
	)

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

Аргументы

value	[Number] - Сумма
distributorId	[ID] optional - Дистрибьютор, для которого будет определяться точность округления. По умолчанию дистрибьютор маршрута

Возвращает: Number - Форматированное число

roundDouble (value, prec)

roundDouble	(	value	,
		prec
	)

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

Аргументы

value	[Number] - Число
prec	[Number] optional - Число знаков после запятой (по умолчанию = 6)

Возвращает: Number - Форматированное число

roundPrice (value, distributorId)

roundPrice	(	value	,
		distributorId
	)

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

Аргументы

value	[Number] - Цена
distributorId	[ID] optional - Дистрибьютор, для которого будет определяться точность округления (по умолчанию дистрибьютор маршрута)

Возвращает: Number - Форматированное число

roundQuantity (value, isReal, distributorId)

roundQuantity	(	value	,
		isReal	,
		distributorId
	)

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

Аргументы

value	[Number] - Количество
isReal	[Boolean] optional - Признак дробного количества (по умолчанию = true)
distributorId	[ID] optional - Дистрибьютор, для которого будет определяться точность округления (по умолчанию дистрибьютор маршрута)

Возвращает: Number - Форматированное число

roundWeight (value, distributorId)

roundWeight	(	value	,
		distributorId
	)

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

Аргументы

value	[Number] - Вес
distributorId	[ID] optional - Параметр не используется (2020-01-01) и замены не требует

Возвращает: Number - Форматированное число

stringDateTime (dt, format)

stringDateTime	(	dt	,
		format
	)

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

Аргументы

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

Возвращает: String - Преобразованные дата и время

Подробное описание

Открытые члены

Методы

correctDateTime (checkValue, minValue, maxValue, format)

dateTimeFromVariant (vdt)

dateTimeIsNull (dt)

dateTimeToString (dt)

dateToUIGenitive (dt)

daysBetweenDates (begin, end)

formatAmount (value, distributorId)

formatDate (dt)

formatDateTime (dt)

formatDiscount (value)

formatDouble (value, prec)

formatPercent (value)

formatPrice (value, distributorId)

formatQuantity (value, isReal, distributorId)

formatSurveyAnswer (value, distributorId)

formatTime (dt)

idIsValid (id)

monthName (monthNumber, isShort)

pathToUri (path)

roundAmount (value, distributorId)

roundDouble (value, prec)

roundPrice (value, distributorId)

roundQuantity (value, isReal, distributorId)

roundWeight (value, distributorId)

stringDateTime (dt, format)