Class JsDate


  • public class JsDate
    extends JavaScriptObject
    A simple wrapper around a native JS Date object.
    • Constructor Summary

      Constructors 
      Modifier Constructor Description
      protected JsDate()
      Non directly instantiable, use one of the create() methods.
    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods 
      Modifier and Type Method Description
      static JsDate create()
      Creates a new date with the current time.
      static JsDate create​(double milliseconds)
      Creates a new date with the specified internal representation, which is the number of milliseconds since midnight on January 1st, 1970.
      static JsDate create​(int year, int month)
      Creates a new date using the specified values.
      static JsDate create​(int year, int month, int dayOfMonth)
      Creates a new date using the specified values.
      static JsDate create​(int year, int month, int dayOfMonth, int hours)
      Creates a new date using the specified values.
      static JsDate create​(int year, int month, int dayOfMonth, int hours, int minutes)
      Creates a new date using the specified values.
      static JsDate create​(int year, int month, int dayOfMonth, int hours, int minutes, int seconds)
      Creates a new date using the specified values.
      static JsDate create​(int year, int month, int dayOfMonth, int hours, int minutes, int seconds, int millis)
      Creates a new date using the specified values.
      static JsDate create​(java.lang.String dateString)
      Creates a new date from a string to be parsed.
      int getDate()
      Returns the day of the month.
      int getDay()
      Returns the day of the week, from 0 (Sunday) to 6 Saturday.
      int getFullYear()
      Returns the four-digit year.
      int getHours()
      Returns the hour, between 0 (midnight) and 23.
      int getMilliseconds()
      Returns the milliseconds, between 0 and 999.
      int getMinutes()
      Returns the minutes, between 0 and 59.
      int getMonth()
      Returns the month, from 0 (January) to 11 December.
      int getSeconds()
      Returns the seconds, between 0 and 59.
      double getTime()
      Returns the internal millisecond representation of the date, the number of milliseconds since midnight on January 1st, 1970.
      int getTimezoneOffset()
      Returns the difference, in minutes, between the local and UTC representations of this date.
      int getUTCDate()
      Returns the day of the month, in UTC.
      int getUTCDay()
      Returns the day of the week, from 0 (Sunday) to 6 Saturday, in UTC.
      int getUTCFullYear()
      Returns the four-digit year, in UTC.
      int getUTCHours()
      Returns the hour, between 0 (midnight) and 23, in UTC.
      int getUTCMilliseconds()
      Returns the milliseconds, between 0 and 999, in UTC.
      int getUTCMinutes()
      Returns the minutes, between 0 and 59, in UTC.
      int getUTCMonth()
      Returns the month, from 0 (January) to 11 December, in UTC.
      int getUTCSeconds()
      Returns the seconds, between 0 and 59, in UTC.
      int getYear()
      Deprecated.
      static double now()
      Returns the numeric value corresponding to the current time - the number of milliseconds elapsed since 1 January 1970 00:00:00 UTC.
      static double parse​(java.lang.String dateString)
      Parses a string representation of a date and time and returns the internal millisecond representation.
      double setDate​(int dayOfMonth)
      Sets the day of the month.
      double setFullYear​(int year)
      Sets the year.
      double setFullYear​(int year, int month)
      Sets the year and month.
      double setFullYear​(int year, int month, int day)
      Sets the year, month, and day.
      double setHours​(int hours)
      Sets the hour.
      double setHours​(int hours, int mins)
      Sets the hour and minutes.
      double setHours​(int hours, int mins, int secs)
      Sets the hour, minutes, and seconds.
      double setHours​(int hours, int mins, int secs, int ms)
      Sets the hour, minutes, seconds, and milliseconds.
      double setMinutes​(int minutes)
      Sets the minutes.
      double setMinutes​(int minutes, int seconds)
      Sets the minutes and seconds.
      double setMinutes​(int minutes, int seconds, int millis)
      Sets the minutes, seconds, and milliseconds.
      double setMonth​(int month)
      Sets the month.
      double setMonth​(int month, int dayOfMonth)
      Sets the month and day.
      double setSeconds​(int seconds)
      Sets the seconds.
      double setSeconds​(int seconds, int millis)
      Sets the seconds and milliseconds.
      double setTime​(double milliseconds)
      Sets the internal date representation.
      double setUTCDate​(int dayOfMonth)
      Sets the day of the month, in UTC.
      double setUTCFullYear​(int year)
      Sets the year, in UTC.
      double setUTCFullYear​(int year, int month)
      Sets the year and month, in UTC.
      double setUTCFullYear​(int year, int month, int day)
      Sets the year, month, and day, in UTC.
      double setUTCHours​(int hours)
      Sets the hour, in UTC.
      double setUTCHours​(int hours, int mins)
      Sets the hour and minutes, in UTC.
      double setUTCHours​(int hours, int mins, int secs)
      Sets the hour, minutes, and seconds, in UTC.
      double setUTCHours​(int hours, int mins, int secs, int ms)
      Sets the hour, minutes, seconds, and milliseconds, in UTC.
      double setUTCMinutes​(int minutes)
      Sets the minutes, in UTC.
      double setUTCMinutes​(int minutes, int seconds)
      Sets the minutes and seconds, in UTC.
      double setUTCMinutes​(int minutes, int seconds, int millis)
      Sets the minutes, seconds, and milliseconds, in UTC.
      double setUTCMonth​(int month)
      Sets the month, in UTC.
      double setUTCMonth​(int month, int dayOfMonth)
      Sets the month and day, in UTC.
      double setUTCSeconds​(int seconds)
      Sets the seconds, in UTC.
      double setUTCSeconds​(int seconds, int millis)
      Sets the seconds and milliseconds, in UTC.
      double setYear​(int year)
      Deprecated.
      java.lang.String toDateString()
      Returns a date string in the local time zone.
      java.lang.String toGMTString()
      Deprecated.
      java.lang.String toLocaleDateString()
      Returns a date string in the local time zone according to local formatting conventions.
      java.lang.String toLocaleString()
      Returns a date and time string in the local time zone according to local formatting conventions.
      java.lang.String toLocaleTimeString()
      Returns a time string in the local time zone according to local formatting conventions.
      java.lang.String toTimeString()
      Returns a time string in the local time zone.
      java.lang.String toUTCString()
      Returns a date and time string in UTC.
      static double UTC​(int year, int month, int dayOfMonth, int hours, int minutes, int seconds, int millis)
      Returns the internal millisecond representation of the specified UTC date and time.
      double valueOf()
      Returns the millisecond representation, as getTime().
      • Methods inherited from class java.lang.Object

        clone, finalize, getClass, notify, notifyAll, wait, wait, wait
    • Constructor Detail

      • JsDate

        protected JsDate()
        Non directly instantiable, use one of the create() methods.
    • Method Detail

      • create

        public static JsDate create()
        Creates a new date with the current time.
      • create

        public static JsDate create​(double milliseconds)
        Creates a new date with the specified internal representation, which is the number of milliseconds since midnight on January 1st, 1970. This is the same representation returned by getTime().
      • create

        public static JsDate create​(int year,
                                    int month)
        Creates a new date using the specified values.
      • create

        public static JsDate create​(int year,
                                    int month,
                                    int dayOfMonth)
        Creates a new date using the specified values.
      • create

        public static JsDate create​(int year,
                                    int month,
                                    int dayOfMonth,
                                    int hours)
        Creates a new date using the specified values.
      • create

        public static JsDate create​(int year,
                                    int month,
                                    int dayOfMonth,
                                    int hours,
                                    int minutes)
        Creates a new date using the specified values.
      • create

        public static JsDate create​(int year,
                                    int month,
                                    int dayOfMonth,
                                    int hours,
                                    int minutes,
                                    int seconds)
        Creates a new date using the specified values.
      • create

        public static JsDate create​(int year,
                                    int month,
                                    int dayOfMonth,
                                    int hours,
                                    int minutes,
                                    int seconds,
                                    int millis)
        Creates a new date using the specified values.
      • create

        public static JsDate create​(java.lang.String dateString)
        Creates a new date from a string to be parsed.
      • now

        public static double now()
        Returns the numeric value corresponding to the current time - the number of milliseconds elapsed since 1 January 1970 00:00:00 UTC.
      • parse

        public static double parse​(java.lang.String dateString)
        Parses a string representation of a date and time and returns the internal millisecond representation. If the string cannot be parsed, the returned value will be NaN. Use Double.isNaN(double) to check the result.
      • UTC

        public static double UTC​(int year,
                                 int month,
                                 int dayOfMonth,
                                 int hours,
                                 int minutes,
                                 int seconds,
                                 int millis)
        Returns the internal millisecond representation of the specified UTC date and time.
      • getDate

        public final int getDate()
        Returns the day of the month.
      • getDay

        public final int getDay()
        Returns the day of the week, from 0 (Sunday) to 6 Saturday.
      • getFullYear

        public final int getFullYear()
        Returns the four-digit year.
      • getHours

        public final int getHours()
        Returns the hour, between 0 (midnight) and 23.
      • getMilliseconds

        public final int getMilliseconds()
        Returns the milliseconds, between 0 and 999.
      • getMinutes

        public final int getMinutes()
        Returns the minutes, between 0 and 59.
      • getMonth

        public final int getMonth()
        Returns the month, from 0 (January) to 11 December.
      • getSeconds

        public final int getSeconds()
        Returns the seconds, between 0 and 59.
      • getTime

        public final double getTime()
        Returns the internal millisecond representation of the date, the number of milliseconds since midnight on January 1st, 1970. This is the same representation returned by getTime().
      • getTimezoneOffset

        public final int getTimezoneOffset()
        Returns the difference, in minutes, between the local and UTC representations of this date. The value returned is affected by whether or not daylight savings time would be in effect on specified date.
      • getUTCDate

        public final int getUTCDate()
        Returns the day of the month, in UTC.
      • getUTCDay

        public final int getUTCDay()
        Returns the day of the week, from 0 (Sunday) to 6 Saturday, in UTC.
      • getUTCFullYear

        public final int getUTCFullYear()
        Returns the four-digit year, in UTC.
      • getUTCHours

        public final int getUTCHours()
        Returns the hour, between 0 (midnight) and 23, in UTC.
      • getUTCMilliseconds

        public final int getUTCMilliseconds()
        Returns the milliseconds, between 0 and 999, in UTC.
      • getUTCMinutes

        public final int getUTCMinutes()
        Returns the minutes, between 0 and 59, in UTC.
      • getUTCMonth

        public final int getUTCMonth()
        Returns the month, from 0 (January) to 11 December, in UTC.
      • getUTCSeconds

        public final int getUTCSeconds()
        Returns the seconds, between 0 and 59, in UTC.
      • getYear

        @Deprecated
        public final int getYear()
        Deprecated.
        Returns the year minus 1900.
      • setDate

        public final double setDate​(int dayOfMonth)
        Sets the day of the month. Returns the millisecond representation of the adjusted date.
      • setFullYear

        public final double setFullYear​(int year)
        Sets the year. Returns the millisecond representation of the adjusted date.
      • setFullYear

        public final double setFullYear​(int year,
                                        int month)
        Sets the year and month. Returns the millisecond representation of the adjusted date.
      • setFullYear

        public final double setFullYear​(int year,
                                        int month,
                                        int day)
        Sets the year, month, and day. Returns the millisecond representation of the adjusted date.
      • setHours

        public final double setHours​(int hours)
        Sets the hour. Returns the millisecond representation of the adjusted date.
      • setHours

        public final double setHours​(int hours,
                                     int mins)
        Sets the hour and minutes. Returns the millisecond representation of the adjusted date.
      • setHours

        public final double setHours​(int hours,
                                     int mins,
                                     int secs)
        Sets the hour, minutes, and seconds. Returns the millisecond representation of the adjusted date.
      • setHours

        public final double setHours​(int hours,
                                     int mins,
                                     int secs,
                                     int ms)
        Sets the hour, minutes, seconds, and milliseconds. Returns the millisecond representation of the adjusted date.
      • setMinutes

        public final double setMinutes​(int minutes)
        Sets the minutes. Returns the millisecond representation of the adjusted date.
      • setMinutes

        public final double setMinutes​(int minutes,
                                       int seconds)
        Sets the minutes and seconds. Returns the millisecond representation of the adjusted date.
      • setMinutes

        public final double setMinutes​(int minutes,
                                       int seconds,
                                       int millis)
        Sets the minutes, seconds, and milliseconds. Returns the millisecond representation of the adjusted date.
      • setMonth

        public final double setMonth​(int month)
        Sets the month. Returns the millisecond representation of the adjusted date.
      • setMonth

        public final double setMonth​(int month,
                                     int dayOfMonth)
        Sets the month and day. Returns the millisecond representation of the adjusted date.
      • setSeconds

        public final double setSeconds​(int seconds)
        Sets the seconds. Returns the millisecond representation of the adjusted date.
      • setSeconds

        public final double setSeconds​(int seconds,
                                       int millis)
        Sets the seconds and milliseconds. Returns the millisecond representation of the adjusted date.
      • setTime

        public final double setTime​(double milliseconds)
        Sets the internal date representation. Returns the milliseconds argument.
      • setUTCDate

        public final double setUTCDate​(int dayOfMonth)
        Sets the day of the month, in UTC. Returns the millisecond representation of the adjusted date.
      • setUTCFullYear

        public final double setUTCFullYear​(int year)
        Sets the year, in UTC. Returns the millisecond representation of the adjusted date.
      • setUTCFullYear

        public final double setUTCFullYear​(int year,
                                           int month)
        Sets the year and month, in UTC. Returns the millisecond representation of the adjusted date.
      • setUTCFullYear

        public final double setUTCFullYear​(int year,
                                           int month,
                                           int day)
        Sets the year, month, and day, in UTC. Returns the millisecond representation of the adjusted date.
      • setUTCHours

        public final double setUTCHours​(int hours)
        Sets the hour, in UTC. Returns the millisecond representation of the adjusted date.
      • setUTCHours

        public final double setUTCHours​(int hours,
                                        int mins)
        Sets the hour and minutes, in UTC. Returns the millisecond representation of the adjusted date.
      • setUTCHours

        public final double setUTCHours​(int hours,
                                        int mins,
                                        int secs)
        Sets the hour, minutes, and seconds, in UTC. Returns the millisecond representation of the adjusted date.
      • setUTCHours

        public final double setUTCHours​(int hours,
                                        int mins,
                                        int secs,
                                        int ms)
        Sets the hour, minutes, seconds, and milliseconds, in UTC. Returns the millisecond representation of the adjusted date.
      • setUTCMinutes

        public final double setUTCMinutes​(int minutes)
        Sets the minutes, in UTC. Returns the millisecond representation of the adjusted date.
      • setUTCMinutes

        public final double setUTCMinutes​(int minutes,
                                          int seconds)
        Sets the minutes and seconds, in UTC. Returns the millisecond representation of the adjusted date.
      • setUTCMinutes

        public final double setUTCMinutes​(int minutes,
                                          int seconds,
                                          int millis)
        Sets the minutes, seconds, and milliseconds, in UTC. Returns the millisecond representation of the adjusted date.
      • setUTCMonth

        public final double setUTCMonth​(int month)
        Sets the month, in UTC. Returns the millisecond representation of the adjusted date.
      • setUTCMonth

        public final double setUTCMonth​(int month,
                                        int dayOfMonth)
        Sets the month and day, in UTC. Returns the millisecond representation of the adjusted date.
      • setUTCSeconds

        public final double setUTCSeconds​(int seconds)
        Sets the seconds, in UTC. Returns the millisecond representation of the adjusted date.
      • setUTCSeconds

        public final double setUTCSeconds​(int seconds,
                                          int millis)
        Sets the seconds and milliseconds, in UTC. Returns the millisecond representation of the adjusted date.
      • setYear

        @Deprecated
        public final double setYear​(int year)
        Deprecated.
        Sets a two-digit year.
      • toDateString

        public final java.lang.String toDateString()
        Returns a date string in the local time zone.
      • toGMTString

        @Deprecated
        public final java.lang.String toGMTString()
        Deprecated.
        Returns a date and time string in GMT.
      • toLocaleDateString

        public final java.lang.String toLocaleDateString()
        Returns a date string in the local time zone according to local formatting conventions.
      • toLocaleString

        public final java.lang.String toLocaleString()
        Returns a date and time string in the local time zone according to local formatting conventions.
      • toLocaleTimeString

        public final java.lang.String toLocaleTimeString()
        Returns a time string in the local time zone according to local formatting conventions.
      • toTimeString

        public final java.lang.String toTimeString()
        Returns a time string in the local time zone.
      • toUTCString

        public final java.lang.String toUTCString()
        Returns a date and time string in UTC.
      • valueOf

        public final double valueOf()
        Returns the millisecond representation, as getTime().