全部产品
Search
文档中心

智能数据建设与治理 Dataphin:创建及管理公共日历

更新时间:Sep 16, 2026

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

权限说明

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

公共日历页面概述

image

区域

说明

①公共日历列表

为您展示当前已创建的公共日历,您可以通过输入日历名称或编码搜索公共日历,同时支持编辑、克隆和删除操作。

  • 编辑:编辑公共日历时,需配置日历名称、编码和日历模板,相关配置说明同新建操作,详情请参见创建公共日历。

  • 克隆:克隆公共日历时,需配置日历名称、编码和克隆范围。其中,克隆范围可选择日历+标签或仅日历。

  • 删除:删除公共日历时,系统将校验公共日历是否存在引用依赖,包括标签、日历、日期类型。存在依赖时,请先删除相关引用后再进行删除操作。

②操作区

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

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

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

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

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

  • 导入:当前支持使用本地文件导入标签。单击导入,打开标签导入对话框,您可单击下载模板,下载标签导入模板至本地,按照模板填入所需标签信息后,上传文件(仅支持.xlsx格式的文件)完成导入。

    说明
    • 导入后,修改不可撤销,建议先使用克隆备份日历。

    • 单个文件支持上传最多5000个日期,即5000行,系统将自动读取文件中的第2~5001行数据。

    • 若文件Tag列中填写的标签编码在所选公共日历中不存在,则跳过此行内容。

    • 若文件Date列中填写的日期格式不符合YYYY-MM-DD格式,则跳过此行内容。

    • 若单个标签的指定日期已达到36500的上限,超出上限的日期则跳过。

  • 标签列表和引用:支持查看引用当前日历的标签和日历。

    • 标签:包括标签名称/编码、描述、引用次数。同时,支持查看标签详情、编辑、克隆和删除操作。您可在列表上方,输入标签名称或标签编码搜索标签。

      工作日作为内置标签,在标签列表中置顶,不支持删除。对日期类型的引用,均算作对工作日标签的引用。

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

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

③日历

为您展示日历页的信息,包括每个自然日的类型(工作日、假日)、标签名称。支持为某个指定日期添加标签以及修改日期类型。

  • 添加标签:添加标签时,需要选择标签来源,可选择已有标签或新建标签。若选择已有标签,则可为当前日期添加未拥有的标签。若所选标签的例外日期中包含当前日期,则将当前日期从例外日期中移除,并添加至指定日期列表。

  • 修改日期类型:修改指定日期的类型,操作详情请参见修改日期类型。

创建公共日历

  1. 单击Dataphin首页顶部菜单栏的规划,选择公共定义。

  2. 在公共定义页面中,单击公共日历页签,在公共日历页签中,单击新建公共日历,打开新建公共日历对话框。

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

    参数

    描述

    日历名称

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

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

    • 不能超过32个字符。

    编码

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

    日历模板

    基于选择的日历模板初始化日历。默认内置4 * 13、5-4-4、4-5-4、4-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. 单击确定,完成公共日历新建。

后续步骤

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