日历规则（CalendarRule）表/实体引用（Microsoft Dataverse）

2025-10-31

定义服务以及资源或资源组的忙/闲时间，例如工作、非工作、休假和阻止。

Messages

下表列出了日历规则（CalendarRule）表的邮件。消息表示可以在表上执行的作。它们也可能是事件。

名称是事件？	Web API 操作	SDK for .NET
`Associate` 事件：True	关联记录	关联记录
`Disassociate` 事件：True	取消关联记录	取消关联记录

属性

下表列出了日历规则（CalendarRule）表的选定属性。

资产	价值
显示名称	日历规则
显示集合名称	日历规则
架构名称	`CalendarRule`
集合架构名称	`CalendarRules`
实体集名称	`calendarrules`
逻辑名称	`calendarrule`
逻辑集合名称	`calendarrules`
PrimaryId属性	`calendarruleid`
PrimaryName属性	`name`
表类型	`Standard`
所有权类型	`None`

可写列/属性

这些列/属性为 IsValidForCreate 或 IsValidForUpdate （通常两者）返回 true。按 SchemaName 列出。

日历 ID
CalendarRuleId
说明
Duration
EffectiveIntervalEnd
EffectiveIntervalStart
Effort
EndTime
ExtentCode
GroupDesignator
InnerCalendarId
IsModified
IsSelected
IsSimple
IsVaried
名称
偏移量
模式
排
StartTime
SubCode
TimeCode
时区代码

CalendarId

资产	价值
Description	与日历规则关联的日历的唯一标识符。
显示名称	Calendar
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`calendarid`
RequiredLevel	系统必填
类型	查找
Targets	日历

CalendarRuleId

资产	价值
Description	日历规则的唯一标识符。
显示名称	日历规则
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`calendarruleid`
RequiredLevel	系统必填
类型	Uniqueidentifier

Description

资产	价值
Description	定义服务以及资源或资源组（例如工作、非工作、休假和阻止）的忙/闲时间。
显示名称	说明
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`description`
RequiredLevel	None
类型	备忘录
Format	文本
格式名称	文本
ImeMode	Auto
是可本地化的	假
MaxLength （最大长度）	2000

持续时间

资产	价值
Description	日历规则的持续时间（以分钟为单位）。
显示名称	Duration
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`duration`
RequiredLevel	None
类型	整数
最大值	2147483647
最小值	0

EffectiveIntervalEnd

资产	价值
Description	日历规则的有效间隔结束。
显示名称	有效间隔结束
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`effectiveintervalend`
RequiredLevel	None
类型	日期时间
可以更改日期时间行为	假
日期时间行为	用户本地
Format	DateOnly
ImeMode	未激活
源类型掩码	0

EffectiveIntervalStart

资产	价值
Description	日历规则的有效间隔开始。
显示名称	有效间隔开始时间
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`effectiveintervalstart`
RequiredLevel	None
类型	日期时间
可以更改日期时间行为	假
日期时间行为	用户本地
Format	DateOnly
ImeMode	未激活
源类型掩码	0

Effort

资产	价值
Description	在日历规则描述的时间段内，资源可用的工作量。
显示名称	Effort
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`effort`
RequiredLevel	None
类型	Double
ImeMode	Disabled
最大值	1000000000
最小值	0
精准率	2

EndTime

资产	价值
Description	仅供内部使用。
显示名称	End
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`endtime`
RequiredLevel	None
类型	日期时间
可以更改日期时间行为	假
日期时间行为	用户本地
Format	日期和时间
ImeMode	未激活
源类型掩码	0

ExtentCode

资产	价值
Description	日历规则的范围。
显示名称	盘区代码
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`extentcode`
RequiredLevel	None
类型	整数
最大值	1000000000
最小值	0

GroupDesignator

资产	价值
Description	组的唯一标识符。
显示名称	组设计器
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`groupdesignator`
RequiredLevel	None
类型	String
Format	文本
格式名称	文本
ImeMode	Auto
是可本地化的	假
MaxLength （最大长度）	36

InnerCalendarId

资产	价值
Description	非叶日历规则的内部日历的唯一标识符。
显示名称	内部日历
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`innercalendarid`
RequiredLevel	None
类型	查找
Targets	日历

IsModified

资产	价值
Description	仅供内部使用。
显示名称	已修改
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`ismodified`
RequiredLevel	None
类型	布尔
全局选择名称	`calendarrule_ismodified`
默认值	假
真实标签	是的
虚假标签	否

IsSelected

资产	价值
Description	不同日期日历规则中使用的标志。
显示名称	已选择
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`isselected`
RequiredLevel	None
类型	布尔
全局选择名称	`calendarrule_isselected`
默认值	假
真实标签	是的
虚假标签	否

IsSimple

资产	价值
Description	不同日期日历规则中使用的标志。
显示名称	简单
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`issimple`
RequiredLevel	None
类型	布尔
全局选择名称	`calendarrule_issimple`
默认值	假
真实标签	是的
虚假标签	否

是可变的

资产	价值
Description	叶非递归规则中使用的标志。
显示名称	变化
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`isvaried`
RequiredLevel	None
类型	布尔
全局选择名称	`calendarrule_isvaried`
默认值	假
真实标签	是的
虚假标签	否

Name

资产	价值
Description	日历规则的名称。
显示名称	名称
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`name`
RequiredLevel	None
类型	String
Format	文本
格式名称	文本
ImeMode	Auto
是可本地化的	假
MaxLength （最大长度）	160

Offset

资产	价值
Description	叶非递归规则的起始偏移量。
显示名称	偏移量
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`offset`
RequiredLevel	None
类型	整数
最大值	1000000000
最小值	0

图案

资产	价值
Description	规则重复模式。
显示名称	重复模式
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`pattern`
RequiredLevel	None
类型	String
Format	文本
格式名称	文本
ImeMode	Auto
是可本地化的	假
MaxLength （最大长度）	256

等级

资产	价值
Description	日历规则的排名。
显示名称	排
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`rank`
RequiredLevel	系统必填
类型	整数
最大值	1000000000
最小值	0

StartTime

资产	价值
Description	规则的开始时间。
显示名称	启动
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`starttime`
RequiredLevel	None
类型	日期时间
可以更改日期时间行为	假
日期时间行为	用户本地
Format	日期和时间
ImeMode	未激活
源类型掩码	0

SubCode

资产	价值
Description	日历规则的子类型。
显示名称	子代码
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`subcode`
RequiredLevel	None
类型	整数
最大值	1000000000
最小值	0

TimeCode

资产	价值
Description	日历规则的类型，例如工作时间、休息时间、假日或休假。
显示名称	类型
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`timecode`
RequiredLevel	None
类型	整数
最大值	2147483647
最小值	-2147483648

时区代码

资产	价值
Description	日历规则的本地时区。
显示名称	时区
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`timezonecode`
RequiredLevel	None
类型	整数
最大值	2147483647
最小值	-2147483648

只读列/属性

这些列/属性为 IsValidForCreate 和 IsValidForUpdate 返回 false。按 SchemaName 列出。

业务单位 ID
CreatedBy
创建时间
创建时BehalfBy
ModifiedBy
修改时间
ModifiedOnBehalfBy
组织 ID
版本编号

业务单位 ID

资产	价值
Description	与日历规则关联的业务部门的唯一标识符。
显示名称	业务部门
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`businessunitid`
RequiredLevel	申请必填
类型	Uniqueidentifier

CreatedBy

资产	价值
Description	创建日历规则的用户的唯一标识符。
显示名称	创建者
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`createdby`
RequiredLevel	None
类型	查找
Targets	systemuser

CreatedOn

资产	价值
Description	创建日历规则的日期和时间。
显示名称	创建时间
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`createdon`
RequiredLevel	None
类型	日期时间
可以更改日期时间行为	假
日期时间行为	用户本地
Format	日期和时间
ImeMode	未激活
源类型掩码	0

创建时BehalfBy

资产	价值
Description	创建 calendarrule 的委托用户的唯一标识符。
显示名称	创建者（委托）
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`createdonbehalfby`
RequiredLevel	None
类型	查找
Targets	systemuser

ModifiedBy

资产	价值
Description	上次修改日历规则的用户的唯一标识符。
显示名称	修改者
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`modifiedby`
RequiredLevel	None
类型	查找
Targets	systemuser

修改时间

资产	价值
Description	上次修改日历规则的日期和时间。
显示名称	修改时间
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`modifiedon`
RequiredLevel	None
类型	日期时间
可以更改日期时间行为	假
日期时间行为	用户本地
Format	日期和时间
ImeMode	未激活
源类型掩码	0

ModifiedOnBehalfBy

资产	价值
Description	上次修改 calendarrule 的委托用户的唯一标识符。
显示名称	修改者（委托）
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`modifiedonbehalfby`
RequiredLevel	None
类型	查找
Targets	systemuser

组织ID

资产	价值
Description	与日历规则关联的组织的唯一标识符。
显示名称	组织
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`organizationid`
RequiredLevel	申请必填
类型	Uniqueidentifier

版本号

资产	价值
Description
显示名称
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`versionnumber`
RequiredLevel	None
类型	BigInt
最大值	9223372036854775807
最小值	-9223372036854775808

多对一关系

这些关系是多对一的。按 SchemaName 列出。

calendar_calendar_rules
inner_calendar_calendar_rules
lk_calendarrule_createdby
lk_calendarrule_createdonbehalfby
lk_calendarrule_modifiedby
lk_calendarrule_modifiedonbehalfby

calendar_calendar_rules

一To-Many 关系：日历calendar_calendar_rules

资产	价值
引用实体	`calendar`
引用属性	`calendarid`
引用属性	`calendarid`
ReferencingEntityNavigationPropertyName	`calendarid`
是层次结构
级联配置	档案： `NoCascade` 分配： `NoCascade` 删除： `Cascade` 合并： `NoCascade` 重新父级： `NoCascade` RollupView： `NoCascade` 共享： `NoCascade` 取消分享： `NoCascade`

inner_calendar_calendar_rules

一To-Many 关系：日历inner_calendar_calendar_rules

资产	价值
引用实体	`calendar`
引用属性	`calendarid`
引用属性	`innercalendarid`
ReferencingEntityNavigationPropertyName	`innercalendarid`
是层次结构
级联配置	档案： `NoCascade` 分配： `NoCascade` 删除： `RemoveLink` 合并： `NoCascade` 重新父级： `NoCascade` RollupView： `NoCascade` 共享： `NoCascade` 取消分享： `NoCascade`

lk_calendarrule_createdby

一To-Many 关系： systemuser lk_calendarrule_createdby

资产	价值
引用实体	`systemuser`
引用属性	`systemuserid`
引用属性	`createdby`
ReferencingEntityNavigationPropertyName	`createdby`
是层次结构
级联配置	档案： `NoCascade` 分配： `NoCascade` 删除： `NoCascade` 合并： `NoCascade` 重新父级： `NoCascade` RollupView： `NoCascade` 共享： `NoCascade` 取消分享： `NoCascade`

lk_calendarrule_createdonbehalfby

单To-Many 关系： systemuser lk_calendarrule_createdonbehalfby

资产	价值
引用实体	`systemuser`
引用属性	`systemuserid`
引用属性	`createdonbehalfby`
ReferencingEntityNavigationPropertyName	`createdonbehalfby`
是层次结构
级联配置	档案： `NoCascade` 分配： `NoCascade` 删除： `NoCascade` 合并： `NoCascade` 重新父级： `NoCascade` RollupView： `NoCascade` 共享： `NoCascade` 取消分享： `NoCascade`

lk_calendarrule_modifiedby

单To-Many 关系： systemuser lk_calendarrule_modifiedby

资产	价值
引用实体	`systemuser`
引用属性	`systemuserid`
引用属性	`modifiedby`
ReferencingEntityNavigationPropertyName	`modifiedby`
是层次结构
级联配置	档案： `NoCascade` 分配： `NoCascade` 删除： `NoCascade` 合并： `NoCascade` 重新父级： `NoCascade` RollupView： `NoCascade` 共享： `NoCascade` 取消分享： `NoCascade`

lk_calendarrule_modifiedonbehalfby

一To-Many 关系： systemuser lk_calendarrule_modifiedonbehalfby

资产	价值
引用实体	`systemuser`
引用属性	`systemuserid`
引用属性	`modifiedonbehalfby`
ReferencingEntityNavigationPropertyName	`modifiedonbehalfby`
是层次结构
级联配置	档案： `NoCascade` 分配： `NoCascade` 删除： `NoCascade` 合并： `NoCascade` 重新父级： `NoCascade` RollupView： `NoCascade` 共享： `NoCascade` 取消分享： `NoCascade`

另请参阅

Dataverse 表/实体引用
 Dataverse Web API 参考
 calendarrule

反馈

此页面是否有帮助？