UtcTimePropertiesBuilder
一个生成器，用于创建TimeProperties对象实例。UtcTimePropertiesBuilder允许调用者创建一个基于UTC的ITimeProperties实例。约束条件是开始时间和执行时间窗口的组合。例如，如果我们希望在凌晨2点至凌晨4点 (UTC) 之间执行EPG同步任务，则可以使用以下命令构建一个timeProperties：UtcTimePropertiesBuilder.startHour(2).startMinute(0).startSecond(0).executionWindowInMinutes(120).build();
扩展
Builder
构造函数
new UtcTimePropertiesBuilder()
new UtcTimePropertiesBuilder(): UtcTimePropertiesBuilder
返回值
方法
build()
build(): ITimeProperties
根据提供的参数构建TimeProperties对象。
抛出
InvalidArgumentError如果缺少一个或多个必填字段。IllegalStateError如果在此生成器实例已经构建过一次对象之后调用该函数。
返回值
ITimeProperties 构建的TimeProperties对象。
executionWindowInMinutes()
executionWindowInMinutes(window:
number): UtcTimePropertiesBuilder
在TimeProperties中设置执行时间窗口的长度。
对于该时间属性，此字段是可选的。默认值为60分钟。
参数
window
number
执行时间窗口的长度，以分钟为单位。
抛出
IllegalStateError如果在此生成器实例已经构建过一次对象之后调用该函数。InvalidArgumentError如果执行时间窗口小于1小时。
返回值
UtcTimePropertiesBuilder 设置了执行窗口的UtcTimePropertiesBuilder对象。
startHour()
startHour(hour:
number): UtcTimePropertiesBuilder
在TimeProperties中设置开始时间的小时值。
此字段是该时间属性必需要有的字段。
参数
hour
number
代表小时 (0-23)。
抛出
IllegalStateError如果在此生成器实例已经构建过一次对象之后调用该函数。InvalidArgumentError如果小时值不在0到23之间的范围内。
返回值
UtcTimePropertiesBuilder 设置了开始时间小时值的UtcTimePropertiesBuilder对象。
startMinute()
startMinute(minute:
number): UtcTimePropertiesBuilder
在TimeProperties中设置开始时间的分钟值。
此字段是该时间属性必需要有的字段。
参数
minute
number
代表分钟 (0-59)。
抛出
IllegalStateError如果在此生成器实例已经构建过一次对象之后调用该函数。InvalidArgumentError如果分钟值不在0到59之间的范围内。
返回值
UtcTimePropertiesBuilder 设置了开始时间分钟值的UtcTimePropertiesBuilder对象。
startSecond()
startSecond(second:
number): UtcTimePropertiesBuilder
在TimeProperties中设置开始时间的秒数值。
此字段是该时间属性必需要有的字段。
参数
second
number
代表秒数 (0-59)。
抛出
IllegalStateError如果在此生成器实例已经构建过一次对象之后调用该函数。InvalidArgumentError如果秒数值不在0到59之间的范围内。
返回值
UtcTimePropertiesBuilder 设置了开始时间秒数值的UtcTimePropertiesBuilder对象。
Last updated: 2026年7月31日
