すべてのプロダクト
Search
ドキュメントセンター

PolarDB:変換関数

最終更新日:May 31, 2024

このトピックでは、変換関数の構文、パラメーター、および例について説明します。

TO_TMINTERVAL

説明

この関数は、CHARVARCHAR2NCHAR、またはNVARCHAR2データ型の文字列をINTERVAL YEAR to MONTHデータ型の値に変換します。

構文

TO_YMINTERVAL(char)

Parameters

パラメーター

説明

char

変換される文字列。 この値は、CHARVARCHAR2NCHAR、およびNVARCHAR2のデータ型をサポートしています。

戻り値

戻り値はINTERVAL YEAR TO MONTHデータ型です。

<bx id="1" type="code" text="code id=" vagfxr "title=" "uuid=" lj3p9k6m4x4je2wunwb "code=" SELECT to_yminterval('2016-1 ') DUALから;
to_yminterval
---------------
+ 2016-01 "data-tag=" codeblock "outputclass=" language-sql ""/>SELECT to_yminterval('2016-1 ') DUALから;
 to_yminterval
---------------
 + 2016-01 

TO_DAINTERVAL

説明

この関数は、CHARVARCHAR2NCHAR、またはNVARCHAR2データ型の文字列をINTERVAL DAY to SECONDデータ型の値に変換します。

構文

TO_DSINTERVAL(char[, nlsparam])

Parameters

パラメーター

説明

char

変換される文字列。 この値は、CHARVARCHAR2NCHAR、およびNVARCHAR2のデータ型をサポートしています。

nlsparam

オプションです。 このパラメーターをNLS_NUMERIC_CHARACTERS="dg" 形式のNLS_NUMERIC_CHARACTERSに設定します。ここで、dは10進数、gはグループ区切り文字を示します。 どちらの文字もスペースにすることはできません。

戻り値

戻り値はINTERVAL DAY TO SECONDデータ型です。

<bx id="1" type="code" text="code id=" 22f6058a1fwcm "title=" "uuid=" ljmt16hry79pegivx49 "code=" SELECT to_dsinterval('1 1:1:00 ') DUALから;
to_dsinterval
---------------
+ 01 01:01:00 "data-tag=" codeblock "outputclass=" language-sql ""/>SELECT to_dsinterval('1 1:1:00 ') DUALから;
 to_dsinterval
---------------
 + 01 01:01:00 

TO_TIMESTAMP_TZ

説明

この関数は、charVARCHAR2NCHAR、またはNVARCHAR2データ型のCHARパラメーターの値をTIMESTAMP WITH TIME ZONEデータ型の値に変換します。

構文

TO_TIMESTAMP_TZ(char[, fmt][, 'nlsparam'])

Parameters

パラメーター

説明

char

TIMESTAMP WITH TIME ZONEデータ型の値に変換される文字列。

fmt

TIMESTAMP WITH TIME ZONEデータ型の値が返される形式。

nlsparam

オプションです。 月と日付が返される言語。

戻り値

戻り値はTIMESTAMP WITH TIME ZONEデータ型です。

NUMTODSAINTERVAL

説明

この関数は、nパラメーターの値をINTERVAL DAY to SECONDデータ型の値に変換します。

説明

interval_unitパラメーターの値は大文字と小文字を区別しません。 括弧 () 内の先頭と末尾の値は無視されます。 デフォルトでは、戻り値の精度は9です。

構文

NUMTODSINTERVAL(n,interval_unit)

Parameters

パラメーター

説明

n

NUMBERデータ型の値、または暗黙的にデータをNUMBERデータ型の値に変換できる式。

interval_unit

nパラメーターの単位。 この値は、CHARVARCHAR2NCHAR、およびNVARCHAR2のデータ型をサポートしています。 必要に応じて、この値は、DAY、HOUR、MINUTE、およびSECONDのいずれかの文字列に解析できます。

戻り値

戻り値はINTERVAL DAY TO SECONDデータ型です。

<bx id="1" type="code" text="code id=" 7e8d709c1f3w8 "title=" "uuid=" ljmt2pkylzaplvvjtv "code=" SELECT numtodsinterval (「3.123456789」、「時間」) DUALから;
numtodsinterval
--------------------
+ 00 03:07:24.44444 "data-tag=" codeblock "outputclass=" language-sql ""/>SELECT numtodsinterval('3.123456789 ','hour') DUALから;
  numtodsinterval
--------------------
 + 00 03:07:24.44444 

NUMTOYMINTERVAL

説明

この関数は、nパラメーターの値をINTERVAL YEAR to MONTHデータ型の値に変換します。

説明

interval_unitパラメーターの値は大文字と小文字を区別しません。 括弧 () 内の先頭と末尾の値は無視されます。 デフォルトでは、戻り値の精度は9です。

構文

NUMTOYMINTERVAL(n,interval_unit)

Parameters

パラメーター

説明

n

NUMBERデータ型の値、または暗黙的にデータをNUMBERデータ型の値に変換できる式。

interval_unit

nパラメーターの単位。 この値は、CHARVARCHAR2NCHAR、およびNVARCHAR2のデータ型をサポートしています。 必要に応じて、値は次の文字列YEARおよびMONTHのいずれかに解析できます。

戻り値

戻り値はINTERVAL YEAR TO MONTHデータ型です。

<bx id="1" type="code" text="code id=" 10123d5c1f7ex "title=" "uuid=" ljxqvnt9htzkfy13gvt "code=" SELECT numtoyminterval('3.123456789 '、'year') DUALから;
numtoyminterval
-----------------
+ 03-01 "data-tag=" codeblock "outputclass=" language-sql ""/>SELECT numtoyminterval('3.123456789 '、'year') DUALから;
 numtoyminterval
-----------------
 + 03-01 

UNISTR

説明

この関数は、文字データに解析されたテキストまたは式をパラメーターとして使用し、国の文字セットのパラメーターの値を返します。 データベースの全国文字セットは、AL16、UTF16、またはUTF8エンコード形式をサポートしています。

この関数を使用すると、指定した文字列の文字のUnicodeエンコード値を使用できます。 これは、NCHARデータ型の列にデータを挿入する場合に便利です。

文字のUnicodeエンコードされた値は \xxxx形式です。ここで、xxxxはUCS-2エンコード形式の文字の16進値です。 付加された文字は2つのコード単位として符号化され、第1のコード単位はU + D800からU + DBFFまでの高置換範囲であり、第2のコード単位はU + DC00からU + DFFFまでの低置換範囲である。 文字列にバックスラッシュ (\) を含める場合は、2つのバックスラッシュ (\\) を一緒に追加します。 これにより、データの移行と保存に役立ちます。

構文

UNISTR (文字列)

Parameters

パラメーター

説明

String

変換される文字列。

戻り値

戻り値はSTRINGデータ型です。

<bx id="1" type="code" text="code id=" adecf9081fwaj "title=" "uuid=" ljmtdfh66ujsy8qnoh "code=" SELECT UNISTR('abc\00e5\00f1\00f6') DUALから;
unistr
---------
abc å ñ ö "data-tag=" codeblock "outputclass=" language-sql ""/>SELECT UNISTR('abc\00e5\00f1\00f6') DUAL;
 unistr
---------
 abc å ñ ö 

TO_SINGLE_BYTE

説明

この関数は、charパラメーターの値のすべてのマルチバイト文字を対応するシングルバイト文字に変換します。

charパラメーターの値のマルチバイト文字に相当するシングルバイト文字がない场合は, 戻り値にマルチバイト文字として表示されます。 この関数は、データベースの文字セットに1バイト文字と複数バイト文字の両方が含まれている場合にのみ機能します。

この関数は、CLOBデータ型の値を直接サポートしません。 ただし、CLOBデータ型の値は、暗黙的なデータ型変換を使用して、入力パラメーターの値として渡すことができます。

構文

TO_SINGLE_BYTE(char)

Parameters

パラメーター

説明

char

このパラメーターの値は、CHAR、VARCHAR2、NCHAR、およびNVARCHAR2のデータ型をサポートしています。

戻り値

戻り値は、charパラメーターの値と同じデータ型です。

<bx id="1" type="code" text="code id=" 5e908bf71fd3r "title=" "uuid=" ljmte3144m55whjuj9f "code=" SELECT to_single_byte('123$test ') DUALから;
to_single_byte
----------------
123$test "data-tag=" codeblock "outputclass=" language-sql ""/>SELECT to_single_byte('123$test') DUAL;
 to_single_byte
----------------
 123$test 

TO_MULTI_バイト

説明

この関数は、charパラメーターの値のすべてのシングルバイト文字を対応するマルチバイト文字に変換します。

charパラメーターの値の1バイト文字で、同等のマルチバイト文字がない场合は, 戻り値に1バイト文字として表示されます。 この関数は、データベースの文字セットに1バイト文字と複数バイト文字の両方が含まれている場合にのみ機能します。

この関数は、CLOBデータ型の値を直接サポートしません。 ただし、CLOBデータ型の値は、暗黙的なデータ型変換を使用して、入力パラメーターの値として渡すことができます。

構文

TO_MULTI_BYTE(char)

Parameters

パラメーター

説明

char

このパラメーターの値は、CHAR、VARCHAR2、NCHAR、およびNVARCHAR2のデータ型をサポートしています。

戻り値

戻り値は、charパラメーターの値と同じデータ型です。

<bx id="1" type="code" text="code id=" 885747871fjgi "title=" "uuid=" ljmtgfgqf0i1a3yivo "code=" select to_multi_byte('Hello':::text) from dual;
to_multi_byte
---------------
こんにちは "data-tag=" codeblock "outputclass=" language-sql ""/> デュアルからto_multi_byte('Hello'::text) を選択します。
 to_multi_byte
---------------
 こんにちは 

TO_CLOB

説明

この関数は、NCLOBデータ型の列または文字列のNCLOBデータ型の値をCLOBデータ型の値に変換します。

構文

TO_CLOB(lob_column | char)

Parameters

パラメーター

説明

lob_column

NCLOBデータ型の列。

char

このパラメーターの値は、CHAR、VARCHAR2、NCHAR、NVARCHAR2、CLOB、およびNCLOBのデータ型をサポートしています。 PL/SQLパッケージでは、TO_CLOB関数を使用して、RAW、CHAR、VARCHAR、VARCHAR2、NCHAR、NVARCHAR2、CLOB、およびNCLOBのデータ型の値に変換できます。

戻り値

戻り値はCLOBデータ型です。

<bx id="1" type="code" text="code code=" テーブルEmployee_to_clob(ID VARCHAR2(4 BYTE) 、First_Name VARCHAR2(10 BYTE)) を作成します。Employee_to_clob(ID、First_Name) 値 ('01' 、'Jason') に挿入します。Employee_to_clobからto_clob(first_name) を選択します。to_clob
---------
Jason "id=" d476bc951f0y7 "title=" "uuid=" ljmth6wtb2g2iualt "data-tag=" codeblock "outputclass=" language-sql ""/> 作成テーブルEmployee_to_clob(ID VARCHAR2(4 BYTE)) 、First_Name VARCHARCHARARARARAR2 (10) BYTE;
Employee_to_clob(ID、First_Name) 値 ('01' 、'Jason') に挿入します。Employee_to_clobからto_clob(first_name) を選択します。
 to_clob
---------
 ジェイソン 

RAWTOHEX

説明

この関数は、RAWデータ型の値を16進数形式の文字値に変換します。

この関数はSQLの組み込み関数です。 rawパラメーターの値がRAWデータ型でない場合、この関数は、バイト数を使用して表される値を、同じバイト数を含むRAWデータ型の値に変換します。 データ自体は変更されませんが、データ型はRAWに変換されます。

構文

RAWTOHEX (生)

Parameters

パラメーター

説明

このパラメーターの値は、LONG、LONG RAW、CLOB、NCLOB、BLOB、およびBFILE以外のデータ型です。

戻り値

戻り値はVARCHAR2データ型です。 値には、元の値を構成するバイトが含まれ、16進形式です。 各バイトは、2つの16進数で表される。

<bx id="1" type="code" text="code id=" fbde79861fi2n "title=" "uuid=" ljmti5634qap07nee2t "code=" SELECT rawtohex('hello world'::varchar) FROM DUAL;
rawtohex
------------------------
68656c6c6f20776f726c64 "data-tag=" codeblock "outputclass=" language-sql ""/>SELECT rawtohex('hello world'::varchar) DUALから;
        rawtohex
------------------------
 68656c6c6f20776f726c6 4 

HEXTORAW

説明

この関数は、16進数を含むCHAR、VARCHAR2、NCHAR、またはNVARCHAR2データ型の文字をRAWデータ型の値に変換します。

説明

この関数は、CLOBデータ型の値を直接サポートしません。 ただし、CLOBデータ型の値は、暗黙的なデータ型変換を使用して、入力パラメーターの値として渡すことができます。

構文

HEXTORAW(char)

Parameters

パラメーター

説明

char

このパラメーターの値は、CHAR、VARCHAR2、NCHAR、またはNVARCHAR2データ型です。

戻り値

戻り値はRAWデータ型です。

<bx id="1" type="code" text="code id=" 1ed3c1271ftyy "title=" "uuid=" ljmtisn8n4hszs0moxq "code=" SELECT hextoraw(rawtohex('hello world'::bpchar)) DUALから;
hextoraw
--------------------------
\x68656c6c6f20776f726c64 "data-tag=" codeblock "outputclass=" language-sql ""/>SELECT hextoraw(rawtohex('hello world'::bpchar)) DUALから;
         hextoraw
--------------------------
 \x68656c6c6f20776f726c64 

ASCIISTR

説明

この関数は、文字セット内の文字列、またはデータを文字列に解析できる式をパラメーターとして使用し、データベース文字セット内のASCII文字列を返します。 ASCII以外の文字は \xxxx形式に変換されます。xxxxはUTF-16コード単位を示します。

構文

ASCIISTR (チャー)

Parameters

パラメーター

説明

char

このパラメーターの値は、文字セット内の文字列、またはデータを文字列に解析できる式です。

戻り値

戻り値は、データベース文字セット内のASCII文字列です。

<bx id="1" type="code" text="code id=" 4a5573251fapg "title=" "uuid=" ljmtjm9nkx8dde6m17 "code=" SELECT ASCIISTR('W ÈÐńńà y') DUALから;
asciistr
---------------------------------------
W\00C8\00D0\0144\0117
               asciistr
---------------------------------------
 W\00C8\00D0\0144\0117\015B\010E\00E 0y