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

相关推荐
DS小龙哥7 小时前
STM32F103C8T6的智能医疗药品存储柜系统设计与华为云实现
数据库·stm32·华为云
lypzcgf7 小时前
Coze源码分析-API授权-删除令牌-后端源码
数据库·人工智能·后端·系统架构·开源·go·安全架构
一伦明悦დ7 小时前
jetson开发板Ubuntu系统Docker中使用 MySQL 数据库详解-安装与配置指南
数据库·mysql·ubuntu
CServer_018 小时前
AI+PLM如何重构特种/高端复杂装备行业的工艺管理?
人工智能·物联网·重构·自动化·制造·工业物联网
猫猫的小茶馆8 小时前
【STM32】贪吃蛇 [阶段 8] 嵌入式游戏引擎通用框架设计
stm32·单片机·嵌入式硬件·mcu·物联网·游戏引擎·智能硬件
智海观潮8 小时前
Spark和Spring整合处理离线数据
大数据·spring·spark
学Java的bb8 小时前
后端Web实战-多表操作&员工列表查询
数据库
2301_781392529 小时前
Spring框架入门:从IoC到AOP
java·数据库·spring
yBmZlQzJ9 小时前
在PostgreSQL中使用分区技术
数据库·postgresql