数値と数値の精度

Prev Next

:::(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.
:::

データ型「Number」は実数(例:53、700、506.2、7.645)です。 Tulipの数値精度により、数値に末尾のゼロを含めることができます(例:1.90、7.300、36.850、419.38910)。

数値精度の詳細

数値入力データは末尾のゼロを保持します。数値Inputを通じて入力されたデータは、Tulipエコシステム全体において、保存および表示時に末尾のゼロが保持されます(小数点以下最大20桁まで)。 20桁を超える入力値は、20分の1桁単位で四捨五入されます。テーブルデータは、float型ではなく、「Postgres Decimal」と呼ばれる新しい高精度データ型で保存されます。

テーブルレコードデータは小数点以下のすべての桁を表示します。テーブルでは、列幅に合わせて省略記号(…)を付加して小数点以下のすべての桁が表示されます。以前の UX の制限では、グリッドビューには最初の 3 桁しか表示されませんでした。小数点以下のすべての桁を表示するには、テーブルレコードをクリックしてください。

数値入力および式では、小数点以下の桁数を任意に制御できます。アプリビルダーは、以下の方法を通じて入力および計算時の桁数を指定・強制できます:* 小数点以下の桁数を正確に設定する「数値入力」の検証ルール。

Number input validation for decimals

  • 外部入力(コネクタ、デバイス、マシン、カスタムウィジェットなど)の小数点以下の桁数を管理し、数学的演算を実行するための式。これらの式には、ROUND() や GETDECIMALPLACES() が含まれます。
  • 新しい式 TOPLAINTEXT() は、完全な精度で小数を出力します。

これらの式に関する詳細は、以下のセクション「精度を管理するための式」をご覧ください。

制限および範囲外時の挙動

最大値: JS MAX SAFE INT* これは、JavaScript における数値データの標準的な最大値です * Tulip Tables API の範囲外処理:この値を超える入力データはエラーとなり、保存されません。

**小数点以下の最大桁数:**20* これは浮動小数点数の桁数よりも多く(以前の Tulip では 15 桁をサポートしていました)、既知のすべてのユースケースを網羅しています。* Tulip Tables API の範囲外処理:20 桁を超える入力データは、20 分の 1 桁単位で四捨五入されます。

数値の精度は、Tulipの他の機能とどのように連携するのでしょうか?

末尾にゼロが続く入力データは、アプリ内の「数値入力」にのみ適用されます。Tulipの他のデータストリームでは、数値の精度が異なる方法で処理されます:

外部データ

コネクタ、マシン、デバイス、およびカスタムウィジェットを通じて入力されるデータは、ソースが提供するデータ型に応じて、引き続き文字列(String)または浮動小数点数(Float)として送信されます。数値データは、Tulip Tablesおよびコンプリートレコードに保存される際に、PostgresのDecimal型に変換されます。

オートメーション

Automationは、2025年後半に末尾のゼロに対応する予定です。現在、計算を行うオートメーションでは、末尾のゼロは保存されません。

精度を管理する式

アプリビルダーは、以下の式を使用して、Tulipに数値を保存する際の桁数を管理できます。

ROUND()

ROUND() を使用すると、希望する小数点以下の桁数を指定し、値を保存する前に末尾にゼロを追加できます。:::(Internal) (Private notes)
insert screenshot of example expression]
:::

アプリ開発者は、平均や合計などの数学的計算を行う際、以下の式を使用して桁数を管理できます。

GETDECIMALPLACES() および ROUND()

GETDECIMALPLACES() および/または ROUND() を使用して、計算結果の小数点以下の桁数を管理します。

TOPLAINTEXT()

末尾のゼロを含め、数値の精度を小数点以下すべて表示するには、TOTEXT() の代わりに TOPLAINTEXT() を使用してください。これは、TOTEXT() が、小数点以下の精度を JavaScript の Number(つまり浮動小数点数)として、最大 16 桁の精度で表示するという下位互換性のある実装を維持しているためです。

技術的な詳細

  • この動作の一環として、Tulip テーブルおよびコンプリートは「float」から、小数点以下最大 20 桁まで保存するように構成された高精度な Postgres Decimal へと移行しました。
  • すべてのソース(アプリ、Tulip Table API、コネクタなど)から受信した数値データは、Tulip テーブルに Postgres Decimal として格納され、格納時に最大 20 桁に丸められます。

過去のデータ

リリース 306 より前に収集されたデータは完全に保持されており、数値は変更されていません。新たに受信されるデータはすべて、小数点以下 20 桁に丸められます。

軽微な変更

数値の精度に関する機能導入後、デシマルとフロート型の違いにより、アプリでの数値処理においていくつかの特殊なケースでの変更や注意点があります:

  1. 式:JavaScriptのNaNおよびInfinityは、高精度のDecimal数値には存在しません。その結果、式では、数学的なエラーが発生した場合(例:負の数の平方根を求めたり、0で除算したりする場合)にエラーが発生するようになりました。a. つまり、アプリビルダーは、JSのNaNやInfinityを扱う特殊なロジックを更新する必要がある場合があります。これらはサポート対象のインターフェースではなく、アプリ内の数学的なエッジケースを処理するためにこれらを利用することは推奨されません。
  2. トリガー:「メッセージを表示」では、数値を引用符で囲むようになりましたa。これにより、「メッセージを表示」で末尾のゼロを表示できるようになりました。
  3. テーブル:CSV エクスポートで、1e6 を超える整数が完全な数値で表示されるようになりました。以前は、CSV では大きな数値(1e6 以上)に対して指数表記が使用されていました。a. これにより、管理者は、指数表記の処理に関する特別な処理がスクリプトに含まれている場合、CSV処理スクリプトを更新してそれらを削除する必要がある可能性があります。
  4. 式:TOTEXT および数値の表現– テキスト表現で末尾のゼロを保持する必要がある場合は、数値を引用符で囲んで末尾のゼロを保持する新しい式 TOPLAINTEXT() を使用してください。a. 式:TOTEXT() は数値を引用符で囲まないため、末尾のゼロは保持されません。 代わりに、新しい TOPLAINTEXT() を使用すると、末尾のゼロを含む数値全体が引用符で囲まれて表示されます。b. TOTEXT() 式を使用していた可能性のあるアプリケーションとの下位互換性を維持するため、新しい式として TOPLAINTEXT() を導入しています。

数値の精度に関するご質問がある場合は、Tulipのカスタマーサクセスマネージャーにお問い合わせいただくか、コミュニティのスレッドに投稿してください。

数値の書式設定と言語

数値の書式設定は国によって異なり、特に区切り記号が異なります。 たとえば、一部の国(米国、メキシコ、中国)では、小数点としてドット(.)を使用し、千の位区切りとしてコンマ(,)を使用します。他の国(ヨーロッパなど)では、小数点としてコンマ(,)を使用します。

Tulip では、以下の状況においてこれらの数値形式が重要になります。1. Tulip ユーザーに数値を表示する際、この形式によってユーザーが正しい値を理解できるようになります。2. ユーザーが入力した内容を解析する際、この形式によって正しい値が Tulip データに記録されるようになります。

数値の書式は、個人の設定で定義されている現在のユーザーの言語によって決定されます。ユーザーが特定の言語を選択していない場合、Tulipはブラウザの設定に基づいて言語を推測します。

言語設定の方法については、こちらをご覧ください。

Only user-level language settings

Note that there is no default instance-level or workspace-level language setting.

r360時点でのデフォルトの数値形式

同じ言語内でも、地域によって使用される数値形式に違いがある場合があります。この動作を理解するために、ご希望の言語について以下の点にご注意ください:

以下の言語では、デフォルトで小数点区切りとしてコンマ ( , ) が使用されます:* ブルガリア語* チェコ語* デンマーク語* オランダ語* エストニア語* フィンランド語* フランス語* ドイツ語* ギリシャ語* ハンガリー語* インドネシア語* イタリア語* ラトビア語* リトアニア語* ノルウェー語* ポーランド語* ポルトガル語* ルーマニア語* ロシア語* スロバキア語* スロベニア語* スペイン語* スウェーデン語* トルコ語* ウクライナ語* ベトナム語

この動作を変更するには、システム管理者またはTulip Support までお問い合わせください。