Class RecurrenceRule

RecurrenceRule

Mewakili aturan pengulangan untuk rangkaian peristiwa.

Perhatikan bahwa class ini juga berperilaku seperti EventRecurrence yang dimilikinya, sehingga Anda dapat merangkai pembuatan aturan bersama seperti berikut:

recurrence.addDailyRule().times(3).interval(2).addWeeklyExclusion().times(2);
Pengubah seperti times(times) dan interval(interval) diterapkan ke aturan yang baru-baru ini ditambahkan.

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
addDailyExclusion()RecurrenceRuleMenambahkan aturan yang mengecualikan kejadian 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 kemunculan setiap bulan.
addMonthlyRule()RecurrenceRuleMenambahkan aturan yang menyebabkan acara berulang setiap bulan.
addWeeklyExclusion()RecurrenceRuleMenambahkan aturan yang mengecualikan kejadian setiap minggu.
addWeeklyRule()RecurrenceRuleMenambahkan aturan yang menyebabkan acara berulang setiap minggu.
addYearlyExclusion()RecurrenceRuleMenambahkan aturan yang mengecualikan kejadian setiap tahun.
addYearlyRule()RecurrenceRuleMenambahkan aturan yang menyebabkan acara berulang setiap tahun.
interval(interval)RecurrenceRuleMengonfigurasi aturan agar hanya diterapkan pada interval unit waktu aturan ini.
onlyInMonth(month)RecurrenceRuleMengonfigurasi aturan agar hanya diterapkan pada bulan tertentu.
onlyInMonths(months)RecurrenceRuleMengonfigurasi aturan agar hanya diterapkan pada bulan tertentu.
onlyOnMonthDay(day)RecurrenceRuleMengonfigurasi aturan agar hanya diterapkan pada hari tertentu dalam sebulan.
onlyOnMonthDays(days)RecurrenceRuleMengonfigurasi aturan agar hanya diterapkan pada hari tertentu dalam sebulan.
onlyOnWeek(week)RecurrenceRuleMengonfigurasi aturan agar hanya diterapkan pada minggu tertentu dalam setahun.
onlyOnWeekday(day)RecurrenceRuleMengonfigurasi aturan agar hanya diterapkan pada hari tertentu dalam seminggu.
onlyOnWeekdays(days)RecurrenceRuleMengonfigurasi aturan agar hanya diterapkan pada hari tertentu dalam seminggu.
onlyOnWeeks(weeks)RecurrenceRuleMengonfigurasi aturan agar hanya berlaku pada minggu tertentu dalam setahun.
onlyOnYearDay(day)RecurrenceRuleMengonfigurasi aturan agar hanya berlaku pada hari tertentu dalam setahun.
onlyOnYearDays(days)RecurrenceRuleMengonfigurasi aturan agar hanya berlaku pada hari tertentu dalam setahun.
setTimeZone(timeZone)EventRecurrenceTetapkan zona waktu untuk pengulangan ini.
times(times)RecurrenceRuleMengonfigurasi aturan yang akan diakhiri setelah sejumlah kejadian tertentu.
until(endDate)RecurrenceRuleMengonfigurasi aturan agar berakhir pada tanggal tertentu (inklusif).
weekStartsOn(day)RecurrenceRuleMengonfigurasi awal hari dalam seminggu, untuk tujuan penerapan aturan.

Dokumentasi mendetail

addDailyExclusion()

Menambahkan aturan yang mengecualikan kejadian setiap hari.

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

Return

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.
var recurrence = CalendarApp.newRecurrence().addDailyRule().times(10);

Return

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

Return

EventRecurrence — EventRecurrence ini untuk perantaian

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

Return

EventRecurrence — EventRecurrence ini untuk perantaian

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 kemunculan setiap bulan.

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

Return

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 setiap bulan 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.
var recurrence = CalendarApp.newRecurrence().addMonthlyRule().times(4);

Return

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 kejadian setiap minggu.

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

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

Return

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 dengan hari 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.
var recurrence = CalendarApp.newRecurrence().addWeeklyRule().times(10);

Return

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 kejadian setiap tahun.

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

Return

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, acara berulang pada hari yang sama dalam setahun dengan acara pertama dalam seri, tetapi hal ini dapat diubah dengan memanggil onlyOnYearDay(day) atau onlyOnYearDays(days).

Return

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 diterapkan pada interval unit waktu aturan ini.

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

Parameter

NamaJenisDeskripsi
intervalIntegerinterval dalam satuan waktu aturan

Return

RecurrenceRule — RecurrenceRule ini untuk perantaian


onlyInMonth(month)

Mengonfigurasi aturan agar hanya diterapkan pada bulan tertentu.

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

Parameter

NamaJenisDeskripsi
monthMonthbulan

Return

RecurrenceRule — RecurrenceRule ini untuk perantaian


onlyInMonths(months)

Mengonfigurasi aturan agar hanya diterapkan pada bulan tertentu.

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

Parameter

NamaJenisDeskripsi
monthsMonth[]bulan

Return

RecurrenceRule — RecurrenceRule ini untuk perantaian


onlyOnMonthDay(day)

Mengonfigurasi aturan agar hanya diterapkan pada hari tertentu dalam sebulan.

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

Parameter

NamaJenisDeskripsi
dayIntegertanggal

Return

RecurrenceRule — RecurrenceRule ini untuk perantaian


onlyOnMonthDays(days)

Mengonfigurasi aturan agar hanya diterapkan pada hari tertentu dalam sebulan.

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

Parameter

NamaJenisDeskripsi
daysInteger[]tanggal

Return

RecurrenceRule — RecurrenceRule ini untuk perantaian


onlyOnWeek(week)

Mengonfigurasi aturan agar hanya diterapkan pada minggu tertentu dalam setahun.

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

Parameter

NamaJenisDeskripsi
weekIntegerminggu

Return

RecurrenceRule — RecurrenceRule ini untuk perantaian


onlyOnWeekday(day)

Mengonfigurasi aturan agar hanya diterapkan pada hari tertentu dalam seminggu.

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

Parameter

NamaJenisDeskripsi
dayWeekdayhari dalam seminggu

Return

RecurrenceRule — RecurrenceRule ini untuk perantaian


onlyOnWeekdays(days)

Mengonfigurasi aturan agar hanya diterapkan pada hari tertentu dalam seminggu.

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

Parameter

NamaJenisDeskripsi
daysWeekday[]hari

Return

RecurrenceRule — RecurrenceRule ini untuk perantaian


onlyOnWeeks(weeks)

Mengonfigurasi aturan agar hanya berlaku pada minggu tertentu dalam setahun.

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

Parameter

NamaJenisDeskripsi
weeksInteger[]minggu

Return

RecurrenceRule — RecurrenceRule ini untuk perantaian


onlyOnYearDay(day)

Mengonfigurasi aturan agar hanya berlaku pada hari tertentu dalam setahun.

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

Parameter

NamaJenisDeskripsi
dayIntegerhari dalam tahun

Return

RecurrenceRule — RecurrenceRule ini untuk perantaian


onlyOnYearDays(days)

Mengonfigurasi aturan agar hanya berlaku pada hari tertentu dalam setahun.

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

Parameter

NamaJenisDeskripsi
daysInteger[]hari

Return

RecurrenceRule — RecurrenceRule ini untuk perantaian


setTimeZone(timeZone)

Tetapkan zona waktu untuk pengulangan ini. Hal ini memengaruhi tanggal dan waktu peristiwa berulang, dan apakah peristiwa bergeser seiring waktu musim panas. Setelan defaultnya adalah zona waktu kalender.

Parameter

NamaJenisDeskripsi
timeZoneStringzona waktu, yang ditentukan dalam format "panjang" (mis., 'America/New_York', seperti yang dicantumkan oleh Joda.org)

Return

EventRecurrence — EventRecurrence ini untuk perantaian

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 yang akan diakhiri setelah sejumlah kejadian tertentu.

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

Parameter

NamaJenisDeskripsi
timesIntegerberapa kali pengulangan

Return

RecurrenceRule — RecurrenceRule ini untuk perantaian


until(endDate)

Mengonfigurasi aturan agar berakhir pada tanggal tertentu (inklusif).

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

Parameter

NamaJenisDeskripsi
endDateDate

Return

RecurrenceRule — RecurrenceRule ini untuk perantaian

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 awal hari dalam seminggu, untuk tujuan penerapan aturan.

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

Parameter

NamaJenisDeskripsi
dayWeekdayhari dimulainya pekan

Return

RecurrenceRule — RecurrenceRule ini untuk perantaian