DateUtil (TwelveMonkeys :: Common :: Language support 3.1.2 API)

java.lang.Object
- com.twelvemonkeys.lang.DateUtil

```
public final class DateUtil
extends Object
```
A utility class with useful date manipulation methods and constants.

Version:

$Id: //depot/branches/personal/haraldk/twelvemonkeys/release-2/twelvemonkeys-core/src/main/java/com/twelvemonkeys/lang/DateUtil.java#1 $

Author:

Harald Kuhr

Field Summary

Fields
Modifier and Type	Field and Description
`static long`	`CALENDAR_YEAR` One calendar year: 365.2425 days (31556952000 milliseconds).
`static long`	`DAY` One day: 24 hours (86 400 000 milliseconds).
`static long`	`HOUR` One hour: 60 minutes (3 600 000 milliseconds).
`static long`	`MINUTE` One minute: 60 seconds (60 000 milliseconds).
`static long`	`SECOND` One second: 1000 milliseconds.

Method Summary

Methods
Modifier and Type	Method and Description
`static long`	`currentTimeDay()` Gets the current time, rounded down to the closest day.
`static long`	`currentTimeHour()` Gets the current time, rounded down to the closest hour.
`static long`	`currentTimeMinute()` Gets the current time, rounded down to the closest minute.
`static long`	`currentTimeSecond()` Gets the current time, rounded down to the closest second.
`static long`	`delta(Date pStart)` Returns the time between the given start time and now (as defined by `System.currentTimeMillis()`).
`static long`	`delta(long pStart)` Returns the time between the given start time and now (as defined by `System.currentTimeMillis()`).
`static long`	`roundToDay(long pTime)` Rounds the given time down to the closest day, using the default timezone.
`static long`	`roundToDay(long pTime, TimeZone pTimeZone)` Rounds the given time down to the closest day, using the given timezone.
`static long`	`roundToHour(long pTime)` Rounds the given time down to the closest hour, using the default timezone.
`static long`	`roundToHour(long pTime, TimeZone pTimeZone)` Rounds the given time down to the closest hour, using the given timezone.
`static long`	`roundToMinute(long pTime)` Rounds the given time down to the closest minute.
`static long`	`roundToSecond(long pTime)` Rounds the given time down to the closest second.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - SECOND
```
public static final long SECOND
```
    One second: 1000 milliseconds.
    
    See Also:
    Constant Field Values
  - MINUTE
```
public static final long MINUTE
```
    One minute: 60 seconds (60 000 milliseconds).
    
    See Also:
    Constant Field Values
  - HOUR
```
public static final long HOUR
```
    One hour: 60 minutes (3 600 000 milliseconds). 60 minutes = 3 600 seconds = 3 600 000 milliseconds
    
    See Also:
    Constant Field Values
  - DAY
```
public static final long DAY
```
    One day: 24 hours (86 400 000 milliseconds). 24 hours = 1 440 minutes = 86 400 seconds = 86 400 000 milliseconds.
    
    See Also:
    Constant Field Values
  - CALENDAR_YEAR
```
public static final long CALENDAR_YEAR
```
    One calendar year: 365.2425 days (31556952000 milliseconds). 365.2425 days = 8765.82 hours = 525949.2 minutes = 31556952 seconds = 31556952000 milliseconds.
    
    See Also:
    Constant Field Values
- Method Detail
  - delta
```
public static long delta(long pStart)
```
    Returns the time between the given start time and now (as defined by System.currentTimeMillis()).
    
    Parameters:
    pStart - the start time
    
    Returns:
    the time between the given start time and now.
  - delta
```
public static long delta(Date pStart)
```
    Returns the time between the given start time and now (as defined by System.currentTimeMillis()).
    
    Parameters:
    pStart - the start time
    
    Returns:
    the time between the given start time and now.
  - currentTimeSecond
```
public static long currentTimeSecond()
```
    Gets the current time, rounded down to the closest second. Equivalent to invoking roundToSecond(System.currentTimeMillis()).
    
    Returns:
    the current time, rounded to the closest second.
  - currentTimeMinute
```
public static long currentTimeMinute()
```
    Gets the current time, rounded down to the closest minute. Equivalent to invoking roundToMinute(System.currentTimeMillis()).
    
    Returns:
    the current time, rounded to the closest minute.
  - currentTimeHour
```
public static long currentTimeHour()
```
    Gets the current time, rounded down to the closest hour. Equivalent to invoking roundToHour(System.currentTimeMillis()).
    
    Returns:
    the current time, rounded to the closest hour.
  - currentTimeDay
```
public static long currentTimeDay()
```
    Gets the current time, rounded down to the closest day. Equivalent to invoking roundToDay(System.currentTimeMillis()).
    
    Returns:
    the current time, rounded to the closest day.
  - roundToSecond
```
public static long roundToSecond(long pTime)
```
    Rounds the given time down to the closest second.
    
    Parameters:
    pTime - time
    
    Returns:
    the time rounded to the closest second.
  - roundToMinute
```
public static long roundToMinute(long pTime)
```
    Rounds the given time down to the closest minute.
    
    Parameters:
    pTime - time
    
    Returns:
    the time rounded to the closest minute.
  - roundToHour
```
public static long roundToHour(long pTime)
```
    Rounds the given time down to the closest hour, using the default timezone.
    
    Parameters:
    pTime - time
    
    Returns:
    the time rounded to the closest hour.
  - roundToHour
```
public static long roundToHour(long pTime,
               TimeZone pTimeZone)
```
    Rounds the given time down to the closest hour, using the given timezone.
    
    Parameters:
    pTime - time
    pTimeZone - the timezone to use when rounding
    
    Returns:
    the time rounded to the closest hour.
  - roundToDay
```
public static long roundToDay(long pTime)
```
    Rounds the given time down to the closest day, using the default timezone.
    
    Parameters:
    pTime - time
    
    Returns:
    the time rounded to the closest day.
  - roundToDay
```
public static long roundToDay(long pTime,
              TimeZone pTimeZone)
```
    Rounds the given time down to the closest day, using the given timezone.
    
    Parameters:
    pTime - time
    pTimeZone - the timezone to use when rounding
    
    Returns:
    the time rounded to the closest day.

Class DateUtil

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

SECOND

MINUTE

HOUR

DAY

CALENDAR_YEAR

Method Detail

delta

delta

currentTimeSecond

currentTimeMinute

currentTimeHour

currentTimeDay

roundToSecond

roundToMinute

roundToHour

roundToHour

roundToDay

roundToDay