メインコンテンツまでスキップ
バージョン: 26.x

COUNTEQUAL

機能​

配列内で指定されたターゲット値と等しい要素の数をカウントします。

構文​

  • COUNTEQUAL(arr, target)

パラメータ​

  • arr: ARRAY<T>、サポートされる要素タイプには数値、boolean、文字列、datetime、IPが含まれます。
  • target: arrの要素と同じタイプ。

戻り値​

  • BIGINTを返し、等しい要素の数を表します。

使用上の注意​

  • この関数ではNULLはNULLと等しく、カウントされます。

例​

  • 基本

    • COUNTEQUAL([1,2,3,2], 2) -> 2
    • COUNTEQUAL(['a','b','a'], 'a') -> 2
    • COUNTEQUAL([true,false,false], false) -> 2

  • NULLは等しいと見なされ、カウントされます

    • COUNTEQUAL([1,NULL,2,NULL], NULL) -> 2
    • COUNTEQUAL([1,NULL,1], 1) -> 2
    • COUNTEQUAL([1, 2], NULL) -> 0

  • 配列がNULLの場合、NULLを返します

    • COUNTEQUAL(NULL, 1) -> NULL