DatePart函数示例

1. 概述

1.1 功能概述

Wyn报表表达式提供DatePart函数来获取日期指定部分（年/月/日等），返回整型值。

• 语法： DatePart(<时间单位>, <日期时间值>[, <一周的第一天>[, <一年的第一周>]])

• 说明： 返回一个整型（Integer）值，其中包含给定 Date 值的指定部分（年，月，日，时，分，秒，星期几等）

  参数	数据类型	是否必填	描述
  时间单位	String	是	指定要提取的时间部分： DateInterval.Day/d ：返回月的天数 DateInterval.DayOfYear/y ：一年中的一天（1到366） DateInterval.Hour/h ：小时 DateInterval.Minute/n ：分钟 DateInterval.Month/m ：月 DateInterval.Quarter/q : 季度 DateInterval.Second/s ：秒（1到60） DateInterval.Weekday/w : 星期几（1到7） DateInterval.WeekOfYear/ww : 一周（1到53） DateInterval.Year/yyyy : 年
  日期时间值	Date/DateTime	是	需要转换的日期表达式
  一周的第一天	Integer	否	指定星期几为一周的第一天： 0 ：系统设置中指定的一周的第一天 1 ：默认值，指定星期天为一周的第一天 2 ：星期一 3 ：星期二 4 : 星期三 5 : 星期四 6 : 星期五 7 : 星期六
  一年的第一周	Integer	否	指定每年的第一周： 0 ：系统设置中指定为一年的第一周的 1 ：默认值，1月1日所在的周 2 ：第一个至少包含新年中的四天的周 3 : 一年中第一个完整的周

• 示例： {DatePart("m", SaleDate)}，如DatePart("m","2017-11-2")返回月份11。

2. 操作步骤

下面我们以使用 DatePart 函数获取季度值为例为您介绍该函数。由函数表定义可以了解到，使用DatePart函数可以返回 Date 值的指定部分。

通过DatePart("q",订购日期) 获取季度数值（1-4），再结合Choose函数转换为'一季度'、'二季度'等更符合业务习惯的表达方式，完整表达式为：{Choose(DatePart("q",订购日期),"一","二","三","四")&"季度"}。

下面我们以一个简单的报表为例来看一下DatePart函数具体的应用效果。

1. 新建报表，添加“销售数据”数据集后，添加表格组件并按照下图所示绑定数据字段。

   
   

2. 选中表格，添加分组，为表格的分组添加分组条件 {DatePart("q", 订购日期)} ，使数据按照季度进行分组显示；并按分组条件添加数据排序，使其按照季度的先后顺序显示。

   
   

3. 在分组头文本框中添加表达式显示季度值。这里使用的表达式为： {Choose(DatePart("q", 订购日期), "一", "二", "三", "四")}季度 。

   
   

4. 在分组尾和表尾单元格中添加适当汇总。

   
   

5. 预览报表，查看效果。