| java.lang.Object
 com.gwtext.client.util.DateUtil
| DateUtil | | public class DateUtil (Code) | | The date parsing and format syntax is a subset of PHP's date() function, and the formats that are supported will provide results equivalent to their PHP versions. Following is the list of all currently supported formats:
Sample date:
'Wed Jan 10 2007 15:05:01 GMT-0600 (Central Standard Time)'
Format Description Example returned values
------ ----------------------------------------------------------------------- -----------------------
d Day of the month, 2 digits with leading zeros 01 to 31
D A short textual representation of the day of the week Mon to Sun
j Day of the month without leading zeros 1 to 31
l A full textual representation of the day of the week Sunday to Saturday
N ISO-8601 numeric representation of the day of the week 1 (for Monday) through 7 (for Sunday)
S English ordinal suffix for the day of the month, 2 characters st, nd, rd or th. Works well with j
w Numeric representation of the day of the week 0 (for Sunday) to 6 (for Saturday)
z The day of the year (starting from 0) 0 to 364 (365 in leap years)
W ISO-8601 week number of year, weeks starting on Monday 01 to 53
F A full textual representation of a month, such as January or March January to December
m Numeric representation of a month, with leading zeros 01 to 12
M A short textual representation of a month Jan to Dec
n Numeric representation of a month, without leading zeros 1 to 12
t Number of days in the given month 28 to 31
L Whether it's a leap year 1 if it is a leap year, 0 otherwise.
o ISO-8601 year number (identical to (Y), but if the ISO week number (W) Examples: 1998 or 2004
belongs to the previous or next year, that year is used instead)
Y A full numeric representation of a year, 4 digits Examples: 1999 or 2003
y A two digit representation of a year Examples: 99 or 03
a Lowercase Ante meridiem and Post meridiem am or pm
A Uppercase Ante meridiem and Post meridiem AM or PM
g 12-hour format of an hour without leading zeros 1 to 12
G 24-hour format of an hour without leading zeros 0 to 23
h 12-hour format of an hour with leading zeros 01 to 12
H 24-hour format of an hour with leading zeros 00 to 23
i Minutes, with leading zeros 00 to 59
s Seconds, with leading zeros 00 to 59
u Milliseconds, with leading zeros 001 to 999
O Difference to Greenwich time (GMT) in hours and minutes Example: +1030
P Difference to Greenwich time (GMT) with colon between hours and minutes Example: -08:00
T Timezone abbreviation of the machine running the code Examples: EST, MDT, PDT ...
Z Timezone offset in seconds (negative if west of UTC, positive if east) -43200 to 50400
c ISO 8601 date 2007-04-17T15:19:21+08:00
U Seconds since the Unix Epoch (January 1 1970 00:00:00 GMT) 1193432466 or -2138434463
|
| Inner Class :public static class Interval | |
| Field Summary | |
| public static Interval | DAY
| | public static Interval | HOUR
| | public static Interval | MILLI
| | public static Interval | MINUTE
| | public static Interval | MONTH
| | public static Interval | SECOND
| | public static Interval | YEAR
|
| Method Summary | |
| native public static Date | add(Date date, Interval interval, int value)
Provides a convenient method of performing basic date arithmetic. | | native public static Date | clearTime(Date date)
Clears any time information from this date. | | public static Date | create(long time)
Allocates a Date object and initializes it to represent the specified number of milliseconds since the
standard base time known as "the epoch", namely January 1, 1970, 00:00:00 GMT. | | native public static String | format(Date date, String format)
Formats a date given the supplied format string. | | native public static int | getDayOfYear(Date date)
Get the numeric day number of the year, adjusted for leap year. | | native public static int | getDaysInMonth(Date date)
Get the number of days in the current month, adjusted for leap year. | | native public static Date | getFirstDateOfMonth(Date date)
| | native public static int | getFirstDayOfMonth(Date date)
Get the first day of the current month, adjusted for leap year. | | native public static String | getGMTOffset(Date date)
Get the offset from GMT of the current date.
Parameters:
date - the date the 4-character offset string prefixed with + or - (e.g. | | native public static Date | getLastDateOfMonth(Date date)
Get the last date of this date's month. | | native public static int | getLastDayOfMonth(Date date)
Get the last day of the current month, adjusted for leap year. | | public static long | getTime(Date date)
Returns the number of milliseconds since January 1, 1970, 00:00:00 GMT represented by this Date object. | | native public static String | getTimezone(Date date)
Get the timezone abbreviation of the current date.
Parameters:
date - the date the abbreviated timezone name (e.g. | | native public static int | getWeekOfYear(Date date)
Get the string representation of the numeric week number of the year. | | native public static boolean | isLeapYear(Date date)
Whether or not the current date is in a leap year. | | native public static Date | parseDate(String input, String format)
Parses the passed string using the specified format. |
| DAY | | public static Interval DAY(Code) | | |
| HOUR | | public static Interval HOUR(Code) | | |
| MILLI | | public static Interval MILLI(Code) | | |
| MINUTE | | public static Interval MINUTE(Code) | | |
| MONTH | | public static Interval MONTH(Code) | | |
| SECOND | | public static Interval SECOND(Code) | | |
| YEAR | | public static Interval YEAR(Code) | | |
| add | | native public static Date add(Date date, Interval interval, int value)(Code) | | Provides a convenient method of performing basic date arithmetic. This method does not modify the Date instance
being called - it creates and returns a new Date instance containing the resulting date value.
Parameters:
date - the date
Parameters:
interval - the interval enum
Parameters:
value - the value to add the new Date |
| clearTime | | native public static Date clearTime(Date date)(Code) | | Clears any time information from this date.
Parameters:
date - the date the new date |
| create | | public static Date create(long time)(Code) | | Allocates a Date object and initializes it to represent the specified number of milliseconds since the
standard base time known as "the epoch", namely January 1, 1970, 00:00:00 GMT.
Parameters:
time - the time in milliseconds date |
| format | | native public static String format(Date date, String format)(Code) | | Formats a date given the supplied format string. You can also use GWT's standard
com.google.gwt.i18n.client.DateTimeFormat class.
Parameters:
date - the date
Parameters:
format - the format string the formatted date
See Also: com.google.gwt.i18n.client.DateTimeFormat |
| getDayOfYear | | native public static int getDayOfYear(Date date)(Code) | | Get the numeric day number of the year, adjusted for leap year.
Parameters:
date - the date 0 through 364 (365 in leap years) |
| getDaysInMonth | | native public static int getDaysInMonth(Date date)(Code) | | Get the number of days in the current month, adjusted for leap year.
Parameters:
date - the date the number of days in the month |
| getFirstDateOfMonth | | native public static Date getFirstDateOfMonth(Date date)(Code) | | Get the first date of this date's month
Parameters:
date - the date the new date |
| getFirstDayOfMonth | | native public static int getFirstDayOfMonth(Date date)(Code) | | Get the first day of the current month, adjusted for leap year. The returned value is the numeric day index within the week (0-6).
Parameters:
date - the date the day number (0-6) |
| getGMTOffset | | native public static String getGMTOffset(Date date)(Code) | | Get the offset from GMT of the current date.
Parameters:
date - the date the 4-character offset string prefixed with + or - (e.g. '-0600') |
| getLastDateOfMonth | | native public static Date getLastDateOfMonth(Date date)(Code) | | Get the last date of this date's month.
Parameters:
date - the date the new date |
| getLastDayOfMonth | | native public static int getLastDayOfMonth(Date date)(Code) | | Get the last day of the current month, adjusted for leap year. The returned value is the numeric day index within the week (0-6).
Parameters:
date - the date the day number (0-6) |
| getTime | | public static long getTime(Date date)(Code) | | Returns the number of milliseconds since January 1, 1970, 00:00:00 GMT represented by this Date object.
Parameters:
date - the date time in milliseconds |
| getTimezone | | native public static String getTimezone(Date date)(Code) | | Get the timezone abbreviation of the current date.
Parameters:
date - the date the abbreviated timezone name (e.g. 'CST') |
| getWeekOfYear | | native public static int getWeekOfYear(Date date)(Code) | | Get the string representation of the numeric week number of the year.
Parameters:
date - the date 0 through 52 |
| isLeapYear | | native public static boolean isLeapYear(Date date)(Code) | | Whether or not the current date is in a leap year.
Parameters:
date - the date true if date is in a leap year |
| parseDate | | native public static Date parseDate(String input, String format)(Code) | | Parses the passed string using the specified format. Note that this function expects dates in normal calendar format,
meaning that months are 1-based (1 = January) and not zero-based like in JavaScript dates. Any part of the date format
that is not specified will default to the current date value for that part. Time parts can also be specified, but default to 0.
Keep in mind that the input date string must precisely match the specified format string or the parse operation will fail.
Parameters:
input - the unparsed date as a string
Parameters:
format - the format string the parsed date |
|
|