PostgreSQL jsonb_path_exists_tz() 函数使用指南

PostgreSQL jsonb_path_exists_tz() 函数在一个给定的 JSON 中检查一个指定的路径是否是否有返回值。此函数与 jsonb_path_exists() 的不同之处在于提供了对带有时区的日期/时间的支持。

jsonb_path_exists_tz() 语法

这是 PostgreSQL jsonb_path_exists_tz() 函数的语法:

jsonb_path_exists_tz(target JSONB, path JSONPATH [, vars JSONB [, silent BOOLEAN]]) -> BOOLEAN

参数

target
必需的。 要检查的 JSONB 值。
path
必需的。 要检查的 JSON 路径,它是 JSONPATH 类型的。
vars
可选的。 路径中要用到的变量值。
silent
可选的。 如果提供了此参数,并且为 true,该函数会像 @?@@ 操作符一样抑制相同的错误。

返回值

PostgreSQL jsonb_path_exists_tz() 函数返回一个布尔值,它是在一个 JSONB 值中检查指定的路径是否有返回值的结果。 t 表示指定的路径有返回值, f 表示指定的路径没有返回值。

如果任意一个参数是 NULL,jsonb_path_exists_tz() 函数将返回 NULL。

jsonb_path_exists_tz() 示例

基本示例

下面的示例展示了如何使用 PostgreSQL jsonb_path_exists_tz() 函数在一个 JSON 数组中检查指定的 JSON 路径是否有值。

SELECT jsonb_path_exists_tz('[1, 2, 3]', '$[*] ? (@ > 1)');
 jsonb_path_exists_tz
----------------------
 t

这里,我们使用路径 $[*] ? (@ > 2) 来获取 JSON 数组 [1, 2, 3] 中的大于 2 的项。 我们可以使用 jsonb_path_query_array() 函数来验证上面的结果是否正确:

SELECT jsonb_path_query_array('[1, 2, 3]', '$[*] ? (@ > 1)');
 jsonb_path_query_array
------------------------
 [2, 3]

我们可以在 JSON 路径中使用变量,如下:

SELECT jsonb_path_exists_tz(
    '[1, 2, 3, 4]',
    '$[*] ? (@ >= $min && @ <= $max)',
    '{"min": 2, "max": 3}'
);
 jsonb_path_exists_tz
----------------------
 t

这里,我们在 JSON 路径 $[*] ? (@ >= $min && @ <= $max) 中使用了两个变量 minmax,并且我们在参数 var 中为变量提供了值 {"min": 2, "max": 3},这样,JSON 路径变成了 $[*] ? (@ >= 2 && @ <= 3)。也就是说,该函数用来检查数组 [1, 2, 3, 4] 中是否包含大于等 2 并且小于等于 3 的值。

时区

PostgreSQL jsonb_path_exists_tz() 函数支持带时区的时间戳。如下:

select
    jsonb_path_exists_tz(
        '["2015-08-01 12:00:00 +00"]',
        '$[*] ? (@.datetime() < "2015-08-02".datetime())'
    );
 jsonb_path_exists_tz
----------------------
 t