Class RecurrenceRule

RecurrenceRule

이벤트 계열에 대한 반복 규칙을 나타냅니다.

이 클래스는 클래스가 속한 EventRecurrence처럼 동작하여 다음과 같이 규칙 생성을 함께 연결할 수 있습니다. 

recurrence.addDailyRule().times(3).interval(2).addWeeklyExclusion().times(2);
times(times) 및 interval(interval)와 같은 수정자는 가장 최근에 추가된 규칙에 적용됩니다.

방법

메서드반환 유형간략한 설명
addDailyExclusion()RecurrenceRule매일 일치하는 항목을 제외하는 규칙을 추가합니다.
addDailyRule()RecurrenceRule이벤트가 매일 반복되도록 하는 규칙을 추가합니다.
addDate(date)EventRecurrence특정 날짜에 이벤트가 반복되도록 하는 규칙을 추가합니다.
addDateExclusion(date)EventRecurrence특정 날짜의 일치하는 항목을 제외하는 규칙을 추가합니다.
addMonthlyExclusion()RecurrenceRule매월 일치하는 항목을 제외하는 규칙을 추가합니다.
addMonthlyRule()RecurrenceRule매월 이벤트가 반복되도록 하는 규칙을 추가합니다.
addWeeklyExclusion()RecurrenceRule매주 일치하는 항목을 제외하는 규칙을 추가합니다.
addWeeklyRule()RecurrenceRule이벤트가 주 1회 반복되도록 규칙을 추가합니다.
addYearlyExclusion()RecurrenceRule1년 단위로 일치하는 항목을 제외하는 규칙을 추가합니다.
addYearlyRule()RecurrenceRule매년 이벤트가 반복되도록 하는 규칙을 추가합니다.
interval(interval)RecurrenceRule규칙의 시간 단위 중 이 간격에만 적용되도록 규칙을 구성합니다.
onlyInMonth(month)RecurrenceRule특정 달에만 적용되도록 규칙을 구성합니다.
onlyInMonths(months)RecurrenceRule특정 달에만 적용되도록 규칙을 구성합니다.
onlyOnMonthDay(day)RecurrenceRule매월 특정 날짜에만 적용되도록 규칙을 구성합니다.
onlyOnMonthDays(days)RecurrenceRule그 달의 특정 날짜에만 적용되도록 규칙을 구성합니다.
onlyOnWeek(week)RecurrenceRule일 년 중 특정 주에만 적용되도록 규칙을 구성합니다.
onlyOnWeekday(day)RecurrenceRule특정 요일에만 적용되도록 규칙을 구성합니다.
onlyOnWeekdays(days)RecurrenceRule특정 요일에만 적용되도록 규칙을 구성합니다.
onlyOnWeeks(weeks)RecurrenceRule1년 중 특정 주에만 적용되도록 규칙을 구성합니다.
onlyOnYearDay(day)RecurrenceRule연중 특정 날짜에만 적용되도록 규칙을 구성합니다.
onlyOnYearDays(days)RecurrenceRule연중 특정 요일에만 적용되도록 규칙을 구성합니다.
setTimeZone(timeZone)EventRecurrence반복의 시간대를 설정합니다.
times(times)RecurrenceRule지정된 횟수만큼 반복한 후에 종료되도록 규칙을 구성합니다.
until(endDate)RecurrenceRule지정된 날짜 (해당 날짜 포함)에 종료되도록 규칙을 구성합니다.
weekStartsOn(day)RecurrenceRule규칙을 적용하기 위해 한 주의 시작 요일을 구성합니다.

자세한 문서

addDailyExclusion()

매일 일치하는 항목을 제외하는 규칙을 추가합니다. 

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

리턴

RecurrenceRule - 새 RecurrenceRule

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

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

addDailyRule()

이벤트가 매일 반복되도록 하는 규칙을 추가합니다. 

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

리턴

RecurrenceRule - 새 RecurrenceRule

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

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

addDate(date)

특정 날짜에 이벤트가 반복되도록 하는 규칙을 추가합니다.

매개변수

이름유형설명
dateDate

리턴

EventRecurrence: 연결을 위한 이 EventRecurrence

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

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

addDateExclusion(date)

특정 날짜의 일치하는 항목을 제외하는 규칙을 추가합니다.

매개변수

이름유형설명
dateDate

리턴

EventRecurrence: 연결을 위한 이 EventRecurrence

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

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

addMonthlyExclusion()

매월 일치하는 항목을 제외하는 규칙을 추가합니다.

기본적으로 제외는 시리즈의 첫 번째 이벤트와 같은 날에 적용되지만 onlyOnMonthDay(day) 또는 onlyOnMonthDays(days)를 호출하여 변경할 수 있습니다.

리턴

RecurrenceRule - 새 RecurrenceRule

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

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

addMonthlyRule()

매월 이벤트가 반복되도록 하는 규칙을 추가합니다.

기본적으로 이벤트는 시리즈의 첫 번째 이벤트와 같은 날에 반복되지만 onlyOnMonthDay(day) 또는 onlyOnMonthDays(days)를 호출하여 변경할 수 있습니다. 

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

리턴

RecurrenceRule - 새 RecurrenceRule

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

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

addWeeklyExclusion()

매주 일치하는 항목을 제외하는 규칙을 추가합니다.

기본적으로 제외는 시리즈의 첫 번째 이벤트와 같은 요일에 적용되지만 onlyOnWeekday(day) 또는 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);

리턴

RecurrenceRule - 새 RecurrenceRule

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

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

addWeeklyRule()

이벤트가 주 1회 반복되도록 규칙을 추가합니다.

기본적으로 이벤트는 시리즈의 첫 번째 이벤트와 같은 요일에 반복되지만 onlyOnWeekday(day) 또는 onlyOnWeekdays(days)를 호출하여 변경할 수 있습니다. 

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

리턴

RecurrenceRule - 새 RecurrenceRule

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

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

addYearlyExclusion()

1년 단위로 일치하는 항목을 제외하는 규칙을 추가합니다.

기본적으로 제외는 시리즈의 첫 번째 이벤트와 같은 날짜에 적용되지만 onlyOnYearDay(day) 또는 onlyOnYearDays(days)를 호출하여 변경할 수 있습니다.

리턴

RecurrenceRule - 새 RecurrenceRule

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

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

addYearlyRule()

매년 이벤트가 반복되도록 하는 규칙을 추가합니다.

기본적으로 이벤트는 시리즈의 첫 번째 이벤트와 같은 날에 반복되지만 onlyOnYearDay(day) 또는 onlyOnYearDays(days)를 호출하여 변경할 수 있습니다.

리턴

RecurrenceRule - 새 RecurrenceRule

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

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

interval(interval)

규칙의 시간 단위 중 이 간격에만 적용되도록 규칙을 구성합니다. 

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

매개변수

이름유형설명
intervalInteger규칙의 시간 단위의 간격

리턴

RecurrenceRule: 이 체이닝을 위한 RecurrenceRule

onlyInMonth(month)

특정 달에만 적용되도록 규칙을 구성합니다. 

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

매개변수

이름유형설명
monthMonth월

리턴

RecurrenceRule: 이 체이닝을 위한 RecurrenceRule

onlyInMonths(months)

특정 달에만 적용되도록 규칙을 구성합니다. 

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

매개변수

이름유형설명
monthsMonth[]월

리턴

RecurrenceRule: 이 체이닝을 위한 RecurrenceRule

onlyOnMonthDay(day)

매월 특정 날짜에만 적용되도록 규칙을 구성합니다. 

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

매개변수

이름유형설명
dayInteger날짜

리턴

RecurrenceRule: 이 체이닝을 위한 RecurrenceRule

onlyOnMonthDays(days)

그 달의 특정 날짜에만 적용되도록 규칙을 구성합니다. 

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

매개변수

이름유형설명
daysInteger[]해당 월의 날짜

리턴

RecurrenceRule: 이 체이닝을 위한 RecurrenceRule

onlyOnWeek(week)

일 년 중 특정 주에만 적용되도록 규칙을 구성합니다. 

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

매개변수

이름유형설명
weekInteger주

리턴

RecurrenceRule: 이 체이닝을 위한 RecurrenceRule

onlyOnWeekday(day)

특정 요일에만 적용되도록 규칙을 구성합니다. 

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

매개변수

이름유형설명
dayWeekday요일

리턴

RecurrenceRule: 이 체이닝을 위한 RecurrenceRule

onlyOnWeekdays(days)

특정 요일에만 적용되도록 규칙을 구성합니다. 

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

매개변수

이름유형설명
daysWeekday[]요일

리턴

RecurrenceRule: 이 체이닝을 위한 RecurrenceRule

onlyOnWeeks(weeks)

1년 중 특정 주에만 적용되도록 규칙을 구성합니다. 

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

매개변수

이름유형설명
weeksInteger[]주

리턴

RecurrenceRule: 이 체이닝을 위한 RecurrenceRule

onlyOnYearDay(day)

연중 특정 날짜에만 적용되도록 규칙을 구성합니다. 

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

매개변수

이름유형설명
dayInteger날짜

리턴

RecurrenceRule: 이 체이닝을 위한 RecurrenceRule

onlyOnYearDays(days)

연중 특정 요일에만 적용되도록 규칙을 구성합니다. 

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

매개변수

이름유형설명
daysInteger[]날짜

리턴

RecurrenceRule: 이 체이닝을 위한 RecurrenceRule

setTimeZone(timeZone)

반복의 시간대를 설정합니다. 이는 이벤트가 반복되는 날짜 및 시간 및 이벤트가 일광 절약 시간에 따라 변화하는지 여부에 영향을 미칩니다. 캘린더의 시간대로 기본 설정됩니다.

매개변수

이름유형설명
timeZoneString'long' 형식으로 지정된 시간대입니다 (예: 'America/New_York'(Joda.org에서 나열)

리턴

EventRecurrence: 연결을 위한 이 EventRecurrence

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

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

times(times)

지정된 횟수만큼 반복한 후에 종료되도록 규칙을 구성합니다. 

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

매개변수

이름유형설명
timesInteger반복 횟수

리턴

RecurrenceRule: 이 체이닝을 위한 RecurrenceRule

until(endDate)

지정된 날짜 (해당 날짜 포함)에 종료되도록 규칙을 구성합니다. 

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

매개변수

이름유형설명
endDateDate

리턴

RecurrenceRule: 이 체이닝을 위한 RecurrenceRule

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위에 대한 인증이 필요합니다.

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

weekStartsOn(day)

규칙을 적용하기 위해 한 주의 시작 요일을 구성합니다. 

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

매개변수

이름유형설명
dayWeekday한 주가 시작되는 요일

리턴

RecurrenceRule: 이 체이닝을 위한 RecurrenceRule