21.13 GET_DATEファンクション

このファンクションは、日付メンバー値を戻します。

構文

APEX_JSON.GET_DATE (
    p_path             IN VARCHAR2,
    p0                 IN VARCHAR2 DEFAULT NULL,
    p1                 IN VARCHAR2 DEFAULT NULL,
    p2                 IN VARCHAR2 DEFAULT NULL,
    p3                 IN VARCHAR2 DEFAULT NULL,
    p4                 IN VARCHAR2 DEFAULT NULL,
    p_default          IN DATE     DEFAULT NULL,
    p_format           IN VARCHAR2 DEFAULT c_date_iso8601,
    p_values           IN t_values DEFAULT g_values )
RETURN DATE;

パラメータ

表21-9 GET_DATEファンクションのパラメータ

パラメータ 説明

p_path

p_valuesへの索引。

p[0-4]

p_pathの各%NをpNで置き換え、i-th %sまたは%dをすべてp[i-1]で置き換えます。

p_default

メンバーが存在しない場合のデフォルト値。

p_format

日付書式マスク。

p_values

解析されたJSONメンバー。デフォルトは、g_valuesです。

戻り値/発生するエラー

表21-10 GET_DATEファンクションの戻り値および発生するエラー

戻り値 説明

DATE

日付を戻します。

VALUE_ERROR

p_values(p_path)が日付ではない場合に、このエラーが発生します。

この例では、JSON文字列を解析し、位置にある値を出力します。

DECLARE 
    j apex_json.t_values; 
BEGIN 
    apex_json.parse(j, '{ "items": [ 1, 2, { "foo": "2014-04-29T10:08:00Z" }] }'); 
    
dbms_output.put_line(to_char(apex_json.get_date(p_path=>'items[%d].foo',p0=>3, p_values=>j), 'DD-Mon-YYYY')); 
END;