TO_CHAR命令格式、參數和傳回值 - MaxCompute

TO_CHAR函數分為字串類型和日期類型兩種。字串類型指的是將BOOLEAN、BIGINT、DECIMAL或DOUBLE類型值轉換為對應的STRING類型。日期類型指的是將日期按照指定格式轉換為字串。

字串類型轉換

將BOOLEAN、BIGINT、DECIMAL或DOUBLE類型值轉換為對應的STRING類型表示。

命令格式

STRING TO_CHAR(BOOLEAN|BIGINT|DOUBLE|DECIMAL <value>)

參數說明

value：必填。BOOLEAN、BIGINT、DECIMAL或DOUBLE類型。

傳回值說明

返回STRING類型。返回規則如下：

value非BOOLEAN、BIGINT、DECIMAL或DOUBLE類型時，返回報錯。
value值為NULL時，返回NULL。

使用樣本

樣本1：將如下值轉換為STRING類型。

SELECT TO_CHAR(123);

返回結果如下。

+------------+
| _c0        |
+------------+
| 123        |
+------------+

樣本2：輸入參數為NULL，傳回值還為NULL。

SELECT TO_CHAR(NULL);

返回結果如下。

+------------+
| _c0        |
+------------+
| NULL       |
+------------+

日期類型轉換

將日期按照指定格式轉換為字串。

命令格式

STRING TO_CHAR(DATATIME <date>, STRING <format>)

參數說明

date：必填。DATETIME類型日期值，格式為yyyy-mm-dd hh:mi:ss。如果輸入為STRING類型，且MaxCompute專案的資料類型版本是1.0，會隱式轉換為DATETIME類型後參與運算。
format：必填。STRING類型常量。format中的日期格式部分會被替換成相應的資料，其他字元直接輸出。

傳回值說明

返回STRING類型。返回規則如下：

date非DATETIME或STRING類型時，返回報錯。
date值為NULL時，返回報錯。
format值為NULL時，返回NULL。

樣本資料

為便於理解各函數的使用方法，本文為您提供來源資料，基於來源資料提供函數相關樣本。建立表mf_date_fun_t，並添加資料，命令樣本如下。

create table if not exists mf_date_fun_t(
    id      int,
    date1   date,
    datetime1   datetime,
    timestamp1 timestamp,
    date2   date,
    datetime2   datetime,
    timestamp2 timestamp,
    date3 string,
    date4 bigint);
insert into mf_date_fun_t values
(1,DATE'2021-11-29',DATETIME'2021-11-29 00:01:00',TIMESTAMP'2021-01-11 00:00:00.123456789',DATE'2021-10-29',DATETIME'2021-10-29 00:00:00',TIMESTAMP'2021-10-11 00:00:00.123456789','2021-11-20',123456780),
(2,DATE'2021-11-28',DATETIME'2021-11-28 00:02:00',TIMESTAMP'2021-02-11 00:00:00.123456789',DATE'2021-10-29',DATETIME'2021-10-29 00:00:00',TIMESTAMP'2021-10-11 00:00:00.123456789','2021-11-21',123456781),
(3,DATE'2021-11-27',DATETIME'2021-11-27 00:03:00',TIMESTAMP'2021-03-11 00:00:00.123456789',DATE'2021-10-29',DATETIME'2021-10-29 00:00:00',TIMESTAMP'2021-10-11 00:00:00.123456789','2021-11-22',123456782),
(4,DATE'2021-11-26',DATETIME'2021-11-26 00:04:00',TIMESTAMP'2021-04-11 00:00:00.123456789',DATE'2021-10-29',DATETIME'2021-10-29 00:00:00',TIMESTAMP'2021-10-11 00:00:00.123456789','2021-11-23',123456783),
(5,DATE'2021-11-25',DATETIME'2021-11-25 00:05:00',TIMESTAMP'2021-05-11 00:00:00.123456789',DATE'2021-10-29',DATETIME'2021-10-29 00:00:00',TIMESTAMP'2021-10-11 00:00:00.123456789','2021-11-24',123456784),
(6,DATE'2021-11-24',DATETIME'2021-11-24 00:06:00',TIMESTAMP'2021-06-11 00:00:00.123456789',DATE'2021-10-29',DATETIME'2021-10-29 00:00:00',TIMESTAMP'2021-10-11 00:00:00.123456789','2021-11-25',123456785),
(7,DATE'2021-11-23',DATETIME'2021-11-23 00:07:00',TIMESTAMP'2021-07-11 00:00:00.123456789',DATE'2021-10-29',DATETIME'2021-10-29 00:00:00',TIMESTAMP'2021-10-11 00:00:00.123456789','2021-11-26',123456786),
(8,DATE'2021-11-22',DATETIME'2021-11-22 00:08:00',TIMESTAMP'2021-08-11 00:00:00.123456789',DATE'2021-10-29',DATETIME'2021-10-29 00:00:00',TIMESTAMP'2021-10-11 00:00:00.123456789','2021-11-27',123456787),
(9,DATE'2021-11-21',DATETIME'2021-11-21 00:09:00',TIMESTAMP'2021-09-11 00:00:00.123456789',DATE'2021-10-29',DATETIME'2021-10-29 00:00:00',TIMESTAMP'2021-10-11 00:00:00.123456789','2021-11-28',123456788),
(10,DATE'2021-11-20',DATETIME'2021-11-20 00:10:00',TIMESTAMP'2021-10-11 00:00:00.123456789',DATE'2021-10-29',DATETIME'2021-10-29 00:00:00',TIMESTAMP'2021-10-11 00:00:00.123456789','2021-11-29',123456789);

查詢表mf_date_fun_t中的資料，命令樣本如下：

SELECT * FROM mf_date_fun_t;

返回結果如下。

+------------+------------+---------------------+-------------------------+------------+---------------------+-------------------------+------------+------------+
| id         | date1      | datetime1           | timestamp1              | date2      | datetime2           | timestamp2              | date3      | date4      |
+------------+------------+---------------------+-------------------------+------------+---------------------+-------------------------+------------+------------+
| 1          | 2021-11-29 | 2021-11-29 00:01:00 | 2021-01-11 00:00:00.123 | 2021-10-29 | 2021-10-29 00:00:00 | 2021-10-11 00:00:00.123 | 2021-11-20 | 123456780  |
| 2          | 2021-11-28 | 2021-11-28 00:02:00 | 2021-02-11 00:00:00.123 | 2021-10-29 | 2021-10-29 00:00:00 | 2021-10-11 00:00:00.123 | 2021-11-21 | 123456781  |
| 3          | 2021-11-27 | 2021-11-27 00:03:00 | 2021-03-11 00:00:00.123 | 2021-10-29 | 2021-10-29 00:00:00 | 2021-10-11 00:00:00.123 | 2021-11-22 | 123456782  |
| 4          | 2021-11-26 | 2021-11-26 00:04:00 | 2021-04-11 00:00:00.123 | 2021-10-29 | 2021-10-29 00:00:00 | 2021-10-11 00:00:00.123 | 2021-11-23 | 123456783  |
| 5          | 2021-11-25 | 2021-11-25 00:05:00 | 2021-05-11 00:00:00.123 | 2021-10-29 | 2021-10-29 00:00:00 | 2021-10-11 00:00:00.123 | 2021-11-24 | 123456784  |
| 6          | 2021-11-24 | 2021-11-24 00:06:00 | 2021-06-11 00:00:00.123 | 2021-10-29 | 2021-10-29 00:00:00 | 2021-10-11 00:00:00.123 | 2021-11-25 | 123456785  |
| 7          | 2021-11-23 | 2021-11-23 00:07:00 | 2021-07-11 00:00:00.123 | 2021-10-29 | 2021-10-29 00:00:00 | 2021-10-11 00:00:00.123 | 2021-11-26 | 123456786  |
| 8          | 2021-11-22 | 2021-11-22 00:08:00 | 2021-08-11 00:00:00.123 | 2021-10-29 | 2021-10-29 00:00:00 | 2021-10-11 00:00:00.123 | 2021-11-27 | 123456787  |
| 9          | 2021-11-21 | 2021-11-21 00:09:00 | 2021-09-11 00:00:00.123 | 2021-10-29 | 2021-10-29 00:00:00 | 2021-10-11 00:00:00.123 | 2021-11-28 | 123456788  |
| 10         | 2021-11-20 | 2021-11-20 00:10:00 | 2021-10-11 00:00:00.123 | 2021-10-29 | 2021-10-29 00:00:00 | 2021-10-11 00:00:00.123 | 2021-11-29 | 123456789  |
+------------+------------+---------------------+-------------------------+------------+---------------------+-------------------------+------------+------------+

使用樣本

待用資料樣本

樣本1

--需要注意在Windows環境的MaxCompute用戶端運行時返回結果中的中文字元顯示存在問題
SELECT TO_CHAR(DATETIME '2010-12-03 00:00:00','阿里金融yyyy-mm*dd');

返回結果如下。

+------------+
| _c0        |
+------------+
| 阿里金融2010-12*03 |
+------------+

樣本2

SELECT TO_CHAR(DATETIME '2008-07-18 00:00:00','yyyymmdd');

返回結果如下。

+------------+
| _c0        |
+------------+
| 20080718   |
+------------+

樣本3

SET odps.sql.type.system.odps2=false;
SELECT TO_CHAR('2008-07-18 00:00:00', 'yyyymmdd');

返回結果如下。

+------------+
| _c0        |
+------------+
| 20080718   |
+------------+

樣本4

--'阿里巴巴2010-12*3'無法轉換為符合要求的格式，會引發異常，應該為'阿里巴巴2010-12*03'。
SELECT TO_CHAR(datetime'阿里巴巴2010-12*3', '阿里巴巴yyyy-mm*dd');

樣本5

--'20102401'不是標準日期值，引發異常，應該為'2010-01-24 00:00:00'。
SELECT TO_CHAR(datetime'20102401', 'yyyy');

樣本6

SELECT TO_CHAR(datetime'2010-12-03 00:00:00', null);

返回結果如下。

+------------+
| _c0        |
+------------+
| NULL       |
+------------+

表資料樣本

基於上述樣本資料，將datetime1列日期轉換為滿足指定格式的字串，命令樣本如下。

SELECT  datetime1
        ,TO_CHAR(datetime1,'yyyy-mm-dd') AS datetime1_to_char
FROM    mf_date_fun_t;

返回結果如下。

+---------------------+-------------------+
| datetime1           | datetime1_to_char |
+---------------------+-------------------+
| 2021-11-29 00:01:00 | 2021-11-29        |
| 2021-11-28 00:02:00 | 2021-11-28        |
| 2021-11-27 00:03:00 | 2021-11-27        |
| 2021-11-26 00:04:00 | 2021-11-26        |
| 2021-11-25 00:05:00 | 2021-11-25        |
| 2021-11-24 00:06:00 | 2021-11-24        |
| 2021-11-23 00:07:00 | 2021-11-23        |
| 2021-11-22 00:08:00 | 2021-11-22        |
| 2021-11-21 00:09:00 | 2021-11-21        |
| 2021-11-20 00:10:00 | 2021-11-20        |
+---------------------+-------------------+

MaxCompute：TO_CHAR

字串類型轉換

命令格式

參數說明

傳回值說明

使用樣本

日期類型轉換

命令格式

參數說明

傳回值說明

樣本資料

使用樣本

相關函數