MariaDB WEEKOFYEAR() 函数使用指南

在 MariaDB 中，WEEKOFYEAR() 是一个内置函数，它返回给定日期的周编号。

该函数相当于 WEEK(date,3)。

MariaDB WEEKOFYEAR() 语法

这是 MariaDB WEEKOFYEAR() 函数的语法：

WEEKOFYEAR(date)

参数

date

必需的。一个日期或者日期时间表达式。

如果您提供了错误数量的参数，MariaDB 将报告一个错误：ERROR 1582 (42000): Incorrect parameter count in the call to native function 'WEEKOFYEAR'。

返回值

MariaDB WEEKOFYEAR() 函数返回给定日期位于当年的第几周，取值范围为 1 到 53。

该函数的前提是“一周的第一天是星期一，并且一年中的第一周有 3 天以上”，它相当于 WEEK(date,3)。

如果指定的表达式不是一个合法的日期或者日期时间，WEEKOFYEAR() 函数将返回 NULL。

如果参数为 NULL，WEEKOFYEAR() 函数将返回 NULL。

MariaDB WEEKOFYEAR() 示例

下面的语句展示了 MariaDB WEEKOFYEAR() 函数的基本用法：

SELECT WEEKOFYEAR('2023-01-01');

输出：

+--------------------------+
| WEEKOFYEAR('2023-01-01') |
+--------------------------+
|                       52 |
+--------------------------+

MariaDB WEEKOFYEAR() 函数允许您使用一个日期时间值：

SELECT WEEKOFYEAR('2023-01-01 10:10:10');

输出：

+-----------------------------------+
| WEEKOFYEAR('2023-01-01 10:10:10') |
+-----------------------------------+
|                                52 |
+-----------------------------------+

要获取当前日期的周编号，请使用 NOW() 函数：

SELECT
    NOW(),
    WEEKOFYEAR(NOW());

输出：

+---------------------+-------------------+
| NOW()               | WEEKOFYEAR(NOW()) |
+---------------------+-------------------+
| 2023-01-12 14:59:17 |                 2 |
+---------------------+-------------------+

结论

在 MariaDB 中，WEEKOFYEAR() 是一个内置函数，它返回给定日期的周编号。