Class: ScheduleSpec
ScheduleSpec is a complete description of a set of absolute timestamps (possibly infinite) that an action should occur at. The meaning of a ScheduleSpec depends only on its contents and never changes, except that the definition of a time zone can change over time (most commonly, when daylight saving time policy changes for an area). To create a totally self-contained ScheduleSpec, use UTC or include timezone_data.
For input, you can provide zero or more of: structured_calendar, calendar, cron_string, interval, and exclude_structured_calendar, and all of them will be used (the schedule will take action at the union of all of their times, minus the ones that match exclude_structured_calendar).
On input, calendar and cron_string fields will be compiled into structured_calendar (and maybe interval and timezone_name), so if you Describe a schedule, you'll see only structured_calendar, interval, etc.
If a spec has no matching times after the current time, then the schedule will be subject to automatic deletion (after several days).
Implements
Constructors
constructor
• new ScheduleSpec(properties?): ScheduleSpec
Constructs a new ScheduleSpec.
Parameters
| Name | Type | Description |
|---|---|---|
properties? | IScheduleSpec | Properties to set |
Returns
Properties
calendar
• calendar: ICalendarSpec[]
Calendar-based specifications of times.
Implementation of
cronString
• cronString: string[]
cron_string holds a traditional cron specification as a string. It
accepts 5, 6, or 7 fields, separated by spaces, and interprets them the
same way as CalendarSpec.
5 fields: minute, hour, day_of_month, month, day_of_week
6 fields: minute, hour, day_of_month, month, day_of_week, year
7 fields: second, minute, hour, day_of_month, month, day_of_week, year
If year is not given, it defaults to *. If second is not given, it
defaults to 0.
Shorthands @yearly, @monthly, @weekly, @daily, and @hourly are also
accepted instead of the 5-7 time fields.
Optionally, the string can be preceded by CRON_TZ=<timezone name> or
TZ=<timezone name>, which will get copied to timezone_name. (There must
not also be a timezone_name present.)
Optionally "#" followed by a comment can appear at the end of the string.
Note that the special case that some cron implementations have for
treating day_of_month and day_of_week as "or" instead of "and" when both
are set is not implemented.
@every <interval>[/<phase>] is accepted and gets compiled into an
IntervalSpec instead. <interval> and <phase> should be a decimal integer
with a unit suffix s, m, h, or d.
Implementation of
endTime
• Optional endTime: null | ITimestamp
If end_time is set, any timestamps after end_time will be skipped.
Implementation of
excludeCalendar
• excludeCalendar: ICalendarSpec[]
Any timestamps matching any of exclude_* will be skipped. Deprecated. Use exclude_structured_calendar.
Implementation of
excludeStructuredCalendar
• excludeStructuredCalendar: IStructuredCalendarSpec[]
ScheduleSpec excludeStructuredCalendar.
Implementation of
IScheduleSpec.excludeStructuredCalendar
interval
• interval: IIntervalSpec[]
Interval-based specifications of times.
Implementation of
jitter
• Optional jitter: null | IDuration
All timestamps will be incremented by a random value from 0 to this amount of jitter. Default: 0
Implementation of
startTime
• Optional startTime: null | ITimestamp
If start_time is set, any timestamps before start_time will be skipped. (Together, start_time and end_time make an inclusive interval.)
Implementation of
structuredCalendar
• structuredCalendar: IStructuredCalendarSpec[]
Calendar-based specifications of times.
Implementation of
IScheduleSpec.structuredCalendar
timezoneData
• timezoneData: Uint8Array
ScheduleSpec timezoneData.
Implementation of
timezoneName
• timezoneName: string
Time zone to interpret all calendar-based specs in.
If unset, defaults to UTC. We recommend using UTC for your application if at all possible, to avoid various surprising properties of time zones.
Time zones may be provided by name, corresponding to names in the IANA time zone database (see https://www.iana.org/time-zones). The definition will be loaded by the Temporal server from the environment it runs in.
If your application requires more control over the time zone definition used, it may pass in a complete definition in the form of a TZif file from the time zone database. If present, this will be used instead of loading anything from the environment. You are then responsible for updating timezone_data when the definition changes.
Calendar spec matching is based on literal matching of the clock time with no special handling of DST: if you write a calendar spec that fires at 2:30am and specify a time zone that follows DST, that action will not be triggered on the day that has no 2:30am. Similarly, an action that fires at 1:30am will be triggered twice on the day that has two 1:30s.
Also note that no actions are taken on leap-seconds (e.g. 23:59:60 UTC).
Implementation of
Methods
toJSON
▸ toJSON(): Object
Converts this ScheduleSpec to JSON.
Returns
Object
JSON object
create
▸ create(properties?): ScheduleSpec
Creates a new ScheduleSpec instance using the specified properties.
Parameters
| Name | Type | Description |
|---|---|---|
properties? | IScheduleSpec | Properties to set |
Returns
ScheduleSpec instance
decode
▸ decode(reader, length?): ScheduleSpec
Decodes a ScheduleSpec message from the specified reader or buffer.
Parameters
| Name | Type | Description |
|---|---|---|
reader | Uint8Array | Reader | Reader or buffer to decode from |
length? | number | Message length if known beforehand |
Returns
ScheduleSpec
Throws
If the payload is not a reader or valid buffer
Throws
If required fields are missing
decodeDelimited
▸ decodeDelimited(reader): ScheduleSpec
Decodes a ScheduleSpec message from the specified reader or buffer, length delimited.
Parameters
| Name | Type | Description |
|---|---|---|
reader | Uint8Array | Reader | Reader or buffer to decode from |
Returns
ScheduleSpec
Throws
If the payload is not a reader or valid buffer
Throws
If required fields are missing
encode
▸ encode(message, writer?): Writer
Encodes the specified ScheduleSpec message. Does not implicitly temporal.api.schedule.v1.ScheduleSpec.verify|verify messages.
Parameters
| Name | Type | Description |
|---|---|---|
message | IScheduleSpec | ScheduleSpec message or plain object to encode |
writer? | Writer | Writer to encode to |
Returns
Writer
Writer
encodeDelimited
▸ encodeDelimited(message, writer?): Writer
Encodes the specified ScheduleSpec message, length delimited. Does not implicitly temporal.api.schedule.v1.ScheduleSpec.verify|verify messages.
Parameters
| Name | Type | Description |
|---|---|---|
message | IScheduleSpec | ScheduleSpec message or plain object to encode |
writer? | Writer | Writer to encode to |
Returns
Writer
Writer
fromObject
▸ fromObject(object): ScheduleSpec
Creates a ScheduleSpec message from a plain object. Also converts values to their respective internal types.
Parameters
| Name | Type | Description |
|---|---|---|
object | Object | Plain object |
Returns
ScheduleSpec
getTypeUrl
▸ getTypeUrl(typeUrlPrefix?): string
Gets the default type url for ScheduleSpec
Parameters
| Name | Type | Description |
|---|---|---|
typeUrlPrefix? | string | your custom typeUrlPrefix(default "type.googleapis.com") |
Returns
string
The default type url
toObject
▸ toObject(message, options?): Object
Creates a plain object from a ScheduleSpec message. Also converts values to other types if specified.
Parameters
| Name | Type | Description |
|---|---|---|
message | ScheduleSpec | ScheduleSpec |
options? | IConversionOptions | Conversion options |
Returns
Object
Plain object