Class DateTool


  • public class DateTool
    extends org.apache.velocity.tools.generic.DateTool
    Utility class to handle dates from inside the Automation
    Since:
    7.3
    Author:
    Marco Meschieri - LogicalDOC
    • Field Summary

      • Fields inherited from class org.apache.velocity.tools.generic.DateTool

        DEFAULT_FORMAT_KEY, DEFAULT_LOCALE_KEY, TIMEZONE_KEY
      • Fields inherited from class org.apache.velocity.tools.generic.FormatConfig

        DEFAULT_FORMAT, FORMAT_KEY
      • Fields inherited from class org.apache.velocity.tools.generic.LocaleConfig

        DEFAULT_LOCALE
      • Fields inherited from class org.apache.velocity.tools.generic.SafeConfig

        LOCK_CONFIG_KEY, OLD_LOCK_CONFIG_KEY, SAFE_MODE_KEY
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      Date addDays​(Date src, int amount)
      Adds a given amount of days to a date(you can add negative values to go back in time)
      Date addMilliseconds​(Date src, int amount)
      Adds a given amount of milliseconds to a date(you can add negative values to go back in time)
      Date addMinutes​(Date src, int amount)
      Adds a given amount of minutes to a date(you can add negative values to go back in time)
      Date addMonths​(Date src, int amount)
      Adds a given amount of months to a date(you can add negative values to go back in time)
      Date addSeconds​(Date src, int amount)
      Adds a given amount of seconds to a date(you can add negative values to go back in time)
      Date addYears​(Date src, int amount)
      Adds a given amount of years to a date(you can add negative values to go back in time)
      Date currentTime()
      Gets the current time
      String format​(Date date, boolean time)
      Formats a date
      String format​(Date date, String format)
      Formats a date using a specific format
      String formatISO​(Date date)
      Formats a date using the ISO format: yyyy-MM-dd'T'HH:mm:ss
      String getDateFormatLong()
      Retrieves the default date format with time specification
      String getDateFormatShort()
      Retrieves the default date format without time specification
      Date parse​(String date, String format)
      Parses a string and to retrieve a date
      void setDateFormatLong​(String dateFormatLong)
      Sets the default long format(date with time)
      void setDateFormatShort​(String dateFormatShort)
      Sets the default short format(date without time)
      long toDays​(long ms)
      Calculates how many days are contained in a given amount of milliseconds
      long toHours​(long ms)
      Calculates how many hours are contained in a given amount of milliseconds
      long toMinutes​(long ms)
      Calculates how many minutes are contained in a given amount of milliseconds
      long toMonths​(long ms)
      Calculates how many months are contained in a given amount of milliseconds
      long toSeconds​(long ms)
      Calculates how many seconds are contained in a given amount of milliseconds
      long toWeeks​(long ms)
      Calculates how many weeks are contained in a given amount of milliseconds
      long toYears​(long ms)
      Calculates how many years are contained in a given amount of milliseconds
      • Methods inherited from class org.apache.velocity.tools.generic.DateTool

        format, format, format, format, format, format, format, get, get, getCalendar, getDate, getDateFormat, getDateFormat, getDay, getDay, getMonth, getMonth, getSystemCalendar, getSystemDate, getSystemTime, getTimeZone, getValue, getValue, getValue, getYear, getYear, toCalendar, toCalendar, toDate, toDate, toDate, toDate, toString
      • Methods inherited from class org.apache.velocity.tools.generic.FormatConfig

        getFormat
      • Methods inherited from class org.apache.velocity.tools.generic.LocaleConfig

        getLocale
      • Methods inherited from class org.apache.velocity.tools.generic.SafeConfig

        configure, isConfigLocked, isSafeMode
    • Constructor Detail

      • DateTool

        public DateTool​(String dateFormatLong,
                        String dateFormatShort)
      • DateTool

        public DateTool()
    • Method Detail

      • format

        public String format​(Date date,
                             boolean time)
        Formats a date
        Parameters:
        date - the date to format
        time - if the output must contain the time also
        Returns:
        the formatted string
      • formatISO

        public String formatISO​(Date date)
        Formats a date using the ISO format: yyyy-MM-dd'T'HH:mm:ss
        Parameters:
        date - the date to format
        Returns:
        the formatted string
      • format

        public String format​(Date date,
                             String format)
        Formats a date using a specific format
        Parameters:
        date - the date to format
        format - the format to use eg: dd/MM/yyyy
        Returns:
        the formatted string
        See Also:
        SimpleDateFormat
      • parse

        public Date parse​(String date,
                          String format)
        Parses a string and to retrieve a date
        Parameters:
        date - string to parse
        format - the format to use
        Returns:
        the parsed date
        See Also:
        SimpleDateFormat
      • getDateFormatShort

        public String getDateFormatShort()
        Retrieves the default date format without time specification
        Returns:
        the default date short format
      • setDateFormatShort

        public void setDateFormatShort​(String dateFormatShort)
        Sets the default short format(date without time)
        Parameters:
        dateFormatShort - the short format
      • getDateFormatLong

        public String getDateFormatLong()
        Retrieves the default date format with time specification
        Returns:
        the default date long format
      • setDateFormatLong

        public void setDateFormatLong​(String dateFormatLong)
        Sets the default long format(date with time)
        Parameters:
        dateFormatLong - the long format
      • currentTime

        public Date currentTime()
        Gets the current time
        Returns:
        the current time
      • addYears

        public Date addYears​(Date src,
                             int amount)
        Adds a given amount of years to a date(you can add negative values to go back in time)
        Parameters:
        src - the date to use
        amount - number of years
        Returns:
        the new date
      • addMonths

        public Date addMonths​(Date src,
                              int amount)
        Adds a given amount of months to a date(you can add negative values to go back in time)
        Parameters:
        src - the date to use
        amount - number of months
        Returns:
        the new date
      • addDays

        public Date addDays​(Date src,
                            int amount)
        Adds a given amount of days to a date(you can add negative values to go back in time)
        Parameters:
        src - the date to use
        amount - number of days
        Returns:
        the new date
      • addMinutes

        public Date addMinutes​(Date src,
                               int amount)
        Adds a given amount of minutes to a date(you can add negative values to go back in time)
        Parameters:
        src - the date to use
        amount - number of minutes
        Returns:
        the new date
      • addSeconds

        public Date addSeconds​(Date src,
                               int amount)
        Adds a given amount of seconds to a date(you can add negative values to go back in time)
        Parameters:
        src - the date to use
        amount - number of seconds
        Returns:
        the new date
      • addMilliseconds

        public Date addMilliseconds​(Date src,
                                    int amount)
        Adds a given amount of milliseconds to a date(you can add negative values to go back in time)
        Parameters:
        src - the date to use
        amount - number of milliseconds
        Returns:
        the new date
      • toDays

        public long toDays​(long ms)
        Calculates how many days are contained in a given amount of milliseconds
        Parameters:
        ms - the milliseconds
        Returns:
        number of days
      • toHours

        public long toHours​(long ms)
        Calculates how many hours are contained in a given amount of milliseconds
        Parameters:
        ms - the milliseconds
        Returns:
        number of hours
      • toMinutes

        public long toMinutes​(long ms)
        Calculates how many minutes are contained in a given amount of milliseconds
        Parameters:
        ms - the milliseconds
        Returns:
        number of minutes
      • toMonths

        public long toMonths​(long ms)
        Calculates how many months are contained in a given amount of milliseconds
        Parameters:
        ms - the milliseconds
        Returns:
        number of months
      • toSeconds

        public long toSeconds​(long ms)
        Calculates how many seconds are contained in a given amount of milliseconds
        Parameters:
        ms - the milliseconds
        Returns:
        number of seconds
      • toWeeks

        public long toWeeks​(long ms)
        Calculates how many weeks are contained in a given amount of milliseconds
        Parameters:
        ms - the milliseconds
        Returns:
        number of weeks
      • toYears

        public long toYears​(long ms)
        Calculates how many years are contained in a given amount of milliseconds
        Parameters:
        ms - the milliseconds
        Returns:
        number of years