How to use

ucar.nc2.time.CalendarDateUnit

constructor

/**
 * Create a CalendarDateUnit from a calendar and a udunit string = "unit since calendarDate"
 * @param calt use this Calendar, or null for default calendar
 * @param udunitString "unit since calendarDate"
 * @return CalendarDateUnit
 * @throws IllegalArgumentException if udunitString is not paresable
 */
static public CalendarDateUnit withCalendar(Calendar calt, String udunitString) {
 if (calt == null)
  calt = Calendar.getDefault();
 return new CalendarDateUnit(calt, udunitString);
}

/**
 * Create a CalendarDateUnit from a calendar and a udunit string = "unit since calendarDate"
 * @param calt use this Calendar, or null for default calendar
 * @param udunitString "unit since calendarDate"
 * @return CalendarDateUnit
 * @throws IllegalArgumentException if udunitString is not paresable
 */
static public CalendarDateUnit withCalendar(Calendar calt, String udunitString) {
 if (calt == null) calt = Calendar.getDefault();
 return new CalendarDateUnit(calt, udunitString);
}

/**
 * Create a CalendarDateUnit from a calendar, a CalendarPeriod.Field, and a base date
 * @param calt use this Calendar, or null for default calendar
 * @param periodField a CalendarPeriod.Field like Hour or second
 * @param baseDate "since baseDate"
 * @return CalendarDateUnit
 */
static public CalendarDateUnit of(Calendar calt, CalendarPeriod.Field periodField, CalendarDate baseDate) {
 if (calt == null) calt = Calendar.getDefault();
 return new CalendarDateUnit(calt, periodField, baseDate);
}

/**
 * Create a CalendarDateUnit from a calendar, a CalendarPeriod.Field, and a base date
 * @param calt use this Calendar, or null for default calendar
 * @param periodField a CalendarPeriod.Field like Hour or second
 * @param baseDate "since baseDate"
 * @return CalendarDateUnit
 */
static public CalendarDateUnit of(Calendar calt, CalendarPeriod.Field periodField, CalendarDate baseDate) {
 if (calt == null) calt = Calendar.getDefault();
 return new CalendarDateUnit(calt, periodField, baseDate);
}

/**
 * Create a CalendarDateUnit from a calendar and a udunit string = "unit since calendarDate"
 * @param calt use this Calendar, or null for default calendar
 * @param udunitString "unit since calendarDate"
 * @return CalendarDateUnit
 * @throws IllegalArgumentException if udunitString is not paresable
 */
static public CalendarDateUnit withCalendar(Calendar calt, String udunitString) {
 if (calt == null) calt = Calendar.getDefault();
 return new CalendarDateUnit(calt, udunitString);
}

/**
 * Create a CalendarDateUnit from a calendar name and a udunit string = "unit since calendarDate"
 * @param calendarName must match a calendar enum, or one of its aliases, see ucar.nc2.time.Calendar.get()
 * @param udunitString "unit since calendarDate"
 * @return CalendarDateUnit
 * @throws IllegalArgumentException if udunitString is not paresable
 */
static public CalendarDateUnit of(String calendarName, String udunitString) {
 Calendar calt = Calendar.get(calendarName);
 if (calt == null) calt = Calendar.getDefault();
 return new CalendarDateUnit(calt, udunitString);
}

/**
 * Create a CalendarDateUnit from a calendar name and a udunit string = "unit since calendarDate"
 * @param calendarName must match a calendar enum, or one of its aliases, see ucar.nc2.time.Calendar.get()
 * @param udunitString "unit since calendarDate"
 * @return CalendarDateUnit
 * @throws IllegalArgumentException if udunitString is not paresable
 */
static public CalendarDateUnit of(String calendarName, String udunitString) {
 Calendar calt = Calendar.get(calendarName);
 if (calt == null) calt = Calendar.getDefault();
 return new CalendarDateUnit(calt, udunitString);
}

/**
 * Create a CalendarDateUnit from a calendar name and a udunit string = "unit since calendarDate"
 * @param calendarName must match a calendar enum, or one of its aliases, see ucar.nc2.time.Calendar.get()
 * @param udunitString "unit since calendarDate"
 * @return CalendarDateUnit
 * @throws IllegalArgumentException if udunitString is not paresable
 */
static public CalendarDateUnit of(String calendarName, String udunitString) {
 Calendar calt = Calendar.get(calendarName);
 if (calt == null)
  calt = Calendar.getDefault();
 return new CalendarDateUnit(calt, udunitString);
}