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이벤트가 매주 반복되도록 하는 규칙을 추가합니다.
addYearlyExclusion()RecurrenceRule매년 일치하는 항목을 제외하는 규칙을 추가합니다.
addYearlyRule()RecurrenceRule이벤트가 매년 반복되도록 하는 규칙을 추가합니다.
interval(interval)RecurrenceRule규칙의 시간 단위 중 이 간격에만 적용되도록 규칙을 구성합니다.
onlyInMonth(month)RecurrenceRule특정 달에만 적용되도록 규칙을 구성합니다.
onlyInMonths(months)RecurrenceRule특정 달에만 적용되도록 규칙을 구성합니다.
onlyOnMonthDay(day)RecurrenceRule해당 월의 특정 날짜에만 적용되도록 규칙을 구성합니다.
onlyOnMonthDays(days)RecurrenceRule해당 월의 특정 날짜에만 적용되도록 규칙을 구성합니다.
onlyOnWeek(week)RecurrenceRule1년 중 특정 주에만 적용되도록 규칙을 구성합니다.
onlyOnWeekday(day)RecurrenceRule특정 요일에만 적용되도록 규칙을 구성합니다.
onlyOnWeekdays(days)RecurrenceRule특정 요일에만 적용되도록 규칙을 구성합니다.
onlyOnWeeks(weeks)RecurrenceRule1년 중 특정 주에만 적용되도록 규칙을 구성합니다.
onlyOnYearDay(day)RecurrenceRule1년 중 특정 날짜에만 적용되도록 규칙을 구성합니다.
onlyOnYearDays(days)RecurrenceRule1년 중 특정 요일에만 적용되도록 규칙을 구성합니다.
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()

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

기본적으로 일정은 반복 일정의 첫 번째 일정과 같은 요일에 반복됩니다. 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()

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

기본적으로 제외는 계열이지만 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)

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

// 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)

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

// 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)

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

// 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