Package org.zkoss.zul.impl

Class DateTimeFormatInputElement

    • Field Detail

      • _locale

        protected java.util.Locale _locale

      • _tzone

        protected java.util.TimeZone _tzone

    • Constructor Detail

      • DateTimeFormatInputElement

        public DateTimeFormatInputElement()

    • Method Detail

      • getLocale

        public java.util.Locale getLocale()
        Returns the locale associated with this component, or null if Locales.getCurrent() is preferred.
        Since:
        5.0.7

      • setLocale

        public void setLocale​(java.util.Locale locale)
        Sets the locale used to identify the format of this component.

        Default: null (i.e., Locales.getCurrent(), the current locale is assumed)

        Since:
        5.0.7

      • setLocale

        public void setLocale​(java.lang.String locale)
        Sets the locale used to identify the format of this component.

        Default: null (i.e., Locales.getCurrent(), the current locale is assumed)

        Since:
        5.0.7

      • getTimeZone

        public java.util.TimeZone getTimeZone()
        Returns the time zone that this component belongs to, or null if the default time zone is used.

        The default time zone is determined by TimeZones.getCurrent().

      • setTimeZone

        public void setTimeZone​(java.util.TimeZone tzone)
        Sets the time zone that this component belongs to, or null if the default time zone is used.

        The default time zone is determined by TimeZones.getCurrent().

      • setTimeZone

        public void setTimeZone​(java.lang.String id)
        Sets the time zone that this component belongs to, or null if the default time zone is used.

        The default time zone is determined by TimeZones.getCurrent().

        Parameters:
        id - the time zone's ID, such as "America/Los_Angeles". The time zone will be retrieved by calling TimeZone.getTimeZone(id).

      • getZoneId

        protected java.time.ZoneId getZoneId()

      • getValue

        public java.util.Date getValue()
                        throws WrongValueException
        Returns the value (in Date), might be null unless a constraint stops it.
        Throws:
        WrongValueException - if user entered a wrong value

      • setValue

        public void setValue​(java.util.Date value)
              throws WrongValueException
        Sets the value (in Date).
        Parameters:
        value - the date to be assigned to this component.
        Notice that, if this component does not allow users to select the time (i.e., the format limited to year, month and day), the date specified here is better to set hour, minutes, seconds and milliseconds to zero (for the current timezone, TimeZones.getCurrent()), so it is easier to work with other libraries, such as SQL. Dates has a set of utilities to simplify the task.
        Throws:
        WrongValueException - if value is wrong

      • getValueInZonedDateTime

        public java.time.ZonedDateTime getValueInZonedDateTime()
                                                throws WrongValueException
        Returns the value (in ZonedDateTime), might be null unless a constraint stops it.
        Throws:
        WrongValueException - if user entered a wrong value
        Since:
        9.0.0

      • setValueInZonedDateTime

        public void setValueInZonedDateTime​(java.time.ZonedDateTime value)
                             throws WrongValueException
        Sets the value (in ZonedDateTime).
        Parameters:
        value - the date to be assigned to this component.
        Notice that, if this component does not allow users to select the time (i.e., the format limited to year, month and day), the date specified here is better to set hour, minutes, seconds and milliseconds to zero (for the current timezone, TimeZones.getCurrent()), so it is easier to work with other libraries, such as SQL. Dates has a set of utilities to simplify the task.
        Throws:
        WrongValueException - if value is wrong
        Since:
        9.0.0

      • getValueInLocalDateTime

        public java.time.LocalDateTime getValueInLocalDateTime()
                                                throws WrongValueException
        Returns the value (in LocalDateTime), might be null unless a constraint stops it.
        Throws:
        WrongValueException - if user entered a wrong value
        Since:
        9.0.0

      • setValueInLocalDateTime

        public void setValueInLocalDateTime​(java.time.LocalDateTime value)
                             throws WrongValueException
        Sets the value (in LocalDateTime).
        Parameters:
        value - the date to be assigned to this component.
        Notice that, if this component does not allow users to select the time (i.e., the format limited to year, month and day), the date specified here is better to set hour, minutes, seconds and milliseconds to zero (for the current timezone, TimeZones.getCurrent()), so it is easier to work with other libraries, such as SQL. Dates has a set of utilities to simplify the task.
        Throws:
        WrongValueException - if value is wrong
        Since:
        9.0.0

      • getValueInLocalDate

        public java.time.LocalDate getValueInLocalDate()
                                        throws WrongValueException
        Returns the value (in LocalDate), might be null unless a constraint stops it.
        Throws:
        WrongValueException - if user entered a wrong value
        Since:
        9.0.0

      • setValueInLocalDate

        public void setValueInLocalDate​(java.time.LocalDate value)
                         throws WrongValueException
        Sets the value (in LocalDate).
        Parameters:
        value - the date to be assigned to this component.
        Notice that, if this component does not allow users to select the time (i.e., the format limited to year, month and day), the date specified here is better to set hour, minutes, seconds and milliseconds to zero (for the current timezone, TimeZones.getCurrent()), so it is easier to work with other libraries, such as SQL. Dates has a set of utilities to simplify the task.
        Throws:
        WrongValueException - if value is wrong
        Since:
        9.0.0

      • getValueInLocalTime

        public java.time.LocalTime getValueInLocalTime()
                                        throws WrongValueException
        Returns the value (in LocalTime), might be null unless a constraint stops it.
        Throws:
        WrongValueException - if user entered a wrong value
        Since:
        9.0.0

      • setValueInLocalTime

        public void setValueInLocalTime​(java.time.LocalTime value)
                         throws WrongValueException
        Sets the value (in LocalTime).
        Parameters:
        value - the date to be assigned to this component.
        Notice that, if this component does not allow users to select the time (i.e., the format limited to year, month and day), the date specified here is better to set hour, minutes, seconds and milliseconds to zero (for the current timezone, TimeZones.getCurrent()), so it is easier to work with other libraries, such as SQL. Dates has a set of utilities to simplify the task.
        Throws:
        WrongValueException - if value is wrong
        Since:
        9.0.0

      • toZonedDateTime

        protected java.time.ZonedDateTime toZonedDateTime​(java.util.Date value)

      • toDate

        protected java.util.Date toDate​(java.time.LocalDateTime value)

      • toDate

        protected java.util.Date toDate​(java.time.LocalDate value)

      • toDate

        protected java.util.Date toDate​(java.time.LocalTime value)