Lines Matching full:interval
19 * \brief C++ API: Format and parse date interval in a language-independent manner.
40 * Date interval means from one date to another date,
49 * For example, the date interval format from "Jan 11, 2008" to "Jan 18,. 2008"
62 * We introduce class DateIntervalInfo to save date interval
66 * Logically, the interval patterns are mappings
95 * The calendar fields we support for interval formatting are:
109 * For other calendar fields, the compact interval formatting is not
110 * supported. And the interval format will be fall back to fall-back
115 * There are pre-defined interval patterns for those pre-defined skeletons
119 * is "year", the date interval pattern is "MMM d, yyyy - MMM d, yyyy",
122 * the date interval pattern is "MMM d - MMM d, yyyy",
125 * the date interval pattern is "MMM d-d, yyyy", such as "Jan 10-20, 2007".
127 * For date skeleton, the interval patterns when year, or month, or date is
129 * For time skeleton, the interval patterns when am/pm, or hour, or minute is
134 * the interval patterns for the skeleton is not defined in resource file,
135 * the interval pattern will falls back to the interval "fallback" pattern
137 * If the interval "fallback" pattern is not defined, the default fall-back
142 * The rule to generate interval patterns are:
146 * interval pattern, which mostly is the concatenate the two original
148 * For example, interval pattern from "Jan 10, 2007 10:10 am"
155 * For example, interval pattern from "Jan 10, 2007 10:10 am"
162 * If two dates are the same, the interval pattern is the single date pattern.
163 * For example, interval pattern from "Jan 10, 2007" to "Jan 10, 2007" is
167 * the interval pattern is the single date pattern.
169 * the interval pattern from "Jan 10, 2007" to "Jan 20, 2007" is "Jan 2007".
174 * and date interval patterns.
179 * Users are encouraged to created date interval formatter this way and
188 * interval patterns.
191 * DateIntervalInfo provides the date interval patterns.
204 * // the date interval object which the DateIntervalFormat formats on
231 * @param skeleton the skeleton on which interval format based.
233 * @return a date time interval formatter which the caller owns.
244 * the date interval pattern information is load from resource files.
245 * Users are encouraged to created date interval formatter this way and
250 * interval patterns in resource files.
255 * The given Locale provides the interval patterns.
258 * the interval patterns defined in resource file to above skeleton are:
262 * @param skeleton the skeleton on which the interval format is based.
265 * @return a date time interval formatter which the caller owns.
288 * @param skeleton the skeleton on which interval format based.
291 * @return a date time interval formatter which the caller owns.
304 * In this factory method, user provides its own date interval pattern
307 * interval patterns.
310 * interval patterns in resource files.
315 * The DateIntervalInfo provides the interval patterns.
318 * User are encouraged to set default interval pattern in DateIntervalInfo
319 * as well, if they want to set other interval patterns ( instead of
320 * reading the interval patterns from resource files).
321 * When the corresponding interval pattern for a largest calendar different
322 * field is not found ( if user not set it ), interval format fallback to
323 * the default interval pattern.
324 * If user does not provide default interval pattern, it fallback to
327 * @param skeleton the skeleton on which interval format based.
331 * @return a date time interval formatter which the caller owns.
393 * in an interval format; in this case the fieldPosition
415 * in an interval format; in this case the fieldPosition
433 * @param fromCalendar calendar set to the from date in date interval
434 * to be formatted into date interval string
435 * @param toCalendar calendar set to the to date in date interval
436 * to be formatted into date interval string
442 * in an interval format; in this case the fieldPosition
457 * Date interval parsing is not supported. Please do not use.
460 * date time interval strings into Formattable objects with
488 * Gets the date time interval patterns.
489 * @return the date time interval patterns associated with
490 * this date interval formatter.
497 * Set the date time interval patterns.
498 * @param newIntervalPatterns the given interval patterns to copy.
508 * @return the date formatter associated with this date interval formatter.
579 * Save the interval pattern information.
580 * Interval pattern consists of 2 single date patterns and the separator.
581 * For example, interval pattern "MMM d - MMM d, yyyy" consists
586 * Also, the first date appears in an interval pattern could be
588 * And such information is saved in the interval pattern as well.
594 * Whether the first date in interval pattern is later date or not.
596 * And for a particular interval pattern, the order can be
597 * overriden by prefixing the interval pattern with "latestFirst:" or
601 * and the pattern is "d MMM - d MMM yyyy", the interval format is
604 * the interval format is "10 Feb - 10 Jan, 2007"
623 * the DateIntervalInfo provides the interval patterns.
629 * @param locale the locale of this date interval formatter.
644 * @param locale the locale of this date interval formatter.
648 * @return a date time interval formatter which the caller owns.
656 * Below are for generating interval patterns local to the formatter
683 * Format 2 Calendars using fall-back interval pattern
688 * @param fromCalendar calendar set to the from date in date interval
689 * to be formatted into date interval string
690 * @param toCalendar calendar set to the to date in date interval
691 * to be formatted into date interval string
711 * Initialize interval patterns locale to this formatter
714 * 1. the interval patterns saved in resource bundle files are interval
716 * It does not have interval patterns based on both date and time.
717 * Interval patterns on both date and time are algorithm generated.
719 * For example, it has interval patterns on skeleton "dMy" and "hm",
720 * but it does not have interval patterns on skeleton "dMyhm".
722 * The rule to generate interval patterns for both date and time skeleton are
725 * For example, interval pattern from "Jan 10, 2007 10:10 am"
731 * For example, interval pattern from "Jan 10, 2007 10:10 am"
736 * the interval pattern needs to include such field if such fields are
738 * For example, a pattern/skeleton is "hm", but the interval pattern
749 * Set fall back interval pattern given a calendar field,
794 * Generate date or time interval pattern from resource,
795 * and set them into the interval pattern locale to this formatter.
799 * For example, the interval patterns saved in DateIntervalInfo
801 * Need to get interval patterns for dMMMMy from dMMMy.
802 * Another example, the interval patterns saved in DateIntervalInfo
804 * Need to get interval patterns for "hmz' from 'hmv'
807 * in order to get interval patterns for 'y' differ,
813 * TRUE if interval pattern found for the skeleton,
823 * Generate interval pattern from existing resource
825 * It not only save the interval patterns,
830 * @param bestSkeleton the best match skeleton which has interval pattern
840 * @return whether the interval pattern is found
842 * TRUE if interval pattern is found by
853 * Adjust field width in best match interval pattern to match
867 * Since date interval format is well-formed format,
874 * @param bestMatchIntervalPattern the best match interval pattern
878 * @param adjustedIntervalPattern adjusted interval pattern
888 * Concat a single date pattern with a time interval pattern,
890 * This is used to handle time interval patterns on skeleton with
914 * Split interval patterns into 2 part.
915 * @param intervalPattern interval pattern
916 * @return the index in interval pattern which split the pattern into 2 part
922 * Break interval patterns as 2 part and save them into pattern info.
924 * @param intervalPattern interval pattern
931 * Break interval patterns as 2 part and save them into pattern info.
933 * @param intervalPattern interval pattern
934 * @param laterDateFirst whether later date appear first in interval pattern
945 * @param firstPart the first part in interval pattern
946 * @param secondPart the second part in interval pattern
961 * The interval patterns for this locale.
981 * Following are interval information relevant (locale) to this formatter.
