文字

文字代表內建資料類型的一種常數值。某些 (但非全部) 資料類型可以使用文字表示。

字串常值

字串常值必須「加引號」,可以使用單引號 ( ' ) 或雙引號 ( " )。

加引號的文字:

字面意義 用法示範 注意事項
加引號的字串
  • "abc"
  • "it's"
  • 'it\'s'
  • 'Title: "Boy"'
  • 使用單引號 ( ' ) 括住的字串可以包含未逸出的雙引號 ( " ),反之亦然。
  • 反斜線 ( \ ) 引入逸出序列。請參閱下方的逸出序列表。
  • 加引號的字串不能含有換行符號,即使前面有反斜線 ( \ ) 也不行。
原始字串
  • R"abc+"
  • r'f\(abc,(.\*),def\)'
  • 具有原始字串文字前置字元 ( r R ) 且加引號的文字,系統會將之解譯為原始/規則運算式字串。
  • 反斜線字元 ( \ ) 不能用作逸出字元。如果在字串文字內出現反斜線後接另一個字元,則這兩個字元都會保留。
  • 原始字串結尾的反斜線數量不得為奇數。
  • 原始字串可用於建構規則運算式。

字串常值的逸出序列

下表列出可在字串文字中代表非英數字元的所有有效逸出序列。凡是此表未列出的序列都會產生錯誤。

逸出序列 說明
\a Bell
\b Backspace
\f 換頁
\n 換行
\r 回車
\t 分頁
\v 垂直分頁
\\ 反斜線 ( \ )
\? 問號 ( ? )
\" 雙引號 ( " )
\' 單引號 ( ' )
\\` 倒引號 ( \` )
\ooo 由 3 個數字 (介於 0 到 7 範圍內) 組成的八進位逸出。解碼成一個 Unicode 字元 (字串文字) 或位元組 (位元組文字)。
\xhh \Xhh 由 2 個十六進位數字 (0 到 9 或 A 到 F 或 a 到 f) 組成的十六進位逸出。解碼成一個 Unicode 字元 (字串文字) 或位元組 (位元組文字)。示例:
  • '\x41' == 'A'
  • '\x41B' 'AB'
  • '\x4' 是錯誤值
\uhhhh Unicode 逸出,含小寫的「u」和 4 個十六進位數字。只適用於字串文字或 ID。

請注意,系統不允許使用 D800 到 DFFF 的範圍,因為這些是代理 unicode 值。
\Uhhhhhhhh Unicode 逸出,含大寫的「U」和 8 個十六進位數字。只適用於字串文字或 ID。

系統不允許使用 D800 到 DFFF 的範圍,因為這些值是代理 unicode 值。而且,系統也不允許大於 10FFFF 的值。

日期文字

如要在計算欄位中使用日期和時間常值,請在值前加上適當的標記:

字面意義 標準日期格式 用法示範
日期 YYYY-[M]M-[D]D DATE '2021-4-1'
日期和時間 YYYY-[M]M-[D]D [[H]H:[M]M:[S]S] DATETIME '2021-5-29 23:59:59'

數值文字

使用不含引號的整數或浮點值輸入數值字面值。例如:

字面意義 示例 用法示範
整數 1, -1, 0
  • 2 + 2
  • CASE WHEN Cost > 100 THEN...
浮點 1.23、-1.2345
  • SQRT(3.14)
  • FLOOR(-42.123)

布林值字面值

評估布林運算式時,請使用常值 truefalse。例如:

IF( Boolean field = true, "yes","no")

IF( Boolean field = false, "no","yes")
IF( Boolean field, "yes","no")

IF(not Boolean field, "yes","no")