DateUtil (Asakusa Framework 0.10.3 API)

java.lang.Object
- com.asakusafw.runtime.value.DateUtil

```
public final class DateUtil
extends Object
```
Utilities about date and time.

Since:

0.1.0

Version:

0.7.0

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static int`	`getDayFromCalendar(Calendar calendar)` Returns a date as the number of elapsed days from `0001/01/01 (YYYY/MM/DD)`.
`static int`	`getDayFromDate(Date date)` Returns a date as the number of elapsed days from `0001/01/01 (YYYY/MM/DD)`.
`static int`	`getDayFromDate(int year, int month, int day)` Returns a date as the number of elapsed days from `0001/01/01 (YYYY/MM/DD)`.
`static int`	`getDayFromSeconds(long seconds)` Converts the number of elapsed seconds from `0001/01/01 (YYYY/MM/DD) 00:00:00` to the corresponded date as the number of elapsed days.
`static int`	`getDayFromYear(int year)` Converts the year to the number of elapsed days from `0001/01/01 (YYYY/MM/DD)` about the first day of the specified year.
`static int`	`getDayOfMonth(int dayOfYear, boolean leap)` Converts the number of elapsed days from beginning of the year to the date in the current month.
`static int`	`getMonthOfYear(int dayOfYear, boolean leap)` Converts the number of elapsed days from beginning of the year to the corresponding month.
`static long`	`getSecondFromCalendar(Calendar calendar)` Converts the date and time as the number of elapsed seconds from `0001/01/01 (YYYY/MM/DD) 00:00:00`.
`static long`	`getSecondFromDate(Date date)` Converts the date and time as the number of elapsed seconds from `0001/01/01 (YYYY/MM/DD) 00:00:00`.
`static int`	`getSecondFromTime(int hour, int minute, int second)` Converts the time as the number of elapsed seconds from `00:00:00`.
`static int`	`getSecondOfDay(long seconds)` Converts the number of elapsed seconds from `0001/01/01 (YYYY/MM/DD) 00:00:00` to the number of elapsed seconds from beginning of the corresponding date.
`static int`	`getYearFromDay(int days)` Converts the number of elapsed days from `0001/01/01 (YYYY/MM/DD)` to the corresponding year.
`static boolean`	`isLeap(int year)` Whether the target year is leap year or not.
`static int`	`parseDate(CharSequence value, char dateSegmentSeparator)` Parses a `Date` value.
`static long`	`parseDateTime(CharSequence value, char dateSegmentSeparator, char dateTimeSeparator, char timeSegmentSeparator)` Parses a `DateTime` value.
`static void`	`setDayToCalendar(int days, Calendar calendar)` Converts the number of elapsed days from `0001/01/01 (YYYY/MM/DD)` to the corresponded date, and set it to the target calendar object.
`static void`	`setSecondToCalendar(long seconds, Calendar calendar)` Converts the number of elapsed seconds from `0001/01/01 (YYYY/MM/DD) 00:00:00` to the corresponded date, and set it to the target calendar object.
`static void`	`toDateString(int elapsedDays, char dateSegmentSeparator, StringBuilder target)` Appends a string representation of `Date`.
`static void`	`toDateTimeString(long elapsedSeconds, char dateSegmentSeparator, char dateTimeSeparator, char timeSegmentSeparator, StringBuilder target)` Appends a string representation of `DateTime`.

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

- Method Detail
  - getDayFromDate
```
public static int getDayFromDate(int year,
                                 int month,
                                 int day)
```
    Returns a date as the number of elapsed days from 0001/01/01 (YYYY/MM/DD).
    
    Parameters:
    
    year - year
    
    month - month (1-12)
    
    day - day (1-31)
    
    Returns:
    
    the number of elapsed days (0-origin)
  - getDayFromCalendar
```
public static int getDayFromCalendar(Calendar calendar)
```
    Returns a date as the number of elapsed days from 0001/01/01 (YYYY/MM/DD).
    
    Parameters:
    
    calendar - the target calendar object
    
    Returns:
    
    the number of elapsed days (0-origin)
    
    Since:
    
    0.2.2
  - getDayFromDate
```
public static int getDayFromDate(Date date)
```
    Returns a date as the number of elapsed days from 0001/01/01 (YYYY/MM/DD).
    
    Parameters:
    
    date - the target date object
    
    Returns:
    
    the number of elapsed days (0-origin)
    
    Since:
    
    0.7.0
  - setDayToCalendar
```
public static void setDayToCalendar(int days,
                                    Calendar calendar)
```
    Converts the number of elapsed days from 0001/01/01 (YYYY/MM/DD) to the corresponded date, and set it to the target calendar object. Note that, the hour, minute, second and millisecond fields will be set to 0.
    
    Parameters:
    
    days - the number of elapsed days from 0001/01/01 (YYYY/MM/DD)
    
    calendar - the target calendar object
    
    Since:
    
    0.2.2
  - getSecondFromTime
```
public static int getSecondFromTime(int hour,
                                    int minute,
                                    int second)
```
    Converts the time as the number of elapsed seconds from 00:00:00.
    
    Parameters:
    
    hour - hour
    
    minute - minute
    
    second - second
    
    Returns:
    
    the number of elapsed seconds (0-origin)
  - getSecondFromCalendar
```
public static long getSecondFromCalendar(Calendar calendar)
```
    Converts the date and time as the number of elapsed seconds from 0001/01/01 (YYYY/MM/DD) 00:00:00.
    
    Parameters:
    
    calendar - the target calendar object
    
    Returns:
    
    the number of elapsed seconds (0-origin)
    
    Since:
    
    0.2.2
  - getSecondFromDate
```
public static long getSecondFromDate(Date date)
```
    Converts the date and time as the number of elapsed seconds from 0001/01/01 (YYYY/MM/DD) 00:00:00.
    
    Parameters:
    
    date - the target date object
    
    Returns:
    
    the number of elapsed seconds (0-origin)
    
    Since:
    
    0.7.0
  - setSecondToCalendar
```
public static void setSecondToCalendar(long seconds,
                                       Calendar calendar)
```
    Converts the number of elapsed seconds from 0001/01/01 (YYYY/MM/DD) 00:00:00 to the corresponded date, and set it to the target calendar object. Note that, the millisecond fields will be set to 0.
    
    Parameters:
    
    seconds - the number of elapsed seconds
    
    calendar - the target calendar object
    
    Since:
    
    0.2.2
  - getYearFromDay
```
public static int getYearFromDay(int days)
```
    Converts the number of elapsed days from 0001/01/01 (YYYY/MM/DD) to the corresponding year.
    
    Parameters:
    
    days - the number of elapsed days
    
    Returns:
    
    the corresponded year
  - isLeap
```
public static boolean isLeap(int year)
```
    Whether the target year is leap year or not.
    
    Parameters:
    
    year - the target year
    
    Returns:
    
    true if the target year is leap year, otherwise false
  - getDayFromYear
```
public static int getDayFromYear(int year)
```
    Converts the year to the number of elapsed days from 0001/01/01 (YYYY/MM/DD) about the first day of the specified year. For example, getDayFromYear(1) returns just 0.
    
    Parameters:
    
    year - the target year
    
    Returns:
    
    the number of elapsed days about the first day of the specified year
  - getMonthOfYear
```
public static int getMonthOfYear(int dayOfYear,
                                 boolean leap)
```
    Converts the number of elapsed days from beginning of the year to the corresponding month.
    
    Parameters:
    
    dayOfYear - the number of elapsed days from beginning of the year
    
    leap - whether the target year is leap year or not
    
    Returns:
    
    the month including the target day (1-origin)
  - getDayOfMonth
```
public static int getDayOfMonth(int dayOfYear,
                                boolean leap)
```
    Converts the number of elapsed days from beginning of the year to the date in the current month.
    
    Parameters:
    
    dayOfYear - the number of elapsed days from beginning of the year
    
    leap - whether the target year is leap year or not
    
    Returns:
    
    the date in the current month (1-origin)
  - getDayFromSeconds
```
public static int getDayFromSeconds(long seconds)
```
    Converts the number of elapsed seconds from 0001/01/01 (YYYY/MM/DD) 00:00:00 to the corresponded date as the number of elapsed days.
    
    Parameters:
    
    seconds - the number of elapsed seconds (0-origin)
    
    Returns:
    
    the corresponded number of elapsed days (0-origin)
    
    See Also:
    
    getSecondOfDay(long)
  - getSecondOfDay
```
public static int getSecondOfDay(long seconds)
```
    Converts the number of elapsed seconds from 0001/01/01 (YYYY/MM/DD) 00:00:00 to the number of elapsed seconds from beginning of the corresponding date.
    
    Parameters:
    
    seconds - the number of elapsed seconds (0-origin)
    
    Returns:
    
    the number of elapsed seconds of the day (0-origin)
    
    See Also:
    
    getDayFromSeconds(long)
  - parseDate
```
public static int parseDate(CharSequence value,
                            char dateSegmentSeparator)
```
    Parses a Date value.
    
    Parameters:
    
    value - the date value
    
    dateSegmentSeparator - the separator char between each date segment
    
    Returns:
    
    the days for Date object
    
    Since:
    
    0.7.0
  - parseDateTime
```
public static long parseDateTime(CharSequence value,
                                 char dateSegmentSeparator,
                                 char dateTimeSeparator,
                                 char timeSegmentSeparator)
```
    Parses a DateTime value.
    
    Parameters:
    
    value - the date-time value
    
    dateSegmentSeparator - the separator char between each date segment
    
    dateTimeSeparator - the separator char between date and time
    
    timeSegmentSeparator - the separator char between each time segment
    
    Returns:
    
    the seconds for DateTime object
    
    Since:
    
    0.7.0
  - toDateString
```
public static void toDateString(int elapsedDays,
                                char dateSegmentSeparator,
                                StringBuilder target)
```
    Appends a string representation of Date.
    
    Parameters:
    
    elapsedDays - the number of elapsed days from 0001/01/01
    
    dateSegmentSeparator - the separator char between each date segment
    
    target - the target buffer
    
    Since:
    
    0.7.0
  - toDateTimeString
```
public static void toDateTimeString(long elapsedSeconds,
                                    char dateSegmentSeparator,
                                    char dateTimeSeparator,
                                    char timeSegmentSeparator,
                                    StringBuilder target)
```
    Appends a string representation of DateTime.
    
    Parameters:
    
    elapsedSeconds - the number of elapsed seconds from 0001/01/01 00:00:00
    
    dateSegmentSeparator - the separator char between each date segment
    
    dateTimeSeparator - the separator char between date and time
    
    timeSegmentSeparator - the separator char between each time segment
    
    target - the target buffer
    
    Since:
    
    0.7.0

Class DateUtil

Method Summary

Methods inherited from class java.lang.Object

Method Detail

getDayFromDate

getDayFromCalendar

getDayFromDate

setDayToCalendar

getSecondFromTime

getSecondFromCalendar

getSecondFromDate

setSecondToCalendar

getYearFromDay

isLeap

getDayFromYear

getMonthOfYear

getDayOfMonth

getDayFromSeconds

getSecondOfDay

parseDate

parseDateTime

toDateString

toDateTimeString