Examples of javax.time.calendar.Calendrical

javax.time.calendar.Calendrical
A flexible representation of calendrical information which may or may not be valid.
Dates and times often need to be processed even when they are not fully valid. Calendrical permits that processing to occur, however the cost is a complicated state model. Use this class with care.
Instances of calendrical hold any combination of date and time information. The five pieces of state are date, time, offset, zone and a field-value map. Each piece of state is optional, allowing the calendrical to contain incomplete information.
The state of a calendrical can conflict itself. For example, the date might be '2007-12-03' while the field-value map holds the month as February. This can be checked using {@link #checkConsistent()}. Values that can be derived from other values, such as MonthOfYear from date, can be removed using {@link #removeDerivable()}.
The state in the field-value map can also be merged according to rules. For example, parsing might read in 'HourOfAmPm=9', 'AmPm=PM' and 'MinuteOfHour=25'. Using the {@link #mergeStrict()} and related methods these different fields canbe merged into a LocalTime.
Virtually any two parts of the state can conflict. For example, the offset might be '+01:00' while the time zone is 'Asia/Tokyo'. This is invalid as the offset '+01:00' is never valid for Tokyo. This can be checked manually if desired before calling {@link #toZonedDateTime()}.
Finally, the field-value map may contain values that are outside the normal range for the field. For example, a day of month of -3 or an hour of 1000. The {@link #mergeLenient()} method can be used to interpret these values.
Each method is documented to explain how it handles the possible conflicting cases. A key method is {@link #merge(CalendricalContext)} which takes all the availabledata and attempts to merge it together into meaningful information.
Calendrical is mutable and cannot be shared safely between threads without external synchronization. @author Michael Nascimento Santos @author Stephen Colebourne

     * @throws CalendricalFormatException if an error occurs during printing
     */
    public void print(CalendricalProvider calendricalProvider, Appendable appendable) {
        FormatUtil.checkNotNull(calendricalProvider, "calendrical provider");
        FormatUtil.checkNotNull(appendable, "appendable");
        Calendrical calendrical = calendricalProvider.toCalendrical();
        try {
            printerParser.print(calendrical, appendable, symbols);
        } catch (UnsupportedCalendarFieldException ex) {
            throw new CalendricalFormatFieldException(ex);
        } catch (IOException ex) {

View Full Code Here

     * @throws IndexOutOfBoundsException if the position is invalid
     * @throws CalendricalParseException if the parse fails
     */
    public Calendrical parse(String text) {
        ParsePosition pos = new ParsePosition(0);
        Calendrical result = parse(text, pos);
        if (pos.getErrorIndex() >= 0 || pos.getIndex() < text.length()) {
            String str = text;
            if (str.length() > 64) {
                str = str.substring(0, 64) + "...";
            }

View Full Code Here

        @Override
        public StringBuffer format(Object obj, StringBuffer toAppendTo, FieldPosition pos) {
            FormatUtil.checkNotNull(obj, "object to be printed");
            FormatUtil.checkNotNull(toAppendTo, "string buffer");
            FormatUtil.checkNotNull(pos, "field position");
            Calendrical fdt = null;
            if (obj instanceof CalendricalProvider) {
                fdt = ((CalendricalProvider) obj).toCalendrical();
                if (fdt == null) {
                    throw new NullPointerException("The CalendricalProvider implementation must not return null");
                }

View Full Code Here

     * Converts this field to a <code>Calendrical</code>.
     *
     * @return the calendrical representation for this instance, never null
     */
    public Calendrical toCalendrical() {
        return new Calendrical(rule(), getValue());
    }

View Full Code Here

            .appendValue(ISOChronology.hourOfDayRule())
            .optionalStart().appendLiteral(':').appendValue(ISOChronology.minuteOfHourRule(), 2)
            .optionalStart().appendLiteral(':').appendValue(ISOChronology.secondOfMinuteRule(), 2)
            .toFormatter();
        ParsePosition pp = new ParsePosition(0);
        Calendrical cal = f.parse(str, pp);
        if (pp.getErrorIndex() >= 0) {
            throw new IllegalArgumentException(str);
        }
        return deduplicate(cal.mergeStrict().toLocalTime());
    }

View Full Code Here

        int pos = 0;
        if (str.startsWith("-")) {
            pos = 1;
        }
        ParsePosition pp = new ParsePosition(pos);
        Calendrical cal = f.parse(str, pp);
        if (pp.getErrorIndex() >= 0) {
            throw new IllegalArgumentException(str);
        }
        LocalTime time = cal.mergeStrict().toLocalTime();
        int secs = time.getHourOfDay() * 60 * 60 +
                time.getMinuteOfHour() * 60 + time.getSecondOfMinute();
        if (pos == 1) {
            secs = -secs;
        }

View Full Code Here

     * Converts this field to a <code>Calendrical</code>.
     *
     * @return the calendrical representation for this instance, never null
     */
    public Calendrical toCalendrical() {
        return new Calendrical(rule(), getValue());
    }

View Full Code Here

     * Converts this field to a <code>Calendrical</code>.
     *
     * @return the calendrical representation for this instance, never null
     */
    public Calendrical toCalendrical() {
        return new Calendrical(rule(), getValue());
    }

View Full Code Here

     */
    public DateTimeParseContext(DateTimeFormatSymbols symbols) {
        super();
        FormatUtil.checkNotNull(symbols, "symbols");
        this.symbols = symbols;
        calendricals.add(new Calendrical());
    }

View Full Code Here

     * Converts this field to a <code>Calendrical</code>.
     *
     * @return the calendrical representation for this instance, never null
     */
    public Calendrical toCalendrical() {
        return new Calendrical(rule(), getValue());
    }

View Full Code Here

0 1

TOP

Related Classes of javax.time.calendar.Calendrical

javax.time.calendar.format.DateTimeParseContext

javax.time.calendar.field.WeekOfWeekBasedYear

javax.time.calendar.field.MinuteOfHour

javax.time.i18n.CopticDate

javax.time.calendar.field.WeekBasedYear

javax.time.calendar.format.DateTimeFormatter$ClassicFormat

javax.time.calendar.field.Year

javax.time.calendar.field.DayOfYear

javax.time.calendar.field.NanoOfSecond

javax.time.calendar.field.SecondOfMinute

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.