在许多应用程序中，可能需要实现周状态功能，例如列出特定日期的所有星期日。在这种情况下，编写一个能够列出两个日期之间特定星期几的日期的函数是非常有帮助的。本文将介绍如何创建这样一个函数，并展示其使用方法。
最初，需要列出两个日期之间的所有星期日，因此编写了相应的代码。后来，将该代码进行了泛化，使其能够列出任何星期几的日期，最终形成了这个函数。
这个函数接受三个参数：起始日期（DateFrom）、结束日期（DateTo）和星期几的名称（DayName）。
起始日期（DateFrom）：希望列出特定星期几的日期的起始日期。它接受两种日期格式：“MM/DD/YYYY”和“MM-DD-YYYY”。
结束日期（DateTo）：希望列出特定星期几的日期的结束日期。它接受两种日期格式：“MM/DD/YYYY”和“MM-DD-YYYY”。
星期几的名称（DayName）：需要列出日期的星期几的名称。有效值包括“Sunday”，“Monday”，“Tuesday”，“Wednesday”，“Thursday”，“Friday”和“Saturday”。
该函数首先使用DATEDIFF函数找出两个日期之间的天数，然后使用这个数字循环遍历每一天，并检查所需的星期几。为了获取星期几的名称，使用DATENAME函数，它会给提供星期几的名称，如“Sunday”，“Monday”等。然后，将给定的星期几与这些名称进行比较，如果找到，则将日期插入到表中。最终，表中包含了所有需要的日期。
可以在需要特定星期几日期列表的SELECT语句或存储过程中使用此代码。
CREATE FUNCTION fnGetDatesforAday(
@DtFrom DATETIME,
@DtTo DATETIME,
@DayName VARCHAR(12)
)
RETURNS @DateList TABLE ([Day] varchar(20), Dt datetime)
AS
BEGIN
IF NOT (@DayName = 'Monday' OR @DayName = 'Sunday' OR @DayName = 'Tuesday' OR @DayName = 'Wednesday' OR @DayName = 'Thursday' OR @DayName = 'Friday' OR @DayName = 'Saturday')
BEGIN
INSERT INTO @DateList
SELECT 'Invalid Day', NULL AS DAT
RETURN
END
DECLARE @TotDays INT
DECLARE @CNT INT
SET @TotDays = DATEDIFF(DD, @DTFROM, @DTTO) -- [NO OF DAYS between two dates]
SET @CNT = 0
WHILE @TotDays >= @CNT -- repeat for all days
BEGIN
IF DATENAME(DW, (@DTTO - @CNT)) = @DAYNAME
BEGIN
INSERT INTO @DateList
SELECT @DAYNAME, (@DTTO - @CNT) AS DAT
END
SET @CNT = @CNT + 1
END
RETURN
END
以下是如何使用这个函数的示例：
SELECT [Day], [Dt] FROM dbo.fnGetDatesforAday(
'7/1/2008',
'8/31/2008',
'Sunday'
)
输出结果：
| Day | Dt |
|---|---|
| Sunday | 2008-08-31 00:00:00.000 |
可以使用CONVERT函数和ORDER BY子句按照不同的格式和排序顺序列出日期。
SELECT [Day], CONVERT(VARCHAR, [Dt], 105) AS [Date] FROM dbo.fnGetDatesforAday(
'7/1/2008',
'8/31/2008',
'Sunday'
) ORDER BY [Dt]
输出结果：
| Day | Date |
|---|---|
| Sunday | 06-07-2008 |
如果输入了无效的星期几名称，函数将返回“Invalid Day”和NULL日期。
SELECT [Day], CONVERT(VARCHAR, [Dt], 105) AS [Date] FROM dbo.fnGetDatesforAday(
'7/1/2008',
'8/31/2008',
'Sumday'
) ORDER BY [Dt]
| Day | Date |
|---|---|
| Invalid Day | NULL |