Package org.opencms.gwt.client.ui.input.datebox

Class CmsDateConverter

java.lang.Object
org.opencms.gwt.client.ui.input.datebox.CmsDateConverter
public final class CmsDateConverter extends Object
This class is an Helper with mostly static methods that convert a given date object or that convert a given String.

  • Field Details

  • Method Details

    • cutSuffix

      public static String cutSuffix(String time)
      Cuts the suffix (am or pm) from a given time String.

      If the given String has less than 5 characters an dosen't contains an am or pm in it the original String is returned.

      Parameters:
      time - the time String to cut the suffix from
      Returns:
      the time String without the suffix or the original String if the format of the String is incorrect

    • dateToString

      public static String dateToString(Date date)
      Formats the provided date to a date only representation.

      Parameters:
      date - the date to format
      Returns:
      the formatted date as a string

    • getDateWithTime

      public static Date getDateWithTime(Date date, String time)
      Merges a given Date object with a given time String.

      Returns a null if the given time format coudn't be parsed.

      The expected time String should include the am pm information if the time format is in 12 hour presentation.

      Parameters:
      date - the given Date object which time has to be set
      time - the given time String which should be inserted into the Date Object
      Returns:
      the merged date Object

    • getDateWithTime

      public static Date getDateWithTime(Date date, String time, com.google.gwt.i18n.client.DateTimeFormat timeFormat)
      Changes the time portion of date to another value.
      Parameters:
      date - the original date
      time - the string representing the time to be set in the result
      timeFormat - the format to use for parsing the time
      Returns:
      a new Date with the date from the date parameter and the time from the time parameter.

    • getTime

      public static String getTime(Date date)
      Returns the short time format of a given date as String.

      Parameters:
      date - the date to get the short time format from
      Returns:
      the short time format of a given date

    • is12HourPresentation

      public static boolean is12HourPresentation()
      Returns true if the current date format is in the 12 hour representation mode false otherwise.

      Returns:
      true if an am or a pm is in a new Date object false otherwise

    • isAm

      public static boolean isAm(Date date)
      Returns true if an am is in the given date object false otherwise.

      Parameters:
      date - the date to check
      Returns:
      true if an am is in the given Date object false otherwise

    • toDate

      public static Date toDate(String dateText) throws Exception
      Parses the provided String as a date.

      First try to parse the String with the given time format.

      If that fails try to parse the date with the browser settings.

      Parameters:
      dateText - the string representing a date
      Returns:
      the date created, or null if there was a parse error
      Throws:
      Exception - in case the text can not be parsed to a date

    • toDateString

      public static String toDateString(Date date)
      Formats the provided date as only a date format (dd/mm/yyyy). Note, a null date is a possible input.
      Parameters:
      date - the date to format
      Returns:
      the formatted date as a string

    • toDayDate

      public static Date toDayDate(String dateText) throws Exception
      Parses the provided String as a date.

      First try to parse the String with the given time format.

      If that fails try to parse the date with the browser settings.

      Parameters:
      dateText - the string representing a date
      Returns:
      the date created, or null if there was a parse error
      Throws:
      Exception - in case the text can not be parsed to a date

    • toString

      public static String toString(Date date)
      Formats the provided date. Note, a null date is a possible input.
      Parameters:
      date - the date to format
      Returns:
      the formatted date as a string

    • validateDate

      public static boolean validateDate(Date date)
      Validates a time String if it matches one of the two regular expressions.

      Returns true if the given date matches to one of the regular expressions, false otherwise.

      Parameters:
      date - the date String to check
      Returns:
      true if the given time matches to one of the regular expressions, false otherwise

    • validateTime

      public static boolean validateTime(String time)
      Validates a time String if it matches the regular expressions.

      Returns true if the given time matches the regular expressions, false otherwise.

      Parameters:
      time - the time String to check
      Returns:
      true if the given time matches the regular expressions, false otherwise