文档

创建及管理公共日历

更新时间:

Dataphin提供租户级别的公共日历功能。公共日历支持自定义日历、自定义日期类型(工作日和假日)和灵活的自定义日历标签。以帮助您在配置调度任务时,结合公共日历中的定义信息配置条件调度参数,进行灵活的调度。或在创建任务时引用公共日历,避免在创建任务时重复定义,减少开发和后期维护成本。本文将为您介绍如何创建及管理公共日历。

权限说明

仅支持超级管理员系统管理员新增、修改、删除公共日历。

公共日历页面概述

image

区域

说明

公共日历列表

为您展示当前已创建的公共日历,您可以通过输入日历名称或编码搜索公共日历,同时支持编辑和删除操作。删除公共日历时,系统将校验公共日历是否存在引用依赖,包括标签、日历、日期类型。存在依赖时,请先删除相关引用后在进行删除操作。

操作区

  • 内建函数说明:公共日历提供相关内置函数,您可以使用公共日历内置函数进行相关的计算开发,提升开发效率。支持的函数,请参见公共日历内建函数

  • 新建公共日历:创建的公共日历可以用于离线任务、标签条件等计算场景。创建公共日历,请参见创建公共日历

  • 今天:单击今天,日历将快速定位至当天。

  • 翻页:您可以单击imageimage切换当前日历页。

  • 标签搜索:支持通过输入标签关键字搜索标签。

  • 查看日历引用:支持查看引用当前日历的标签日期类型日历

    • 引用标签:包括标签名称/编码、日期范围、引用次数及支持查看详情、编辑和删除操作。同时,您可以输入标签名称或标签编码搜索标签。

    • 日期类型:包括所属项目/板块、对象名称、对象类型、引用类型、引用时间及支持查看详情、编辑和删除操作。

    • 日历:包括所属项目/板块、对象名称、对象类型、引用时间及支持查看详情、编辑和删除操作。

  • 新建标签:支持为当前日历新建标签,用于离线任务、标签条件计算等场景。创建标签,请参见新建标签

日历

为您展示日历页的信息,包括每个自然日的类型(工作日、假日)、标签名称。

创建公共日历

  1. 在Dataphin首页,单击顶部菜单栏规划->公共定义

  2. 按照以下操作指引,进入新建公共日历对话框。

    依次单击公共日历->+新建公共日历

    image

  3. 新建公共日历对话框中,配置日历相关信息。

    参数

    说明

    日历名称

    填写日历名称。命名规则如下:

    • 支持中文、英文字母、数字、下划线(_)、短划线(-)。

    • 不能超过32个字符。

    编码

    公共日历的唯一标识,任务引用时的参数值。仅支持字母、数字、下划线(_)组合。不能超过32个字符。

    日历模板

    基于选择的日历模板初始化日历。默认内置4 * 135-4-44-5-44-4-5财务日历,您可以根据业务需求进行选择或自定义财务日历。

    4 * 13 财务日历:每年52周,分为13个月,每月4周,每6年的最后一个财务月将多一周。

    5-4-4 财务日历:每年52周,每个季度13周,季度内每月周数遵循5-4-4 ,每6年的最后一个财务月将多一周。

    4-5-4 财务日历:每年52周,每个季度13周,季度内每月周数遵循4-5-4 ,每6年的最后一个财务月将多一周。

    4-4-5财务日历:每年52周,每个季度13周,季度内每月周数遵循4-4-5 ,每6年的最后一个财务月将多一周。

    自定义财务日历:可以自定义周起始日财务基准日

    重要

    编辑日历改变模板设置,所有调整将失效。

    周起始日

    一周的第一天。

    财务基准日

    财年的最后一天。

    溢出周归属

    非自定义的内置财务日历支持配置溢出周归属,指当前日历模板每6年将多出一周,可配置溢出周归属第6年的哪个财务月。

    日历标题格式

    每一个日历月的标题格式。支持以下6种标题格式。

    • FY{YYYY} M{n}:例如,2024财年第8财务月,日历标题将显示为FY2024 M8

    • FY{YYYY} Q{n} M{n}:例如,2024财年第3季度第2财务月,日历标题将显示为FY2024 Q3 M2

    • FY{YY} Q{n} M{n}:例如,2024财年第3季度第2财务月,日历标题将显示为FY24 Q3 M2

    • FY{YY} M{n}:例如,2024财年第8财务月,日历标题将显示为FY24 M8

    • {YYYY}财年 第{n}季度第{n}财务月:例如,2024财年第3季度第2财务月,日历标题将显示为2024财年第3季度第2财务月

    • {YYYY}财年 第{n}财务月:例如,2024财年第8财务月,日历标题将显示为2024财年第8财务月

  4. 单击确定,完成公共日历新建。

后续步骤

完成公共日历的创建后,您可以根据业务需求在日历中添加相应的标签。具体操作,请参见新建标签