CAST

数値のキャスト

数値は、数値データ型または文字列データ型にキャストできます。

少ない桁数の値に数値をキャストすると、その数値は四捨五入ではなく、切り捨てられます。例えば、98.765 を INT にキャストすると 98 が返され、CHAR にキャストすると 9 が返されます。また、CHAR(4) にキャストすると 98.7 が返されます。負数を CHAR にキャストすると負符号のみが返され、小数を CHAR にキャストすると小数点のみが返される点に注意してください。

数値は、0 ～ 9 の数字の桁、小数点、先頭にある 1 つまたは複数の記号 (+ または –)、および指数記号 (文字 E または e) とそれに続く 1 つ以下の + 記号または – 記号で構成できます。数値に桁区切り文字 (コンマ) を入れることはできません。詳細は、"Caché SQL の使用法" の “言語要素” にある "リテラル" のセクションを参照してください。

数値は、キャストされる前に Caché SQL によって以下のようにその数値のキャノニック形式に変換されます。指数演算が実行されます。Caché によって、先頭と末尾にあるゼロ、先頭にある + 記号、および末尾にある小数点が取り除かれます。数値がキャストされる前に、複数の記号が変換されます。ただし、SQL では 2 つ続いたマイナス記号はコメントを示す記号として扱われます。したがって、数値の中にマイナス記号を 2 つ続けて記述すると、Caché ではそのコード行のそれ以降の部分はコメントとして扱われます。

Caché 浮動小数点は、DEC、DECIMAL、NUMERIC、または FLOAT データ型をとることができます。DOUBLE データ型は IEEE 浮動小数点標準に従って浮動小数点を表します。Caché 浮動小数点データ型は DOUBLE データ型より精度が高く、ほとんどのアプリケーションに推奨されます。CAST を使用して浮動小数点を DOUBLE データ型にキャストすることはできません。代わりに、ObjectScript の $DOUBLE 関数を使用します。

数値を日付データ型または時刻データ型にキャストすると、SQL ではゼロ (0) として表示されます。ただし、日付または時刻にキャストした数値を埋め込み SQL から ObjectScript に渡すと、対応する $HOROLOG 値として表示されます。

文字列のキャスト

文字列は他の文字データ型にキャストできます。得られる返り値は、1 文字、先頭の n 文字、または文字列全体です。

キャストの前に、Caché SQL によって埋め込み引用符文字 ('can''t'=can't) および文字列連結 ('can'||'not'=cannot) が変換されます。先頭の空白や末尾の空白は削除されます。

文字列を数値型にキャストすると、必ず 1 桁のゼロ (0) が返されます。

文字列は、DATE、TIME、TIMESTAMP のいずれかのデータ型にキャストできます。以下の演算では、有効な数値が得られます。

• DATE ： 'yyyy-mm-dd' 形式の文字列は DATE にキャストできます。これは、ODBC 日付形式に対応した文字列形式です。値とその範囲の確認が行われます。入力された日付値は、有効な日付であることが必要です。月および日のフィールドに先頭のゼロが不足している場合は、追加されます。SQL では、キャストされたこの値はロケールの日付表示形式で表示されます。例えば、'2004-11-23' が '11/23/2004' と表示されます。埋め込み SQL では、このキャストにより、対応する $HOROLOG 日付整数が返されます。無効な ODBC 日付や非数値文字列を DATE にキャストすると、論理モードでは 0 として表され、日付 0 は 1840–12–31 として表示されます。

• TIME ： 'hh:mm:ss' または 'hh:mm:ss.nn' 形式の文字列は TIME にキャストできます。これは、ODBC 時刻形式に対応した文字列形式です。値とその範囲の確認が行われます。先頭のゼロが不足している場合は追加されます。埋め込み SQL では、このキャストにより、対応する $HOROLOG 時刻整数が返されます。無効な ODBC 時刻や非数値文字列を TIME にキャストすると、論理モードでは 0 として表され、時刻 0 は 00:00:00 として表示されます。

• TIMESTAMP ： 有効な日付と時刻、有効な日付、または有効な時刻で構成される文字列は TIMESTAMP にキャストできます。日付部分はさまざまな形式で指定できます。不足する日付部分の既定値は 1841–01–01 です。不足する時刻部分の既定値は 00:00:00 です。00 ～ 49 の 2 桁の年は 21 世紀の年に変換され、50 ～ 99 の 2 桁の年は 20 世紀の年に変換されます。先頭のゼロが不足している場合は追加されます。秒の小数部 (指定されている場合) の前には、ピリオド (.) とコロン (:) のいずれかを付けることができます。これらの記号は、意味が異なります。ピリオドは標準的な小数を示すため、12:00:00.4 は 10 分の 4 秒を示し、12:00:00.004 は 1000 分の 4 秒を示します。コロンは、それに続く値が 1000 分の 1 秒単位であることを示すため、12:00:00:4 は 1000 分の 4 秒を示します。コロンの後に続けることができる桁数は 3 に制限されています。

NULL および空文字列のキャスト

NULL はあらゆるデータ型にキャストできますが、返り値は NULL です。

空文字列 ('') は以下のようにキャストします。

• すべての文字データ型からは NULL が返されます。

• すべての数値データ型からは 0 (ゼロ) が返されます。末尾には小数部のゼロが適切な数だけ表示されます。DOUBLE データ型からは 0 (ゼロ) が返されます。小数部のゼロは末尾に表示されません。

• DATE データ型からは 12/31/1840 が返されます。

• TIME データ型からは 00:00:00 が返されます。

• TIMESTAMP、DATETIME、および SMALLDATETIME データ型からは NULL が返されます。

• BIT データ型からは 0 が返されます。

• すべてのバイナリ・データ型からは NULL が返されます。

日付のキャスト

日付は、日付データ型、数値データ型、または文字データ型にキャストできます。

日付を TIMESTAMP、DATETIME、または SMALLDATETIME のいずれかのデータ型にキャストすると、YYYY-MM-DD hh:mm:ss 形式のタイムスタンプが返されます。日付には時刻部分がないため、返されるタイムスタンプの時刻部分は常に 00:00:00 です。expr 値がロケールの日付表示形式において有効な日付ではない場合、CAST は NULL を返します。

以下のダイナミック SQL の例では、DATE データ型のフィールドを TIMESTAMP にキャストしています。

  ZNSPACE "SAMPLES"
  SET myquery=2
  SET myquery(1)="SELECT TOP 5 DOB,CAST(DOB AS TIMESTAMP) AS TStamp,"
  SET myquery(2)="FROM Sample.Person"
  SET tStatement = ##class(%SQL.Statement).%New()
  SET qStatus = tStatement.%Prepare(.myquery)
   IF qStatus'=1 {WRITE "%Prepare failed:" DO $System.Status.DisplayError(qStatus) QUIT}
  SET rset = tStatement.%Execute()
  DO rset.%Display()
  WRITE !,"End of data"

以下のダイナミック SQL の例では、TIMESTAMP データ型のフィールドを DATE にキャストしています。

  ZNSPACE "SAMPLES"
  SET myquery=2
  SET myquery(1)="SELECT TOP 5 EventDate,CAST(EventDate AS DATE) AS Horolog,"
  SET myquery(2)="FROM Aviation.Event"
  SET tStatement = ##class(%SQL.Statement).%New()
  SET qStatus = tStatement.%Prepare(.myquery)
   IF qStatus'=1 {WRITE "%Prepare failed:" DO $System.Status.DisplayError(qStatus) QUIT}
  SET rset = tStatement.%Execute()
  DO rset.%Display()
  WRITE !,"End of data"

日付を数値データ型にキャストすると、その日付の $HOROLOG 値が返されます。これは、1840 年 12 月 31 日を 0 とし、そこから起算した日数を表す整数値です。

日付を文字列データ型にキャストすると、日付全体、またはキャスト先のデータ型で決まる長さの日付が返されます。ただし、表示形式はキャスト先の文字列データ型で異なります。CHAR VARYING および CHARACTER VARYING の両データ型では、日付全体が返されます。例えば、MM/DD/YYYY 形式で日付を表現している場合は、その日付が同じ形式の文字列として返されます。他のデータ型では、日付 (またはその一部) が ODBC 日付形式の文字列として返されます。例えば、日付を mm/dd/yyyy 形式で表現している場合は、その日付が YYYY-MM-DD という形式の文字列として返されます。したがって、日付 04/24/2004 に対して、CHAR データ型では暦年の先頭文字である '2' が返され、CHAR(8) データ型では '2004–04–' が返されます。

ビット値のキャスト

expr 値 AS BIT では、0 または 1 が返されるようにキャストすることができます。expr が 1 など、ゼロ以外の数値の場合は、1 が返されます。expr が “TRUE”、“True”、または “true” の場合は、1 が返されます(“True” という語は大文字と小文字の任意の組み合わせで示してもかまいませんが、“T” と短縮することはできません)。expr がその他の非数値の場合は、0 が返されます。expr が 0 の場合は、0 が返されます。

次の例では、最初の 5 つの CAST 演算では 1 が返され、次の 5 つでは 0 が返されます。

SELECT CAST(1 AS BIT) AS One, 
       CAST(7 AS BIT) AS Num,      
       CAST(743.6 AS BIT) AS Frac,  
       CAST(0.3 AS BIT) AS Zerofrac,
       CAST('tRuE' AS BIT) AS TrueWord,
       CAST(0 AS BIT) AS Zero,  
       CAST('FALSE' AS BIT) AS FalseWord, 
       CAST('T' AS BIT) AS T,    
       CAST('F' AS BIT) AS F,   
       CAST(0.0 AS BIT) AS Zerodot