Package io.ultreia.java4all.util

Class Dates

  • public final class Dates
extends Object
    Created by tchemit on 29/12/2017.
    Author:
    Tony Chemit - dev@tchemit.fr

    • Constructor Detail

      • Dates

        public Dates()

    • Method Detail

      • formatDate

        public static String formatDate​(Date date,
                                String pattern)
        Format a date using the pattern in argument. The pattern is the same using for DateFormat object.
        Parameters:
        date - the date to format
        pattern - the pattern to use
        Returns:
        a String corresponding to the date formatted
        See Also:
        DateFormat

      • parseDate

        public static Date parseDate​(String date,
                             String pattern)
                      throws ParseException
        Parse a date using the pattern in argument. The pattern is the same using for DateFormat object.
        Parameters:
        date - the String to parse
        pattern - the pattern to use
        Returns:
        a Date corresponding to the String argument parsed
        Throws:
        ParseException - for parsing errors
        See Also:
        DateFormat

      • createDate

        public static Date createDate​(int s,
                              int m,
                              int h,
                              int dd,
                              int mm,
                              int yy)
        Create a new date from day, month and year (French version). The month is the real month of the year and not the one which is stored in Calendar object.
        Parameters:
        s - value of the seconds 1-60
        m - value of the minutes 1-60
        h - value of the hours 1-24
        dd - value of the day 1-31
        mm - value of the month 1-12
        yy - value of the year 0-9999
        Returns:
        a new date

      • createDate

        public static Date createDate​(int dd,
                              int mm,
                              int yy)
        Create a new date from day, month and year (French version). The month is the real month of the year and not the one which is stored in Calendar object. Time is set to 00:00:00.000
        Parameters:
        dd - value of the day 1-31
        mm - value of the month 1-12
        yy - value of the year 0-9999
        Returns:
        a new date

      • createDateAfterToday

        public static Date createDateAfterToday​(int ddStep,
                                        int mmStep,
                                        int yyStep)
        Create a new date after the current date (today) with modification on day, month and year. You can use negative values on arguments to have a date before today.
        Parameters:
        ddStep - nb days you want to increase from the current date
        mmStep - nb months you want to increase from the current date
        yyStep - nb years you want to increase from the current date
        Returns:
        a new date from the current date increase by days, months and years.

      • setLastDayOfMonth

        public static Date setLastDayOfMonth​(Date date)
        Set the last day of month to the date in argument. The value depends on the month of the date. (30 april, 28 february, ...)
        Parameters:
        date - Date to modify
        Returns:
        the date with day of month modified

      • setFirstDayOfMonth

        public static Date setFirstDayOfMonth​(Date date)
        Set the first day of month to the date in argument.
        Parameters:
        date - Date to modify
        Returns:
        the date with day of month modified

      • setLastDayOfYear

        public static Date setLastDayOfYear​(Date date)
        Set the last day of year to the date in argument.
        Parameters:
        date - Date to modify
        Returns:
        the date with day of year modified

      • setFirstDayOfYear

        public static Date setFirstDayOfYear​(Date date)
        Set the first day of year to the date in argument.
        Parameters:
        date - Date to modify
        Returns:
        the date with day of year modified

      • setMinTimeOfDay

        public static Date setMinTimeOfDay​(Date date)
        Set the min time of the day : 00:00:00.000.
        Parameters:
        date - to modify
        Returns:
        Date with the time set to the minimum in the day

      • setMaxTimeOfDay

        public static Date setMaxTimeOfDay​(Date date)
        Set the max time of the day. EUROPE : 23:59:59.999.
        Parameters:
        date - to modify
        Returns:
        Date with the time set to the maximum in the day

      • between

        public static boolean between​(Date myDate,
                              Date beforeDate,
                              Date afterDate)
        Check if the first date in argument is included between the two other dates. The argument myDate can be equals to beforeDate or afterDate to validate the includes.
        Parameters:
        myDate - the date to test
        beforeDate - the first date of the period to test
        afterDate - the second date of the period to test
        Returns:
        true if myDate is included between beforeDate and afterDate

      • currentPeriod

        public static boolean currentPeriod​(Date beforeDate,
                                    Date afterDate)
        Check if the current date is between the two dates in argument.
        Parameters:
        beforeDate - the first date of the period
        afterDate - the second date of the period
        Returns:
        true if the current date is included between the two dates, false otherwise
        See Also:
        between(Date, Date, Date)

      • getMonth

        public static int getMonth​(Date date)
        Get the month value from a date (between 0 and 11).
        Parameters:
        date - the date to extract month
        Returns:
        the month value of the date

      • getDifferenceInSeconds

        public static int getDifferenceInSeconds​(Date beginDate,
                                         Date endDate)
        Do the difference between the two dates in argument. The result is a number of seconds between the two dates.
        Parameters:
        beginDate - first date
        endDate - second date
        Returns:
        a number of seconds between beginDate and endDate

      • getDifferenceInMinutes

        public static int getDifferenceInMinutes​(Date beginDate,
                                         Date endDate)
        Do the difference between the two dates in argument. The result is a number of minutes between the two dates.
        Parameters:
        beginDate - first date
        endDate - second date
        Returns:
        a number of minutes between beginDate and endDate

      • getDifferenceInHours

        public static int getDifferenceInHours​(Date beginDate,
                                       Date endDate)
        Do the difference between the two dates in argument. The result is a number of hours between the two dates.
        Parameters:
        beginDate - first date
        endDate - second date
        Returns:
        a number of hours between beginDate and endDate

      • getDifferenceInDays

        public static int getDifferenceInDays​(Date beginDate,
                                      Date endDate)
        Do the difference between the two dates in argument. The result is a number of days between the two dates. Ex : 28/01/2009 and 08/02/2009 return 11.
        Parameters:
        beginDate - first date
        endDate - second date
        Returns:
        a number of days between beginDate and endDate

      • getDifferenceInMonths

        public static int getDifferenceInMonths​(Date beginDate,
                                        Date endDate)
        Do the difference between the two dates in argument. The result is a number of months between the two dates. Ex : 01/01/2009 and 28/02/2009 return 2 months. Warning, if beginDate is inferior to endDate, the result will be 1 minimum
        Parameters:
        beginDate - first date
        endDate - second date
        Returns:
        a number of months between beginDate and endDate

      • getAge

        public static int getAge​(Date birthDate)
        Get the age of a person born on the date in argument. The result is a number of years between the birth date and now. Ex : 01/01/2000 returns 11 years (now date is 26/10/2011).
        Parameters:
        birthDate - birth date
        Returns:
        a number of years between birthDate and now

      • getMonthLibelle

        public static String getMonthLibelle​(int monthNumber,
                                     Locale locale)
        Get libelle of the month corresponding to the number given in argument.
        Parameters:
        monthNumber - between 1-12
        locale - Locale for language support
        Returns:
        a String corresponding to the libelle of the month

      • getMonthLibelle

        public static String getMonthLibelle​(int monthNumber)
        Get libelle of the month corresponding to the number given in argument.
        Parameters:
        monthNumber - between 1-12
        Returns:
        a String corresponding to the libelle of the month

      • getYesterday

        public static Date getYesterday​(Date date)
        Get the date before today
        Parameters:
        date - concerned
        Returns:
        Date before today

      • getDefaultCalendar

        public static Calendar getDefaultCalendar​(Date date)
        Get the calendar corresponding to the date. The default calendar will be returned (default time zone and locale).
        Parameters:
        date - used to set the calendar time
        Returns:
        the default calendar with time corresponding to the date

      • truncateToDayOfWeek

        public static Date truncateToDayOfWeek​(Date date)
        Truncate a date to its week (to monday). It's equivalent to a call to org.apache.commons.lang3.time.DateUtils#truncate(Date, int) and giving Calendar.DAY_OF_WEEK argument, but such a call raise an exception showing that this field is not supported. This method allows you to bypass this limitation.
        Parameters:
        date - any date
        Returns:
        a date in the same week as given date, a monday. All field below (hours, secondes, ms) are zeroed.

      • getDay

        public static Date getDay​(Date date)
        Enleve les données des heures (hour, minute, second, milli = 0).
        Parameters:
        date - la date a modifier
        Returns:
        la date d'un jour

      • getEndOfDay

        public static Date getEndOfDay​(Date date)
        Positionne une date sur la fin d'un jour
        Parameters:
        date - la date a modifier
        Returns:
        la date d'un jour

      • getDateAndTime

        public static Date getDateAndTime​(Date day,
                                  Date time,
                                  boolean useSecond,
                                  boolean useMiliSecond)
        Créer la date qui utilise le jour donné dans day et l'heure donnée dans time.
        Parameters:
        day - le jour à utiliser
        time - l'heure a utiliser
        useSecond - FIXME
        useMiliSecond - FIXME
        Returns:
        la date donnée avec l'heure courante

      • getTime

        public static Date getTime​(Date dayTime,
                           boolean useSecond,
                           boolean useMiliSecond)
        Créer la date qui utilise uniquement l'heure donnée dans dayTime.
        Parameters:
        dayTime - l'heure a utiliser
        useSecond - FIXME
        useMiliSecond - FIXME
        Returns:
        la date donnée avec uniquement l'heure courante