Package com.vaadin.client

Class DateTimeService

  • public class DateTimeService
extends Object
    This class provides date/time parsing services to all components on the client side.
    Author:
    Vaadin Ltd.

    • Constructor Detail

      • DateTimeService

        public DateTimeService()
        Creates a new date time service with the application default locale.

    • Method Detail

      • asTwoDigits

        public static String asTwoDigits​(int i)
        Utility method to format positive int as zero-padded two-digits number.
        Parameters:
        i - the value
        Returns:
        "00".."99"
        Since:
        8.4

      • getLocale

        public String getLocale()

      • getMonth

        public String getMonth​(int month)

      • getShortMonth

        public String getShortMonth​(int month)

      • getDay

        public String getDay​(int day)

      • getShortDay

        public String getShortDay​(int day)
        Returns the localized short name of the specified day.
        Parameters:
        day - the day, 0 is SUNDAY
        Returns:
        the localized short name

      • getFirstDayOfWeek

        public int getFirstDayOfWeek()
        Returns the first day of the week, according to the used Locale.
        Returns:
        the localized first day of the week, 0 is SUNDAY

      • isTwelveHourClock

        public boolean isTwelveHourClock()
        Returns whether the locale has twelve hour, or twenty four hour clock.
        Returns:
        true if the locale has twelve hour clock, false for twenty four clock

      • getClockDelimeter

        public String getClockDelimeter()

      • getAmPmStrings

        public String[] getAmPmStrings()

      • getStartWeekDay

        public int getStartWeekDay​(Date month)
        Returns the first day of week of the specified month.
        Parameters:
        month - the month, not null
        Returns:
        the first day of week,

      • setMilliseconds

        public static void setMilliseconds​(Date date,
                                   int ms)

      • getMilliseconds

        public static int getMilliseconds​(Date date)

      • getNumberOfDaysInMonth

        public static int getNumberOfDaysInMonth​(Date date)

      • isLeapYear

        public static boolean isLeapYear​(Date date)

      • isSameDay

        public static boolean isSameDay​(Date d1,
                                Date d2)

      • getISOWeekNumber

        public static int getISOWeekNumber​(Date date)
        Returns the ISO-8601 week number of the given date.
        Parameters:
        date - The date for which the week number should be resolved
        Returns:
        The ISO-8601 week number for date

      • formatDate

        public String formatDate​(Date date,
                         String formatStr)
        Check if format contains the month name. If it does we manually convert it to the month name since DateTimeFormat.format always uses the current locale and will replace the month name wrong if current locale is different from the locale set for the DateField. MMMM is converted into long month name, MMM is converted into short month name. '' are added around the name to avoid that DateTimeFormat parses the month name as a pattern.
        Parameters:
        date - The date to convert
        formatStr - The format string that might contain MMM or MMMM
        Returns:

      • formatDate

        public String formatDate​(Date date,
                         String formatStr,
                         com.google.gwt.i18n.client.TimeZone timeZone)
        Check if format contains the month name. If it does we manually convert it to the month name since DateTimeFormat.format always uses the current locale and will replace the month name wrong if current locale is different from the locale set for the DateField. MMMM is converted into long month name, MMM is converted into short month name. '' are added around the name to avoid that DateTimeFormat parses the month name as a pattern. z is converted into the time zone name, using the specified timeZoneJSON
        Parameters:
        date - The date to convert
        formatStr - The format string that might contain MMM or MMMM
        timeZone - The TimeZone used to replace z, can be null
        Returns:
        the formatted date string
        Since:
        8.2

      • parseDate

        public Date parseDate​(String dateString,
                      String formatString,
                      boolean lenient)
               throws IllegalArgumentException
        Parses the given date string using the given format string and the locale set in this DateTimeService instance.
        Parameters:
        dateString - Date string e.g. "1 February 2010"
        formatString - Format string e.g. "d MMMM yyyy"
        lenient - true to use lenient parsing, false to use strict parsing
        Returns:
        A Date object representing the dateString. Never returns null.
        Throws:
        IllegalArgumentException - if the parsing fails