Class DtEnd<T extends Temporal>

  • All Implemented Interfaces:
    Serializable, Comparable<Property>, FluentProperty

    public class DtEnd<T extends Temporal>
    extends DateProperty<T>
    $Id$

    Created: [Apr 6, 2004]

    Defines a DTEND iCalendar component property.

         4.8.2.2 Date/Time End
    
            Property Name: DTEND
    
            Purpose: This property specifies the date and time that a calendar
            component ends.
    
            Value Type: The default value type is DATE-TIME. The value type can
            be set to a DATE value type.
    
            Property Parameters: Non-standard, value data type, time zone
            identifier property parameters can be specified on this property.
    
            Conformance: This property can be specified in "VEVENT" or
            "VFREEBUSY" calendar components.
    
            Description: Within the "VEVENT" calendar component, this property
            defines the date and time by which the event ends. The value MUST be
            later in time than the value of the "DTSTART" property.
    
            Within the "VFREEBUSY" calendar component, this property defines the
            end date and time for the free or busy time information. The time
            MUST be specified in the UTC time format. The value MUST be later in
            time than the value of the "DTSTART" property.
    
            Format Definition: The property is defined by the following notation:
    
              dtend      = "DTEND" dtendparam":" dtendval CRLF
    
              dtendparam = *(
    
                         ; the following are optional,
                         ; but MUST NOT occur more than once
    
                         (";" "VALUE" "=" ("DATE-TIME" / "DATE")) /
                         (";" tzidparam) /
    
                         ; the following is optional,
                         ; and MAY occur more than once
    
                         (";" xparam)
    
                         )
    
    
    
              dtendval   = date-time / date
              ;Value MUST match value type
     

    Examples:

          // construct an end date from a start date and a duration..
          DtStart start = ...
          Dur oneWeek = new Dur("1W");
          DtEnd end = new DtEnd(oneWeek.getTime(start.getDate());
     
    See Also:
    Serialized Form
    • Constructor Detail

      • DtEnd

        public DtEnd()
        Default constructor. The time value is initialised to the time of instantiation.
      • DtEnd

        public DtEnd​(String value)
        Creates a new instance initialised with the parsed value.
        Parameters:
        value - the DTEND value string to parse
      • DtEnd

        public DtEnd​(ParameterList aList,
                     String aValue)
        Parameters:
        aList - a list of parameters for this component
        aValue - a value string for this component
      • DtEnd

        public DtEnd​(T aDate)
        Constructor. Date or Date-Time format is determined based on the presence of a VALUE parameter.
        Parameters:
        aDate - a date
      • DtEnd

        @Deprecated
        public DtEnd​(T time,
                     boolean utc)
        Deprecated.
        UTC time is now specified via the generic type (i.e. Instant)
        Constructs a new DtEnd with the specified time.
        Parameters:
        time - the time of the DtEnd
        utc - specifies whether time is UTC
      • DtEnd

        public DtEnd​(ParameterList aList,
                     T aDate)
        Constructor. Date or Date-Time format is determined based on the presence of a VALUE parameter.
        Parameters:
        aList - a list of parameters for this component
        aDate - a date
    • Method Detail

      • newFactory

        protected PropertyFactory<DtEnd<T>> newFactory()
        Description copied from class: Property
        Returns a new property factory used to create deep copies.
        Specified by:
        newFactory in class Property
        Returns:
        a property factory instance