:::(Info)Following Release 306, Tulip is changing the way numbers are stored in Tables and Completion Records to support capturing, storing, and displaying trailing zeros.
:::
Тип данных «Число» представляет собой действительное число (например, 53, 700, 506,2, 7,645). Точность вычислений в Tulip позволяет числам содержать нули в конце (например, 1,90; 7,300; 36,850; 419,38910).
Подробная информация о числовой точности
**Данные, вводимые в поле «Число», сохраняют конечные нули.**Данные, введенные через оператор «Число» ( Input), сохраняют конечные нули при хранении и отображении во всей экосистеме Tulip — до 20 знаков после запятой. Значения, превышающие 20 цифр, будут округляться до ближайшей 20-й значащей цифры. Данные таблиц хранятся в новом точном типе данных под названием Postgres Decimal — вместо числа с плавающей запятой.
Данные записей таблицы отображают все цифры после запятой. Таблицыотображают все цифры после запятой с многоточием при достижении ширины столбца. Предыдущее ограничение пользовательского интерфейса позволяло отображать только первые 3 цифры в виде сетки. Чтобы просмотреть все цифры после запятой, щелкните запись таблицы.
**Поля ввода чисел и выражения позволяют контролировать количество знаков после запятой.**Разработчики приложений могут задавать и обеспечивать соблюдение количества знаков при вводе и вычислениях с помощью: * правила валидации поля ввода чисел для установки точного количества знаков после запятой.

- Выражений для управления количеством знаков после запятой во внешних входных данных (например, коннекторы, устройства, машины, пользовательские виджеты) и выполнения математических вычислений. К таким выражениям относятся ROUND() и GETDECIMALPLACES().
- Новое выражение TOPLAINTEXT() выводит десятичные числа с полной точностью.
Подробнее об этих выражениях читайте в разделе ниже: «Выражения для управления точностью».
Ограничения и поведение при выходе за пределы диапазона
Максимальное значение: JS MAX SAFE INT* Это стандартное максимальное значение для числовых данных в JavaScript * Обработка выхода за пределы в Tulip Tables API: входящие данные, превышающие это значение, вызовут ошибку и не будут сохранены.
Максимальное количество знаков после запятой: 20* Это больше, чем количество знаков в числах с плавающей запятой (ранее Tulip поддерживал 15 знаков), и охватывает все известные сценарии использования.* Обработка выхода за пределы в Tulip Tables API: входящие данные, содержащие более 20 знаков, будут округлены до ближайшего 20-го знака
Как работает числовая точность с другими функциями Tulip?
Ввод данных с нулями в конце применим только к числовым полям в приложениях. Другие потоки данных в Tulip обрабатывают числовую точность по-разному:
Внешние данные
Данные, поступающие через коннекторы, машины, устройства и пользовательские виджеты, по-прежнему передаются в виде строк или чисел с плавающей запятой — это зависит от типа данных, предоставляемого источником. Числовые данные преобразуются в десятичные числа Postgres при сохранении в таблицах Tulip и записях завершения.
Автоматизации
Automations будут поддерживать конечные нули позднее в 2025 году. В настоящее время автоматизации, выполняющие вычисления, не сохраняют конечные нули.
Выражения для управления точностью
Разработчики приложений могут управлять количеством значащих цифр при сохранении чисел в Tulip с помощью следующего выражения.
ROUND()
Используйте функцию ROUND(), чтобы указать желаемое количество знаков после запятой и добавить нули в конце числа перед сохранением значения.:::(Internal) (Private notes)
insert screenshot of example expression]
:::
Разработчики приложений могут управлять количеством знаков при выполнении математических вычислений, включая вычисление средних значений и сумм, с помощью следующих выражений.
GETDECIMALPLACES() и ROUND()
Используйте GETDECIMALPLACES() и/или ROUND() для управления количеством знаков после запятой в результатах вычислений.
TOPLAINTEXT()
Используйте функцию TOPLAINTEXT() вместо TOTEXT(), чтобы отобразить числовое значение с полной точностью, включая конечные нули. Это связано с тем, что функция TOTEXT() сохраняет обратно совместимую реализацию, отображающую точные десятичные числа в виде чисел JavaScript (т. е. чисел с плавающей запятой) с точностью не более 16 знаков.
Технические детали
- В рамках данного поведения таблицы и автозаполнения Tulip перешли с «чисел с плавающей запятой» на точные десятичные числа Postgres, которые настроены на хранение до 20 знаков после запятой.
- Входящие числовые данные из всех источников (т. е. приложений, API таблиц Tulip, коннекторов и т. д.) хранятся в таблицах Tulip в виде чисел Postgres Decimal и при сохранении округляются до максимум 20 знаков.
Исторические данные
Данные, собранные до версии 306, были полностью сохранены с неизменными числовыми значениями. Любые новые поступающие данные округляются до 20 знаков после запятой.
Незначительные изменения
Существуют некоторые изменения в крайних случаях и нюансы в обработке чисел в приложениях после внедрения функции «Точность чисел», обусловленные различиями между числами типа «decimal» и «float»:
- Выражения: значения NaN и Infinity в JavaScript отсутствуют в точных десятичных числах — в результате при возникновении математических ошибок (например, при извлечении квадратного корня из отрицательного числа или делении на 0) в выражениях теперь будет генерироваться ошибка. a. Это означает, что разработчикам приложений, возможно, придётся обновить любую логику для особых случаев, работающую с значениями JS NaN и Infinity. Эти значения не являются поддерживаемым интерфейсом, и мы не рекомендуем использовать их для обработки математических крайних случаев в ваших приложениях.
- Триггеры: функция «Показать сообщение» теперь использует кавычки для обтекания чисел a. Это означает, что теперь вы сможете отображать конечные нули в функции «Показать сообщение».
- Таблицы: при экспорте в CSV теперь отображаются полные числа (больше 1e6) — ранее в CSV для больших чисел (больше 1e6) использовалась экспоненциальная запись. a. Это означает, что вашим администраторам, возможно, потребуется обновить скрипты обработки CSV, чтобы удалить любые особые случаи обработки чисел в экспоненциальном формате, если таковые имелись.
- Выражения: TOTEXT и представление чисел — если вам нужно сохранить конечные нули в текстовом представлении, используйте новое выражение TOPLAINTEXT(), которое заключает числа в кавычки для сохранения конечных нулей.a. Выражения: TOTEXT() не заключает числа в кавычки и, следовательно, не сохраняет конечные нули. Вместо этого используйте новую функцию TOPLAINTEXT(), чтобы отобразить полное число с конечными нулями, заключенное в кавычки.b. Мы вводим TOPLAINTEXT() в качестве нового выражения для обеспечения обратной совместимости с приложениями, которые, возможно, использовали выражение TOTEXT().
Если у вас есть вопросы по работе с точностью чисел, обратитесь к менеджеру по работе с клиентами Tulip или оставьте сообщение в соответствующей ветке сообщества.
Форматирование чисел и язык
Форматирование чисел варьируется в зависимости от страны, в частности в отношении разделителей. Например, в некоторых странах (США, Мексика, Китай) в качестве десятичного разделителя используется точка (.), а в качестве разделителя тысяч — запятая (,). В других странах (например, в Европе) в качестве десятичного разделителя используется запятая (,).
В Tulip эти форматы чисел важны в следующих контекстах: 1. При отображении числа пользователю Tulip формат гарантирует, что пользователь правильно поймёт значение. 2. При анализе введённых пользователем данных формат гарантирует, что в базе данных Tulip будет записано правильное значение.
Формат чисел определяется текущим языком пользователя, указанным в его личных настройках. Если пользователь не выбрал конкретный язык, Tulip определит язык на основе настроек браузера.
Узнайте, как настроить языковые предпочтения.
Note that there is no default instance-level or workspace-level language setting.
Формат чисел по умолчанию, начиная с версии r360
В пределах одного языка могут наблюдаться различия в формате чисел, используемом в разных географических регионах. Чтобы понять это поведение, обратите внимание на следующее для выбранного вами языка:
В следующих языках по умолчанию в качестве разделителя десятичных знаков используется запятая ( , ):* болгарский* чешский* датский* нидерландский* эстонский* финский* французский* немецкий* греческий* венгерский* индонезийский* итальянский* латышский* литовский* норвежский* польский* португальский* румынский* русский* словацкий* словенский* испанский* шведский* турецкий* украинский* вьетнамский
Чтобы изменить это поведение, обратитесь к системному администратору или по адресу Tulip Support.
{{snippet.Нашли ли вы то, что искали?}}


