com.threerings.gwt.util

Class DateUtil

java.lang.Object

com.threerings.gwt.util.DateUtil

public class DateUtil
extends Object

Time and date utility methods.

Constructor Summary

Constructors

Constructor and Description
DateUtil()

Method Summary

Methods

Modifier and Type	Method and Description
static String	formatDate(Date date) Formats the supplied date relative to the current time: Today, Yesterday, MMM dd, and finally MMM dd, YYYY.
static String	formatDate(Date date, boolean useShorthand) Formats the supplied date relative to the current time: Today, Yesterday, MMM dd, and finally MMM dd, YYYY.
static String	formatDateTime(Date date) Creates a label of the form "formatDate(java.util.Date) at formatTime(java.util.Date)".
static String	formatTime(Date date) Creates a label of the form "9:15am".
static int	getDayOfMonth(Date date)
static int	getDayOfWeek(Date date)
static int	getHour(Date date)
static int	getMinute(Date date)
static int	getMonth(Date date)
static int	getYear(Date date) Returns the year component of the supplied date.
static Date	newDate(String dateStr)
static Date	toDate(int[] datevec)
static int[]	toDateVec(Date date)
static Date	toUtc(Date date) Returns the equivalent of this date when it was in Greenwich.
static void	zeroTime(Date date)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DateUtil

public DateUtil()

Method Detail

formatTime

public static String formatTime(Date date)

Creates a label of the form "9:15am". TODO: support 24 hour time for people who go for that sort of thing. If date is null the empty string is returned.

formatDate

public static String formatDate(Date date)

Formats the supplied date relative to the current time: Today, Yesterday, MMM dd, and finally MMM dd, YYYY. If date is null the empty string is returned.

formatDate

public static String formatDate(Date date,
                boolean useShorthand)

Formats the supplied date relative to the current time: Today, Yesterday, MMM dd, and finally MMM dd, YYYY. If date is null the empty string is returned.

Parameters:

useShorthand - if false, "Today" and "Yesterday" will not be used, only the month/day and month/day/year formats.

formatDateTime

public static String formatDateTime(Date date)

Creates a label of the form "formatDate(java.util.Date) at formatTime(java.util.Date)". If date is null the empty string is returned.

toDate

public static Date toDate(int[] datevec)

toDateVec

public static int[] toDateVec(Date date)

newDate

public static Date newDate(String dateStr)

getDayOfMonth

public static int getDayOfMonth(Date date)

getDayOfWeek

public static int getDayOfWeek(Date date)

getMonth

public static int getMonth(Date date)

getHour

public static int getHour(Date date)

getMinute

public static int getMinute(Date date)

getYear

public static int getYear(Date date)

Returns the year component of the supplied date. Note: this is not the year minus 1900 which the underlying Date.getYear() method returns. It's the actual year. Returning years since 1900 is stupid.

zeroTime

public static void zeroTime(Date date)

toUtc

public static Date toUtc(Date date)

Returns the equivalent of this date when it was in Greenwich. For example, a date at 4pm pacific would result in a new date at 4pm gmt, or 8am pacific. This has the effect of normalizing the date. It may be used to allow clients to send data requests to the server in absolute time, which can then be treated appropriately on the server.