TDengine 日期时间函数 DAYOFWEEK 使用手册

DAYOFWEEK 函数使用手册

函数描述

DAYOFWEEK 函数用于返回指定日期是一周中的第几天。该函数遵循标准的星期编号约定,返回值范围为 1-7,其中:

  • 1 = 星期日 (Sunday)
  • 2 = 星期一 (Monday)
  • 3 = 星期二 (Tuesday)
  • 4 = 星期三 (Wednesday)
  • 5 = 星期四 (Thursday)
  • 6 = 星期五 (Friday)
  • 7 = 星期六 (Saturday)

语法

sql 复制代码
DAYOFWEEK(date_expression)

参数说明

  • date_expression : 日期表达式,支持以下类型:
    • TIMESTAMP 类型的时间戳
    • BIGINT 类型的 Unix 时间戳(秒或毫秒)
    • VARCHAR/NCHAR 类型的日期字符串
    • NULL 值

返回值

  • 返回类型 :BIGINT
  • 返回值范围:1-7(对应星期日到星期六)
  • 如果输入为 NULL,则返回 NULL

使用示例

1. 使用 TIMESTAMP 类型

sql 复制代码
-- 查询当前时间是星期几
SELECT DAYOFWEEK(NOW()) AS day_of_week;

-- 查询指定时间戳是星期几
SELECT DAYOFWEEK('2024-01-15 10:30:00') AS day_of_week;
-- 结果: 2 (星期一)

2. 使用 Unix 时间戳

sql 复制代码
-- 使用秒级时间戳 (2024-01-15 对应的时间戳)
SELECT DAYOFWEEK(1705315800) AS day_of_week;
-- 结果: 4 (星期三)

-- 使用毫秒级时间戳  
SELECT DAYOFWEEK(1705315800000) AS day_of_week;
-- 结果: 4 (星期三)

3. 使用日期字符串

sql 复制代码
-- ISO 格式日期字符串
SELECT DAYOFWEEK('2024-01-15') AS day_of_week;
-- 结果: 2 (星期一)

-- 带时间的日期字符串
SELECT DAYOFWEEK('2024-12-25 12:00:00') AS day_of_week;
-- 结果: 4 (星期三,圣诞节)

4. 在表查询中使用

sql 复制代码
-- 假设有一个订单表 orders,包含 order_time 字段
SELECT 
    order_id,
    order_time,
    DAYOFWEEK(order_time) AS order_day,
    CASE DAYOFWEEK(order_time)
        WHEN 1 THEN '星期日'
        WHEN 2 THEN '星期一'
        WHEN 3 THEN '星期二'
        WHEN 4 THEN '星期三'
        WHEN 5 THEN '星期四'
        WHEN 6 THEN '星期五'
        WHEN 7 THEN '星期六'
    END AS day_name
FROM orders
WHERE order_time >= '2024-01-01';

5. 统计分析示例

sql 复制代码
-- 统计每个工作日的订单数量
SELECT 
    DAYOFWEEK(order_time) AS day_of_week,
    COUNT(*) AS order_count
FROM orders
WHERE order_time >= '2024-01-01'
GROUP BY DAYOFWEEK(order_time)
ORDER BY day_of_week;

-- 筛选周末的数据
SELECT *
FROM orders  
WHERE DAYOFWEEK(order_time) IN (1, 7)  -- 星期日和星期六
AND order_time >= '2024-01-01';

6. 处理 NULL 值

sql 复制代码
-- NULL 值处理
SELECT DAYOFWEEK(NULL) AS result;
-- 结果: NULL

-- 过滤 NULL 值
SELECT DAYOFWEEK(order_time) AS day_of_week
FROM orders where order_time is not null;

时区注意事项

重要说明

使用 DAYOFWEEK 函数时需要特别注意时区问题,因为不同的时区可能会影响日期的计算结果:

  1. 数据库时区设置: 函数的结果可能受到数据库服务器时区设置的影响
  2. 客户端时区: 客户端和服务器时区不一致时可能导致结果偏差
  3. UTC 转换: Unix 时间戳通常基于 UTC,在转换为本地时间时需要考虑时区偏移

时区相关示例

sql 复制代码
-- 显示当前时区设置
SELECT TIMEZONE();

-- 在不同时区下同一时间戳可能返回不同的星期几
-- 例如:UTC 时间 2024-01-01 00:30:00 (星期一)
-- 在 UTC+8 时区显示为 2024-01-01 08:30:00 (星期一)
-- 在 UTC-5 时区显示为 2023-12-31 19:30:00 (星期日)

SELECT 
    '2024-01-01 00:30:00' AS utc_time,
    DAYOFWEEK('2024-01-01 00:30:00') AS day_utc;

建议

  1. 统一时区: 在应用中保持数据库和客户端时区的一致性
  2. 明确时区: 在处理跨时区数据时,明确指定时区或统一使用 UTC
  3. 测试验证: 在不同时区环境下测试函数返回结果的正确性

相关函数

  • WEEKDAY(): 返回星期几(0-6,Monday=0)
  • WEEK(): 返回一年中的第几周
  • WEEKOFYEAR(): 返回一年中的第几周(ISO 标准)
  • NOW(): 获取当前时间戳
  • TIMEZONE(): 获取当前时区设置

常见用途

  1. 业务分析: 分析不同工作日的业务数据分布
  2. 排班管理: 根据星期几安排工作计划
  3. 数据过滤: 筛选工作日或周末的数据
  4. 报表统计: 按星期维度进行数据统计和分析

关于 TDengine

TDengine 专为物联网IoT平台、工业大数据平台设计。其中,TDengine TSDB 是一款高性能、分布式的时序数据库(Time Series Database),同时它还带有内建的缓存、流式计算、数据订阅等系统功能;TDengine IDMP 是一款AI原生工业数据管理平台,它通过树状层次结构建立数据目录,对数据进行标准化、情景化,并通过 AI 提供实时分析、可视化、事件管理与报警等功能。

相关推荐
数字新视界40 分钟前
机房动环监控系统在提升数据中心安全与效率中的创新应用
物联网·数据中心·数据中心基础设施管理·dcim管理系统·数据中心dcim
不脱发的程序猿3 小时前
ESP32制作加热杯垫
嵌入式硬件·物联网·esp32·语音识别
数字新视界3 小时前
数据中心DCIM管理系统助力提升机房管理效率与安全性
大数据·人工智能·物联网·信息与通信·动环监控系统
阿里云大数据AI技术4 小时前
孩子王基于阿里云Data Agent的智能体实践:300+Agent 覆盖400+业务场景
大数据·人工智能·agent
城北徐宫6 小时前
MySQL数据类型整理
数据库·mysql
数据库小学妹6 小时前
数据库容量规划:四个数与扩容触发线
运维·数据库·后端
武子康6 小时前
H3-World 扩展跳跃与开门:新动作怎样进入训练数据?
大数据·人工智能·算法
时间的拾荒人6 小时前
Redis Cluster 集群详解:分片算法、搭建、故障处理与扩容实战
数据库·redis·算法·集群
软件技术NINI7 小时前
DeepSeek 大模型落地应用实战指南
大数据·人工智能
纆兰9 小时前
MySQL的多表查询
数据库·mysql