tencent cloud

TDSQL-C MySQL 版

动态与公告
产品动态
产品公告
新手指引
产品简介
产品概述
产品优势
应用场景
产品架构
产品规格
实例类型
产品功能列表
数据库版本
地域和可用区
常用概念
使用限制
使用规范建议
自研内核
内核概述
内核版本更新动态
内核优化版本
功能类特性
性能类特性
安全类特性
稳定性特性
分析引擎特性
内核问题检查与修复
购买指南
计费概述
产品价格
创建集群
变配说明
续费说明
欠费说明
退费说明
按量转包年包月
按量转 Serverless
增值服务计费说明
查看费用账单
快速入门
数据库审计
简介
查看审计实例列表
开通审计服务
查看审计日志
日志投递
配置事后告警
修改审计规则
修改审计服务
关闭审计服务
审计规则模板
查看审计任务
授权子用户使用数据库审计
Serverless 服务
Serverless 简介
创建和管理 Serverless 版集群
弹性管理工具
Serverless 资源包
多可用区部署
配置变更
常见问题
Serverless 成本预估器
操作指南
操作总览
控制台切换集群页面视图
数据库连接
实例管理
配置变更
实例形态管理
集群管理
只读实例管理
数据库代理
账号管理
数据库管理
数据库管理工具(DMC)
参数配置
多可用区部署
全球数据库
备份与恢复
操作日志
迁移数据
并行查询
列存索引 CSI
分析引擎
数据库安全和加密
监控与告警
SQL 基本操作
使用 SCF 连接 TDSQL-C MySQL 版
标签
实践教程
TDSQL-C MySQL 版数据库审计等保实践
通过 DTS 升级数据库版本 MySQL5.7至8.0
TDSQL-C MySQL 版使用规范
新版本控制台
数据库代理多连接地址实现多 RO 组
数据库代理的优势
如何选择存储空间计费模式
通过 DTS 构建异地灾备
为集群创建 VPC
如何进行数据恢复
如何解决 CPU 使用率高的问题
如何授权子用户查看监控
白皮书
安全白皮书
性能白皮书
故障处理
连接相关
性能相关
API 文档
History
Introduction
API Category
Making API Requests
Instance APIs
Multi-Availability Zone APIs
Other APIs
Audit APIs
Database Proxy APIs
Backup and Recovery APIs
Parameter Management APIs
Billing APIs
serverless APIs
Resource Package APIs
Account APIs
Performance Analysis APIs
Data Types
Error Codes
常见问题
基础概念
购买与计费
兼容与格式
连接与网络
功能特性
控制台操作
数据库表
性能与日志
数据库审计
TDSQL-C MySQL 版和云数据库 MySQL 有什么区别
相关协议
服务等级协议
服务条款
TDSQL-C 政策
隐私政策
数据处理和安全协议
通用参考
标准与认证
词汇表
联系我们

日期函数支持说明

PDF
聚焦模式
字号
最后更新时间: 2025-12-03 14:20:22
目前只读分析引擎支持大部分 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位。

帮助和支持

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

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

文档反馈