jetbrains.buildServer.util
Class Dates

java.lang.Object
  jetbrains.buildServer.util.Dates

public class Dates
extends java.lang.Object

Field Summary

static int	APR
static int	AUG
static int	DEC
static java.lang.String	DEFAULT_DATE_FORMAT
static int	FEB
static int	JAN
static int	JUL
static int	JUN
static int	MAR
static int	MAY
static int	NOV
static int	OCT
static long	ONE_DAY
static long	ONE_HOUR
static long	ONE_MINUTE
static long	ONE_SECOND
static long	ONE_WEEK
static int	SEP

Constructor Summary

Dates()

Method Summary

static java.util.Date	after(java.util.Date date)
static java.util.Date	after(java.util.Date date, long time)
static java.util.Date	afterNow(long time)
static java.util.Date	before(java.util.Date date)
static java.util.Date	before(java.util.Date date, long time)
static java.util.Date	beforeNow(long time)
static java.lang.String	convertDateToFormalString(java.util.Date date) Converts a date to a formal string like 19991231, independent of current locale.
static java.lang.String	convertTimeToFormalString(java.util.Date time) Converts a timestamp to a formal string like 19991231.235959, independent of current locale.
static long	days(double num)
static java.util.Date	daysAfter(java.util.Date date, int days)
static java.util.Date	daysAfterNow(int days)
static java.util.Date	daysBefore(java.util.Date date, int days)
static java.util.Date	daysBeforeNow(int days)
static int	daysBetween(java.util.Date startDate, java.util.Date endDate) Returns number of calendar days between two dates.
static java.lang.String	formatDate(java.util.Date date, java.lang.String format)
static java.lang.String	formatDate(java.util.Date date, java.lang.String pattern, java.util.TimeZone tz) Formats date according to specified timezone.
static java.lang.String	formatInterval(java.util.Date from, java.util.Date to, java.util.TimeZone tz)
static long	hours(double num)
static boolean	isBeforeWithError(java.util.Date before, java.util.Date after, long allowedError)
static boolean	isDayChanged(java.util.Date date1, java.util.Date date2)
static boolean	isSameDay(java.util.Calendar cal1, java.util.Calendar cal2) Return true if two dates have the same day of the same year (but may have different time).
static java.util.Date	makeDate(int year, int month, int day)
static java.util.Date	makeDate(int year, int month, int day, java.util.Calendar calendar)
static java.util.Date	makeDate(int year, int month, int day, int hour, int minute, int second, java.lang.String timeZone)
static long	minutes(double num)
static java.util.Date	now()
static long	seconds(double num)
static java.util.Date	today()
static java.util.Date	tomorrow()
static java.util.Date	toStandardDate(java.util.Date date) Prevents using inheritors of java.util.Date (e.g.
static java.util.Date	truncateTime(java.util.Date dateAndTime)
static java.util.Date	yesterday()

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_DATE_FORMAT

public static final java.lang.String DEFAULT_DATE_FORMAT

See Also:

Constant Field Values

JAN

public static final int JAN

See Also:

Constant Field Values

FEB

public static final int FEB

See Also:

Constant Field Values

MAR

public static final int MAR

See Also:

Constant Field Values

APR

public static final int APR

See Also:

Constant Field Values

MAY

public static final int MAY

See Also:

Constant Field Values

JUN

public static final int JUN

See Also:

Constant Field Values

JUL

public static final int JUL

See Also:

Constant Field Values

AUG

public static final int AUG

See Also:

Constant Field Values

SEP

public static final int SEP

See Also:

Constant Field Values

OCT

public static final int OCT

See Also:

Constant Field Values

NOV

public static final int NOV

See Also:

Constant Field Values

DEC

public static final int DEC

See Also:

Constant Field Values

ONE_SECOND

public static final long ONE_SECOND

See Also:

Constant Field Values

ONE_MINUTE

public static final long ONE_MINUTE

See Also:

Constant Field Values

ONE_HOUR

public static final long ONE_HOUR

See Also:

Constant Field Values

ONE_DAY

public static final long ONE_DAY

See Also:

Constant Field Values

ONE_WEEK

public static final long ONE_WEEK

See Also:

Constant Field Values

Constructor Detail

Dates

public Dates()

Method Detail

makeDate

public static java.util.Date makeDate(int year,
                                      int month,
                                      int day)

seconds

public static long seconds(double num)

minutes

public static long minutes(double num)

hours

public static long hours(double num)

days

public static long days(double num)

after

public static java.util.Date after(java.util.Date date,
                                   long time)

before

public static java.util.Date before(java.util.Date date,
                                    long time)

afterNow

public static java.util.Date afterNow(long time)

beforeNow

public static java.util.Date beforeNow(long time)

makeDate

public static java.util.Date makeDate(int year,
                                      int month,
                                      int day,
                                      java.util.Calendar calendar)

now

public static java.util.Date now()

today

public static java.util.Date today()

tomorrow

public static java.util.Date tomorrow()

yesterday

public static java.util.Date yesterday()

Since:

6.5

after

public static java.util.Date after(java.util.Date date)

before

public static java.util.Date before(java.util.Date date)

makeDate

public static java.util.Date makeDate(int year,
                                      int month,
                                      int day,
                                      int hour,
                                      int minute,
                                      int second,
                                      java.lang.String timeZone)

isBeforeWithError

public static boolean isBeforeWithError(java.util.Date before,
                                        java.util.Date after,
                                        long allowedError)

daysBeforeNow

public static java.util.Date daysBeforeNow(int days)

daysAfterNow

public static java.util.Date daysAfterNow(int days)

daysBefore

public static java.util.Date daysBefore(java.util.Date date,
                                        int days)

daysAfter

public static java.util.Date daysAfter(java.util.Date date,
                                       int days)

truncateTime

public static java.util.Date truncateTime(java.util.Date dateAndTime)

isDayChanged

public static boolean isDayChanged(@NotNull
                                   java.util.Date date1,
                                   @NotNull
                                   java.util.Date date2)

formatInterval

public static java.lang.String formatInterval(java.util.Date from,
                                              java.util.Date to,
                                              @NotNull
                                              java.util.TimeZone tz)

formatDate

public static java.lang.String formatDate(java.util.Date date,
                                          java.lang.String format)

formatDate

@NotNull
public static java.lang.String formatDate(@NotNull
                                                  java.util.Date date,
                                                  @NotNull
                                                  java.lang.String pattern,
                                                  @NotNull
                                                  java.util.TimeZone tz)

Formats date according to specified timezone.

Parameters:

date - date

pattern - pattern

tz - timezone

Returns:

formatted date in specified timezone

convertDateToFormalString

public static java.lang.String convertDateToFormalString(java.util.Date date)

Converts a date to a formal string like 19991231, independent of current locale.

Nulls are converted to empty strings.

Parameters:

date - date to convert.

Returns:

8-digits string in form YYYYMMDD.

convertTimeToFormalString

public static java.lang.String convertTimeToFormalString(java.util.Date time)

Converts a timestamp to a formal string like 19991231.235959, independent of current locale.

Nulls are converted to empty strings.

Parameters:

time - timestamp to convert.

Returns:

15-character string in form YYYYMMDD.HHMMSS.

isSameDay

public static boolean isSameDay(@NotNull
                                java.util.Calendar cal1,
                                @NotNull
                                java.util.Calendar cal2)

Return true if two dates have the same day of the same year (but may have different time). We use Calendar because timezone issue is very important for the comparison.

Returns:

see above

Since:

6.0

daysBetween

public static int daysBetween(@NotNull
                              java.util.Date startDate,
                              @NotNull
                              java.util.Date endDate)

Returns number of calendar days between two dates.

Parameters:

startDate - start date

endDate - end date, endDate must be after the startDate

Returns:

toStandardDate

@NotNull
public static java.util.Date toStandardDate(@NotNull
                                                    java.util.Date date)

Prevents using inheritors of java.util.Date (e.g. java.sql.Date, java.sql.Time, java.sql.Timestamp). This method should be used when you need to serialize date value (e.g. for XML-RPC).

Parameters:

date - original date value

Returns:

instance of exactly java.util.Date with the specified date value