CDOW( ) 函数

返回指定日期或日期时间是星期几。英文“Character Day of Week”的缩写。

语法

CDOW(日期/日期时间, 长度)

参数

名称 类型 描述
日期/日期时间

日期时间

要为其返回星期几名称的域、表达式或字面量值。
长度

数值

1 和 9 之间的一个值,可指定输出字符串的长度。要以缩写形式显示星期几名称,请指定一个较小值。

输出

字符。

示例

基本示例

返回 "Wednesday",因为 2014 年 12 月 31 日是 Wednesday,并且长度为 9:

CDOW(`20141231`, 9)

返回 "Wed",因为 2014 年 12 月 31 日是 Wednesday,并且长度为 3:

CDOW(`20141231 235959`, 3)

返回 Invoice_date 域中每个值的完整日名称:

CDOW(发票日期, 9)

返回 Receipt_timestamp 域中每个值的缩写日名称:

CDOW(回执时间戳, 3)

高级示例

添加一个域以标识日期对应于星期几

使用 CDOW( ) 函数可以创建一个计算域,以标识某个日期域中的所有日期对应于星期几。一旦您创建了该计算域,您就可以将其添加到日期列旁边的视图中:

DEFINE FIELD Name_of_Day COMPUTED CDOW(交易日期, 3)

创建一个过滤器以测试是否存在发生在周末的交易

使用 CDOW( ) 函数可以创建一个过滤器,以隔离发生在周末的交易:

SET FILTER TO CDOW(交易日期, 3) = "Sat" OR CDOW(交易日期, 3) = "Sun"

备注

参数详细信息

日期/日期时间指定的域可以使用任何日期或日期时间格式,前提是域定义正确定义了该格式。

如果长度参数比日期名称短,则日期名称将被缩短至指定长度。如果长度参数大于日期名称,则使用空格填充日期名称。

指定日期或日期时间字面值

在为日期/日期时间指定字面量日期或日期时间值时,您必须使用下表中的格式,并且必须将值放在反引号中 — 例如,`20141231`

在日期或时间的各个部分之间,不要使用任何分隔符,如斜杠 (/) 或冒号 (:)。

  • 日期时间值 - 您可以使用日期、分隔符和下表列出的时间格式的任意组合。日期必须位于时间前面,并且您必须在两者之间使用分隔符。有效分隔符是单个空格、字母 't' 或字母 'T'。

  • 时间值 – 您必须使用 24 小时时钟指定时间。协调世界时 (UTC) 偏移量前面必须带有加号 (+) 或减号 (-)。

    格式示例

    字面值示例

    YYYYMMDD

    `20141231`

    YYMMDD

    `141231`

    YYYYMMDD hhmmss

    `20141231 235959`

    YYMMDDthhmm

    `141231t2359`

    YYYYMMDDThh

    `20141231T23`

    YYYYMMDD hhmmss+/-hhmm

    (UTC 偏移量)

    `20141231 235959-0500`

    YYMMDD hhmm+/-hh

    (UTC 偏移量)

    `141231 2359+01`

    说明

    请勿在包含 UTC 偏移量数据的主时间格式中单独使用 hh。例如,请避免:hh+hhmm。结果可能不可靠。

     

相关函数

如果您需要将星期几返回为数字(1 到 7),请使用 DOW( ) 而不是 CDOW( )。

ACL 脚本指南 14.1