How to use

Date

in

org.stjs.javascript

/**
 * Computes the date from the given arguments interpreting them as UTC and 
 * returns the corresponding time value.
 * 
 * <p>The <tt>UTC</tt> function differs from the <tt>Date</tt> constructor 
 * in two ways: it returns a time value as a <tt>Number</tt>, rather than 
 * creating a <tt>Date</tt> object, and it interprets the arguments in UTC
 * rather than as local time.
 * 
 * @param year the year (in UTC time zone)
 * @param month the month of the year (in UTC time zone)
 * @param day the day of the month (in UTC time zone)
 * @param hours the hour of the day (in UTC time zone)
 * @param minutes the minute of the hour (in UTC time zone)
 * @param seconds the second of the minute (in UTC time zone)
 * @param ms the milliseconds of the second (in UTC time zone)
 * @return the UTC time value corresponding to the given arguments
 */
public static double UTC(int year, int month, int day, int hours, int minutes, int seconds, int ms) {
  return new Date(year, month, day, hours, minutes, seconds, ms).getTime();
}
 

/**
 * Computes the date from the given arguments interpreting them as UTC with
 * the <tt>hours</tt>, <tt>minutes</tt>, <tt>seconds</tt> and 
 * <tt>milliseconds</tt> fields set to 0 and returns the corresponding time 
 * value.
 * 
 * <p>The <tt>UTC</tt> function differs from the <tt>Date</tt> constructor 
 * in two ways: it returns a time value as a <tt>Number</tt>, rather than 
 * creating a <tt>Date</tt> object, and it interprets the arguments in UTC
 * rather than as local time.
 * 
 * @param year the year (in UTC time zone)
 * @param month the month of the year (in UTC time zone)
 * @param day the day of the month (in UTC time zone)
 * @return the UTC time value corresponding to the given arguments
 */
public static double UTC(int year, int month, int day) {
  return UTC(year, month, day, 0);
}

/**
 * Returns the minutes of the hour corresponding to this <tt>Date</tt>'s time 
 * value, in the local time zone. 
 * 
 * @return the minutes of the hour corresponding to this <tt>Date</tt>'s time value, in the local time zone.
 */
public double getMinutes() {
  return getField(getCalendar(false), Calendar.MINUTE);
}

/**
 * Sets the month of year field of this <tt>Date</tt> interpreted in the 
 * local time zone. Month numbers are 0 indexed, with January being 0 
 * and December being 11.
 * 
 * @param month the new month
 */
public void setMonth(int month) {
  setMonth(month, (int)getDay());
}
 

/**
 * Sets the month of year and day of month fields of this <tt>Date</tt> 
 * interpreted in the local time zone. Month numbers are 0 indexed, with 
 * January being 0 and December being 11.
 * 
 * @param month the new month
 * @param day the new day of month
 */
public void setMonth(int month, int day) {
  setField(getCalendar(true), Calendar.MONTH, month);
  setDate(day);
}

public static String Date() {
  return new Date().toString();
}

@Override
public Date deserialize(JsonElement elem, Type typeOfT, JsonDeserializationContext context)
    throws JsonParseException {
  if (elem == null) {
    return null;
  }
  return new Date(elem.getAsString());
}

  /**
   * Returns the time value associated to this <tt>Date</tt>
   * 
   * @return the time value associated to this <tt>Date</tt>
   */
  public double valueOf() {
    return getTime();
  }
}

/**
 * Sets the minutes, seconds and milliseconds field of this <tt>Date</tt> 
 * interpreted in the local time zone.
 * 
 * @param min the new minutes
 * @param sec the new seconds
 * @param ms the new milliseconds
 */
public void setMinutes(int min, int sec, int ms) {
  setField(getCalendar(true), Calendar.MINUTE, min);
  setSeconds(sec, ms);
}

/**
 * Sets the seconds and milliseconds fields of this <tt>Date</tt> 
 * interpreted in the local time zone.
 * 
 * @param sec the new seconds
 * @param ms the new milliseconds
 */
public void setSeconds(int sec, int ms) {
  setField(getCalendar(true), Calendar.SECOND, sec);
  setMilliseconds(ms);
}
 

/**
 * Sets the year, month and day of month fields of this <tt>Date</tt> 
 * interpreted in the local time zone.
 * 
 * @param year the new year
 * @param month the new month
 * @param day the new day of month
 */
public void setFullYear(int year, int month, int day) {
  setField(getCalendar(true), Calendar.YEAR, year);
  setMonth(month, day);
}

/**
 * Sets the hours, minutes, seconds and milliseconds field of this 
 * <tt>Date</tt> interpreted in the local time zone.
 * 
 * @param hour the new hour
 * @param min the new minutes
 * @param sec the new seconds
 * @param ms the new milliseconds
 */
public void setHours(int hour, int min, int sec, int ms) {
  setField(getCalendar(true), Calendar.HOUR_OF_DAY, hour);
  setMinutes(min, sec, ms);
}

/**
 * Sets the time value of this <tt>Date</tt> directly
 *  
 * @param time the new time value for this <tt>Date</tt>
 */
public void setTime(long time) {
  getCalendar(true).setTimeInMillis(time);
}

/**
 * Sets the day of month field of this <tt>Date</tt> interpreted in the 
 * local time zone.
 * 
 * @param day the new day of month
 */
public void setDate(int day) {
  setField(getCalendar(true), Calendar.DAY_OF_WEEK, day);
}

/**
 * Sets the year and month fields of this <tt>Date</tt> 
 * interpreted in the local time zone.
 * 
 * @param year the new year
 * @param month the new month
 */
public void setFullYear(int year, int month) {
  setFullYear(year, month, (int)getDate());
}

@Override
public Date deserialize(JsonParser jp, DeserializationContext ctxt) throws IOException, JsonProcessingException {
  return new Date(jp.getText());
}

public static String toNormalizedString(Date d) {
  // TODO - improve perf here
  return new SimpleDateFormat(DEFAULT_DATE_PATTERN).format(new java.util.Date((long) d.getTime()));
}

/**
 * Returns the time value associated to this <tt>Date</tt>
 * 
 * @return the time value associated to this <tt>Date</tt>
 */
public double getTime() {
  if (getCalendar(false) != null) {
    return calendar.getTimeInMillis();
  }
  return Double.NaN;
}

/**
 * Sets the milliseconds field of this <tt>Date</tt> interpreted in the local time zone.
 * 
 * @param ms the new milliseconds
 */
public void setMilliseconds(int ms) {
  setField(getCalendar(true), Calendar.MILLISECOND, ms);
}

/**
 * Updates the ID timestamp of the object, for versioning purposes.
 *
 * @method updateTimestamp
 */
public void updateTimestamp() {
  String rawId = id.substring(0, id.lastIndexOf("/"));
  if (rawId.endsWith("/") == false)
    rawId += "/";
  rawId += new Date().getTime();
  id = rawId;
}