From c6902ad571563fc2544fb0b87b3528e530c14854 Mon Sep 17 00:00:00 2001 From: Bing Long Date: Fri, 26 Apr 2013 19:23:57 +0000 Subject: [PATCH] ICU-100113 Added DateTimePatternGeneratorSample.java. Updated the API document in datetimepatterngenerator class for getBestPattern, addPattern, replaceFieldTypes. X-SVN-Rev: 33555 --- .../icu/text/DateTimePatternGenerator.java | 48 +---- .../DateTimePatternGeneratorSample.java | 184 ++++++++++++++++++ 2 files changed, 187 insertions(+), 45 deletions(-) create mode 100644 icu4j/samples/src/com/ibm/icu/samples/text/datetimepatterngenerator/DateTimePatternGeneratorSample.java diff --git a/icu4j/main/classes/core/src/com/ibm/icu/text/DateTimePatternGenerator.java b/icu4j/main/classes/core/src/com/ibm/icu/text/DateTimePatternGenerator.java index 420f2be18c9..955a51ef5f7 100644 --- a/icu4j/main/classes/core/src/com/ibm/icu/text/DateTimePatternGenerator.java +++ b/icu4j/main/classes/core/src/com/ibm/icu/text/DateTimePatternGenerator.java @@ -42,48 +42,6 @@ import com.ibm.icu.util.UResourceBundle; * The main method people will use is getBestPattern(String skeleton), since * normally this class is pre-built with data from a particular locale. However, * generators can be built directly from other data as well. - * 
- * // some simple use cases
- * Date sampleDate = new Date(99, 9, 13, 23, 58, 59);
- * ULocale locale = ULocale.GERMANY;
- * TimeZone zone = TimeZone.getTimeZone("Europe/Paris");
- * 
- * // make from locale
- * 
- * DateTimePatternGenerator gen = DateTimePatternGenerator.getInstance(locale);
- * SimpleDateFormat format = new SimpleDateFormat(gen.getBestPattern("MMMddHmm"),
- *     locale);
- * format.setTimeZone(zone);
- * assertEquals("simple format: MMMddHmm", 
- *     "8:58 14. Okt",
- *     format.format(sampleDate));
- * // (a generator can be built from scratch, but that is not a typical use case)
- * 
- * // modify the generator by adding patterns
- * DateTimePatternGenerator.PatternInfo returnInfo = new DateTimePatternGenerator.PatternInfo();
- * gen.addPattern("d'. von' MMMM", true, returnInfo);
- * // the returnInfo is mostly useful for debugging problem cases
- * format.applyPattern(gen.getBestPattern("MMMMddHmm"));
- * assertEquals("modified format: MMMddHmm",
- *     "8:58 14. von Oktober",
- *     format.format(sampleDate));
- * 
- * // get a pattern and modify it
- * format = (SimpleDateFormat) DateFormat.getDateTimeInstance(DateFormat.FULL,
- *     DateFormat.FULL, locale);
- * format.setTimeZone(zone);
- * String pattern = format.toPattern();
- * assertEquals("full-date",
- *     "Donnerstag, 14. Oktober 1999 8:58 Uhr GMT+02:00",
- *     format.format(sampleDate));
- * 
- * // modify it to change the zone.
- * String newPattern = gen.replaceFieldTypes(pattern, "vvvv");
- * format.applyPattern(newPattern);
- * assertEquals("full-date, modified zone",
- *     "Donnerstag, 14. Oktober 1999 8:58 Uhr Frankreich",
- *     format.format(sampleDate));
- *
* @stable ICU 3.6 */ public class DateTimePatternGenerator implements Freezable, Cloneable { @@ -393,7 +351,7 @@ public class DateTimePatternGenerator implements FreezableExample code:{@.jcite com.ibm.icu.samples.text.datetimepatterngenerator.DateTimePatternGeneratorSample:---getBestPatternExample} * @param skeleton The skeleton is a pattern containing only the variable fields. * For example, "MMMdd" and "mmhh" are skeletons. * @return Best pattern matching the input skeleton. @@ -497,7 +455,7 @@ public class DateTimePatternGenerator implements Freezable * Note that single-field patterns (like "MMM") are automatically added, and * don't need to be added explicitly! - * + * *

Example code:{@.jcite com.ibm.icu.samples.text.datetimepatterngenerator.DateTimePatternGeneratorSample:---addPatternExample} * @param pattern Pattern to add. * @param override When existing values are to be overridden use true, otherwise * use false. @@ -679,7 +637,7 @@ public class DateTimePatternGenerator implements FreezableExample code:{@.jcite com.ibm.icu.samples.text.datetimepatterngenerator.DateTimePatternGeneratorSample:---replaceFieldTypesExample} * @param pattern input pattern * @param skeleton For the pattern to match to. * @return pattern adjusted to match the skeleton fields widths and subtypes. diff --git a/icu4j/samples/src/com/ibm/icu/samples/text/datetimepatterngenerator/DateTimePatternGeneratorSample.java b/icu4j/samples/src/com/ibm/icu/samples/text/datetimepatterngenerator/DateTimePatternGeneratorSample.java new file mode 100644 index 00000000000..87769f030cb --- /dev/null +++ b/icu4j/samples/src/com/ibm/icu/samples/text/datetimepatterngenerator/DateTimePatternGeneratorSample.java @@ -0,0 +1,184 @@ +/* + ******************************************************************************* + * Copyright (C) 2013, International Business Machines Corporation and * + * others. All Rights Reserved. * + ******************************************************************************* + */ +package com.ibm.icu.samples.text.datetimepatterngenerator; + +import java.util.Date; + +import com.ibm.icu.text.DateFormat; +import com.ibm.icu.text.DateTimePatternGenerator; +import com.ibm.icu.text.SimpleDateFormat; +import com.ibm.icu.util.GregorianCalendar; +import com.ibm.icu.util.TimeZone; +import com.ibm.icu.util.ULocale; + +/** + * com.ibm.icu.text.DateTimePatternGenerator Sample Code + */ +public class DateTimePatternGeneratorSample { + + public static void main (String[] args) { + getBestPatternExample(); + addPatternExample(); + replaceFieldTypesExample(); + } + + + public static void getBestPatternExample() { + System.out.println("========================================================================"); + System.out.println(" getBestPatternExample()"); + System.out.println(); + System.out.println(" Use DateTimePatternGenerator to create customized date/time pattern:"); + System.out.println(" yQQQQ,yMMMM, MMMMd, hhmm, jjmm per locale"); + System.out.println("========================================================================"); + // ---getBestPatternExample + final String[] skeletons = { + "yQQQQ", // year + full name of quarter, i.e., 4th quarter 1999 + "yMMMM", // year + full name of month, i.e., October 1999 + "MMMMd", // full name of month + day of the month, i.e., October 25 + "hhmm", // 12-hour-cycle format, i.e., 1:32 PM + "jjmm" // preferred hour format for the given locale, i.e., 24-hour-cycle format for fr_FR + }; + final ULocale[] locales = { + new ULocale ("en_US"), + new ULocale ("fr_FR"), + new ULocale ("zh_CN"), + }; + DateTimePatternGenerator dtfg = null; + Date date= new GregorianCalendar(1999,9,13,23,58,59).getTime(); + System.out.printf("%-20s%-35s%-35s%-35s\n\n", "Skeleton", "en_US", "fr_FR","zh_CN"); + for (String skeleton:skeletons) { + System.out.printf("%-20s", skeleton); + for (ULocale locale:locales) { + // create a DateTimePatternGenerator instance for given locale + dtfg = DateTimePatternGenerator.getInstance(locale); + // use getBestPattern method to get the best pattern for the given skeleton + String pattern = dtfg.getBestPattern(skeleton); + // Constructs a SimpleDateFormat with the best pattern generated above and the given locale + SimpleDateFormat sdf = new SimpleDateFormat(pattern, locale); + // Get the format of the given date + System.out.printf("%-35s",sdf.format(date)); + } + System.out.println("\n"); + } + /** output of the sample code: + ************************************************************************************************************* + Skeleton en_US fr_FR zh_CN + + yQQQQ 4th quarter 1999 4e trimestre 1999 1999年第四季度 + + yMMMM October 1999 octobre 1999 1999年10月 + + MMMMd October 13 13 octobre 10月13日 + + hhmm 11:58 PM 11:58 PM 下午11:58 + + jjmm 11:58 PM 23:58 下午11:58 + + **************************************************************************************************************/ + // Use DateTime.getPatternInstance to produce the same Date/Time format with predefined constant field value + final String[] dtfskeleton = { + DateFormat.YEAR_QUARTER, // year + full name of quarter, i.e., 4th quarter 1999 + DateFormat.YEAR_MONTH, // year + full name of month, i.e., October 1999 + DateFormat.MONTH_DAY // full name of month + day of the month, i.e., October 25 + }; + System.out.printf("%-20s%-35s%-35s%-35s\n\n", "Skeleton", "en_US", "fr_FR","zh_CN"); + for (String skeleton:dtfskeleton) { + System.out.printf("%-20s", skeleton); + for (ULocale locale:locales) { + // Use DateFormat.getPatternInstance to get the date/time format for the locale, + // and apply the format to the given date + String df=DateFormat.getPatternInstance(skeleton,locale).format(date); + System.out.printf("%-35s",df); + } + System.out.println("\n"); + } + + /** output of the sample code: + ************************************************************************************************************ + Skeleton en_US fr_FR zh_CN + + yQQQQ 4th quarter 1999 4e trimestre 1999 1999年第四季度 + + yMMMM October 1999 octobre 1999 1999年10月 + + MMMMd October 13 13 octobre 10月13日 + ************************************************************************************************************/ +// ---getBestPatternExample +} + + public static void addPatternExample() { + System.out.println("========================================================================"); + System.out.println(" addPatternExample()"); + System.out.println(); + System.out.println(" Use addPattern API to add new '. von' to existing pattern"); + System.out.println("========================================================================"); + // ---addPatternExample + Date date= new GregorianCalendar(1999,9,13,23,58,59).getTime(); + ULocale locale = ULocale.FRANCE; + // Create an DateTimePatternGenerator instance for the given locale + DateTimePatternGenerator gen = DateTimePatternGenerator.getInstance(locale); + SimpleDateFormat format = new SimpleDateFormat(gen.getBestPattern("MMMMddHmm"), locale); + DateTimePatternGenerator.PatternInfo returnInfo = new DateTimePatternGenerator.PatternInfo(); + // Add '. von' to the existing pattern + gen.addPattern("d'. von' MMMM", true, returnInfo); + // Apply the new pattern + format.applyPattern(gen.getBestPattern("MMMMddHmm")); + System.out.println("New Pattern for FRENCH: "+format.toPattern()); + System.out.println("Date Time in new Pattern: "+format.format(date)); + + /** output of the sample code: + ************************************************************************************************** + New Pattern for FRENCH: dd. 'von' MMMM HH:mm + Date Time in new Pattern: 13. von octobre 23:58 + + *************************************************************************************************/ + // ---addPatternExample +} + + public static void replaceFieldTypesExample() { + // Use repalceFieldTypes API to replace zone 'zzzz' with 'vvvv' + System.out.println("========================================================================"); + System.out.println(" replaceFieldTypeExample()"); + System.out.println(); + System.out.println(" Use replaceFieldTypes API to replace zone 'zzzz' with 'vvvv"); + System.out.println("========================================================================"); + // ---replaceFieldTypesExample + Date date= new GregorianCalendar(1999,9,13,23,58,59).getTime(); + TimeZone zone = TimeZone.getTimeZone("Europe/Paris"); + ULocale locale = ULocale.FRANCE; + DateTimePatternGenerator gen = DateTimePatternGenerator.getInstance(locale); + SimpleDateFormat format = new SimpleDateFormat("EEEE d MMMM y HH:mm:ss zzzz",locale); + format.setTimeZone(zone); + String pattern = format.toPattern(); + System.out.println("Pattern before replacement:"); + System.out.println(pattern); + System.out.println("Date/Time format in fr_FR:"); + System.out.println(format.format(date)); + // Replace zone "zzzz" in the pattern with "vvvv" + String newPattern = gen.replaceFieldTypes(pattern, "vvvv"); + // Apply the new pattern + format.applyPattern(newPattern); + System.out.println("Pattern after replacement:"); + System.out.println(newPattern); + System.out.println("Date/Time format in fr_FR:"); + System.out.println(format.format(date)); + + /** output of the sample code: + *************************************************************************************************** + Pattern before replacement: + EEEE d MMMM y HH:mm:ss zzzz + Date/Time format in fr_FR: + jeudi 14 octobre 1999 05:58:59 heure avancée d’Europe centrale + Pattern after replacement: + EEEE d MMMM y HH:mm:ss vvvv + Date/Time format in fr_FR: + jeudi 14 octobre 1999 05:58:59 heure de l’Europe centrale + + **************************************************************************************************/ + // ---replaceFieldTypesExample + } +} \ No newline at end of file -- 2.40.0