ig.scheduler.DateRecurrence

Generates a recurring date pattern.

Remarks

The DateRecurrence class is used to generate dates based on a formulaic pattern.

An instance of this class can be created from an iCalendar conformant string which represents an recurrence rule (see the iCalendar RRULE expression) using the DateRecurrence.fromICalendarString method.

To provide bi-directional serialization support, an iCalendar conformant string can be generated from an instance of this class using the DateRecurrence.toICalendarString method.

To make an activity such as an Appointment recurring, assign an iCalendar conformant string to the ActivityBase.recurrence property.

Dependencies

jquery-1.4.4.js
infragistics.util.js
infragistics.ext_core.js
infragistics.ext_collections.js
infragistics.ext_collectionsExtended.js
infragistics.ext_io.js
infragistics.ext_text.js
infragistics.ext_web.js
infragistics.dv_core.js
infragistics.dv_jquerydom.js
infragistics.dv_interactivity.js
infragistics.ext_ui.js
The current widget has no options.
The current widget has no events.
  • ig.scheduler.DateRecurrence
    Constructor

    new $.ig.scheduler.DateRecurrence( );

    Creates a new instance with default values.

  • ig.scheduler.DateRecurrence
    Constructor

    new $.ig.scheduler.DateRecurrence( frequency:ig.scheduler.DateRecurrenceFrequency );

    Creates a new instance with the specified DateRecurrence.frequency.

    • frequency
    • Type:ig.scheduler.DateRecurrenceFrequency
    • The value of the DateRecurrence.frequency property; specifies the frequency at which occurrences are generated, i.e., daily, weekly, monthly, etc.
  • count

    .count( );

    Specifies the maximum number of occurrences this instance generates.

    Remarks

    A DateRecurrence can be limited by either a specific number of occurrences, or by a specific date after which no occurrences will be generated.

    Use the DateRecurrence.until property to limit the occurrences generated by a specific date.

    Note that the Count property and the DateRecurrence.until property are mutually exclusive; setting both properties causes undefined behavior.

  • count

    .count( value:number );

    Specifies the maximum number of occurrences this instance generates.

    • value
    • Type:number

    Remarks

    A DateRecurrence can be limited by either a specific number of occurrences, or by a specific date after which no occurrences will be generated.

    Use the DateRecurrence.until property to limit the occurrences generated by a specific date.

    Note that the Count property and the DateRecurrence.until property are mutually exclusive; setting both properties causes undefined behavior.

  • equals

    .equals( obj:object );
    Return Type:
    boolean
    Return Type Description:
    True if the specified object equals this object. False otherwise.

    Overridden. Returns true if the specified object equals this object.

    • obj
    • Type:object
    • Object to compare to.
  • frequency

    .frequency( );
    Return Type:
    ig.scheduler.DateRecurrenceFrequency
    Return Type Description:
    Returns a DateRecurrenceFrequency.

    Specifies the frequency at which occurrences are generated, i.e., daily, weekly, monthly, etc.

  • frequency

    .frequency( value:ig.scheduler.DateRecurrenceFrequency );
    Return Type:
    ig.scheduler.DateRecurrenceFrequency
    Return Type Description:
    Returns a DateRecurrenceFrequency.

    Specifies the frequency at which occurrences are generated, i.e., daily, weekly, monthly, etc.

    • value
    • Type:ig.scheduler.DateRecurrenceFrequency
  • fromICalendarString

    .fromICalendarString( recurrence:string );
    Return Type:
    ig.scheduler.DateRecurrence
    Return Type Description:
    A DateRecurrence instance.

    Parses the specified string, assumed to conform to the iCalendar recurrence specification, into a DateRecurrence instance.

    • recurrence
    • Type:string
    • A string presumed to be in the iCalendar recurrence format.

    Remarks

    If the specified string is invalid, an exception is thrown, containing information about what part of the string was malformed or otherwise invalid.

  • getHashCode

    .getHashCode( );
    Return Type:
    number
    Return Type Description:
    Hash code of the object.

    Overridden. Returns the hash code of this object.

  • interval

    .interval( );

    Specifies the interval at which occurrences appear. A value of one (default) indicates that the DateRecurrence.frequency property alone drives occurrence generation.

    Remarks

    The Interval property provides a way to allow occurrences that would ordinarily appear to be "skipped". For example, assigning a value of two to this property means "every other" occurrence that would normally be generated is skipped. A value of three causes two slots to be skipped.

  • interval

    .interval( value:number );

    Specifies the interval at which occurrences appear. A value of one (default) indicates that the DateRecurrence.frequency property alone drives occurrence generation.

    • value
    • Type:number

    Remarks

    The Interval property provides a way to allow occurrences that would ordinarily appear to be "skipped". For example, assigning a value of two to this property means "every other" occurrence that would normally be generated is skipped. A value of three causes two slots to be skipped.

  • raisePropertyChangedEvent

    .raisePropertyChangedEvent( propertyName:string );

    Raises the DateRecurrence.propertyChanged event.

    • propertyName
    • Type:string
    • The name of the property whose value has changed.
  • rules

    .rules( );
    Return Type:
    ig.scheduler.RulesCollection
    Return Type Description:
    Returns a RulesCollection.

    Specifies additional rules which affect the generation of occurrences.

    Remarks

    Recurrence rules can be used to specify additional criteria for occurrence generation. For example, you can specify one or more rules to indicate that occurrence generation should be restricted to a specific month, week, day of the week, etc.

    Depending on their combination, recurrence rules can limit or expand the number of occurrences.

  • rules

    .rules( index:number );
    Return Type:
    ig.scheduler.DateRecurrenceRuleBase
    Return Type Description:
    Returns a DateRecurrenceRuleBase.

    • index
    • Type:number
  • rules

    .rules( index:number, value:ig.scheduler.DateRecurrenceRuleBase );
    Return Type:
    ig.scheduler.DateRecurrenceRuleBase
    Return Type Description:
    Returns a DateRecurrenceRuleBase.

    • index
    • Type:number
    • value
    • Type:ig.scheduler.DateRecurrenceRuleBase
  • toICalendarString

    .toICalendarString( );
    Return Type:
    string
    Return Type Description:
    String that describes this DateRecurrence.

    Converts this DateRecurrence to its iCalendar string representation.

  • toICalendarString

    .toICalendarString( recurrence:ig.scheduler.DateRecurrence );
    Return Type:
    string
    Return Type Description:
    String that describes the specified DateRecurrence.

    Converts the specified DateRecurrence to its iCalendar string representation.

    • recurrence
    • Type:ig.scheduler.DateRecurrence
    • DateRecurrence instance to convert to string representation.
  • toString

    .toString( );
    Return Type:
    string
    Return Type Description:
    Text that describes the recurrence.

    Returns a human-readable description of this recurrence.

  • toStringWithStartDate

    .toStringWithStartDate( startDate:ig.Date, [cultureName:string] );
    Return Type:
    string
    Return Type Description:
    A human-readable description of the recurrence pattern.

    Returns a string representation of the recurrence based on the specified start date.

    • startDate
    • Type:ig.Date
    • The start date of the recurrence
    • cultureName
    • Type:string
    • Optional
    • Optional; the ISO-639 compliant language code which identifies the language culture. For example, English language with United States dialect is 'en-US'; Japanese is 'ja-JP'; French is 'fr-FR', etc. Specify null to use the local machine's current language culture.
  • toStringWithStartDateAndTimes

    .toStringWithStartDateAndTimes( startDate:ig.Date, startTime:ig.Date, endTime:ig.Date, [cultureName:string] );
    Return Type:
    string
    Return Type Description:
    A human-readable description of the recurrence pattern.

    Returns a string representation of the recurrence based on the specified start date.

    • startDate
    • Type:ig.Date
    • The start date of the recurrence or null.
    • startTime
    • Type:ig.Date
    • The start time of each recurrence instance or null.
    • endTime
    • Type:ig.Date
    • The end time of each recurrence instance or null.
    • cultureName
    • Type:string
    • Optional
    • Optional; the ISO-639 compliant language code which identifies the language culture. For example, English language with United States dialect is 'en-US'; Japanese is 'ja-JP'; French is 'fr-FR', etc. Specify null to use the local machine's current language culture.
  • until

    .until( );

    Specifies the maximum date after which no occurrences will be generated.

    Remarks

    A DateRecurrence can be limited by either a specific number of occurrences, or by a specific date, after which no occurrences will be generated.

    Use the DateRecurrence.count property to limit the maximum number of occurrences that will be generated.

    Note that the Count property and the DateRecurrence.until property are mutually exclusive; setting both properties causes undefined behavior.

  • until

    .until( value:ig.Date );

    Specifies the maximum date after which no occurrences will be generated.

    • value
    • Type:ig.Date

    Remarks

    A DateRecurrence can be limited by either a specific number of occurrences, or by a specific date, after which no occurrences will be generated.

    Use the DateRecurrence.count property to limit the maximum number of occurrences that will be generated.

    Note that the Count property and the DateRecurrence.until property are mutually exclusive; setting both properties causes undefined behavior.

  • weekStart

    .weekStart( );

    Specifies the first day of the week for this recurrence pattern.

    Remarks

    This property has implications when applying certain rules, such as a WeekOfYearRecurrenceRule, regarding when the first week of the year starts. The first week of the year is considered to be the first week that has at least 4 days in that year. Note that the default value of this property is Monday.
  • weekStart

    .weekStart( value:ig.DayOfWeek );

    Specifies the first day of the week for this recurrence pattern.

    • value
    • Type:ig.DayOfWeek

    Remarks

    This property has implications when applying certain rules, such as a WeekOfYearRecurrenceRule, regarding when the first week of the year starts. The first week of the year is considered to be the first week that has at least 4 days in that year. Note that the default value of this property is Monday.

Copyright © 1996 - 2024 Infragistics, Inc. All rights reserved.