[]
        
在线Demo 免费试用
(Showing Draft Content)

DatePart函数示例

1. 函数示例

语法: 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. 新建报表,添加“销售数据”数据集后,添加表格组件并按照下图所示绑定数据字段。

image2020-6-10_12-9-27.png


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

image2020-10-13_11-47-59.png


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

image2020-10-13_11-50-36.png


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

image2020-6-10_12-10-27.png


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

datepart函数.gif