原文链接：【KWDB 创作者计划】KWDB时间格式化函数超详细测试 - OSCHINA - 中文开源技术交流社区

作者：少湖说

前言

在时序数据的处理与分析领域，时间格式化不仅是数据展示的关键环节，更是深入洞察数据规律、提升数据价值的重要基础。从工业生产中设备运行状态的实时监控，到金融市场中交易数据的精细分析，准确且灵活的时间格式化处理，能够将原始的时间数据转化为更具可读性、更符合业务需求的信息，为决策提供有力支持。

KWDB 作为一款功能强大的时序数据库，其时间格式化函数为用户提供了丰富多样的处理方式。然而，不同的业务场景对时间格式有着各异的要求，如何熟练运用这些函数，精准实现所需的时间格式化效果，成为众多开发者和数据分析师关注的焦点。

本文将深入探索 KWDB 时间格式化函数，通过一系列详细且全面的测试，涵盖各种常见及特殊的应用场景，剖析每个函数的特性、适用范围和使用技巧。无论是简单的时间显示调整，还是复杂的时间序列分析中的格式转换，都能在本文找到实用的参考。希望通过这些测试与分析，能帮助读者深入理解并熟练掌握 KWDB 时间格式化函数，充分发挥其在数据处理中的优势，挖掘出时序数据背后更多的价值。

一、KWDB 特殊语法格式列表

为了兼容 SQL 标准，KWDB 支持以下函数，这些函数与常规的内置函数具有等效功能。

二、KWDB 特殊语法格式实操

这里我使用 KWDB 数据库与 MySQL 数据库的 SQL 语法做一个对比，让我们清晰的看到对应的区别。

2.1 示例一：KWDB/MySQL------AT TIME ZONE/timezone ()

在 KWDB 里，AT TIME ZONE 可把时间从一个时区转换到另一个时区。

-- 假设表中有个字段为 ts 的时间戳列ｓｅｌｅｃｔ ts AT TIME ZONE 'Asia/Shanghai' FROM your_table;

这行代码会把 your_table 表中 ts 字段的时间转换为亚洲 / 上海时区的时间。

MySQL 没有 timezone () 函数，同样使用 CONVERT_TZ 函数来处理时区转换。

-- 假设表中有个字段为 ts 的时间戳列ｓｅｌｅｃｔ CONVERT_TZ('2025-04-16 12:30:00', 'UTC', 'Asia/Shanghai');

该代码同样是将 ts 字段的时间从 UTC 时区转换为亚洲 / 上海时区的时间。

语法差异：KWDB 支持 AT TIME ZONE 语法和可能存在的 timezone () 函数；而 MySQL 主要使用 CONVERT_TZ 函数来处理时区转换。

功能一致性：尽管语法不同，但它们的核心功能都是进行时区转换，都是将一个时间从一个时区转换到另一个时区。

2.2 示例二：EXTRACT------KWDB 实操效果

可以看到，KWDB 操作的是对应的 k_timestamp，下方是返回 YEAR FROM 的效果。

-- 从时间戳中提取年份ｓｅｌｅｃｔ EXTRACT(YEAR FROM k_timestamp) AS year_part FROM users;-- 从时间戳中提取小时ｓｅｌｅｃｔ EXTRACT(HOUR FROM k_timestamp) AS hour_part FROM users;

运行效果如下图：

MySQL 则会是以下的这种用法。

-- 从时间戳中提取年份ｓｅｌｅｃｔ EXTRACT(YEAR FROM '2025-04-16 12:30:00') AS year_part;-- 从时间戳中提取小时ｓｅｌｅｃｔ EXTRACT(HOUR FROM '2025-04-16 12:30:00') AS hour_part;

2.3 示例三：OVERLAY (PLACING FROM FOR) 和 overlay(,, , )

在这个示例中，text1 是 HelloWorld，text2 是 SQL，从第 6 个位置开始，将长度为 5 的子字符串（即 World）替换为 SQL，最终结果 result1 和 result2 都将是 HelloSQL。

KWDB_SQL:

-- 示例数据WITH sample_data AS (    ｓｅｌｅｃｔ 'HelloWorld' AS text1, 'SQL' AS text2, 6 AS int1, 5 AS int2
)-- 使用 OVERLAY(<text1> PLACING <text2> FROM <int1> FOR <int2>) 语法ｓｅｌｅｃｔ 
    OVERLAY(text1 PLACING text2 FROM int1 FOR int2) AS result1,    -- 使用 overlay(<text1>,<text2>, <int1>, <int2>) 语法
    overlay(text1, text2, int1, int2) AS result2FROM sample_data;

KWDB 效果：

MySQL 仅支持 overlay () 函数，不支持 OVERLAY ( PLACING FROM FOR) 这种语法。overlay () 函数的作用是用 text2 替换 text1 中从位置 int1 开始长度为 int2 的子字符串。

-- 示例数据ｓｅｌｅｃｔ overlay('HelloWorld', 'SQL', 6, 5) AS result;

在这个示例中，overlay () 函数会将 HelloWorld 中从第 6 个位置开始长度为 5 的子字符串（即 World）替换为 SQL，最终结果 result 为 HelloSQL。

语法支持差异：KWDB 同时支持 OVERLAY (PLACING FROM FOR) 和 overlay (,, , ) 两种语法；而 MySQL 只支持 overlay (,, , ) 这种形式。功能相同点：两种数据库在使用支持的语法时，功能都是用指定的字符串替换原字符串中特定位置和长度的子字符串。

三、时序数据库与关系数据库的区别

下标就是各个维度的时序数据库与关系数据库的对比。

四、总结

本文聚焦于 KWDB 时间格式化函数，通过详细测试与分析，为开发者和数据分析师提供了全面的使用参考，同时对比了 KWDB 与 MySQL 在特殊语法格式上的差异，并阐述了时序数据库与关系数据库的区别。

从数据模型、数据存储与管理、查询方式三个维度对比了时序数据库与关系数据库的区别。时序数据库以时间戳为核心，数据按时间顺序排列，采用顺序存储、列式存储，支持数据压缩，围绕时间范围、间隔进行查询；而关系数据库采用关系模型，以二维表形式存储数据，以行式存储为主，强调数据一致性和事务处理能力，查询功能强大灵活，但处理时序特定查询效率较低。开发者在选择数据库时，应根据具体的业务需求和数据特点进行综合考虑。

KWDB 开源库地址：https://gitee.com/kwdb/kwdb

KWDB 学习地址：https://www.kaiwudb.com/learning/

KWDB 活动地址：https://mp.weixin.qq.com/s/ZKQo7eQj_AtwamONCSl07A

希望本文能为大家带来一些价值，欢迎留言讨论。