式 & 式

式は INTEGER データ型を含んでいる任意の有効な式です。ビット演算のためにバイナリ数値へ変換されます。

~ 式

式は INTEGER データ型を含んでいる任意の有効な式です。ビット演算のためにバイナリ数値へ変換されます。チルダ（~）は、ユーザー定義名の一部として使用できません。

式 | 式

式は INTEGER データ型を含んでいる任意の有効な式です。ビット演算のためにバイナリ数値へ変換されます。

式 ^ 式

式は INTEGER データ型を含んでいる任意の有効な式です。ビット演算のためにバイナリ数値へ変換されます。キャレット記号（^）は、ユーザー定義名の一部として使用できません。

ASCII (string)

string の一番左の文字の数値を返します。値は、データベース コード ページ内の文字の位置です。UNICODE 関数も参照してください。

BIT_LENGTH (string)

string の長さをビット数で返します。

CHAR (code)

code 引数により選択されるデータベース コード ページの文字に対応する、単一文字の文字列を返します。引数は整数値でなければなりません。NCHAR 関数も参照してください。

CHAR_LENGTH (string)

string 内のバイト数を返します。CHAR および NCHAR string では、すべての埋め込みが意味を持ちます。

CHAR_LENGTH2 (string)

string 内の文字数を返します。CHAR および NCHAR string では、すべての埋め込みが意味を持ちます。データにダブルバイト文字が含まれている場合は、文字列のサイズより小さい値が返されることがあります。

CHARACTER_LENGTH (string)

CONCAT (string1, string2)

string2 を string1 に連結した結果の文字列を返します。

ISNUMERIC (string)

LCASE または LOWER (string)

string の大文字がすべて小文字に変換された文字列を返します。

LEFT (string, count)

string の左端から count 分の文字を返します。count の値は整数です。

LENGTH (string)

string 内の文字数を返します。VARCHAR、NVARCHAR、LONGVARCHAR、または NLONGVARCHAR の string の場合、後続の空白はカウントされます。CHAR、NCHAR、LONGVARCHAR、または NLONGVARCHAR の string の場合、後続のヌルはカウントされます。string の終端文字はカウントされません。ANSI_PADDING = OFF の場合、後続のヌルは後続の空白と同様に扱われ、CHAR 列では長さにカウントされません。

LOCATE (string1, string2[, start])

string2 の中で string1 が最初に現れる位置を返します。string2 内での検索は、開始位置（start）が指定されていなければ、先頭の文字位置から始めます。検索は指定された開始位置から始まります。string2 の先頭文字位置は 1 です。string1 が見つからない場合は、値 0 が返されます。

LTRIM (string)

string から先頭の空白を除いた文字を返します。CHAR および NCHAR string では、すべての埋め込みが意味を持ちます。

NCHAR (code)

code 引数で指定される Unicode コードポイント値に対応する、単一文字のワイド文字列を返します。引数は整数値でなければなりません。CHAR 関数も参照してください。

OCTET_LENGTH (string)

string の長さを 8 進数（バイト数）で返します。CHAR および NCHAR string では、すべての埋め込みが意味を持ちます。

POSITION (string1, string2)

string2 の中にある string1 の位置を返します。string1 が string2 内に存在しない場合は、ゼロが返されます。

REPLACE (string1, string2, string3)

string1 を検索して string2 が現れる箇所を探し、それをすべて string3 に置き換えます。その結果が返されます。文字列が現れなかった場合は、string1 が返されます。

REPLICATE (string, count)

string を count の回数だけ繰り返して構成した string を返します。count の値は整数です。

REVERSE (string)

文字の並びが反転された string を返します。文字列型の先頭のスペースは末尾のスペースとは異なり、意味のあるものと見なされることに注意してください。例を参照してください。

RIGHT (string, count)

string の右端から count 分の文字を返します。count の値は整数です。

RTRIM (string)

string から後続の空白を除いた文字列を返します。ANSI_PADDING = OFF の場合、後続のヌルは後続の空白と同様に扱われ、CHAR 列の値から除かれます。

SOUNDEX (string)

SPACE (count)

count で示された数の空白から成る string を返します。

STUFF (string1, start, length, string2)

string1 の start 位置から length で示された数だけの文字を string2 で置き換えた結果得られる文字列を返します。start と length は整数です。

SUBSTRING (string1, start, length)

string1 の中の start で指定された文字位置から、length で指定された文字数を取り出し、その文字列を返します。start 値には、任意の数値を指定できます。string1 の先頭位置は 1 です。0 または負数の start 値は、先頭位置の左と見なされます。length は負の値にできません。

UCASE または UPPER (string)

string の小文字すべて大文字に変換された文字列を返します。

UNICODE (string)

string の一番左の文字の Unicode コードポイント値を返します。ASCII 関数も参照してください。

ABS (numeric_exp)

numeric_exp の絶対値（正数）を返します。

ACOS (float_exp)

ラジアンで示された角度として、float_exp のアークコサインを返します。

ASIN (float_exp)

ラジアンで示された角度として、float_exp のアークサインを返します。

ATAN (float_exp)

ラジアンで示された角度として、float_exp のアークタンジェントを返します。

ATAN2 (float_exp1, float_exp2)

ラジアンで示された角度として、x（float_exp1）座標と y（float_exp2）座標のアークタンジェントを返します。

CEILING (numeric_exp)

numeric_exp で示された値以上の最小の整数を返します。

COS (float_exp)

float_exp がラジアンで示された角度である場合、float_exp のコサインを返します。

COT (float_exp)

float_exp がラジアンで示された角度である場合、float_exp のコタンジェントを返します。

DEGREES (numeric_exp)

numeric_exp のラジアンから変換された度数を返します。

EXP (float_exp)

float_exp の指数値を返します。

FLOOR (numeric_exp)

numeric_exp で示された値以下の最大の整数を返します。

LOG (float_exp)

float_exp の自然対数を返します。

LOG10 (float_exp)

float_exp の 10 を底とする対数を返します。

MOD (integer_exp1, integer_exp2)

integer_exp1 を integer_exp2 で割った余り（絶対値）を返します。

POWER (numeric_exp, integer_exp)

numeric_exp に integer_exp で示されたべき乗を行った値を返します。

RADIANS (numeric_exp)

numeric_exp の度数から変換されたラジアン値を返します。

RAND (integer_exp)

integer_exp をオプションのシード値として使用する、ランダムな浮動小数点値を返します。

ROUND (numeric_exp, integer_exp)

小数点の右側の integer_exp で示される位置で丸められた numeric_exp を返します。integer_exp が負数の場合、numeric_exp は、小数点の左側の |integer_exp|（integer_exp の絶対値）で示される位置で丸められます。

SIGN (numeric_exp)

numeric_exp の符号を示す値を返します。numeric_exp が 0 より小さい場合は -1 が返されます。numeric_exp が 0 の場合は 0 が返されます。numeric_exp が 0 より大きい場合は 1 が返されます。

SIN (float_exp)

float_exp がラジアンで示された角度である場合、float_exp のサインを返します。

SQRT (float_exp)

float_exp の平方根を返します。

TAN (float_exp)

float_exp がラジアンで示された角度である場合、float_exp のタンジェントを返します。

TRUNCATE (numeric_exp, integer_exp)

小数点の右側の integer_exp で示される位置で切り捨てられた numeric_exp を返します。integer_exp が負数の場合、numeric_exp は、小数点の左側の |integer_exp|（絶対値）で示される位置で切り捨てられます。

現在の現地日付を 'yyyy-mm-dd' 形式で返します。デフォルトで、ローカル時計の日付を使用します。SET TIME ZONE を呼び出した場合、CURDATE() の値は、システム時計とオペレーティング システムの地域の設定を基に UTC 日付と時刻を計算し、SET TIME ZONE のオフセット値を加算することによって決定されます。

現在の現地時刻を 'hh:mm:ss' 形式で返します。デフォルトで、ローカル時計の時刻を使用します。SET TIME ZONE を呼び出した場合、CURTIME() の値は、システム時計とオペレーティング システムの地域の設定を基に UTC 日付と時刻を計算し、SET TIME ZONE のオフセット値を加算することによって決定されます。

DATEADD(datepart, interval, date_exp)

日付に interval を加算した新しい DATETIME 値を返します。たとえば、datepart が day、interval が 11、date_exp が 2020 年 1 月 26 日の場合は、2020 年 2 月 6 日を返します。datepart には interval を加算する日付の部分を指定します。値は以下のいずれかである必要があります。

interval には、datepart を増加させるために用いる正または負の整数値を指定します。interval に小数部が含まれる場合、小数部は無視されます。

date_exp は DATETIME 値、暗黙的に DATETIME 値に変換される値、または DATE 形式の文字列を返す式です。DATETIME を参照してください。

DATEDIFF(datepart, start, end)

datepart には差異を計算する日付の部分を指定します。値は以下のいずれかである必要があります。

start には差異を計算する始まりの日付を指定します。start は DATETIME 値または DATE 形式の Unicode 文字列を返す式です。

end には差異を計算する終わりの日付を指定します。end は DATETIME 値または DATE 形式の Unicode 文字列を返す式です。

end から start が減算されます。戻り値が整数値の範囲外の場合はエラーが返されます。データ型の範囲を参照してください。

DATEFLOOR(timestamp_exp, interval_unit)

timestamp_exp を最も近い interval_unit の境界に切り捨てることによって決定されるタイムスタンプを返します。この切り捨ては、interval_unit より右にあるすべてのタイムスタンプ フィールドを最小値に設定することで行われます。たとえば、interval_unit が day である場合は、timestamp_exp の year、month、および day はすべて保持され、hour、minute、および second はゼロに設定されます。

interval_unit に対して有効な値は次のとおりです。

DATEFROMPARTS(year, month, day)

DATENAME (datepart, date_exp)

date_exp の datepart を表す英語の文字列（VARCHAR）を返します。たとえば、datepart month は January、February というように月名を返します。datepart weekday は Monday、Tuesday というように曜日を返します。

datepart には返される日付の部分を指定します。値は以下のいずれかである必要があります。

date_exp は DATETIME 値、暗黙的に DATETIME 値に変換される値、または DATE 形式の文字列を返す式です。DATETIME を参照してください。

DATEPART(datepart, date_exp)

date_exp の datepart を表す整数を返します。たとえば、datepart month は月を表す整数を返します（1 月 = 1、2 月 = 2）。datepart weekday は曜日を表す整数を返します（日曜日 = 1、土曜日 = 7）。

datepart には返される日付の部分を指定します。値は以下のいずれかである必要があります。

TZOFFSET 値は、タイム ゾーンのオフセットを分数（符号付き）で返します。TZOFFSET を指定した DATEPART 関数は、SYSDATETIMEOFFSET() および、タイム ゾーンのオフセットを含んでいる文字列リテラルでのみ機能します。タイム ゾーン オフセットの範囲は -14:00 から +14:00 です。時刻と日付関数の例を参照してください。

date_exp は DATETIME 値、暗黙的に DATETIME 値に変換される値、または DATE 形式の文字列を返す式です。DATETIME を参照してください。

DAY(date_exp)

指定された date_exp の日にちを返します。これは DATEPART(day, date_exp) とまったく同じです。DATEPART(datepart, date_exp) を参照してください。

DAYNAME(date_exp)

date_exp の曜日部分に対して、曜日の名前（たとえば、Sunday から Saturday）を含んでいる英語の文字列を返します。

date_exp には、日付リテラル、SQL_TIMESTAMP リテラル、または DATE、DATETIME、タイムスタンプ データが格納されている列を指定できます。

DAYOFMONTH(date_exp)

date_exp の月の何日目かを 1 ～ 31 の範囲の整数値で返します。date_exp には、日付リテラル、SQL_TIMESTAMP リテラル、または DATE、DATETIME、タイムスタンプ データが格納されている列を指定できます。

DAYOFYEAR(date_exp)

date_exp の年の何日目かを 1 ～ 366 の範囲の整数値で返します。

DATETIMEFROMPARTS(year, month, day, hour, minute, seconds, milliseconds)

DATETIMEOFFSETFROMPARTS(year, month, day, hour, minute, seconds, fractions, hour_offset, minute_offset, scale)

scale を除くパラメーターのいずれかがヌルである場合は、ヌルが返されます。scale がヌルの場合は、エラーが返されます。

scale には、分数値の精度を指定します。指定できる範囲は 0 から 7 です。fractions は scale によって決まり、範囲は 0 から 9999999 です。たとえば、scale が 3 の場合、各 fractions はミリ秒を表します。fractions に指定される桁数は、scale の値以下でなければなりません。

hour_offset には、タイム ゾーンの時部分を指定します。範囲は -14 から +14 です。minute_offset には、タイム ゾーンの分部分を指定します。範囲は 0 から 59 です。hour_offset と minute_offset の符号は、hour_offset が 0 でない限り、同じでなければなりません。

EVERYN(interval_unit, timestamp_exp, rounding_unit, bucket_size)

timestamp_exp を最も近いタイム バケットの開始に切り捨てることによって決定されるタイムスタンプを返します。タイム バケットは、bucket_size * interval_unit をバケットとし、最も近い rounding_unit の開始からカウントします。

interval_unit および rounding_unit に対して有効な値は次のとおりです。

メモ：interval_unit より rounding_unit の方が間隔が大きい場合にのみ、EVERYN は有用な結果をもたらします。

EXTRACT(extract_field, extract_source)

extract_source の extract_field 部分を返します。引数 extract_source は、日付、時刻、または間隔を表す式です。

extract_field には次の値を指定でき、またこれらの値が対象の式から返されます。

HOUR(time_exp)

時刻を 0 ～ 23 の範囲の整数値で返します。time_exp には、日付リテラル、SQL_TIMESTAMP リテラル、または DATE、DATETIME、タイムスタンプ データが格納されている列を指定できます。

MINUTE(time_exp)

分を 0 ～ 59 の範囲の整数値で返します。time_exp には、日付リテラル、SQL_TIMESTAMP リテラル、または DATE、DATETIME、タイムスタンプ データが格納されている列を指定できます。

MONTH(date_exp)

月を 1 ～ 12 の範囲の整数値で返します。date_exp には、日付リテラル、SQL_TIMESTAMP リテラル、または DATE、DATETIME、タイムスタンプ データが格納されている列を指定できます。

MONTHNAME(date_exp)

date_exp の月の部分に対して、月名（たとえば、January から December）を含んでいる英語の文字列を返します。date_exp には、日付リテラル、SQL_TIMESTAMP リテラル、または DATE、DATETIME、タイムスタンプ データが格納されている列を指定できます。

デフォルトで、ローカル時計の時刻を使用します。SET TIME ZONE を呼び出した場合、NOW() の値は、システム時計とオペレーティング システムの地域の設定を基に UTC 日付と時刻を計算し、SET TIME ZONE のオフセット値を加算することによって決定されます。

QUARTER(date_exp)

date_exp の四半期を 1 ～ 4 の範囲の整数値で返します。1 は 1 月 1 日～ 3 月 31 日を表します。date_exp には、日付リテラル、SQL_TIMESTAMP リテラル、または DATE、DATETIME、タイムスタンプ データが格納されている列を指定できます。

SECOND(time_exp)

秒を 0 ～ 59 の範囲の整数値で返します。time_exp には、日付リテラル、SQL_TIMESTAMP リテラル、または DATE、DATETIME、タイムスタンプ データが格納されている列を指定できます。

デフォルトで、ローカル時計の時刻を使用します。小数位は、Windows 10 ではセプタ秒、Linux ではナノ秒、その他すべてのプラットフォームではマイクロ秒です。値が返されない末尾の数字部分は、9 桁までゼロで埋められます。SET TIME ZONE を呼び出した場合、SYSDATETIME() の値は、システム時計とオペレーティング システムの地域の設定を基に UTC 日付と時刻を計算し、SET TIME ZONE のオフセット値を加算することによって決定されます。

デフォルトで、ローカル時計の時刻を使用します。小数位は、Windows 10 ではセプタ秒、Linux ではナノ秒、その他すべてのプラットフォームではマイクロ秒です。値が返されない末尾の数字部分は、9 桁までゼロで埋められます。SET TIME ZONE を呼び出した場合、SYSUTCDATETIME() の値は、システム時計とオペレーティング システムの地域の設定を基に UTC 日付と時刻を計算することによって決定されます。

TIMEFROMPARTS(hour, minute, seconds, fractions, scale)

scale を除くパラメーターのいずれかがヌルである場合は、ヌルが返されます。scale がヌルの場合は、エラーが返されます。

scale には、分数値の精度を指定します。指定できる範囲は 0 から 7 です。fractions は scale によって決まり、範囲は 0 から 9999999 です。たとえば、scale が 3 の場合、各 fractions はミリ秒を表します。fractions に指定される桁数は、scale の値以下でなければなりません。

TIMESTAMPADD(interval, integer_exp, timestamp_exp)

interval タイプの integer_exp で示された間隔を timestamp_exp に加算したタイムスタンプを返します。

interval に指定できるキーワードは次のとおりです。

TIMESTAMPDIFF(interval, timestamp_exp1, timestamp_exp2)

timestamp_exp2 が timestamp_exp1 より大きい場合に、その差である interval の整数値を返します。

interval に指定できる値は、TIMESTAMPADD と同じです。

WEEK(date_exp)

date_exp が 1 年の第何週目かを 1 ～ 53 の範囲の整数値で返します。date_exp には、日付リテラル、SQL_TIMESTAMP リテラル、または DATE、DATETIME、タイムスタンプ データが格納されている列を指定できます。

WEEKDAY(date_exp)

指定された date_exp の曜日を返します。1 = 日曜日、7 = 土曜日です。これは DATEPART(weekday, date_exp) とまったく同じです。DATEPART(datepart, date_exp) を参照してください。

YEAR(date_exp)

年数を整数値で返します。範囲はデータ ソースに依存します。date_exp には、日付リテラル、SQL_TIMESTAMP リテラル、または DATE、DATETIME、タイムスタンプ データが格納されている列を指定できます。

COALESCE(expression1, expression2[, ... ])

詳細については、COALESCE も参照してください。

IF (predicate, expression1, expression2)

述部（predicate）が真の場合は expression1 を返します。そうでない場合は expression2 を返します。

IFNULL(exp, value)

exp がヌルの場合は value が返されます。exp がヌルでない場合は exp が返されます。value に指定するデータ型は、exp のデータ型と互換性がなければなりません。

ISNULL(exp, value)

ヌルを value で示された値に置き換えます。exp はヌルをチェックする式です。value は exp がヌルの場合に返される値です。ヌルでない場合は exp が返されます。value に指定するデータ型は、exp のデータ型と互換性がなければなりません。

NULLIF (exp1, exp2)

2 つの式が等しくない場合は、exp1 を返します。式が等しい場合、NULLIF はヌル値を返します。

CAST(exp AS type)

TRY_CAST (exp AS type)

exp（式）を type へ変換します。この type は Zen で使用できるデータ型に表示されるいずれかのデーター型です。桁数と小数位パラメーターも含めます。

CONVERT (exp, type [, style ])

TRY_CONVERT (exp, type [, style ])

以下の型の引数を使用して、exp を、指定された type に 変換します。

オプション パラメーターの style は、DATETIME データ型のみに適用されます。このパラメーターを使用すると、DATETIME データ型のミリ秒部分が切り捨てられます。style の値は 20 または 120 です。どちらの値も正規の形式である yyyy-mm-dd hh:mm:ss を指定します。変換関数の例を参照してください。