网络
虚拟私有云 VPC
弹性公网IP EIP
弹性负载均衡 ELB
NAT网关 NAT
云专线 DC
虚拟专用网络 VPN
云连接 CC
VPC终端节点 VPCEP
企业路由器 ER
企业交换机 ESW
全球加速 GA
企业连接 EC
云原生应用网络 ANC
安全与合规
安全技术与应用
Web应用防火墙 WAF
企业主机安全 HSS
云防火墙 CFW
安全云脑 SecMaster
DDoS防护 AAD
数据加密服务 DEW
数据库安全服务 DBSS
云堡垒机 CBH
数据安全中心 DSC
云证书管理服务 CCM
威胁检测服务 MTD
态势感知 SA
认证测试中心 CTC
边缘安全 EdgeSec
应用中间件
微服务引擎 CSE
分布式消息服务Kafka版
分布式消息服务RabbitMQ版
分布式消息服务RocketMQ版
API网关 APIG
分布式缓存服务 DCS
多活高可用服务 MAS
事件网格 EG
管理与监管
统一身份认证服务 IAM
消息通知服务 SMN
云监控服务 CES
应用运维管理 AOM
应用性能管理 APM
云日志服务 LTS
云审计服务 CTS
标签管理服务 TMS
配置审计 Config
应用身份管理服务 OneAccess
资源访问管理 RAM
组织 Organizations
资源编排服务 RFS
优化顾问 OA
IAM 身份中心
云运维中心 COC
资源治理中心 RGC
解决方案
高性能计算 HPC
SAP
混合云灾备
开天工业工作台 MIW
Haydn解决方案工厂
数字化诊断治理专家服务
云生态
云商店
合作伙伴中心
华为云开发者学堂
华为云慧通差旅
开发与运维
软件开发生产线 CodeArts
需求管理 CodeArts Req
流水线 CodeArts Pipeline
代码检查 CodeArts Check
编译构建 CodeArts Build
部署 CodeArts Deploy
测试计划 CodeArts TestPlan
制品仓库 CodeArts Artifact
移动应用测试 MobileAPPTest
CodeArts IDE Online
开源镜像站 Mirrors
性能测试 CodeArts PerfTest
应用管理与运维平台 ServiceStage
云应用引擎 CAE
开源治理服务 CodeArts Governance
华为云Astro轻应用
CodeArts IDE
Astro工作流 AstroFlow
代码托管 CodeArts Repo
漏洞管理服务 CodeArts Inspector
联接 CodeArtsLink
软件建模 CodeArts Modeling
Astro企业应用 AstroPro
CodeArts盘古助手
华为云Astro大屏应用
计算
弹性云服务器 ECS
Flexus云服务
裸金属服务器 BMS
云手机服务器 CPH
专属主机 DeH
弹性伸缩 AS
镜像服务 IMS
函数工作流 FunctionGraph
云耀云服务器(旧版)
VR云渲游平台 CVR
Huawei Cloud EulerOS
云化数据中心 CloudDC
网络
虚拟私有云 VPC
弹性公网IP EIP
弹性负载均衡 ELB
NAT网关 NAT
云专线 DC
虚拟专用网络 VPN
云连接 CC
VPC终端节点 VPCEP
企业路由器 ER
企业交换机 ESW
全球加速 GA
企业连接 EC
云原生应用网络 ANC
CDN与智能边缘
内容分发网络 CDN
智能边缘云 IEC
智能边缘平台 IEF
CloudPond云服务
安全与合规
安全技术与应用
Web应用防火墙 WAF
企业主机安全 HSS
云防火墙 CFW
安全云脑 SecMaster
DDoS防护 AAD
数据加密服务 DEW
数据库安全服务 DBSS
云堡垒机 CBH
数据安全中心 DSC
云证书管理服务 CCM
威胁检测服务 MTD
态势感知 SA
认证测试中心 CTC
边缘安全 EdgeSec
大数据
MapReduce服务 MRS
数据湖探索 DLI
表格存储服务 CloudTable
可信智能计算服务 TICS
推荐系统 RES
云搜索服务 CSS
数据可视化 DLV
数据接入服务 DIS
数据仓库服务 GaussDB(DWS)
数据治理中心 DataArts Studio
湖仓构建 LakeFormation
智能数据洞察 DataArts Insight
应用中间件
微服务引擎 CSE
分布式消息服务Kafka版
分布式消息服务RabbitMQ版
分布式消息服务RocketMQ版
API网关 APIG
分布式缓存服务 DCS
多活高可用服务 MAS
事件网格 EG
开天aPaaS
应用平台 AppStage
开天企业工作台 MSSE
开天集成工作台 MSSI
API中心 API Hub
云消息服务 KooMessage
交换数据空间 EDS
云地图服务 KooMap
云手机服务 KooPhone
组织成员账号 OrgID
云空间服务 KooDrive
管理与监管
统一身份认证服务 IAM
消息通知服务 SMN
云监控服务 CES
应用运维管理 AOM
应用性能管理 APM
云日志服务 LTS
云审计服务 CTS
标签管理服务 TMS
配置审计 Config
应用身份管理服务 OneAccess
资源访问管理 RAM
组织 Organizations
资源编排服务 RFS
优化顾问 OA
IAM 身份中心
云运维中心 COC
资源治理中心 RGC
区块链
区块链服务 BCS
数字资产链 DAC
华为云区块链引擎服务 HBS
解决方案
高性能计算 HPC
SAP
混合云灾备
开天工业工作台 MIW
Haydn解决方案工厂
数字化诊断治理专家服务
价格
成本优化最佳实践
专属云商业逻辑
云生态
云商店
合作伙伴中心
华为云开发者学堂
华为云慧通差旅
其他
管理控制台
消息中心
产品价格详情
系统权限
客户关联华为云合作伙伴须知
公共问题
宽限期保留期
奖励推广计划
活动
云服务信任体系能力说明
开发与运维
软件开发生产线 CodeArts
需求管理 CodeArts Req
流水线 CodeArts Pipeline
代码检查 CodeArts Check
编译构建 CodeArts Build
部署 CodeArts Deploy
测试计划 CodeArts TestPlan
制品仓库 CodeArts Artifact
移动应用测试 MobileAPPTest
CodeArts IDE Online
开源镜像站 Mirrors
性能测试 CodeArts PerfTest
应用管理与运维平台 ServiceStage
云应用引擎 CAE
开源治理服务 CodeArts Governance
华为云Astro轻应用
CodeArts IDE
Astro工作流 AstroFlow
代码托管 CodeArts Repo
漏洞管理服务 CodeArts Inspector
联接 CodeArtsLink
软件建模 CodeArts Modeling
Astro企业应用 AstroPro
CodeArts盘古助手
华为云Astro大屏应用
存储
对象存储服务 OBS
云硬盘 EVS
云备份 CBR
高性能弹性文件服务 SFS Turbo
弹性文件服务 SFS
存储容灾服务 SDRS
云硬盘备份 VBS
云服务器备份 CSBS
数据快递服务 DES
云存储网关 CSG
专属分布式存储服务 DSS
数据工坊 DWR
地图数据 MapDS
键值存储服务 KVS
容器
云容器引擎 CCE
云容器实例 CCI
容器镜像服务 SWR
云原生服务中心 OSC
应用服务网格 ASM
华为云UCS
数据库
云数据库 RDS
数据复制服务 DRS
文档数据库服务 DDS
分布式数据库中间件 DDM
云数据库 GaussDB
云数据库 GeminiDB
数据管理服务 DAS
数据库和应用迁移 UGO
云数据库 TaurusDB
人工智能
AI开发平台ModelArts
华为HiLens
图引擎服务 GES
图像识别 Image
文字识别 OCR
自然语言处理 NLP
内容审核 Moderation
图像搜索 ImageSearch
医疗智能体 EIHealth
企业级AI应用开发专业套件 ModelArts Pro
人脸识别服务 FRS
对话机器人服务 CBS
语音交互服务 SIS
人证核身服务 IVS
视频智能分析服务 VIAS
城市智能体
自动驾驶云服务 Octopus
盘古大模型 PanguLargeModels
IoT物联网
设备接入 IoTDA
全球SIM联接 GSL
IoT数据分析 IoTA
路网数字化服务 DRIS
IoT边缘 IoTEdge
设备发放 IoTDP
企业应用
域名注册服务 Domains
云解析服务 DNS
企业门户 EWP
ICP备案
商标注册
华为云WeLink
华为云会议 Meeting
隐私保护通话 PrivateNumber
语音通话 VoiceCall
消息&短信 MSGSMS
云管理网络
SD-WAN 云服务
边缘数据中心管理 EDCM
云桌面 Workspace
应用与数据集成平台 ROMA Connect
ROMA资产中心 ROMA Exchange
API全生命周期管理 ROMA API
政企自服务管理 ESM
视频
实时音视频 SparkRTC
视频直播 Live
视频点播 VOD
媒体处理 MPC
视频接入服务 VIS
数字内容生产线 MetaStudio
迁移
主机迁移服务 SMS
对象存储迁移服务 OMS
云数据迁移 CDM
迁移中心 MGC
专属云
专属计算集群 DCC
开发者工具
SDK开发指南
API签名指南
DevStar
华为云命令行工具服务 KooCLI
Huawei Cloud Toolkit
CodeArts API
云化转型
云架构中心
云采用框架
用户服务
账号中心
费用中心
成本中心
资源中心
企业管理
工单管理
客户运营能力
国际站常见问题
支持计划
专业服务
合作伙伴支持计划
我的凭证
华为云公共事业服务云平台
工业软件
工业数字模型驱动引擎
硬件开发工具链平台云服务
工业数据转换引擎云服务

日期和时间函数

更新时间:2025-01-24 GMT+08:00
分享

本文介绍日期、时间函数的语法规则,包括参数解释、函数示例等。管道符特性处理的日期和时间为timestamp类型,返回值格式表现为yyyy-MM-dd HH:mm:ss.SSS TimeZone。

函数列表

表1 日期和时间函数

函数

描述

current_timestamp函数

返回当前日期和时间,格式为yyyy-MM-dd HH:mm:ss.SSS

from_iso8601_date函数

将ISO8601格式的日期表达式expr转换为date类型的日期表达式,格式为yyyy-MM-dd

from_iso8601_timestamp函数

将ISO8601格式的日期表达式expr转换为timestamp类型的日期表达式,格式为yyyy-MM-dd HH:mm:ss.SSS

mills_to_timestamp函数

将UNIX时间戳转换为日期和时间表达式。

from_unixtime函数

将UNIX时间戳转换为日期和时间表达式。与mills_to_timestamp函数用法一致。

to_iso8601函数

将日期类型或时间戳类型的日期时间表达式转换为ISO8601格式的日期时间表达式。

timestamp_to_mills函数

将时间戳类型的日期和时间表达式转换为UNIX时间戳。

to_unixtime函数

将时间戳类型的日期和时间表达式转换为UNIX时间戳。与timestamp_to_mills函数用法一致。

time_ceil函数

将时间戳舍入,将其作为新的时间戳返回。Period可以是任何ISO8601的周期,如P3M(季度)或PT12H(半天)。指定Origin作为时间戳,以设置舍入的参考时间。例如,TIME_CEIL(time, 'PT1H', '2016-06-27 00:30:00')测量的小时周期从00:30-01:30而不是00:00-01:00。时区(如果提供)应该是时区名称,如“America/Los_Angeles”或偏移量,如“-08:00”。

time_floor函数

向下舍入时间戳,将其作为新的时间戳返回。Period可以是任何ISO8601的周期,如P3M(季度)或PT12H(半天)。指定Origin作为时间戳,以设置舍入的参考时间。例如,TIME_FLOOR(time, 'PT1H', '2016-06-27 00:30:00')测量的小时周期从00:30-01:30而不是00:00-01:00。时区(如果提供)应该是时区名称,如“America/Los_Angeles”或偏移量,如“-08:00”。

ceil函数

使用时间单位对时间戳进行四舍五入,单位可以是SECOND、MINUTE、 HOUR、 DAY、 WEEK、 MONTH、 QUARTER或 YEAR。

floor函数

使用时间单位对时间戳进行向下舍入,单位可以是SECOND、MINUTE、 HOUR、 DAY、 WEEK、 MONTH、 QUARTER或 YEAR。

time_shift函数

将时间戳expr移动一个Period(步长时间)。Period可以是任何ISO8601的Period。

timezone_hour函数

计算系统时区和utc时区的小时偏移量。如果提供了时区,则计算系统时区与给定时区的偏移量。

timezone_minute函数

计算系统时区和utc时区的分钟偏移量。如果提供了时区,则计算系统时区与给定时区的偏移量。

time_format函数

将时间戳类型的日期和时间表达式转换为指定格式的日期和时间表达式。

date_format函数

将时间戳类型的日期和时间表达式转换为指定格式的日期和时间表达式。

time_parse函数

将日期和时间字符串转换为指定格式的时间戳类型的日期和时间表达式。

date_parse函数

将日期和时间字符串转换为指定格式的时间戳类型的日期和时间表达式。

time_extract函数

通过指定字段提取日期时间表达式的日期或时间部分。EPOCH, SECOND, MINUTE, HOUR, DAY(月的日), DOW(周的日), DOY(年的日), WEEK(年周), MONTH(1到12), QUARTER(1到4),或YEAR,时区(如果提供)应为时区名称,如"America/Los_Angeles"或偏移量,如"-08:00"

date_trunc函数

根据您指定的时间单位截断日期和时间表达式,并以毫秒、秒、分钟、小时、天、月或年为单位对齐。

date_diff函数

返回时间戳expr1和时间戳expr2之间的单位数(有符号)。

current_date函数

返回当前日期,格式是“yyyy-MM-dd”。

now函数

返回当前日期和时间,格式是“yyyy-MM-dd HH:mm:ss.SSS”。功能与current_timestamp一致

date_add函数

给时间加上给定的时间间隔

current_time函数

返回当前时间,格式为HH:mm:ss.SSSSSS。

current_timezone函数

返回当前时区。

localtime函数

返回本地时间。

localtimestamp函数

返回本地的日期和时间。

year_of_week函数

返回目标日期在ISO周日历中的年份。year_of_week函数等同于yow函数。

yow函数

返回目标日期在ISO周日历中的年份。year_of_week函数等同于yow函数。

time_series函数

用于补全您查询时间窗口内缺失的数据。

current_timestamp函数

返回当前日期和时间,格式为yyyy-MM-dd HH:mm:ss.SSS。

语法:current_timestamp()

返回值类型:timestamp类型

示例:SELECT CURRENT_TIMESTAMP()

表2 查询分析结果

类型

场景

查询语句

CURRENT_TIMESTAMP()

返回结果

2023-04-17 10:48:41.286

from_iso8601_date函数

将ISO8601格式的日期表达式转化为date类型的日期表达式,格式为YYYY-MM-DD。

语法:from_iso8601_date(expr)

表3 参数说明

参数名称

描述

类型

是否必选

expr

ISO8601格式的日期表达式

String

返回值类型:String类型

示例:SELECT FROM_ISO8601_DATE('2018-05-14')

表4 查询分析结果

类型

场景

查询语句

FROM_ISO8601_DATE('2018-05-14')

返回结果

2018-05-14

from_iso8601_timestamp函数

将ISO8601格式的日期和时间表达式转化为timestamp类型的日期和时间表达式,格式为YYYY-MM-DD HH:MM:SS.Ms Time_zone

语法:from_iso8601_timestamp(expr)

表5 参数说明

参数名称

描述

类型

是否必选

expr

ISO8601格式的日期和时间表达式

String

返回值类型:timestamp类型。

示例:SELECT FROM_ISO8601_TIMESTAMP('2018-05-14T11:51:50.153+08:00')

表6 查询分析结果

类型

场景

查询语句

FROM_ISO8601_TIMESTAMP('2018-05-14T11:51:50.153+08:00')

返回结果

2018-05-14 11:51:50.153 +08:00

mills_to_timestamp函数

将毫秒级的时间戳转换为timestamp类型的时间和日期表达式。

  • 将毫秒级的时间戳转化为timestamp类型的日期和时间表达式,格式为yyyy-MM-dd HH:mm:ss.SSS。

    语法:mills_to_timestamp(expr)

    表7 参数说明

    参数名称

    描述

    类型

    是否必选

    expr

    UNIX时间戳

    Long

    返回值类型:timestamp类型

    示例:SELECT MILLS_TO_TIMESTAMP(1626774758000)

    表8 查询分析结果

    类型

    场景

    查询语句

    MILLS_TO_TIMESTAMP(1626774758000)

    返回结果

    2021-07-20 17:52:38.000 Asia/Shanghai

from_unixtime函数

将秒级或毫秒级时间戳转换为日期和时间表达式。当expr取值小于时视为秒。

  • 将秒级或毫秒级时间戳转化为时间戳类型的日期和时间表达式。

    语法:from_unixtime(expr)

    表9 参数说明

    参数名称

    描述

    类型

    是否必选

    expr

    秒级或毫秒级时间戳

    Long

    返回值类型:timestamp

    示例:SELECT FROM_UNIXTIME(1626774758000)

    表10 查询分析结果

    类型

    场景

    查询语句

    FROM_UNIXTIME(1626774758000)

    返回结果

    2021-07-20 09:52:38.000 UTC

    示例:SELECT FROM_UNIXTIME(1731916857)

    表11 查询分析结果

    类型

    场景

    查询语句

    FROM_UNIXTIME(1731916857)

    返回结果

    2024-11-18 08:00:57.000 UTC

  • 将秒级或毫秒级时间戳转化为带特定时区的timestamp类型的日期和时间表达式。

    语法:from_unixtime(expr, timezone)

    表12 参数说明

    参数名称

    描述

    类型

    是否必选

    expr

    UNIX时间戳

    Long

    timezone

    时区

    String

    返回值类型:String类型

    示例:SELECT FROM_UNIXTIME(1626774758000, 'Asia/Shanghai')

    表13 查询分析结果

    类型

    场景

    查询语句

    FROM_UNIXTIME(1626774758000, 'Asia/Shanghai')

    返回结果

    2021-07-20 17:52:38.000 Asia/Shanghai

  • 将秒级或毫秒级时间戳转换为具有特定时区的日期和时间表达式。表达式中,hour和minute表示时区偏移量。

    语法:from_unixtime(expr, hour, minutes)

    表14 参数说明

    参数名称

    描述

    类型

    是否必选

    expr

    UNIX时间戳

    Long

    hour

    小时

    Integer

    minute

    分钟

    Integer

    返回值类型:String

    示例:SELECT FROM_UNIXTIME(1626774758000, -2, 0)

    表15 查询分析结果

    类型

    场景

    查询语句

    FROM_UNIXTIME(1626774758000, -2, 0)

    返回结果

    2021-07-20 07:52:38.000 -02:00

to_iso8601函数

将日期类型或时间戳类型的日期时间表达式转换为ISO8601格式的日期时间表达式。

语法:to_iso8601(expr)

表16 参数说明

参数名称

描述

类型

是否必选

expr

timestamp类型的日期和时间表达式

timestamp类型

返回值类型:String类型

示例:SELECT TO_ISO8601(from_unixtime(1626774758000))

表17 查询分析结果

类型

场景

查询语句

TO_ISO8601(FROM_UNIXTIME(1626774758000))

返回结果

2021-07-20T09:52:38.000Z

timestamp_to_mills函数

将timestamp类型的日期和时间表达式转换为毫秒级的时间戳。

语法:timestamp_to_mills(expr)

表18 参数说明

参数名称

描述

类型

是否必选

expr

timestamp类型的日期和时间表达式

timestamp类型

返回值类型:Long类型

示例:select timestamp_to_mills(from_unixtime(1626774758000))

表19 查询分析结果

类型

场景

查询语句

timestamp_to_mills(from_unixtime(1626774758000))

返回结果

1681287322285

to_unixtime函数

将timestamp类型的日期和时间表达式转换毫秒级的时间戳。

语法:to_unixtime(expr)

表20 参数说明

参数名称

描述

类型

是否必选

expr

timestamp类型的日期和时间表达式

timestamp

返回值类型:Long类型

示例:SELECT to_unixtime(from_unixtime(1626774758000))

表21 查询分析结果

类型

场景

查询语句

to_unixtime(from_unixtime(1626774758000))

返回结果

1626774758

time_ceil函数

将timestamp类型的时间戳按固定周期以四舍五入的方式取整,将其作为新的时间戳返回。Period可以是任何ISO8601的周期,如P3M(季度)或PT12H(半天)。

time_ceil(expr, period)

表22 参数说明

参数名称

描述

类型

是否必选

expr

日期和时间表达式,格式为yyyy-MM-dd HH:mm:ss.SSS TimeZone

timestamp

period

ISO8601的周期

String

返回值类型:timestamp类型

示例1:SELECT TIME_CEIL(from_unixtime(1731930422292), 'PT2H')

表23 查询分析结果

类型

场景

查询语句

TIME_CEIL('2023-04-23 06:46:40.000', 'PT2H')

返回结果

2024-11-18 20:00:00.000 Asia/Shanghai

Period描述:period的格式应为P[n]Y[n]M[n]DT[n]H[n]M[n]S或P[n]W。在这些表示中,【n】是日期和时间元素的数量。不需要前导零,但每个元素的最大位数应由通信各方商定。大写字母P、Y、M、W、D、T、H、M和S是每个日期和时间元素的指示符,不被替换。

  • P是放置在持续时间表示的开始处的持续时间指示符(对于期间)。
  • Y是日历年数值之后的年指示符。
  • M是日历月数值之后的月份指示符。
  • W是周数值之后的周指示符。
  • D是日历天数值之后的日期指示符。
  • T是表示的时间分量之前的时间指示符。
  • H是小时数值之后的小时指示符。
  • M是分钟指示符,紧随分钟数的值。
  • S是秒数值之后的第二个指示符。

例如,“P3Y6M4DT12H30M5S”表示“三年六个月四天十二小时三十分五秒”的持续时间。

更多信息,请访问https://en.wikipedia.org/wiki/ISO_8601

time_floor函数

将timestamp类型的时间戳按时间戳返回。Period可以是任何ISO8601的周期,如P3M(季度)或PT12H(半天)。

语法:time_floor(expr, period)

表24 参数说明

参数名称

描述

类型

是否必选

expr

timestamp类型的日期和时间表达式,格式为yyyy-MM-dd HH:mm:ss.SSS TimeZone

timestamp

period

ISO8601的周期

String

返回值类型:timestamp类型

示例1:SELECT TIME_FLOOR(from_unixtime(1626774758000), 'PT2H')

表25 查询分析结果

类型

场景

查询语句

TIME_FLOOR(from_unixtime(1626774758000), 'PT2H')

返回结果

2021-07-20 16:00:00.000 Asia/Shanghai

ceil函数

使用时间单位对时间戳进行四舍五入,单位可以是SECOND、MINUTE、 HOUR、 DAY、 WEEK、 MONTH、 QUARTER或 YEAR。

语法:ceil(expr, unit)

表26 参数说明

参数名称

描述

类型

是否必选

expr

日期和时间表达式,格式为yyyy-MM-dd HH:mm:ss.SSS

timestamp

unit

时间单位

String

返回值类型:String类型

示例:SELECT CEIL('2023-04-20 11:28:31.770', 'DAY')

表27 查询分析结果

类型

场景

查询语句

CEIL ('2023-04-20 11:28:31.770', 'DAY')

返回结果

2023-04-21 00:00:00.000

floor函数

使用时间单位对时间戳进行向下舍入,单位可以是SECOND、MINUTE、 HOUR、 DAY、 WEEK、 MONTH、 QUARTER或 YEAR。

语法:floor(expr, unit)

表28 参数说明

参数名称

描述

类型

是否必选

expr

日期和时间表达式,格式为yyyy-MM-dd HH:mm:ss.SSS

timestamp

unit

时间单位

String

返回值类型:Strin类型

示例:SELECT FLOOR('2023-04-20 11:28:31.770', 'DAY')

表29 查询分析结果

类型

场景

查询语句

FLOOR('2023-04-20 11:28:31.770', 'DAY')

返回结果

2023-04-20 00:00:00.000

time_shift函数

将时间戳expr移动一个Period(步长时间)。Period可以是任何ISO8601的Period。

语法:time_shift(expr, period, step, [timezone])

表30 参数说明

参数名称

描述

类型

是否必选

expr

timestamp类型的日期和时间表达式,格式为yyyy-MM-dd HH:mm:ss.SSS TimeZone

timestamp

period

ISO8601的周期

String

step

步长

Integer

timezone

时区

String

返回值类型:String类型

示例:SELECT TIME_SHIFT( from_unixtime(__time), 'P1D', 5), TIME_SHIFT( from_unixtime(__time), 'P1D', 5,'+08:00')

表31 查询分析结果

类型

场景1

场景2

查询语句

TIME_SHIFT( from_unixtime(__time), 'P1D', 5)

TIME_SHIFT( from_unixtime(__time), 'P1D', 5,'+08:00')

返回结果

2024-11-23 21:58:59.907 Asia/Shanghai

2024-11-23 21:58:59.907 +08:00

timezone_hour函数

计算时区的小时偏移量。

语法:timezone_hour(expr)

表32 参数说明

参数名称

描述

类型

是否必选

expr

日期和时间表达式,格式为yyyy-MM-dd HH:mm:ss.SSS TIMEZONE

timestamp

返回值类型:Integer类型

示例:SELECT TIMEZONE_HOUR('2023-04-22 15:31:30.000 Europe/Rome')

表33 查询分析结果

类型

场景

查询语句

TIMEZONE_HOUR(from_unixtime(__time,'Europe/Rome'))

返回结果

1

timezone_minute函数

计算时区的分钟偏移量。

语法:timezone_minute(expr)

表34 参数说明

参数名称

描述

类型

是否必选

expr

日期和时间表达式,格式为yyyy-MM-dd HH:mm:ss.SSS TIMEZONE

timestamp

返回值类型:Integer类型

示例:SELECT TIMEZONE_MINUTE(from_unixtime(__time))

表35 查询分析结果

类型

场景

查询语句

TIMEZONE_MINUTE(from_unixtime(__time))

返回结果

0

time_format函数

将毫秒级的时间戳或timestamp类型的日期和时间表达式expr,依据用户自定义的format参数以 Joda DateTimeFormat模式转换为指定日期和时间格式的字符串。

语法:time_format(expr, format)

表36 参数说明

参数名称

描述

类型

是否必选

expr

timestamp类型类型的日期和时间表达式或毫秒级的时间戳

timestamp或Long

format

时间格式。

String

返回值类型:String类型

示例:SELECT TIME_FORMAT(__time, 'yyyy-MM-dd HH:mm:ss'), TIME_FORMAT(from_unixtime(__time), 'yyyy-MM-dd HH:mm:ss')

表37 查询分析结果

类型

场景1

场景2

查询语句

TIME_FORMAT(__time, 'yyyy-MM-dd HH:mm:ss')

TIME_FORMAT(from_unixtime(__time), 'yyyy-MM-dd HH:mm:ss')

返回结果

2024-11-18 22:15:16

2024-11-18 22:15:16

time_parse函数

time_parse将给定的字符串expr,依据用户自定义的format参数以 Joda DateTimeFormat模式解析为timestamp类型类型的日期和时间表达式,格式为yyyy-MM-dd HH:mm:ss.SSS TimeZone。若<format>未填写则以默认的ISO8601将字符串解析。

语法:time_parse(expr, format)

表38 参数说明

参数名称

描述

类型

是否必选

expr

某种时间格式的字符串。

String

format

时间格式。

String

返回值类型:timestamp类型的时间和日志表达式

示例:SELECT TIME_PARSE('2024-11-18 22:15:11', 'yyyy-MM-dd HH:mm:ss')
表39 查询和分析结果

__time

场景

查询语句

TIME_PARSE('2024-11-18 22:15:11', 'yyyy-MM-dd HH:mm:ss')

返回结果

2024-11-18 22:15:11.000 Asia/Shanghai

format描述:

Symbol Meaning Presentation Examples

------ ------- ------------ -------

G era text AD

C century of era (>=0) number 20

Y year of era (>=0) year 1996

x weekyear year 1996

w week of weekyear number 27

e day of week number 2

E day of week text Tuesday; Tue

y year year 1996

D day of year number 189

M month of year month July; Jul; 07

d day of month number 10

a halfday of day text PM

K hour of halfday (0~11) number 0

h clockhour of halfday (1~12) number 12

H hour of day (0~23) number 0

k clockhour of day (1~24) number 24

m minute of hour number 30

s second of minute number 55

S fraction of second millis 978

z time zone text Pacific Standard Time; PST

Z time zone offset/id zone -0800; -08:00; America/Los_Angeles

' escape for text delimiter

'' single quote literal '

date_format函数

timestamp类型类型的日期和时间表达式转换为指定日期和时间格式的字符串。

语法:date_format(expr, format)

表40 参数说明

参数名称

描述

类型

是否必选

expr

timestamp类型类型的日期和时间表达式,格式为yyyy-MM-dd HH:mm:ss.SSS TimeZone

timestamp

format

时间格式

String

返回值类型:String类型

示例:SELECT DATE_FORMAT(current_timestamp(),'%H%i')

表41 查询分析结果

类型

场景

查询语句

DATE_FORMAT(current_timestamp(),'%H%i')

返回结果

1432

format描述:

%a Abbreviation for the week. For example, Sun and Sat.

%b Abbreviation of the month. For example, Jan and Dec.

%c Month. Numeral type. Range: 1-12.

%D Day of the month. The value must be suffixed, for example, 0th, 1st, 2nd, and 3rd.

%d Day of the month. The value ranges from 01 to 31 in decimal notation.

%e Day of the month. The value ranges from 1 to 31 in decimal notation.

%H Hour, 24-hour system.

%h Hour, 12-hour system.

%i Minute. Numeral type. Range: 00–59.

%j Day of the year. The value ranges from 001 to 366.

%k Hour. The value ranges from 0 to 23.

%l Hour. The value ranges from 1 to 12.

%M The English expression of the month, for example, January, December.

%m Month. Numeral format. The value ranges from 01 to 12.

%p AM and PM.

%r Time in the 12-hour format. The format is hh:mm:ss AM/PM.

%S Indicates the second. The value ranges from 00 to 59.

%s Indicates the second. The value ranges from 00 to 59.

%T Time, in the 24-hour format of hh:mm:ss.

%v The first week of the year, Monday is the first day of the week. The value ranges from 01 to 53.

%W The name of the day of the week. For example, Sunday and Saturday.

%w Day of the week. Sunday is day 0.

%Y A 4-digit year, for example, 2020.

%y A 2-digit year, for example, 20.

%% Escape character for%.

date_parse函数

将日期和时间字符串转换为指定格式的时间戳类型的日期和时间表达式。

语法:date_parse(expr, pattern)

表42 参数说明

参数名称

描述

类型

是否必选

expr

日期和时间表达式。

String

pattern

日期和时间表达式的转换格式

String

返回值类型:timestamp类型类型的日期和时间表达式。

示例:SELECT DATE_PARSE('2024-11-18 10:53','%Y-%m-%d %h:%i')

表43 查询分析结果

类型

场景

查询语句

DATE_PARSE('2024-11-18 10:53','%Y-%m-%d %h:%i')

返回结果

2024-11-18 10:53:00.000

pattern在设置时,如果设置了分钟,那么就必须同时配置分钟之前的年、月、日和时。

time_extract函数

通过指定字段提取日期时间表达式的日期或时间部分。EPOCH, SECOND, MINUTE, HOUR, DAY(月的日), DOW(周的日), DOY(年的日), WEEK(年周), MONTH(1到12), QUARTER(1到4),或YEAR,时区(如果提供)应为时区名称,如"America/Los_Angeles"或偏移量,如"-08:00"

语法:time_extract(expr, unit)

表44 参数说明

参数名称

描述

类型

是否必选

expr

日期和时间表达式,格式为yyyy-MM-dd HH:mm:ss.SSS

String

unit

时间单位

String

返回值类型:Long类型

示例:SELECT TIME_EXTRACT('2023-05-05','YEAR')

表45 查询分析结果

类型

场景

查询语句

TIME_EXTRACT('2023-05-05','YEAR')

返回结果

2023

date_trunc函数

根据您指定的时间单位截断日期和时间表达式,并以毫秒、秒、分钟、小时、天、月或年为单位对齐。

语法:date_trunc(unit, expr)

表46 参数说明

参数名称

描述

类型

是否必选

expr

timestamp类型的日期和时间表达式,格式为yyyy-MM-dd HH:mm:ss.SSS TimeZone

timestamp

unit

时间单位

String

返回值类型:Long类型

示例:SELECT DATE_TRUNC('year', from_unixtime(__time))

表47 查询分析结果

类型

场景

查询语句

DATE_TRUNC('year', from_unixtime(__time))

返回结果

2024-01-01 00:00:00.000 Asia/Shanghai

date_diff函数

返回时间戳expr1和时间戳expr2之间的单位数(有符号)。

语法:date_diff(unit, expr1, expr2)

表48 参数说明

参数名称

描述

类型

是否必选

expr1

timestamp类型的日期和时间表达式,格式为yyyy-MM-dd HH:mm:ss.SSS TimeZone

timestamp

expr2

timestamp类型的日期和时间表达式,格式为yyyy-MM-dd HH:mm:ss.SSS TimeZone

timestamp

  

unit

时间单位

String

返回值类型:Long类型

示例:SELECT DATE_DIFF('SECOND', CURRENT_TIMESTAMP() ,from_unixtime(__time))

表49 查询分析结果

类型

场景

查询语句

DATE_DIFF('SECOND', CURRENT_TIMESTAMP() ,from_unixtime(__time))

返回结果

-899.00

current_date函数

返回当前日期,格式是“yyyy-MM-dd”。

语法:current_date()

返回值类型:String类型

示例:SELECT CURRENT_DATE()

表50 查询分析结果

类型

场景

查询语句

CURRENT_DATE()

返回结果

2023-04-17

now函数

返回当前日期和时间。功能与current_timestamp一致

语法:now()

返回值类型:timestamp类型的日期和时间表达式,格式为yyyy-MM-dd HH:mm:ss.SSS TimeZone

示例:SELECT NOW()

表51 查询分析结果

类型

场景

查询语句

NOW()

返回结果

2024-11-18 23:29:18.434 Asia/Shanghai

date_add函数

给时间加上给定的时间间隔。

语法:date_add(unit, n, expr)

表52 参数说明

参数名称

描述

类型

是否必选

unit

时间单位,取值为millisecond、second、minute、hour、day、week、month、quarter、year

String

n

时间间隔

Long

expr

timestamp类型的日期和时间表达式,格式为yyyy-MM-dd HH:mm:ss.SSS TimeZone

timestamp

返回值类型:timestamp

示例:SELECT DATE_ADD('MINUTE', 7, from_unixtime(__time))

表53 查询分析结果

类型

场景

查询语句

DATE_ADD('MINUTE', 7, from_unixtime(__time))

返回结果

2024-11-18 23:23:47.407 Asia/Shanghai

current_time函数

返回当前时间,格式为HH:mm:ss.SSSSSS。

语法:current_time()

返回值类型:String类型

示例:SELECT CURRENT_TIME()

表54 查询分析结果

类型

场景

查询语句

CURRENT_TIME ()

返回结果

23:38:18.491+08:00

current_timezone函数

返回当前时区。

语法:current_timezone()

返回值类型:String类型

示例:SELECT CURRENT_TIMEZONE()

表55 查询分析结果

类型

场景

查询语句

CURRENT_TIMEZONE ()

返回结果

Asia/Shanghai

localtime函数

返回本地时间。

语法:localtime()

返回值类型:String类型

示例:SELECT LOCALTIME()

表56 查询分析结果

类型

场景

查询语句

LOCALTIME()

返回结果

23:38:51.346

localtimestamp函数

返回本地的日期和时间。

语法:localtimestamp

返回值类型:String类型

示例:SELECT LOCALTIMESTAMP

表57 查询分析结果

类型

场景

查询语句

LOCALTIMESTAMP

返回结果

2024-11-18 23:39:17.070

year_of_week函数

返回目标日期在ISO周日历中的年份。year_of_week函数等同于yow函数。

语法:year_of_week(expr)

参数说明:

参数名称

描述

类型

是否必选

expr

时间表达式,格式为yyyy-MM-dd HH:mm:ss.SSS或yyyy-MM-dd

String

返回值类型:Integer类型

示例:SELECT YEAR_OF_WEEK('2023-09-22 14:47:59.325'), YEAR_OF_WEEK('2023-09-22')

表58 查询分析结果

类型

场景1

场景2

查询语句

YEAR_OF_WEEK('2023-09-22 14:47:59.325')

YEAR_OF_WEEK('2023-09-22')

返回结果

2023

2023

参数说明:

参数名称

描述

类型

是否必选

expr

timestamp类型的日期和时间表达式,格式为yyyy-MM-dd HH:mm:ss.SSS TimeZone

timestamp

返回值类型:Integer

示例:SELECT YEAR_OF_WEEK(from_unixtime(__time))

表59 查询分析结果

类型

场景

查询语句

YEAR_OF_WEEK(from_unixtime(__time))

返回结果

2024

yow函数

返回目标日期在ISO周日历中的年份。year_of_week函数等同于yow函数。

语法:yow(expr)

表60 参数说明

参数名称

描述

类型

是否必选

expr

时间表达式,格式为yyyy-MM-dd HH:mm:ss.SSS或yyyy-MM-dd

String

返回值类型:Integer类型

示例:SELECT YOW('2023-09-22 14:47:59.325'), YOW('2023-09-22')

表61 查询分析结果

类型

场景1

场景2

查询语句

YOW('2023-09-22 14:47:59.325')

YOW('2023-09-22')

返回结果

2023

2023

表62 参数说明

参数名称

描述

类型

是否必选

expr

时间表达式,格式为yyyy-MM-dd HH:mm:ss.SSS或yyyy-MM-dd

String

返回值类型:Integer类型

示例:SELECT YOW(from_unixtime(__time))

表63 查询分析结果

类型

场景

查询语句

YOW(from_unixtime(__time))

返回结果

2024

time_series函数

用于补全您查询时间窗口内缺失的数据。time_series函数必须搭配GROUP BY语法和ORDER BY语法使用。

语法:time_series(x, window_time, format, padding_data)

表64 参数说明

参数名称

描述

类型

是否必选

x

原始字段。

long或timestamap

window_time

窗口大小,单位为s(秒)、m(分)、h(小时)、d(天)。例如2h、5m、3d。

String

format

返回结果的时间格式。

String

padding_data

补全的内容。包括:0:将缺失的值设置为0。null:将缺失的值设置为null。last:将缺失的值设置了上一个时间点对应的值。next:将缺失的值设置了下一个时间点对应的值。avg:将缺失的值设置为前后两个时间点的平均值。

String

返回值类型:String

示例:select time_series(__time, '1d', 'HH:mm:ss','0') as time, count(*) as count group by time order by time asc

表65 查询分析结果

类型

场景

查询语句

time_series(__time, '1d', 'HH:mm:ss','0') as time, count(*) as count group by time order by time asc

返回结果

提示

您即将访问非华为云网站,请注意账号财产安全

文档反馈

文档反馈

意见反馈

0/500

标记内容

同时提交标记内容