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

相关推荐
Lotus_滴滴4 小时前
【金融保研复习】知识点与可能的题目
数据库
QYR_114 小时前
MR 一体机市场报告:2031全球规模突破 1.98亿美元,中国 40.8% 市占率成核心增长极
大数据·市场研究
白鲸开源5 小时前
一文掌握 Apache SeaTunnel 构建系统与分发基础架构
大数据·开源·源码阅读
学习2年半5 小时前
sql题目
数据库·sql
还是奇怪5 小时前
SQL 注入攻防:绕过注释符过滤的N种方法
数据库·sql·web安全
AgeClub5 小时前
一周快讯 | 银发文娱旅游一周新鲜事
大数据·人工智能·twitter
Run Freely9375 小时前
MySqL-day4_03(索引)
数据库·mysql
编程充电站pro5 小时前
聚合函数陷阱:AVG 和 GROUP BY 搭配使用注意点
数据库·sql
jie*5 小时前
小杰机器学习高级(two)——极大似然估计、交叉熵损失函数
大数据·人工智能·机器学习·tensorflow·逻辑回归·数据库架构·sklearn
会开花的二叉树6 小时前
实战:基于 BRPC+Etcd 打造轻量级 RPC 服务 —— 从注册到调用的完整实现
网络·数据库·c++·rpc·etcd