本數據庫格式化函數提供一套強大的工具用于把各種數據類型 （日期/時間、整數、浮點、數字） 轉換成格式化的字符串以及反過來從格式化的字符串轉換成指定的數據類型。格式化函數表列出了這些函數。這些函數都遵循一個公共的調用規范： 第一個參數是待格式化的值，而第二個是一個定義輸出或輸入格式的模板。

格式化函數

在一個to_char輸出模板串中，一些特定的模式可以被識別并且被替換成基于給定值的被恰當地格式化的數據。任何不屬于模板模式的文本都簡單地照字面拷貝。同樣，在一個輸入模板串里（對其他函數），模板模式標識由輸入數據串提供的值。如果在模板字符串中有不是模板模式的字符，輸入數據字符串中的對應字符會被簡單地跳過（不管它們是否等于模板字符串字符）。

用于日期/時間格式化的模板模式表展示了可以用于格式化日期和時間值的模版。

用于日期/時間格式化的模板模式

修飾語可以被應用于模板模式來修改它們的行為。例如，FMMonth就是帶著FM修飾語的Month模式。用于日期/時間格式化的模板模式修飾語表展示了可用于日期/時間格式化的修飾語模式。

用于日期/時間格式化的模板模式修飾語

日期/時間格式化的使用須知：

• FM抑制前導的零或尾隨的空白， 否則會把它們增加到輸入從而把一個模式的輸出變成固定寬度。在本數據庫中，FM只修改下一個聲明，而在Oracle中，FM影響所有隨后的聲明，并且重復的FM修飾語將觸發填充模式開和關。

• 無論是否指定FM，TM抑制尾隨的空格。

• to_timestamp和to_date忽略輸入中的字母大小寫； 例如MON，Mon和mon都接受相同的字符串。 當使用TM修飾符時，大小寫折疊是根據函數的輸入排序規則進行的。

• to_timestamp和to_date跳過了輸入字符串開頭和日期和時間值周圍的多個空格，除非使用了FX選項。 例如，to_to_timestamp(' 2000 JUN', 'YYY-MON')和to_timestamp('2000 - JUN', 'YYY-MON')都能工作，但to_timestamp('2000 JUN', 'FXYYYY-MON')返回一個錯誤，因為to_timestamp只期望一個空格。FX必須指定為模板中的第一個項目。

• to_timestamp和to_date的模板字符串中的分隔符（一個空格或非字母/非數字字符）與輸入字符串中的任何一個分隔符相匹配，或者被跳過，除非使用了FX選項。例如，to_to_timestamp('2000JUN', 'YYY///MON')和to_timestamp('2000/JUN', 'YYY/MON')可以工作，但to_timestamp('2000/JUN', 'YYYY/MON')返回一個錯誤，因為輸入字符串中的分隔符數量超過了模板中的分隔符數量。 如果指定了FX，模板字符串中的分隔符正好與輸入字符串中的一個字符匹配。 但要注意的是，輸入字符串中的字符不需要與模板字符串中的分隔符相同。例如，to_timestamp('2000/JUN', 'FXYYYY MON')可以工作，但是to_timestamp('2000/JUN', 'FXYYYY MON')返回錯誤，因為模板字符串中的第二個空格會消耗掉輸入字符串中的字母J。

• TZH模板模式可以匹配一個有符號的數字。如果沒有FX選項，減號可能是模糊的，可能被解釋為分隔符。這種模棱兩可的問題可以通過以下方式解決。 如果模板字符串中TZH前的分隔符的數量小于輸入字符串中減號前的分隔符數量，則減號被解釋為TZH的一部分。否則，減號被認為是值之間的分隔符。例如，to_timestamp(''2000 -10', 'YYY TZH')與-10匹配，但to_timestamp('2000 -10', 'YYYY TZH')匹配10到TZH。

• 在to_char模板里可以有普通文本，并且它們會被照字面輸出。你可以把一個子串放到雙引號里強迫它被解釋成一個文本，即使它里面包含模板模式也如此。例如，在 '"Hello Year "YYYY'中，YYYY將被年份數據代替，但是Year中單獨的Y不會。在to_date、to_number以及to_timestamp中，文本和雙引號字符串會導致跳過該字符串中所包含的字符數量，例如"XX"會跳過兩個輸入字符（不管它們是不是XX）。

  說明

  在本數據庫 12 之前，可以使用非字母或非數字字符跳過輸入字符串中的任意文本。例如，to_timestamp('2000y6m1d', 'yyyyy-MM-DD')以前是有效的。 現在，你只能使用字母字符來實現這個目的。 例如，to_timestamp(''2000y6m1d', 'yyyytMMtDDt')和to_timestamp('2000y6m1d', 'yyyyy"y"MM"m"DD"d"')跳過y、m和d。

• 如果你想在輸出里有雙引號，那么你必須在它們前面放反斜線，例如 '\"YYYY Month\"'。不然，在雙引號字符串外面的反斜線就不是特殊的。在雙引號字符串內，反斜線會導致下一個字符被取其字面形式，不管它是什么字符（但是這沒有特殊效果，除非下一個字符是一個雙引號或者另一個反斜線）。

• 在to_timestamp和to_date中，如果年份格式聲明少于四位（如YYY）并且提供的年份少于四位，年份將被調整為最接近于 2020 年，例如95會變成 1995。

• 在to_timestamp和to_date中，負的年份被視為表示 BC。 如果你同時寫一個負的年份和一個顯式的BC字段，你又會得到 AD。第 0 年的輸入被視為公元前 1 年。

• 在to_timestamp和to_date中，在處理超過 4 位數的年份時，YYYY轉換具有限制。你必須在YYYY后面使用一些非數字字符或者模板， 否則年份總是被解釋為 4 位數字。例如（對于 20000 年）：to_date('200001131', 'YYYYMMDD')將會被解釋成一個 4 位數字的年份，而不是在年份后使用一個非數字分隔符，像to_date('20000-1131', 'YYYY-MMDD')或to_date('20000Nov31', 'YYYYMonDD')。

• 在to_timestamp和to_date中，CC（世紀）字段會被接受，但是如果有YYY、YYYY或者Y,YYY字段則會忽略它。如果CC與YY或Y一起使用，則結果被計算為指定世紀中的那一年。如果指定了世紀但是沒有指定年，則會假定為該世紀的第一年。

• 在to_timestamp和to_date中，工作日名稱或編號（DAY、D以及相關的字段類型）會被接受，但會為了計算結果的目的而忽略。季度（Q）字段也是一樣。

• 在to_timestamp和to_date中，一個 ISO 8601 周編號的日期（與一個格里高利日期相區別）可以用兩種方法之一被指定為to_timestamp和to_date：

• 年、周編號和工作日：例如to_date('2006-42-4', 'IYYY-IW-ID')返回日期2006-10-19。如果你忽略工作日，它被假定為 1（周一）。

• 年和一年中的日：例如to_date('2006-291', 'IYYY-IDDD')也返回2006-10-19。

嘗試使用一個混合了 ISO 8601 周編號和格里高利日期的域來輸入一個日期是無意義的，并且將導致一個錯誤。在一個 ISO 周編號的年的環境下，一個“月”或“月中的日”的概念沒有意義。在一個格里高利年的環境下，ISO 周沒有意義。用戶應當避免混合格里高利和 ISO 日期聲明。

• 在to_timestamp中，毫秒（MS）和微秒（US）域都被用作小數點后的秒位。例如to_timestamp('12.3', 'SS.MS')不是 3 毫秒, 而是 300，因為該轉換把它看做 12 + 0.3 秒。這意味著對于格式SS.MS而言，輸入值12.3、12.30和12.300指定了相同數目的毫秒。要得到三毫秒，你必須使用 12.003，轉換會把它看做 12 + 0.003 = 12.003 秒。 下面是一個更復雜的例子 ∶to_timestamp('15:12:02.020.001230', 'HH24:MI:SS.MS.US')是 15 小時、12 分鐘和 2 秒 + 20 毫秒 + 1230 微秒 = 2.021230 秒。

• to_char(..., 'ID')的一周中日的編號匹配extract(isodow from ...)函數，但是to_char(..., 'D')不匹配extract(dow from ...)的日編號。

• to_char(interval)格式化HH和HH12為顯示在一個 12 小時的時鐘上，即零小時和 36 小時輸出為12，而HH24會輸出完整的小時值，對于間隔它可以超過23。

用于數字格式化的模板模式表展示了可以用于格式化數字值的模版模式。

用于數字格式化的模板模式

數字格式化的用法須知：

• 0指定一個總是被打印的數位，即便它包含前導/拖尾的零。9也指定一個數位，但是如果它是前導零則會被空格替換，而如果是拖尾零并且指定了填充模式則它會被刪除（對于to_number()來說，這兩種模式字符等效）。

• 模式字符S、L、D以及G表示當前 locale 定義的負號、貨幣符號、小數點以及數字分隔符字符（見 lc_monetary 和 lc_numeric）。不管 locale 是什么，模式字符句號和逗號就表示小數點和數字分隔符。

• 對于to_char()的模式中的一個負號，如果沒有明確的規定，將為該負號保留一列，并且它將被錨接到（出現在左邊）那個數字。如果S正好出現在某個9的左邊，它也將被錨接到那個數字。

• 使用SG、PL或MI格式化的符號并不掛在數字上面； 例如，to_char(-12, 'MI9999')生成'- 12'，而to_char(-12, 'S9999')生成 ' -12'。（Oracle 里的實現不允許在9前面使用MI，而是要求9在MI前面。）

• TH不會轉換小于零的數值，也不會轉換小數。

• PL、SG和TH是本數據庫擴展。

• 在to_number中，如果沒有使用L或TH之類的非數據模板模式，相應數量的輸入字符會被跳過，不管它們是否匹配模板模式，除非它們是數據字符（也就是數位、負號、小數點或者逗號）。例如，TH會跳過兩個非數據字符。

• 帶有to_char的V會把輸入值乘上10^``n，其中n是跟在V后面的位數。帶有to_number的V以類似的方式做除法。to_char和to_number不支持使用結合小數點的V（例如，不允許99.9V99）。

• EEEE（科學記數法）不能和任何其他格式化模式或修飾語（數字和小數點模式除外）組合在一起使用，并且必須位于格式化字符串的最后（例如9.99EEEE是一個合法的模式）。

某些修飾語可以被應用到任何模板來改變其行為。例如，FM99.99是帶有FM修飾語的99.99模式。用于數字格式化的模板模式修飾語表中展示了用于數字格式化模式修飾語。

用于數字格式化的模板模式修飾語

to_char 例子展示了一些使用to_char函數的例子。

to_char例子