添加链接 注册    登录
link之家
链接快照平台
  • 输入网页链接，自动生成快照
  • 标签化管理网页链接
相关文章推荐
温柔的柳树  ·  俄罗斯世界杯八强出炉：欧洲6球队晋级 南美球 ...·  2 月前    · 
很酷的脆皮肠  ·  亚历山德拉·费奥多萝芙娜（沙皇尼古拉一世之妻 ...·  4 月前    · 
卖萌的芹菜  ·  陆止于此，海始于斯——大连旅游攻略（下） - 知乎·  1 年前    · 
逃跑的墨镜  ·  【台北电影节】《该死的阿修罗》王渝萱夺最佳女 ...·  1 年前    · 
体贴的柳树  ·  什么青菜要放葱搞笑_什么青菜要放葱什么意思_ ...·  1 年前    · 
link之家  ›  DATE_FORMAT函数介绍_云原生大数据计算服务 MaxCompute(MaxCompute)-阿里云帮助中心
https://help.aliyun.com/zh/maxcompute/user-guide/date-format
满身肌肉的火锅
5 月前
DATE_FORMAT

DATE_FORMAT

更新时间：
一键部署
产品详情
相关技术圈
我的收藏

DATE_FORMAT支持将DATE、TIMESTAMP和STRING类型的数据，转换为指定格式的字符串。本文介绍DATE_FORMAT函数的命令格式和使用示例。

命令格式 

string date_format(date|timestamp|string <date>, string <format>)

参数说明

  • date ：必填。待转换的日期值。支持DATE、TIMESTAMP或STRING类型。

    • DATE和STRING类型只能在Hive兼容模式下使用，您可以执行 set odps.sql.hive.compatible=true; 命令打开Hive模式。

    • 如果参数为STRING类型，则格式只支持以下三种日期字段：

      • 'yyyy-MM-dd' ，例如 '2019-12-27' 。

      • 'yyyy-MM-dd hh:mm:ss' ，例如 '2019-12-27 12:23:10' 。

      • 'yyyy-MM-dd hh:mm:ss.SSS' ，例如 '2019-12-27 12:23:10.123' 。

  • format ：必填。STRING类型常量。 format 可由如下日期字段组成，例如 yyyy-MM-dd hh:mm:ss.SSS 或 yyyy-MM-dd hh:mi:ss.SSS ：

    • YYYY 或 yyyy 代表年份，其中yyyy代表日历年，YYYY代表周年。

      说明

      周年格式可能会与实际年份不一致，请谨慎使用。

    • MM 代表月份。

    • mm 代表分钟。

    • dd 代表天。

    • HH 代表24小时制时。

    • hh 代表12小时制时。

    • mi 代表分钟。

    • ss 代表秒。

    • SSS 代表毫秒。

    重要

    • 在非Hive兼容模式下， HH 和 hh 都代表24小时制时。并且只能使用 yyyy-MM-dd hh:mi:ss ，如果使用 yyyy-MM-dd hh:mm:ss ， mm 部分会取月份值。

    • 在Hive兼容模式下， HH 代表24小时制时， hh 代表12小时制时。并且只能使用 yyyy-MM-dd hh:mm:ss ，如果使用 yyyy-MM-dd hh:mi:ss 会返回NULL。

返回值说明

返回STRING类型。返回规则如下：

  • date 非DATE或TIMESTAMP类型时，返回NULL。

  • 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.123456789 | 2021-10-29 | 2021-10-29 00:00:00 | 2021-10-11 00:00:00.123456789 | 2021-11-20 | 123456780  |
| 2    | 2021-11-28 | 2021-11-28 00:02:00 | 2021-02-11 00:00:00.123456789 | 2021-10-29 | 2021-10-29 00:00:00 | 2021-10-11 00:00:00.123456789 | 2021-11-21 | 123456781  |
| 3    | 2021-11-27 | 2021-11-27 00:03:00 | 2021-03-11 00:00:00.123456789 | 2021-10-29 | 2021-10-29 00:00:00 | 2021-10-11 00:00:00.123456789 | 2021-11-22 | 123456782  |
| 4    | 2021-11-26 | 2021-11-26 00:04:00 | 2021-04-11 00:00:00.123456789 | 2021-10-29 | 2021-10-29 00:00:00 | 2021-10-11 00:00:00.123456789 | 2021-11-23 | 123456783  |
| 5    | 2021-11-25 | 2021-11-25 00:05:00 | 2021-05-11 00:00:00.123456789 | 2021-10-29 | 2021-10-29 00:00:00 | 2021-10-11 00:00:00.123456789 | 2021-11-24 | 123456784  |
| 6    | 2021-11-24 | 2021-11-24 00:06:00 | 2021-06-11 00:00:00.123456789 | 2021-10-29 | 2021-10-29 00:00:00 | 2021-10-11 00:00:00.123456789 | 2021-11-25 | 123456785  |
| 7    | 2021-11-23 | 2021-11-23 00:07:00 | 2021-07-11 00:00:00.123456789 | 2021-10-29 | 2021-10-29 00:00:00 | 2021-10-11 00:00:00.123456789 | 2021-11-26 | 123456786  |
| 8    | 2021-11-22 | 2021-11-22 00:08:00 | 2021-08-11 00:00:00.123456789 | 2021-10-29 | 2021-10-29 00:00:00 | 2021-10-11 00:00:00.123456789 | 2021-11-27 | 123456787  |
| 9    | 2021-11-21 | 2021-11-21 00:09:00 | 2021-09-11 00:00:00.123456789 | 2021-10-29 | 2021-10-29 00:00:00 | 2021-10-11 00:00:00.123456789 | 2021-11-28 | 123456788  |
| 10   | 2021-11-20 | 2021-11-20 00:10:00 | 2021-10-11 00:00:00.123456789 | 2021-10-29 | 2021-10-29 00:00:00 | 2021-10-11 00:00:00.123456789 | 2021-11-29 | 123456789  |
+------+-------+------------+------------+-------+------------+------------+-------+------------+

使用示例：静态数据示例 

--打开Hive模式。与SQL语句一起提交。
set odps.sql.hive.compatible=true;
--假设当前时间为2023-11-20 17:52。返回2023-11-20 17:52:41.544。
select date_format(from_utc_timestamp(current_timestamp(), 'UTC'),'yyyy-MM-dd HH:mm:ss.SSS');
--返回2022-04-24。
select date_format('2022-04-24','yyyy-MM-dd');

使用示例：表数据示例

基于 示例数据 ，对datetime1和timestamp1转换为指定格式的字符串，命令示例如下。 

--打开Hive模式并开启2.0新类型。与SQL语句一起提交。
set odps.sql.hive.compatible=true;
set odps.sql.type.system.odps2=true;
select datetime1, timestamp1, date_format(datetime1,'yyyy/mm/dd'),
       date_format(datetime1,'yyyy/mm/dd HH:mm:ss'),
       date_format(timestamp1,'yyyy/mm/dd HH:mm:ss')
from mf_date_fun_t;

返回结果如下。 

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

相关函数

DATE_FORMAT函数属于日期函数， 更多日期计算、日期转换的相关函数请参见 日期函数 。

上一篇：DATE_ADD 下一篇：DATE_SUB
分区和列操作 云原生大数据计算服务 MaxCompute-表操作 插入或覆写数据（INSERT INTO | INSERT OVERWRITE） ALTER TABLE 日期与时间函数 字符串函数
  • 本页导读 （1）
 
推荐文章
温柔的柳树  ·  俄罗斯世界杯八强出炉：欧洲6球队晋级 南美球队占2席--体育--人民网
2 月前
很酷的脆皮肠  ·  亚历山德拉·费奥多萝芙娜（沙皇尼古拉一世之妻）_百度百科
4 月前
卖萌的芹菜  ·  陆止于此，海始于斯——大连旅游攻略（下） - 知乎
1 年前
逃跑的墨镜  ·  【台北电影节】《该死的阿修罗》王渝萱夺最佳女配角 颁奖人百白退场激动到摔倒_哔哩哔哩_bilibili
1 年前
体贴的柳树  ·  什么青菜要放葱搞笑_什么青菜要放葱什么意思_青菜要放葱吗 - 抖音
1 年前
今天看啥   ·   Py中国   ·   codingpro   ·   藏经阁   ·   小百科   ·   link之家   ·   卧龙AI搜索
删除内容请联系邮箱 2879853325@qq.com
link之家 - 链接快照平台
© 2024 ~ 沪ICP备11025650号