tencent cloud

云数据库 MySQL

动态与公告
产品动态
产品公告
新手指引
产品简介
产品概述
产品优势
应用场景
数据库架构
隔离策略
经济型实例
产品功能列表
数据库实例
高可用性(多可用区)
地域和可用区
自研内核
内核概述
内核版本更新动态
功能类特性
性能类特性
安全类特性
稳定类特性
TXRocks 引擎
内核问题检查与修复
购买指南
计费概述
选型指南
购买方式
续费说明
欠费说明
退费说明
按量转包年包月
调整实例费用说明
备份空间收费说明
数据库审计计费说明
数据库代理商业化计费和活动说明
数据库代理计费周期说明
查看费用账单
快速入门
入门概述
创建 MySQL 实例
连接 MySQL 实例
SQL 洞察(原数据库审计)
数据库审计简介
查看审计实例列表
开通审计服务
查看审计日志
日志投递
配置事后告警
修改审计规则
修改审计服务
关闭审计服务
审计规则模板
SQL 审计规则(旧版)
查看审计任务
授权子用户使用数据库审计
MySQL 云盘版
MySQL 云盘版概述
创建 MySQL 云盘版实例
维护管理实例
查看实例监控
调整实例配置
其他功能相关操作
迁移或升级至 MySQL 云盘版
操作指南
使用限制
操作总览
维护管理实例
升级实例
CPU 弹性扩容
只读/灾备实例
数据库代理
数据库管理(DMC)
账号管理
参数配置
备份与回档
数据迁移
网络与安全
监控与告警
日志中心
只读分析引擎
标签
实践教程
腾讯云 MySQL 帮助实现 MySQL 5.7升级至 MySQL 8.0
MySQL 5.6升级到 MySQL 5.7方法和说明
云数据库 MySQL 数据库审计等保实践
构建全场景高可用架构
云数据库 MySQL 使用规范
应用程序配置自动重连功能
MySQL 主实例参数修改的影响
MyISAM 自动转换为 InnoDB 引擎限制
为云数据库 MySQL 创建 VPC
使用云数据库 MySQL 提高业务负载能力
两地三中心灾备建设
读写分离扩展云数据库 MySQL 性能
使用 DTS 将 InnoDB 数据迁移至 RocksDB
构建 LAMP 堆栈 Web 应用程序
构建 Drupal 网站
通过 Python 语言使用 MySQL API
主备实例查询数据不一致
白皮书
性能白皮书
安全白皮书
故障处理
连接相关
性能相关
实例数据同步延迟
设置大小写不敏感失败
通过命令获取 slow_query_log_file 失败
API 文档
History
Introduction
API Category
Instance APIs
调用方式
Data Import APIs
Database Proxy APIs
数据库审计相关接口
Security APIs
Task APIs
Backup APIs
Account APIs
Rollback APIs
Parameter APIs
Database APIs
Monitoring APIs
Log-related API
Data Types
Error Codes
常见问题
选型相关
计费相关
备份相关
回档相关
连接登录
参数修改
升级相关
账号权限
性能内存
运维相关
数据迁移
功能特性
控制台相关
日志相关
事件相关
数据库审计
实例切换影响
API 2.0 切换 3.0 指引
相关协议
服务等级协议
服务条款
通用参考
标准与认证
联系我们
词汇表

日期函数支持说明

PDF
聚焦模式
字号
最后更新时间: 2025-12-03 14:14:27
目前只读分析引擎支持大部分 MySQL 的日期函数,但在部分场景下仍然存在限制和不兼容。本文介绍在只读分析引擎中日期函数的支持列表,并针对输入参数中的类型限制进行了列举。如存在文档中未提到的入参与函数则均不支持。

日期函数支持类型

datediff 函数

两个日期之间有多少个指定的时间间隔函数。
语法datediff(date1, date2)
date1支持值类型:支持 date,datetime 数据类型。
date2支持值类型:支持 date,datetime 数据类型。

year 函数

计算年份函数。
语法year(date1)
date1支持值类型:支持 date,datetime,char,varchar 数据类型。

month 函数

计算月份函数。
语法month(date1)
date1支持值类型:支持 date,datetime,char,varchar 数据类型。

day 函数

计算当天号数函数。
语法day(date1)
date1支持值类型:支持 date,datetime,char,varchar 数据类型。

hour 函数

计算小时函数。
语法hour(date1)
date1支持值类型:支持 date,datetime 数据类型。

minute 函数

计算分钟函数。
语法minute(date1)
date1支持值类型:支持 date,datetime 数据类型。

second 函数

计算秒函数。
语法second(date1)
date1支持值类型:支持 date,datetime 数据类型。

microsecond 函数

返回时间/日期时间的微秒部分。
语法microsecond(date1)
date1支持值类型:支持 date,datetime 数据类型。

quarter 函数

返回给定日期值(1到4之间的数字)的一年中的季度。
语法quarter(date1)
date1支持值类型:支持 date,datetime,varchar,char 数据类型。

date 函数

日期函数。
语法date(date1)
date1支持值类型:支持 date,datetime,char,varchar 数据类型。

sysdate 函数

返回系统时间函数。
语法sysdate()

date_add 函数

日期相加函数。
语法date_add(date1, interval expr type)
date1支持值类型:支持 date,datetime 数据类型。
expr 支持值类型:支持 int,long,double,decimal。
type 支持值类型:支持 DAY,DAY 为关键字。

date_sub 函数

日期相减函数。
语法date_sub(date1, interval expr type)
date1支持值类型:支持 date,datetime 数据类型。
expr 支持值类型:支持 int,long,double,decimal。
type 支持值类型:支持 DAY,DAY 为关键字。

dayofyear 函数

返回给定日期是当年的第几天的函数。
语法dayofyear(date1)
date1支持值类型:支持 date,datetime,char,varchar 数据类型。

dayofmonth 函数

返回给定日期是当月的哪一天的函数。
语法dayofmonth(date1)
date1支持值类型:支持 date,datetime,char,varchar 数据类型。

dayofweek 函数

返回给定日期是当周的哪一天的函数。
语法dayofweek(date1)
date1支持值类型:支持 date,datetime,char,varchar 数据类型。

dayname 函数

返回指定日期对应的星期的名称。
语法dayname(date1)
date1支持值类型:支持 date,datetime,char,varchar 数据类型。

monthname 函数

返回指定日期的月份的名称。
语法monthname(date1)
date1支持值类型:支持 date,datetime,char,varchar 数据类型。

to_seconds 函数

返回指定的日期/日期时间从0年开始的秒数。
语法to_seconds(date1)
date1支持值类型:支持 date,datetime,char,varchar 数据类型。

last_day 函数

返回月份中的最后一天的函数。
语法last_day(date1)
date1支持值类型:支持 date,datetime,char,varchar 数据类型。

sleep 函数

在执行时暂停几秒。
语法sleep(N)
N 支持值类型:int 数据类型。

now 函数

获取当前时间函数。
语法NOW()
获取当前的时间,无需入参。

current_timestamp 函数

获取当前时间函数,等同于 NOW 函数。
语法CURRENT_TIMESTAMP()
获取当前的时间,无需入参。

curdate 函数

获取当前日期函数,等同于 CURRENT_DATE 函数。
语法CURDATE()
获取当前的日期,无需入参。

current_date 函数

获取当前日期函数,等同于 CURDATE 函数。
语法CURRENT_DATE()
获取当前的时间,无需入参。

current_time 函数

获取当前时间函数。
语法CURRENT_TIME()
获取当前的时间,无需入参。

curtime 函数

获取当前时间函数,等同于 CURRENT_TIME 函数。
语法CURTIME()
获取当前的时间,无需入参。

from_unixtime 函数

将时间戳转换为时间格式函数。
语法FROM_UNIXTIME(unix_timestamp[,format])
unix_timestamp 支持 int 类型数字。
format 支持的格式如下面 date_format 函数 的表格示例。若 format 为空,则默认为 %Y-%m-%d %H:%i:%s 格式。

unix_timestamp 函数

基于日期时间将其转换为时间戳的函数。
语法UNIX_TIMESTAMP([date])
date 支持 DATE 标准的日期类型。
注意:
仅1.2404.17.0及以后的版本支持 FROM_UNIXTIME 函数与 UNIX_TIMESTAMP 函数。

weekday 函数

获取参数值所对应的星期。
语法weekday(date)
获取一个日期对应的星期数,入参支持 Date 或 Datetime 值,返回结果范围:0 - 6,分别对应:星期日 - 星期六。如果日期为 NULL 或 0000-00-00,函数则返回 NULL。

timediff 函数

获取两个时间之间的差值。
语法timediff(time1,time2)
获取 time1与 time2之间的时间差值,time1 - time2。

to_days 函数

获取从公元0年12月31日到入参值之间的天数。
语法to_days(date)
获取结果为天数,此天数为入参值与公元0年之间的天数,入参支持 Date 或字符串值,返回结果为数字类型。

yearweek 函数

获取指定日期所在年份和周数的函数。
语法yearweek(date[,mode])
获取结果为周数,date 为要计算的日期(例如:'2025-06-15'),mode 为可选参数,用于指定周的起始日。默认为0,表示周的起始日为周日。返回结果为数字类型。

time 函数

提取时间或者日期表达式中的时间部分,并通过字符串返回。
语法time(expr)
获取结果为时间,expr 可填写时间类型或者日期时间类型。返回类型为字符串,如果 expr 为空,则返回为空。

date_format 函数

日期格式化函数。
语法date_format(date1, format)
date1支持值类型:支持 date,datetime,char,varchar 数据类型,不支持 date1包含 null 场景。format 规定日期/时间的输出格式。可以使用的格式如下表。
格式
描述
%a
缩写星期名。
%b
缩写月名。
%c
月,数值。
%D
带有英文前缀的月中的天。
%d
月的天,数值(00 - 31)。
%e
月的天,数值(0 - 31)。
%f
微秒。
%H
小时(00 - 23)。
%h
小时(01 - 12)。
%I
小时(01 - 12)。
%i
分钟,数值(00 - 59)。
%j
年的天(001 - 366)。
%k
小时(0 - 23)。
%l
小时(1 - 12)。
%M
月名。
%m
月,数值(00 -12)。
%p
AM 或 PM。
%r
时间,12 - 小时(hh:mm:ss AM 或 PM)。
%S
秒(00 - 59)。
%s
秒(00 - 59)。
%T
时间,24 - 小时(hh:mm:ss)。
%U
周(00 - 53)星期日是一周的第一天。
%u
周(00 - 53)星期一是一周的第一天。
%V
周(01 - 53)星期日是一周的第一天,与 %X 使用。
%v
周(01 - 53)星期一是一周的第一天,与 %x 使用。
%W
星期名。
%w
周的天(0 = 星期日,6 = 星期六)。
%X
年,其中的星期日是周的第一天,4位,与 %V 使用。
%x
年,其中的星期一是周的第一天,4位,与 %v 使用。
%Y
年,4位。
%y
年,2位。

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈