Lines Matching +full:not +full:- +full:date
3 * Copyright (C) 1996-2015, International Business Machines
24 * <h2> Date Format C API</h2>
26 * Date Format C API consists of functions that convert dates and
28 * language-independent manner. Converting from the internal representation (milliseconds
32 * date formatting and parsing actions.
34 * Date Format helps you to format and parse dates for any locale. Your code can
38 * To format a date for the current Locale with default time and date style,
45 * UDateFormat* dfmt = udat_open(UDAT_DEFAULT, UDAT_DEFAULT, NULL, NULL, -1, NULL, -1, &status);
64 * UDateFormat* df = udat_open(UDAT_DEFAULT, UDAT_DEFAULT, NULL, NULL, -1, NULL, 0, &status);
77 * To get specific fields of a date, you can use UFieldPosition to
88 * UDateFormat* dfmt = udat_open(UDAT_DEFAULT, UDAT_DEFAULT, NULL, -1, NULL, 0, &status);
95 * printf("date format: %s\n", u_austrcpy(buffer, myString));
100 * To format a date for a different Locale, specify it in the call to
104 * UDateFormat* df = udat_open(UDAT_SHORT, UDAT_SHORT, "fr_FR", NULL, -1, NULL, 0, &status);
115 * You can pass in different options for the arguments for date and time style
135 * <p><strong>Date and Time Patterns:</strong></p>
137 * <p>Date and time formats are specified by <em>date and time pattern</em> strings.
138 * Within date and time pattern strings, all unquoted ASCII letters [A-Za-z] are reserved
140 * the date and time formatting algorithm and pattern letters defined by
141 * <a href="http://www.unicode.org/reports/tr35/tr35-dates.html#Date_Field_Symbol_Table">UTS#35
143 …tes.google.com/site/icuprojectuserguide/formatparse/datetime?pli=1#TOC-Date-Field-Symbol-Table">ICU
147 /** A date formatter.
153 /** The possible date/time format styles
168 /** Bitfield for relative date */
181 UDAT_NONE = -1,
188 UDAT_PATTERN = -2,
199 * Constant for date skeleton with year.
204 * Constant for date skeleton with quarter.
209 * Constant for date skeleton with abbreviated quarter.
214 * Constant for date skeleton with year and quarter.
219 * Constant for date skeleton with year and abbreviated quarter.
224 * Constant for date skeleton with month.
229 * Constant for date skeleton with abbreviated month.
234 * Constant for date skeleton with numeric month.
239 * Constant for date skeleton with year and month.
244 * Constant for date skeleton with year and abbreviated month.
249 * Constant for date skeleton with year and numeric month.
254 * Constant for date skeleton with day.
259 * Constant for date skeleton with year, month, and day.
260 * Used in combinations date + time, date + time + zone, or time + zone.
265 * Constant for date skeleton with year, abbreviated month, and day.
266 * Used in combinations date + time, date + time + zone, or time + zone.
271 * Constant for date skeleton with year, numeric month, and day.
272 * Used in combinations date + time, date + time + zone, or time + zone.
277 * Constant for date skeleton with weekday.
282 * Constant for date skeleton with abbreviated weekday.
287 * Constant for date skeleton with year, month, weekday, and day.
288 * Used in combinations date + time, date + time + zone, or time + zone.
293 * Constant for date skeleton with year, abbreviated month, weekday, and day.
294 * Used in combinations date + time, date + time + zone, or time + zone.
299 * Constant for date skeleton with year, numeric month, weekday, and day.
300 * Used in combinations date + time, date + time + zone, or time + zone.
305 * Constant for date skeleton with long month and day.
306 * Used in combinations date + time, date + time + zone, or time + zone.
311 * Constant for date skeleton with abbreviated month and day.
312 * Used in combinations date + time, date + time + zone, or time + zone.
317 * Constant for date skeleton with numeric month and day.
318 * Used in combinations date + time, date + time + zone, or time + zone.
323 * Constant for date skeleton with month, weekday, and day.
324 * Used in combinations date + time, date + time + zone, or time + zone.
329 * Constant for date skeleton with abbreviated month, weekday, and day.
330 * Used in combinations date + time, date + time + zone, or time + zone.
335 * Constant for date skeleton with numeric month, weekday, and day.
336 * Used in combinations date + time, date + time + zone, or time + zone.
344 * Constant for date skeleton with hour, with the locale's preferred hour format (12 or 24).
349 * Constant for date skeleton with hour in 24-hour presentation.
354 * Constant for date skeleton with minute.
359 …* Constant for date skeleton with hour and minute, with the locale's preferred hour format (12 or …
360 * Used in combinations date + time, date + time + zone, or time + zone.
365 * Constant for date skeleton with hour and minute in 24-hour presentation.
366 * Used in combinations date + time, date + time + zone, or time + zone.
371 * Constant for date skeleton with second.
376 * Constant for date skeleton with hour, minute, and second,
378 * Used in combinations date + time, date + time + zone, or time + zone.
383 * Constant for date skeleton with hour, minute, and second in
384 * 24-hour presentation.
385 * Used in combinations date + time, date + time + zone, or time + zone.
390 * Constant for date skeleton with minute and second.
391 * Used in combinations date + time, date + time + zone, or time + zone.
400 * used in combinations date + time + zone, or time + zone.
401 …* @see <a href="http://unicode.org/reports/tr35/#Date_Format_Patterns">LDML Date Format Patterns</…
407 * Constant for <i>generic non-location format</i>, such as Pacific Time;
408 * used in combinations date + time + zone, or time + zone.
409 …* @see <a href="http://unicode.org/reports/tr35/#Date_Format_Patterns">LDML Date Format Patterns</…
415 * Constant for <i>generic non-location format</i>, abbreviated if possible, such as PT;
416 * used in combinations date + time + zone, or time + zone.
417 …* @see <a href="http://unicode.org/reports/tr35/#Date_Format_Patterns">LDML Date Format Patterns</…
423 * Constant for <i>specific non-location format</i>, such as Pacific Daylight Time;
424 * used in combinations date + time + zone, or time + zone.
425 …* @see <a href="http://unicode.org/reports/tr35/#Date_Format_Patterns">LDML Date Format Patterns</…
431 * Constant for <i>specific non-location format</i>, abbreviated if possible, such as PDT;
432 * used in combinations date + time + zone, or time + zone.
433 …* @see <a href="http://unicode.org/reports/tr35/#Date_Format_Patterns">LDML Date Format Patterns</…
439 * Constant for <i>localized GMT/UTC format</i>, such as GMT+8:00 or HPG-8:00;
440 * used in combinations date + time + zone, or time + zone.
441 …* @see <a href="http://unicode.org/reports/tr35/#Date_Format_Patterns">LDML Date Format Patterns</…
451 * Constant for date skeleton with standalone month.
456 * Constant for date skeleton with standalone abbreviated month.
462 * Constant for date skeleton with hour, minute, and generic timezone.
467 * Constant for date skeleton with hour, minute, and timezone.
472 * Constant for date skeleton with hour and generic timezone.
477 * Constant for date skeleton with hour and timezone.
520 * UDAT_HOUR_OF_DAY1_FIELD is used for the one-based 24-hour clock.
529 * UDAT_HOUR_OF_DAY0_FIELD is used for the zero-based 24-hour clock.
555 * resolution and a fractional seconds sub-pattern of SSS. If the
556 * sub-pattern is S or SS, the fractional seconds value will be truncated
557 * (not rounded) to the number of display places specified. If the
558 * fractional seconds sub-pattern is longer than SSS, the additional
609 * UDAT_HOUR1_FIELD is used for the one-based 12-hour clock.
618 * UDAT_HOUR0_FIELD is used for the zero-based 12-hour clock.
708 * corresponding to stand-alone quarters. This is
710 * This displays the stand-alone quarter.
777 * Valid selectors range from 0 to UDAT_FIELD_COUNT-1.
799 * Note: since the mapping is many-to-one, there is no inverse mapping.
815 * are not currently supported).
822 * relative date formatting only affects a limited range of calendar days before or
823 * after the current date, based on the CLDR <field type="day">/<relative> data: For
825 * dates are formatted using the corresponding non-relative style.
829 * @param tzIDLength The length of tzID, or -1 if null-terminated.
831 * @param patternLength The number of characters in the pattern, or -1 if null-terminated.
878 * e.g. accepting "--mon-02-march-2011" for a pattern of "'--: 'EEE-WW-MMMM-yyyy"
890 * count boolean date format constants
899 * If the formatter does not understand the attribute, -1 is returned.
911 …* An example of a boolean attribute is parse leniency control. If the formatter does not understa…
956 * Format a date using a UDateFormat.
957 * The date will be formatted using the conventions specified in {@link #udat_open }
959 * @param dateToFormat The date to format
962 * @param position A pointer to a UFieldPosition. On input, position->field
963 * is read. On output, position->beginIndex and position->endIndex indicate
964 * the beginning and ending indices of field number position->field, if such
983 * Format a date using an UDateFormat.
984 * The date will be formatted using the conventions specified in {@link #udat_open }
987 * mutated if fields are not yet fully calculated, though
988 * the function won't change the logical date and time held
992 * @param position A pointer to a UFieldPosition. On input, position->field
993 * is read. On output, position->beginIndex and position->endIndex indicate
994 * the beginning and ending indices of field number position->field, if such
1013 * Format a date using a UDateFormat.
1014 * The date will be formatted using the conventions specified in {@link #udat_open}
1018 * The date to format
1025 * (may be NULL if field position information is not needed). Any
1048 * Format a date using a UDateFormat.
1049 * The date will be formatted using the conventions specified in {@link #udat_open }
1054 * are not yet fully calculated, though the function won't change the logical
1055 * date and time held by the instance.
1062 * (may be NULL if field position information is not needed). Any
1088 * Parse a string into an date/time using a UDateFormat.
1089 * The date will be parsed using the conventions specified in {@link #udat_open }.
1091 * Note that the normal date formats associated with some calendars - such
1092 * as the Chinese lunar calendar - do not specify enough fields to enable
1094 * calendar, while the year within the current 60-year cycle is specified,
1095 * the number of such cycles since the start date of the calendar (in the
1096 * UCAL_ERA field of the UCalendar object) is not normally part of the format,
1099 * passed in set to the current date, or to a date within the era/cycle that
1104 * @param textLength The length of text, or -1 if null-terminated.
1105 * @param parsePos If not 0, on input a pointer to an integer specifying the offset at which
1106 * to begin parsing. If not 0, on output the offset at which parsing ended.
1108 * @return The value of the parsed date/time
1120 * Parse a string into an date/time using a UDateFormat.
1121 * The date will be parsed using the conventions specified in {@link #udat_open }.
1123 * @param calendar A calendar set on input to the date and time to be used for
1124 * missing values in the date/time string being parsed, and set
1125 * on output to the parsed date/time. When the calendar type is
1133 * @param textLength The length of text, or -1 if null-terminated.
1134 * @param parsePos If not 0, on input a pointer to an integer specifying the offset at which
1135 * to begin parsing. If not 0, on output the offset at which parsing ended.
1150 * With lenient parsing, the parser may use heuristics to interpret inputs that do not
1162 * With lenient parsing, the parser may use heuristics to interpret inputs that do not
1200 * A UDateFormat uses a UNumberFormat to format numbers within a date,
1228 * If the field is not numeric, then override has no effect (like "MMM" will use abbreviation, not n…
1244 * A UDateFormat uses a UNumberFormat to format numbers within a date,
1259 * A UDateFormat uses a UNumberFormat to format numbers within a date,
1270 * Get a locale for which date/time formatting patterns are available.
1274 * @return A locale for which date/time formatting patterns are available, or 0 if none.
1282 * Determine how many locales have date/time formatting patterns available.
1285 * @return The number of locales for which date/time formatting patterns are available.
1293 * Get the year relative to which all 2-digit years are interpreted.
1294 * For example, if the 2-digit start year is 2100, the year 99 will be
1298 * @return The year relative to which all 2-digit years are interpreted.
1307 * Set the year relative to which all 2-digit years will be interpreted.
1308 * For example, if the 2-digit start year is 2100, the year 99 will be
1311 * @param d The year relative to which all 2-digit years will be interpreted.
1346 * @param patternLength The length of pattern, or -1 if null-terminated.
1357 * The possible types of date format symbols
1367 /** The CLDR-style format "wide" weekday names, for example Monday */
1370 * The CLDR-style format "abbreviated" (not "short") weekday names, for example "Mon."
1371 * For the CLDR-style format "short" weekday names, use UDAT_SHORTER_WEEKDAYS.
1382 /** The CLDR-style format "narrow" weekday names, for example "M" */
1388 /** The CLDR-style stand-alone "wide" weekday names */
1391 * The CLDR-style stand-alone "abbreviated" (not "short") weekday names.
1392 * For the CLDR-style stand-alone "short" weekday names, use UDAT_STANDALONE_SHORTER_WEEKDAYS.
1395 /** The CLDR-style stand-alone "narrow" weekday names */
1405 * The CLDR-style short weekday names, e.g. "Su", Mo", etc.
1407 * above, which actually get the CLDR-style *abbreviated* versions of the
1419 * udat_setSymbols not supported for UDAT_CYCLIC_YEARS_WIDE)
1430 * udat_setSymbols not supported for UDAT_CYCLIC_YEARS_NARROW)
1436 * udat_setSymbols not supported for UDAT_ZODIAC_NAMES_WIDE)
1447 * udat_setSymbols not supported for UDAT_ZODIAC_NAMES_NARROW)
1454 /** Date format symbols.
1462 * The symbols are what a UDateFormat uses to represent locale-specific data,
1502 * The symbols are what a UDateFormat uses to represent locale-specific data,
1509 * @param valueLength The length of value, or -1 if null-terminated
1524 * Get the locale for this date format object.
1562 * Extract the date pattern from a UDateFormat set for relative date formatting.
1579 * Extract the time pattern from a UDateFormat set for relative date formatting.
1596 * Set the date & time patterns used by a UDateFormat set for relative date formatting.
1599 * @param datePattern The new date pattern
1600 * @param datePatternLength The length of datePattern, or -1 if null-terminated.
1602 * @param timePatternLength The length of timePattern, or -1 if null-terminated.
1636 * Un-Register a provider factory