TDengine 日期时间函数 DAYOFWEEK 使用手册
DAYOFWEEK 函数使用手册
函数描述
DAYOFWEEK 函数用于返回指定日期是一周中的第几天。该函数遵循标准的星期编号约定，返回值范围为 1-7，其中：
- 1 = 星期日 (Sunday)
- 2 = 星期一 (Monday)
- 3 = 星期二 (Tuesday)
- 4 = 星期三 (Wednesday)
- 5 = 星期四 (Thursday)
- 6 = 星期五 (Friday)
- 7 = 星期六 (Saturday)
语法
DAYOFWEEK(date_expression)
参数说明
- date_expression: 日期表达式，支持以下类型：
- TIMESTAMP 类型的时间戳
- BIGINT 类型的 Unix 时间戳（秒或毫秒）
- VARCHAR/NCHAR 类型的日期字符串
- NULL 值
返回值
- 返回类型：
BIGINT - 返回值范围：1-7（对应星期日到星期六）
- 如果输入为 NULL，则返回 NULL
使用示例
1. 使用 TIMESTAMP 类型
-- 查询当前时间是星期几
SELECT DAYOFWEEK(NOW()) AS day_of_week;-- 查询指定时间戳是星期几
SELECT DAYOFWEEK('2024-01-15 10:30:00') AS day_of_week;
-- 结果: 2 (星期一)
2. 使用 Unix 时间戳
-- 使用秒级时间戳 (2024-01-15 对应的时间戳)
SELECT DAYOFWEEK(1705315800) AS day_of_week;
-- 结果: 4 (星期三)-- 使用毫秒级时间戳
SELECT DAYOFWEEK(1705315800000) AS day_of_week;
-- 结果: 4 (星期三)
3. 使用日期字符串
-- 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. 在表查询中使用
-- 假设有一个订单表 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. 统计分析示例
-- 统计每个工作日的订单数量
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 值
-- 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 函数时需要特别注意时区问题，因为不同的时区可能会影响日期的计算结果：
- 数据库时区设置: 函数的结果可能受到数据库服务器时区设置的影响
- 客户端时区: 客户端和服务器时区不一致时可能导致结果偏差
- UTC 转换: Unix 时间戳通常基于 UTC，在转换为本地时间时需要考虑时区偏移
时区相关示例
-- 显示当前时区设置
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;
建议
- 统一时区: 在应用中保持数据库和客户端时区的一致性
- 明确时区: 在处理跨时区数据时，明确指定时区或统一使用 UTC
- 测试验证: 在不同时区环境下测试函数返回结果的正确性
相关函数
WEEKDAY(): 返回星期几（0-6，Monday=0）WEEK(): 返回一年中的第几周WEEKOFYEAR(): 返回一年中的第几周（ISO 标准）NOW(): 获取当前时间戳TIMEZONE(): 获取当前时区设置
常见用途
- 业务分析: 分析不同工作日的业务数据分布
- 排班管理: 根据星期几安排工作计划
- 数据过滤: 筛选工作日或周末的数据
- 报表统计: 按星期维度进行数据统计和分析
关于 TDengine
TDengine 专为物联网IoT平台、工业大数据平台设计。其中，TDengine TSDB 是一款高性能、分布式的时序数据库（Time Series Database），同时它还带有内建的缓存、流式计算、数据订阅等系统功能；TDengine IDMP 是一款AI原生工业数据管理平台，它通过树状层次结构建立数据目录，对数据进行标准化、情景化，并通过 AI 提供实时分析、可视化、事件管理与报警等功能。