CONVERT (SQL)

MS SQL Server の互換性

この CONVERT の実装は、MS SQL Server と互換性のある一般的な InterSystems IRIS® スカラ関数です。この関数は日付と時刻の書式設定、およびストリーム・データの変換をサポートします。

• CONVERT(type,expression) は指定されたデータ型に式を変換します。InterSystems SQL でサポートされているデータ型の一覧については、"データ型" を参照してください。

  以下の文は、10 進数 (πの近似値) を文字列に変換し、その数を 4 文字に切り捨てます。

  SELECT CONVERT(CHAR(4),3.14159) -- '3.14'

  

  例 ：

  • 数値型間の変換

  • 文字列間の変換

  • 文字列へのストリーム・データの変換

  • 数値型への文字列の変換

  • タイムスタンプへの日付の変換

  • 数値型への日付の変換

• CONVERT(type,expression,formatCode) は、指定されたデータ型に式を変換し、指定された形式コードに基づいて戻り値を書式設定します。

  以下の文は、日付の文字列を TIMESTAMP データ型に変換します。この関数は、形式コード 103 (mm/dd/yy の形式を表す) に基づいて入力を変換します。すべての形式コードは、formatCode 引数の説明を参照してください。

  SELECT CONVERT(TIMESTAMP,'1/1/99',103) -- '01/01/1999 00:00:00'

  

  例 ： 文字列への日付の変換

ODBC 互換性

CONVERT のこの実装は、一般的な InterSystems IRIS ODBC スカラ関数です。この関数は日付と時刻の書式設定をサポートしていません。また、ストリーム・データの変換もサポートしません。

• {fn CONVERT(expression,type)} は、指定されたデータ型に式を変換します。CONVERT のこの実装では、各データ型の引数の前に SQL_ キーワードを付加する必要があります。これらのデータ型はパラメータを受け入れません。例えば、文字列データ型には最大長を設定できません。数値データ型には精度 (最大桁数) と桁 (小数部の最大桁数) を設定できません。

  以下の文は 10 進数を文字列に変換します。返された文字列は切り捨てられません。SQL_VARCHAR(4) などの最大長の指定は許可されません。

  SELECT {fn CONVERT(3.14159,SQL_VARCHAR) } -- '3.14159'

  

例 ：

• 数値型間の変換

• 文字列間の変換

• 数値型への文字列の変換

• タイムスタンプへの日付の変換

• 数値型への日付の変換

type

変換した expression のデータ型です。指定できる型は、InterSystems IRIS の CONVERT() 構文を使用しているか ODBC の {fn CONVERT()} 構文を使用しているかによって異なります。

expression

新しいデータ型への変換元とする式です。expression には、単一の文字列値などのスカラまたはテーブル列などの非スカラを指定できます。expression の有効な値は、type で指定したデータ型によって異なります。

• 定義されたデータ型 (ObjectScript で提供されるホスト変数など) が expression にない場合、そのデータ型は既定で文字列データ型に設定されます。

• expression にストリーム・データがある場合に {fn CONVERT(expression,type)} 構文を使用すると、CONVERT から SQLCODE -37 エラーが発行されます。

• expression が NULL の場合、指定した型に関係なく、変換された値は NULL のままとなります。

• expression が空の文字列 ('') または数値以外の文字列である場合、返される値は指定した type によって異なります。

  • type が文字列データ型の場合、CONVERT からは指定した値が返されます。

  • type が数値データ型または TIME、SQL_TIME、SQL_DATE 型の場合、CONVERT からは 0 (ゼロ) が返されます。

無効な値を type に指定すると SQLCODE -141 エラーが発生します。

formatCode

日付、日付時刻、時刻の各形式を指定する整数コードです。

formatCode を使用して、日付、時刻、タイムスタンプのデータ型から文字列に変換するときの出力を定義します。以下に例を示します。

SELECT CONVERT(VARCHAR,TO_DATE('22 FEB 2022'),1) -- '02/22/22'

文字列から日付、時刻、タイムスタンプのデータ型に変換するときに、formatCode を使用して入力を定義することもできます。以下に例を示します。

SELECT CONVERT(DATE,'22 FEB 2022',106) -- '02/22/2022'

CONVERT() 構文のみが formatCode をサポートします。

無効な形式または formatCode に一致しない形式で expression を指定すると、SQLCODE -141 エラーが生成されます。存在しない formatCode を指定すると、1900-01-01 00:00:00 が返されます。

以下の表に、サポートされている形式コードを示します。

• 1 列目は 2 桁 の年を出力するコードの一覧です。

• 2 列目は 4 桁の年を出力するコード、または年を出力しないコードの一覧です。

数値型間の変換

以下の例では、DECIMAL と DOUBLE のデータ型を使用した小数の変換を比較しています。InterSystems IRIS の CONVERT() 構文を使用しています。DOUBLE への変換によって精度が低下します。

SELECT CONVERT(DECIMAL,-123456789.0000123456789) AS DecimalVal, -- -123456789.0000123457
       CONVERT(DOUBLE,-123456789.0000123456789) AS DoubleVal -- -123456789.00001235306

以下の文は、ODBC の {fn CONVERT()} 構文を使用して上記と同様の変換を実行します。この構文は DECIMAL データ型をサポートしていないことから、値は DOUBLE データ型にのみ変換されます。

SELECT {fn CONVERT(-123456789.0000123456789,SQL_DOUBLE) } AS DecimalVal -- -123456789.00001235306

文字列間の変換

この例は、expression よりも文字列長が短い出力文字列長を指定し、VARCHAR から VARCHAR への変換で文字列を切り詰めています。切り詰めは、InterSystems IRIS の CONVERT() 構文でのみサポートされています。ODBC の {fn CONVERT()} 構文で唯一サポートされている文字列形式は SQL_VARCHAR です。

SELECT CONVERT(VARCHAR(5),'Hello, World') As TruncatedValue -- 'Hello'

文字データ型で文字列長を指定していない場合、最大長は既定で 30 文字になります。

SELECT CONVERT(VARCHAR,'This string is more than 30 characters.') --This string is more than 30 ch

SELECT {fn CONVERT('This string is more than 30 characters.',SQL_VARCHAR) } --This string is more than 30 ch

CONVERT() 構文の場合、BINARY 型または VARBINARY 型への変換にも、この最大長が適用されます。または、長さの指定されていないデータ型は、データ型テーブルに示すように、MAXLEN が 1 の文字にマップされます。

文字列へのストリーム・データの変換

以下の例では、文字ストリーム・フィールドを VARCHAR テキスト文字列に変換します。また、CHAR_LENGTH を使用して、文字ストリーム・フィールドの長さを表示します。

SELECT Notes,CONVERT(VARCHAR(80),Notes) AS NoteText,CHAR_LENGTH(Notes) AS TextLen
FROM Sample.Employee WHERE Notes IS NOT NULL

ODBC の {fn CONVERT()} 構文は文字ストリームをサポートしていません。

文字列への日付の変換

以下の例は、DOB (誕生日) 列の日付を SQL_VARCHAR データ型に変換します。ここで得られる文字列は yyyy-mm-dd 形式で表されます。

SELECT DOB,CONVERT(VARCHAR,DOB) AS DOBtoVChar
FROM Sample.Person

SELECT DOB,{fn CONVERT(DOB,SQL_VARCHAR)} AS DOBtoVChar
FROM Sample.Person

以下の例では、誕生日フィールド (DOB) から、形式設定した文字列への変換をいくつか示しています。それぞれの変換後、出力例の日付文字列がコメントに表示されます。

SELECT DOB,
       CONVERT(VARCHAR(20),DOB) AS DOBDefault, -- Mar 20 1983 12:00AM
       CONVERT(VARCHAR(20),DOB,100) AS DOB100, -- Mar 20 1983 12:00AM
       CONVERT(VARCHAR(20),DOB,107) AS DOB107, -- Mar 20, 1983
       CONVERT(VARCHAR(20),DOB,114) AS DOB114, -- 00:00:00.000
       CONVERT(VARCHAR(20),DOB,126) AS DOB126  -- 1983-03-20T00:00:00:
FROM Sample.Person

既定の形式とコード 100 の形式は同じです。DOB フィールドには時刻値が格納されていないため、時刻を表示する形式 (ここでは、既定値、100、114、126) では、12:00AM (真夜中) を示すゼロ値が指定されます。コード 126 の形式は、日付と時刻の文字列を空白なしで表示します。

InterSystems IRIS の CONVERT() 構文のみが日付文字列の書式設定をサポートしています。ODBC の {fn CONVERT()} 構文ではサポートしていません。

数値型への文字列の変換

以下の例では、複数の文字列の混在が整数に変換されます。InterSystems IRIS では、最初の数値以外の文字で文字列を切り捨て、結果として得られる数値をキャノニック形式に変換します。

SELECT CONVERT(INTEGER,'007 James Bond') -- 7

SELECT {fn CONVERT('007 James Bond',SQL_INTEGER)} -- 7

タイムスタンプへの日付の変換

以下の例は、DOB (誕生日) 列の日付をタイムスタンプ・データ型に変換します。ここで得られるタイムスタンプは、yyyy-mm-dd hh:mm:ss 形式で表されます。

SELECT DOB,CONVERT(TIMESTAMP,DOB) AS DOBtoTstamp
FROM Sample.Person

SELECT DOB,{fn CONVERT(DOB,SQL_TIMESTAMP)} AS DOBtoTstamp
FROM Sample.Person

数値型への日付の変換

以下の例は、DOB (誕生日) 列の日付を整数データ型に変換します。生成される整数は 1840 年 12 月 31 日からの $HOROLOG カウントになります。

SELECT DOB,CONVERT(INTEGER,DOB) AS DOBtoInt
FROM Sample.Person

SELECT DOB,{fn CONVERT(DOB,SQL_INTEGER)} AS DOBtoInt
FROM Sample.Person

ビット値の変換

BIT データ型変換を実行できます。許容される値は、1、0、または NULL です。その他の値を指定すると、InterSystems IRIS によって SQLCODE -141 エラーが発行されます。この例では NULL に対する 2 種類の BIT 変換を示します。

  SET a=""
  &sql(SELECT CONVERT(BIT,:a),
       CONVERT(BIT,NULL)
       INTO :x,:y)
  WRITE !,"SQLCODE=",SQLCODE
  WRITE !,"the host variable is:",x
  WRITE !,"the NULL keyword is:",y

埋め込み SQL を使用してホスト変数に空の文字列を格納している場合にのみ、ビット変換でその文字列を指定できます。CONVERT(BIT,'') のように空の文字列を直接指定すると、InterSystems IRIS によって SQLCODE -141 エラーが発行されます。

CONVERT クラス・メソッド

以下の構文で示すように、データ型を SQL_ キーワードとして指定し、CONVERT()Opens in a new tab メソッドを呼び出すことで、データ型を変換することもできます。

$SYSTEM.SQL.Functions.CONVERT(expression,SQL_convertToType,SQL_convertFromType)

以下に例を示します。

  write $SYSTEM.SQL.Functions.CONVERT(66225,"SQL_VARCHAR","SQL_DATE")