Class RecurrenceRule

RecurrenceRule

Mewakili aturan pengulangan untuk rangkaian acara.

Perhatikan bahwa class ini juga berperilaku seperti EventRecurrence yang menjadi induknya, sehingga Anda dapat menggabungkan pembuatan aturan seperti ini: 

const recurrence = CalendarApp.newRecurrence().addDailyRule().times(3).interval(2).addWeeklyExclusion().times(2);
 Pengubah seperti times(times) dan interval(interval) diterapkan ke aturan yang baru saja ditambahkan.

Metode

MetodeJenis nilai yang ditampilkanDeskripsi singkat
addDailyExclusion()RecurrenceRuleMenambahkan aturan yang mengecualikan kemunculan setiap hari.
addDailyRule()RecurrenceRuleMenambahkan aturan yang menyebabkan acara berulang setiap hari.
addDate(date)EventRecurrenceMenambahkan aturan yang menyebabkan acara berulang pada tanggal tertentu.
addDateExclusion(date)EventRecurrenceMenambahkan aturan yang mengecualikan kemunculan untuk tanggal tertentu.
addMonthlyExclusion()RecurrenceRuleMenambahkan aturan yang mengecualikan kejadian setiap bulan.
addMonthlyRule()RecurrenceRuleMenambahkan aturan yang menyebabkan acara berulang setiap bulan.
addWeeklyExclusion()RecurrenceRuleMenambahkan aturan yang mengecualikan kemunculan setiap minggu.
addWeeklyRule()RecurrenceRuleMenambahkan aturan yang menyebabkan acara berulang setiap minggu.
addYearlyExclusion()RecurrenceRuleMenambahkan aturan yang mengecualikan kemunculan setiap tahun.
addYearlyRule()RecurrenceRuleMenambahkan aturan yang menyebabkan acara berulang setiap tahun.
interval(interval)RecurrenceRuleMengonfigurasi aturan agar hanya berlaku pada interval unit waktu aturan ini.
onlyInMonth(month)RecurrenceRuleMengonfigurasi aturan agar hanya berlaku untuk bulan tertentu.
onlyInMonths(months)RecurrenceRuleMengonfigurasi aturan agar hanya berlaku untuk bulan tertentu.
onlyOnMonthDay(day)RecurrenceRuleMengonfigurasi aturan agar hanya berlaku untuk hari tertentu dalam sebulan.
onlyOnMonthDays(days)RecurrenceRuleMengonfigurasi aturan agar hanya berlaku pada hari tertentu dalam sebulan.
onlyOnWeek(week)RecurrenceRuleMengonfigurasi aturan agar hanya berlaku untuk minggu tertentu dalam setahun.
onlyOnWeekday(day)RecurrenceRuleMengonfigurasi aturan agar hanya berlaku untuk hari tertentu dalam seminggu.
onlyOnWeekdays(days)RecurrenceRuleMengonfigurasi aturan agar hanya berlaku untuk hari-hari tertentu dalam seminggu.
onlyOnWeeks(weeks)RecurrenceRuleMengonfigurasi aturan agar hanya berlaku untuk minggu tertentu dalam setahun.
onlyOnYearDay(day)RecurrenceRuleMengonfigurasi aturan agar hanya berlaku untuk hari tertentu dalam setahun.
onlyOnYearDays(days)RecurrenceRuleMengonfigurasi aturan agar hanya berlaku untuk hari tertentu dalam setahun.
setTimeZone(timeZone)EventRecurrenceMenetapkan zona waktu untuk pengulangan ini.
times(times)RecurrenceRuleMengonfigurasi aturan agar berakhir setelah sejumlah kejadian tertentu.
until(endDate)RecurrenceRuleMengonfigurasi aturan agar berakhir pada tanggal tertentu (inklusif).
weekStartsOn(day)RecurrenceRuleMengonfigurasi hari awal minggu, untuk tujuan penerapan aturan.

Dokumentasi mendetail

addDailyExclusion()

Menambahkan aturan yang mengecualikan kemunculan setiap hari. 

// Creates a rule that recurs every week after the first 30 days.
const recurrence =
    CalendarApp.newRecurrence().addWeeklyRule().addDailyExclusion().times(30);

Pulang pergi

RecurrenceRule — RecurrenceRule baru

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut atau cakupan yang sesuai dari REST API terkait:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

addDailyRule()

Menambahkan aturan yang menyebabkan acara berulang setiap hari. 

// Creates a rule that recurs every day for ten days.
const recurrence = CalendarApp.newRecurrence().addDailyRule().times(10);

Pulang pergi

RecurrenceRule — RecurrenceRule baru

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut atau cakupan yang sesuai dari REST API terkait:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

addDate(date)

Menambahkan aturan yang menyebabkan acara berulang pada tanggal tertentu.

Parameter

NamaJenisDeskripsi
dateDate

Pulang pergi

EventRecurrence — EventRecurrence ini untuk dirangkaikan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut atau cakupan yang sesuai dari REST API terkait:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

addDateExclusion(date)

Menambahkan aturan yang mengecualikan kemunculan untuk tanggal tertentu.

Parameter

NamaJenisDeskripsi
dateDate

Pulang pergi

EventRecurrence — EventRecurrence ini untuk dirangkaikan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut atau cakupan yang sesuai dari REST API terkait:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

addMonthlyExclusion()

Menambahkan aturan yang mengecualikan kejadian setiap bulan.

Secara default, pengecualian diterapkan pada hari yang sama dalam sebulan dengan acara pertama dalam seri, tetapi hal ini dapat diubah dengan memanggil onlyOnMonthDay(day) atau onlyOnMonthDays(days).

Pulang pergi

RecurrenceRule — RecurrenceRule baru

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut atau cakupan yang sesuai dari REST API terkait:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

addMonthlyRule()

Menambahkan aturan yang menyebabkan acara berulang setiap bulan.

Secara default, acara berulang pada hari yang sama dalam sebulan dengan acara pertama dalam rangkaian, tetapi hal ini dapat diubah dengan memanggil onlyOnMonthDay(day) atau onlyOnMonthDays(days). 

// Creates a rule that recurs every month for three months.
const recurrence = CalendarApp.newRecurrence().addMonthlyRule().times(4);

Pulang pergi

RecurrenceRule — RecurrenceRule baru

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut atau cakupan yang sesuai dari REST API terkait:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

addWeeklyExclusion()

Menambahkan aturan yang mengecualikan kemunculan setiap minggu.

Secara default, pengecualian diterapkan pada hari yang sama dalam seminggu dengan acara pertama dalam rangkaian, tetapi hal ini dapat diubah dengan memanggil onlyOnWeekday(day) atau onlyOnWeekdays(days). 

// Creates a rule that recurs every day except the first four Wednesdays.
const recurrence = CalendarApp.newRecurrence()
                       .addDailyRule()
                       .addWeeklyExclusion()
                       .onlyOnWeekday(CalendarApp.Weekday.WEDNESDAY)
                       .times(4);

Pulang pergi

RecurrenceRule — RecurrenceRule baru

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut atau cakupan yang sesuai dari REST API terkait:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

addWeeklyRule()

Menambahkan aturan yang menyebabkan acara berulang setiap minggu.

Secara default, acara berulang pada hari yang sama dalam seminggu dengan acara pertama dalam rangkaian, tetapi hal ini dapat diubah dengan memanggil onlyOnWeekday(day) atau onlyOnWeekdays(days). 

// Creates a rule that recurs every week for ten weeks.
const recurrence = CalendarApp.newRecurrence().addWeeklyRule().times(10);

Pulang pergi

RecurrenceRule — RecurrenceRule baru

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut atau cakupan yang sesuai dari REST API terkait:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

addYearlyExclusion()

Menambahkan aturan yang mengecualikan kemunculan setiap tahun.

Secara default, pengecualian diterapkan pada hari yang sama dalam setahun dengan acara pertama dalam seri, tetapi hal ini dapat diubah dengan memanggil onlyOnYearDay(day) atau onlyOnYearDays(days).

Pulang pergi

RecurrenceRule — RecurrenceRule baru

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut atau cakupan yang sesuai dari REST API terkait:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

addYearlyRule()

Menambahkan aturan yang menyebabkan acara berulang setiap tahun.

Secara default, peristiwa berulang pada hari yang sama dalam setahun dengan peristiwa pertama dalam rangkaian, tetapi hal ini dapat diubah dengan memanggil onlyOnYearDay(day) atau onlyOnYearDays(days).

Pulang pergi

RecurrenceRule — RecurrenceRule baru

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut atau cakupan yang sesuai dari REST API terkait:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

interval(interval)

Mengonfigurasi aturan agar hanya berlaku pada interval unit waktu aturan ini. 

// Creates a rule that recurs every fourth week.
const recurrence = CalendarApp.newRecurrence().addWeeklyRule().interval(4);

Parameter

NamaJenisDeskripsi
intervalIntegerinterval dalam satuan waktu aturan

Pulang pergi

RecurrenceRule — RecurrenceRule ini untuk pembuatan rantai

onlyInMonth(month)

Mengonfigurasi aturan agar hanya berlaku untuk bulan tertentu. 

// Creates a rule that recurs every week in February.
const recurrence = CalendarApp.newRecurrence().addWeeklyRule().onlyInMonth(
    CalendarApp.Month.FEBRUARY);

Parameter

NamaJenisDeskripsi
monthMonthbulan

Pulang pergi

RecurrenceRule — RecurrenceRule ini untuk pembuatan rantai

onlyInMonths(months)

Mengonfigurasi aturan agar hanya berlaku untuk bulan tertentu. 

// Creates a rule that recurs every week in February and March.
const recurrence = CalendarApp.newRecurrence().addWeeklyRule().onlyInMonths(
    [CalendarApp.Month.FEBRUARY, CalendarApp.Month.MARCH]);

Parameter

NamaJenisDeskripsi
monthsMonth[]bulan

Pulang pergi

RecurrenceRule — RecurrenceRule ini untuk pembuatan rantai

onlyOnMonthDay(day)

Mengonfigurasi aturan agar hanya berlaku untuk hari tertentu dalam sebulan. 

// Creates a rule that recurs every month on the fifth day of the month.
const recurrence =
    CalendarApp.newRecurrence().addMonthlyRule().onlyOnMonthDay(5);

Parameter

NamaJenisDeskripsi
dayIntegertanggal

Pulang pergi

RecurrenceRule — RecurrenceRule ini untuk pembuatan rantai

onlyOnMonthDays(days)

Mengonfigurasi aturan agar hanya berlaku pada hari tertentu dalam sebulan. 

// Creates a rule that recurs every month on the first and fifteenth day of the
// month.
const recurrence =
    CalendarApp.newRecurrence().addMonthlyRule().onlyOnMonthDays([1, 15]);

Parameter

NamaJenisDeskripsi
daysInteger[]hari dalam bulan

Pulang pergi

RecurrenceRule — RecurrenceRule ini untuk pembuatan rantai

onlyOnWeek(week)

Mengonfigurasi aturan agar hanya berlaku untuk minggu tertentu dalam setahun. 

// Creates a rule that recurs on the fifth week of every year.
const recurrence = CalendarApp.newRecurrence().addWeeklyRule().onlyOnWeek(5);

Parameter

NamaJenisDeskripsi
weekIntegerminggu

Pulang pergi

RecurrenceRule — RecurrenceRule ini untuk pembuatan rantai

onlyOnWeekday(day)

Mengonfigurasi aturan agar hanya berlaku untuk hari tertentu dalam seminggu. 

// Creates a rule that recurs every week on Wednesdays.
const recurrence = CalendarApp.newRecurrence().addWeeklyRule().onlyOnWeekday(
    CalendarApp.Weekday.WEDNESDAY);

Parameter

NamaJenisDeskripsi
dayWeekdayhari dalam seminggu

Pulang pergi

RecurrenceRule — RecurrenceRule ini untuk pembuatan rantai

onlyOnWeekdays(days)

Mengonfigurasi aturan agar hanya berlaku untuk hari-hari tertentu dalam seminggu. 

// Creates a rule that recurs every week on Tuesdays and Thursdays.
const recurrence = CalendarApp.newRecurrence().addWeeklyRule().onlyOnWeekdays(
    [CalendarApp.Weekday.TUESDAY, CalendarApp.Weekday.THURSDAY]);

Parameter

NamaJenisDeskripsi
daysWeekday[]hari dalam seminggu

Pulang pergi

RecurrenceRule — RecurrenceRule ini untuk pembuatan rantai

onlyOnWeeks(weeks)

Mengonfigurasi aturan agar hanya berlaku untuk minggu tertentu dalam setahun. 

// Creates a rule that recurs on the fifth and tenth weeks of every year.
const recurrence =
    CalendarApp.newRecurrence().addWeeklyRule().onlyOnWeeks([5, 10]);

Parameter

NamaJenisDeskripsi
weeksInteger[]minggu

Pulang pergi

RecurrenceRule — RecurrenceRule ini untuk pembuatan rantai

onlyOnYearDay(day)

Mengonfigurasi aturan agar hanya berlaku untuk hari tertentu dalam setahun. 

// Creates a rule that recurs every year on February 15 (the 46th day).
const recurrence =
    CalendarApp.newRecurrence().addYearlyRule().onlyOnYearDay(46);

Parameter

NamaJenisDeskripsi
dayIntegerhari dalam setahun

Pulang pergi

RecurrenceRule — RecurrenceRule ini untuk pembuatan rantai

onlyOnYearDays(days)

Mengonfigurasi aturan agar hanya berlaku untuk hari tertentu dalam setahun. 

// Creates a rule that recurs every year on January 20 and February 15.
const recurrence =
    CalendarApp.newRecurrence().addYearlyRule().onlyOnYearDay([20, 46]);

Parameter

NamaJenisDeskripsi
daysInteger[]hari dalam setahun

Pulang pergi

RecurrenceRule — RecurrenceRule ini untuk pembuatan rantai

setTimeZone(timeZone)

Menetapkan zona waktu untuk pengulangan ini. Hal ini memengaruhi tanggal dan waktu pengulangan acara, dan apakah acara bergeser dengan waktu musim panas. Secara default menggunakan zona waktu kalender.

Parameter

NamaJenisDeskripsi
timeZoneStringzona waktu, yang ditentukan dalam format "long" (misalnya, 'America/New_York', seperti yang tercantum di Joda.org)

Pulang pergi

EventRecurrence — EventRecurrence ini untuk dirangkaikan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut atau cakupan yang sesuai dari REST API terkait:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

times(times)

Mengonfigurasi aturan agar berakhir setelah sejumlah kejadian tertentu. 

// Creates a rule that recurs every day for ten days.
const recurrence = CalendarApp.newRecurrence().addDailyRule().times(10);

Parameter

NamaJenisDeskripsi
timesIntegerberapa kali pengulangan

Pulang pergi

RecurrenceRule — RecurrenceRule ini untuk pembuatan rantai

until(endDate)

Mengonfigurasi aturan agar berakhir pada tanggal tertentu (inklusif). 

// Creates a rule that recurs every day through the end of 2013.
const recurrence = CalendarApp.newRecurrence().addDailyRule().until(
    new Date('December 31, 2013'));

Parameter

NamaJenisDeskripsi
endDateDate

Pulang pergi

RecurrenceRule — RecurrenceRule ini untuk pembuatan rantai

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut atau cakupan yang sesuai dari REST API terkait:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

weekStartsOn(day)

Mengonfigurasi hari awal minggu, untuk tujuan penerapan aturan. 

// Creates a weekly rule where weeks start on Monday.
const recurrence = CalendarApp.newRecurrence().addWeeklyRule().weekStartsOn(
    CalendarApp.Weekday.MONDAY);

Parameter

NamaJenisDeskripsi
dayWeekdayhari dimulainya minggu

Pulang pergi

RecurrenceRule — RecurrenceRule ini untuk pembuatan rantai