Reference documentation and code samples for the Kubernetes Engine V1 API class Google::Cloud::Container::V1::RecurringTimeWindow.
Represents an arbitrary window of time that recurs.
Inherits
Object
Extended By
Google::Protobuf::MessageExts::ClassMethods
Includes
Google::Protobuf::MessageExts
Methods
#recurrence
defrecurrence()->::String
Returns
(::String) — An RRULE (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) for how
this window reccurs. They go on for the span of time between the start and
end time.
For example, to have something repeat every weekday, you'd use:
FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR
To repeat some window daily (equivalent to the DailyMaintenanceWindow):
FREQ=DAILY
For the first weekend of every month:
FREQ=MONTHLY;BYSETPOS=1;BYDAY=SA,SU
This specifies how frequently the window starts. Eg, if you wanted to have
a 9-5 UTC-4 window every weekday, you'd use something like:
start time = 2019-01-01T09:00:00-0400
end time = 2019-01-01T17:00:00-0400
recurrence = FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR
Windows can span multiple days. Eg, to make the window encompass every
weekend from midnight Saturday till the last minute of Sunday UTC:
start time = 2019-01-05T00:00:00Z
end time = 2019-01-07T23:59:00Z
recurrence = FREQ=WEEKLY;BYDAY=SA
Note the start and end time's specific dates are largely arbitrary except
to specify duration of the window and when it first starts.
The FREQ values of HOURLY, MINUTELY, and SECONDLY are not supported.
#recurrence=
defrecurrence=(value)->::String
Parameter
value (::String) — An RRULE (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) for how
this window reccurs. They go on for the span of time between the start and
end time.
For example, to have something repeat every weekday, you'd use:
FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR
To repeat some window daily (equivalent to the DailyMaintenanceWindow):
FREQ=DAILY
For the first weekend of every month:
FREQ=MONTHLY;BYSETPOS=1;BYDAY=SA,SU
This specifies how frequently the window starts. Eg, if you wanted to have
a 9-5 UTC-4 window every weekday, you'd use something like:
start time = 2019-01-01T09:00:00-0400
end time = 2019-01-01T17:00:00-0400
recurrence = FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR
Windows can span multiple days. Eg, to make the window encompass every
weekend from midnight Saturday till the last minute of Sunday UTC:
start time = 2019-01-05T00:00:00Z
end time = 2019-01-07T23:59:00Z
recurrence = FREQ=WEEKLY;BYDAY=SA
Note the start and end time's specific dates are largely arbitrary except
to specify duration of the window and when it first starts.
The FREQ values of HOURLY, MINUTELY, and SECONDLY are not supported.
Returns
(::String) — An RRULE (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) for how
this window reccurs. They go on for the span of time between the start and
end time.
For example, to have something repeat every weekday, you'd use:
FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR
To repeat some window daily (equivalent to the DailyMaintenanceWindow):
FREQ=DAILY
For the first weekend of every month:
FREQ=MONTHLY;BYSETPOS=1;BYDAY=SA,SU
This specifies how frequently the window starts. Eg, if you wanted to have
a 9-5 UTC-4 window every weekday, you'd use something like:
start time = 2019-01-01T09:00:00-0400
end time = 2019-01-01T17:00:00-0400
recurrence = FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR
Windows can span multiple days. Eg, to make the window encompass every
weekend from midnight Saturday till the last minute of Sunday UTC:
start time = 2019-01-05T00:00:00Z
end time = 2019-01-07T23:59:00Z
recurrence = FREQ=WEEKLY;BYDAY=SA
Note the start and end time's specific dates are largely arbitrary except
to specify duration of the window and when it first starts.
The FREQ values of HOURLY, MINUTELY, and SECONDLY are not supported.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-09 UTC."],[],[],null,["# Kubernetes Engine V1 API - Class Google::Cloud::Container::V1::RecurringTimeWindow (v1.9.0)\n\nVersion latestkeyboard_arrow_down\n\n- [1.9.0 (latest)](/ruby/docs/reference/google-cloud-container-v1/latest/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [1.8.0](/ruby/docs/reference/google-cloud-container-v1/1.8.0/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [1.7.0](/ruby/docs/reference/google-cloud-container-v1/1.7.0/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [1.6.1](/ruby/docs/reference/google-cloud-container-v1/1.6.1/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [1.5.0](/ruby/docs/reference/google-cloud-container-v1/1.5.0/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [1.4.0](/ruby/docs/reference/google-cloud-container-v1/1.4.0/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [1.3.0](/ruby/docs/reference/google-cloud-container-v1/1.3.0/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [1.2.0](/ruby/docs/reference/google-cloud-container-v1/1.2.0/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [1.1.1](/ruby/docs/reference/google-cloud-container-v1/1.1.1/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [1.0.0](/ruby/docs/reference/google-cloud-container-v1/1.0.0/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [0.42.0](/ruby/docs/reference/google-cloud-container-v1/0.42.0/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [0.41.0](/ruby/docs/reference/google-cloud-container-v1/0.41.0/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [0.40.0](/ruby/docs/reference/google-cloud-container-v1/0.40.0/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [0.39.0](/ruby/docs/reference/google-cloud-container-v1/0.39.0/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [0.38.0](/ruby/docs/reference/google-cloud-container-v1/0.38.0/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [0.37.0](/ruby/docs/reference/google-cloud-container-v1/0.37.0/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [0.36.0](/ruby/docs/reference/google-cloud-container-v1/0.36.0/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [0.35.0](/ruby/docs/reference/google-cloud-container-v1/0.35.0/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [0.34.1](/ruby/docs/reference/google-cloud-container-v1/0.34.1/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [0.33.1](/ruby/docs/reference/google-cloud-container-v1/0.33.1/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [0.32.0](/ruby/docs/reference/google-cloud-container-v1/0.32.0/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [0.31.0](/ruby/docs/reference/google-cloud-container-v1/0.31.0/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [0.30.0](/ruby/docs/reference/google-cloud-container-v1/0.30.0/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [0.29.0](/ruby/docs/reference/google-cloud-container-v1/0.29.0/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [0.28.0](/ruby/docs/reference/google-cloud-container-v1/0.28.0/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [0.27.0](/ruby/docs/reference/google-cloud-container-v1/0.27.0/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [0.26.0](/ruby/docs/reference/google-cloud-container-v1/0.26.0/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [0.25.0](/ruby/docs/reference/google-cloud-container-v1/0.25.0/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [0.24.0](/ruby/docs/reference/google-cloud-container-v1/0.24.0/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [0.23.0](/ruby/docs/reference/google-cloud-container-v1/0.23.0/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [0.22.0](/ruby/docs/reference/google-cloud-container-v1/0.22.0/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [0.21.1](/ruby/docs/reference/google-cloud-container-v1/0.21.1/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [0.20.0](/ruby/docs/reference/google-cloud-container-v1/0.20.0/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [0.19.0](/ruby/docs/reference/google-cloud-container-v1/0.19.0/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [0.18.0](/ruby/docs/reference/google-cloud-container-v1/0.18.0/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [0.17.0](/ruby/docs/reference/google-cloud-container-v1/0.17.0/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [0.16.3](/ruby/docs/reference/google-cloud-container-v1/0.16.3/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [0.15.0](/ruby/docs/reference/google-cloud-container-v1/0.15.0/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [0.14.0](/ruby/docs/reference/google-cloud-container-v1/0.14.0/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [0.13.0](/ruby/docs/reference/google-cloud-container-v1/0.13.0/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [0.12.0](/ruby/docs/reference/google-cloud-container-v1/0.12.0/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [0.11.0](/ruby/docs/reference/google-cloud-container-v1/0.11.0/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [0.10.0](/ruby/docs/reference/google-cloud-container-v1/0.10.0/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [0.9.1](/ruby/docs/reference/google-cloud-container-v1/0.9.1/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [0.8.0](/ruby/docs/reference/google-cloud-container-v1/0.8.0/Google-Cloud-Container-V1-RecurringTimeWindow)\n- [0.7.3](/ruby/docs/reference/google-cloud-container-v1/0.7.3/Google-Cloud-Container-V1-RecurringTimeWindow) \nReference documentation and code samples for the Kubernetes Engine V1 API class Google::Cloud::Container::V1::RecurringTimeWindow.\n\nRepresents an arbitrary window of time that recurs. \n\nInherits\n--------\n\n- Object \n\nExtended By\n-----------\n\n- Google::Protobuf::MessageExts::ClassMethods \n\nIncludes\n--------\n\n- Google::Protobuf::MessageExts\n\nMethods\n-------\n\n### #recurrence\n\n def recurrence() -\u003e ::String\n\n**Returns**\n\n- (::String) --- An RRULE (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) for how this window reccurs. They go on for the span of time between the start and end time.\n\n For example, to have something repeat every weekday, you'd use:\n `FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR`\n\n To repeat some window daily (equivalent to the DailyMaintenanceWindow):\n `FREQ=DAILY`\n\n For the first weekend of every month:\n `FREQ=MONTHLY;BYSETPOS=1;BYDAY=SA,SU`\n\n This specifies how frequently the window starts. Eg, if you wanted to have\n a 9-5 UTC-4 window every weekday, you'd use something like:\n `\n start time = 2019-01-01T09:00:00-0400\n end time = 2019-01-01T17:00:00-0400\n recurrence = FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR\n `\n\n Windows can span multiple days. Eg, to make the window encompass every\n weekend from midnight Saturday till the last minute of Sunday UTC:\n `\n start time = 2019-01-05T00:00:00Z\n end time = 2019-01-07T23:59:00Z\n recurrence = FREQ=WEEKLY;BYDAY=SA\n `\n\n Note the start and end time's specific dates are largely arbitrary except\n to specify duration of the window and when it first starts.\n The FREQ values of HOURLY, MINUTELY, and SECONDLY are not supported.\n\n### #recurrence=\n\n def recurrence=(value) -\u003e ::String\n\n**Parameter**\n\n- **value** (::String) --- An RRULE (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) for how this window reccurs. They go on for the span of time between the start and end time.\n\n\n For example, to have something repeat every weekday, you'd use:\n `FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR`\n\n To repeat some window daily (equivalent to the DailyMaintenanceWindow):\n `FREQ=DAILY`\n\n For the first weekend of every month:\n `FREQ=MONTHLY;BYSETPOS=1;BYDAY=SA,SU`\n\n This specifies how frequently the window starts. Eg, if you wanted to have\n a 9-5 UTC-4 window every weekday, you'd use something like:\n `\n start time = 2019-01-01T09:00:00-0400\n end time = 2019-01-01T17:00:00-0400\n recurrence = FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR\n `\n\n Windows can span multiple days. Eg, to make the window encompass every\n weekend from midnight Saturday till the last minute of Sunday UTC:\n `\n start time = 2019-01-05T00:00:00Z\n end time = 2019-01-07T23:59:00Z\n recurrence = FREQ=WEEKLY;BYDAY=SA\n `\n\n Note the start and end time's specific dates are largely arbitrary except\n to specify duration of the window and when it first starts.\nThe FREQ values of HOURLY, MINUTELY, and SECONDLY are not supported. \n**Returns**\n\n- (::String) --- An RRULE (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) for how this window reccurs. They go on for the span of time between the start and end time.\n\n For example, to have something repeat every weekday, you'd use:\n `FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR`\n\n To repeat some window daily (equivalent to the DailyMaintenanceWindow):\n `FREQ=DAILY`\n\n For the first weekend of every month:\n `FREQ=MONTHLY;BYSETPOS=1;BYDAY=SA,SU`\n\n This specifies how frequently the window starts. Eg, if you wanted to have\n a 9-5 UTC-4 window every weekday, you'd use something like:\n `\n start time = 2019-01-01T09:00:00-0400\n end time = 2019-01-01T17:00:00-0400\n recurrence = FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR\n `\n\n Windows can span multiple days. Eg, to make the window encompass every\n weekend from midnight Saturday till the last minute of Sunday UTC:\n `\n start time = 2019-01-05T00:00:00Z\n end time = 2019-01-07T23:59:00Z\n recurrence = FREQ=WEEKLY;BYDAY=SA\n `\n\n Note the start and end time's specific dates are largely arbitrary except\n to specify duration of the window and when it first starts.\n The FREQ values of HOURLY, MINUTELY, and SECONDLY are not supported.\n\n### #window\n\n def window() -\u003e ::Google::Cloud::Container::V1::TimeWindow\n\n**Returns**\n\n- ([::Google::Cloud::Container::V1::TimeWindow](./Google-Cloud-Container-V1-TimeWindow)) --- The window of the first recurrence.\n\n### #window=\n\n def window=(value) -\u003e ::Google::Cloud::Container::V1::TimeWindow\n\n**Parameter**\n\n- **value** ([::Google::Cloud::Container::V1::TimeWindow](./Google-Cloud-Container-V1-TimeWindow)) --- The window of the first recurrence. \n**Returns**\n\n- ([::Google::Cloud::Container::V1::TimeWindow](./Google-Cloud-Container-V1-TimeWindow)) --- The window of the first recurrence."]]