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 函数时需要特别注意时区问题，因为不同的时区可能会影响日期的计算结果：

1. 数据库时区设置: 函数的结果可能受到数据库服务器时区设置的影响
2. 客户端时区: 客户端和服务器时区不一致时可能导致结果偏差
3. 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;

建议

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 提供实时分析、可视化、事件管理与报警等功能。