CalendarDate (NetCDF-Java CDM Public API v5.5.4-SNAPSHOT)

java.lang.Object
- ucar.nc2.time.CalendarDate

All Implemented Interfaces:

java.lang.Comparable<CalendarDate>
```
@Immutable
public class CalendarDate
extends java.lang.Object
implements java.lang.Comparable<CalendarDate>
```
A Calendar Date. Replaces java.util.Date. Allows non-standard calendars. Default is Calendar.gregorian. Always in UTC time zone.

Since:

3/21/11

Field Summary

Fields
Modifier and Type	Field and Description
`static double`	`MILLISECS_IN_DAY`
`static double`	`MILLISECS_IN_HOUR`
`static double`	`MILLISECS_IN_MINUTE`
`static double`	`MILLISECS_IN_MONTH`
`static double`	`MILLISECS_IN_SECOND`
`static double`	`MILLISECS_IN_YEAR`
`static CalendarDate`	`UNKNOWN`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`CalendarDate`	`add(CalendarPeriod period)`
`int`	`compareTo(CalendarDate o)`
`boolean`	`equals(java.lang.Object o)`
`Calendar`	`getCalendar()`
`int`	`getDayOfMonth()`
`long`	`getDifference(CalendarDate o, CalendarPeriod.Field fld)` Get difference between two calendar dates in given Field units
`long`	`getDifferenceInMsecs(CalendarDate o)` Get difference between two calendar dates in millisecs
`int`	`getFieldValue(CalendarPeriod.Field fld)`
`int`	`getHourOfDay()` Get the hour of day (0-23) field for this chronology.
`long`	`getMillis()` Gets the milliseconds of the datetime instant from the Java epoch of 1970-01-01T00:00:00Z.
`java.lang.String`	`getTimeUnits()` udunits formatting
`int`	`hashCode()`
`boolean`	`isAfter(CalendarDate o)`
`boolean`	`isBefore(CalendarDate o)`
`static CalendarDate`	`of(Calendar cal, int year, int monthOfYear, int dayOfMonth, int hourOfDay, int minuteOfHour, int secondOfMinute)` Get Calendar date from fields.
`static CalendarDate`	`of(Calendar cal, long msecs)` Create CalendarDate from msecs since epoch Uses the given Calendar.
`static CalendarDate`	`of(java.util.Date date)` Create CalendarDate from a java.util.Date.
`static CalendarDate`	`of(long msecs)` Create CalendarDate from msecs since epoch Uses standard Calendar.
`static CalendarDate`	`parseISOformat(java.lang.String calendarName, java.lang.String isoDateString)` Get CalendarDate from ISO date string
`static CalendarDate`	`parseUdunits(java.lang.String calendarName, java.lang.String udunits)` Get CalendarDate from udunit date string
`static CalendarDate`	`parseUdunitsOrIso(java.lang.String calendarName, java.lang.String isoOrUdunits)` Get CalendarDate from ISO date string
`static CalendarDate`	`present()` Get a CalendarDate representing the present moment
`static CalendarDate`	`present(Calendar cal)`
`CalendarDate`	`subtract(CalendarPeriod period)`
`java.util.Date`	`toDate()` Get the equivilent java.util.Date
`java.util.GregorianCalendar`	`toGregorianCalendar()`
`java.lang.String`	`toString()` ISO formatted string
`CalendarDate`	`truncate(CalendarPeriod.Field fld)` truncate the CalendarDate, by zeroing all the fields that are less than the field.
`static CalendarDate`	`withDoy(Calendar cal, int year, int doy, int hourOfDay, int minuteOfHour, int secondOfMinute)`

Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait

- Field Detail
  - MILLISECS_IN_DAY
```
public static final double MILLISECS_IN_DAY
```
    See Also:
    
    Constant Field Values
  - MILLISECS_IN_HOUR
```
public static final double MILLISECS_IN_HOUR
```
    See Also:
    
    Constant Field Values
  - MILLISECS_IN_MINUTE
```
public static final double MILLISECS_IN_MINUTE
```
    See Also:
    
    Constant Field Values
  - MILLISECS_IN_MONTH
```
public static final double MILLISECS_IN_MONTH
```
    See Also:
    
    Constant Field Values
  - MILLISECS_IN_SECOND
```
public static final double MILLISECS_IN_SECOND
```
    See Also:
    
    Constant Field Values
  - MILLISECS_IN_YEAR
```
public static final double MILLISECS_IN_YEAR
```
    See Also:
    
    Constant Field Values
  - UNKNOWN
```
public static final CalendarDate UNKNOWN
```
- Method Detail
  - add
```
public CalendarDate add(CalendarPeriod period)
```
  - compareTo
```
public int compareTo(CalendarDate o)
```
    Specified by:
    
    compareTo in interface java.lang.Comparable<CalendarDate>
  - equals
```
public boolean equals(java.lang.Object o)
```
    Overrides:
    
    equals in class java.lang.Object
  - getCalendar
```
public Calendar getCalendar()
```
  - getDayOfMonth
```
public int getDayOfMonth()
```
  - getDifference
```
public long getDifference(CalendarDate o,
                          CalendarPeriod.Field fld)
```
    Get difference between two calendar dates in given Field units
    
    Parameters:
    
    o - other calendar date
    
    Returns:
    
    (this minus o) difference in units of this Field
  - getDifferenceInMsecs
```
public long getDifferenceInMsecs(CalendarDate o)
```
    Get difference between two calendar dates in millisecs
    
    Parameters:
    
    o - other calendar date
    
    Returns:
    
    (this minus o) difference in millisecs
  - getFieldValue
```
public int getFieldValue(CalendarPeriod.Field fld)
```
  - getHourOfDay
```
public int getHourOfDay()
```
    Get the hour of day (0-23) field for this chronology.
    
    Returns:
    
    hour of day (0-23)
  - getMillis
```
public long getMillis()
```
    Gets the milliseconds of the datetime instant from the Java epoch of 1970-01-01T00:00:00Z.
    
    Returns:
    
    the number of milliseconds since 1970-01-01T00:00:00Z
  - getTimeUnits
```
public java.lang.String getTimeUnits()
```
    udunits formatting
    
    Returns:
    
    udunits formatted date
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class java.lang.Object
  - isAfter
```
public boolean isAfter(CalendarDate o)
```
  - isBefore
```
public boolean isBefore(CalendarDate o)
```
  - of
```
public static CalendarDate of(Calendar cal,
                              int year,
                              int monthOfYear,
                              int dayOfMonth,
                              int hourOfDay,
                              int minuteOfHour,
                              int secondOfMinute)
```
    Get Calendar date from fields. Uses UTZ time zone
    
    Parameters:
    
    cal - calendar to use, or null for default
    
    year - any integer
    
    monthOfYear - 1-12
    
    dayOfMonth - 1-31
    
    hourOfDay - 0-23
    
    minuteOfHour - 0-59
    
    secondOfMinute - 0-59
    
    Returns:
    
    CalendarDate
  - of
```
public static CalendarDate of(Calendar cal,
                              long msecs)
```
    Create CalendarDate from msecs since epoch Uses the given Calendar.
    
    Parameters:
    
    cal - calendar to use, or null for default
    
    msecs - milliseconds from 1970-01-01T00:00:00Z
    
    Returns:
    
    CalendarDate in UTC time zone.
  - of
```
public static CalendarDate of(java.util.Date date)
```
    Create CalendarDate from a java.util.Date. Uses standard Calendar.
    
    Parameters:
    
    date - java.util.Date
    
    Returns:
    
    CalendarDate in UTC
  - of
```
public static CalendarDate of(long msecs)
```
    Create CalendarDate from msecs since epoch Uses standard Calendar.
    
    Parameters:
    
    msecs - milliseconds from 1970-01-01T00:00:00Z
    
    Returns:
    
    CalendarDate in UTC
  - parseISOformat
```
public static CalendarDate parseISOformat(java.lang.String calendarName,
                                          java.lang.String isoDateString)
```
    Get CalendarDate from ISO date string
    
    Parameters:
    
    calendarName - get Calendar from Calendar.get(calendarName). may be null
    
    isoDateString - ISO date string
    
    Returns:
    
    CalendarDate
  - parseUdunits
```
public static CalendarDate parseUdunits(java.lang.String calendarName,
                                        java.lang.String udunits)
```
    Get CalendarDate from udunit date string
    
    Parameters:
    
    calendarName - get Calendar from Calendar.get(calendarName). may be null
    
    udunits - must be value (space) udunits string
    
    Returns:
    
    CalendarDate
  - parseUdunitsOrIso
```
@Nullable
public static CalendarDate parseUdunitsOrIso(java.lang.String calendarName,
                                                       java.lang.String isoOrUdunits)
```
    Get CalendarDate from ISO date string
    
    Parameters:
    
    calendarName - get Calendar from Calendar.get(calendarName). may be null
    
    isoOrUdunits - ISO or udunits date string
    
    Returns:
    
    CalendarDate or null if not valid
  - present
```
public static CalendarDate present()
```
    Get a CalendarDate representing the present moment
    
    Returns:
    
    CalendarDate representing the present moment in UTC
  - present
```
public static CalendarDate present(Calendar cal)
```
  - subtract
```
public CalendarDate subtract(CalendarPeriod period)
```
  - toDate
```
public java.util.Date toDate()
```
    Get the equivilent java.util.Date
    
    Returns:
    
    the equivalent Date
  - toGregorianCalendar
```
public java.util.GregorianCalendar toGregorianCalendar()
```
  - toString
```
public java.lang.String toString()
```
    ISO formatted string
    
    Overrides:
    
    toString in class java.lang.Object
    
    Returns:
    
    ISO8601 format (yyyy-MM-ddTHH:mm:ss.SSSZ)
  - truncate
```
public CalendarDate truncate(CalendarPeriod.Field fld)
```
    truncate the CalendarDate, by zeroing all the fields that are less than the field. So 2013-03-01T19:30 becomes 2013-03-01T00:00 if the field is "day"
    
    Parameters:
    
    fld - set to 0 all fields less than this one
    
    Returns:
    
    truncated result
  - withDoy
```
public static CalendarDate withDoy(Calendar cal,
                                   int year,
                                   int doy,
                                   int hourOfDay,
                                   int minuteOfHour,
                                   int secondOfMinute)
```

Class CalendarDate

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

MILLISECS_IN_DAY

MILLISECS_IN_HOUR

MILLISECS_IN_MINUTE

MILLISECS_IN_MONTH

MILLISECS_IN_SECOND

MILLISECS_IN_YEAR

UNKNOWN

Method Detail

add

compareTo

equals

getCalendar

getDayOfMonth

getDifference

getDifferenceInMsecs

getFieldValue

getHourOfDay

getMillis

getTimeUnits

hashCode

isAfter

isBefore

of

of

of

of

parseISOformat

parseUdunits

parseUdunitsOrIso

present

present

subtract

toDate

toGregorianCalendar

toString

truncate

withDoy