organicmaps/icu
13
Fork 0
mirror of https://github.com/unicode-org/icu.git synced 2025-04-08 06:53:45 +00:00
Code Issues 1 Projects Releases Wiki Activity Actions 2

ICU-100113 Added DateTimePatternGeneratorSample.java. Updated the API document in datetimepatterngenerator class for getBestPattern, addPattern, replaceFieldTypes.

Browse source 
X-SVN-Rev: 33555
This commit is contained in:
Bing Long 2013-04-26 19:23:57 +00:00
parent 3db9d2b0f7
commit c6902ad571
2 changed files with 187 additions and 45 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

48
icu4j/main/classes/core/src/com/ibm/icu/text/DateTimePatternGenerator.java
View file

@ -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.
* <pre>
* // some simple use cases
* Date sampleDate = new Date(99, 9, 13, 23, 58, 59);
* ULocale locale = ULocale.GERMANY;
* TimeZone zone = TimeZone.getTimeZone(&quot;Europe/Paris&quot;);
*
* // make from locale
*
* DateTimePatternGenerator gen = DateTimePatternGenerator.getInstance(locale);
* SimpleDateFormat format = new SimpleDateFormat(gen.getBestPattern(&quot;MMMddHmm&quot;),
* locale);
* format.setTimeZone(zone);
* assertEquals(&quot;simple format: MMMddHmm&quot;,
* &quot;8:58 14. Okt&quot;,
* 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(&quot;d'. von' MMMM&quot;, true, returnInfo);
* // the returnInfo is mostly useful for debugging problem cases
* format.applyPattern(gen.getBestPattern(&quot;MMMMddHmm&quot;));
* assertEquals(&quot;modified format: MMMddHmm&quot;,
* &quot;8:58 14. von Oktober&quot;,
* 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(&quot;full-date&quot;,
* &quot;Donnerstag, 14. Oktober 1999 8:58 Uhr GMT+02:00&quot;,
* format.format(sampleDate));
*
* // modify it to change the zone.
* String newPattern = gen.replaceFieldTypes(pattern, &quot;vvvv&quot;);
* format.applyPattern(newPattern);
* assertEquals(&quot;full-date, modified zone&quot;,
* &quot;Donnerstag, 14. Oktober 1999 8:58 Uhr Frankreich&quot;,
* format.format(sampleDate));
* </pre>
* @stable ICU 3.6
*/
public class DateTimePatternGenerator implements Freezable<DateTimePatternGenerator>, Cloneable {
@ -393,7 +351,7 @@ public class DateTimePatternGenerator implements Freezable<DateTimePatternGenera
/**
* Return the best pattern matching the input skeleton. It is guaranteed to
* have all of the fields in the skeleton.
*
* <p>Example 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<DateTimePatternGenera
* <p>
* Note that single-field patterns (like "MMM") are automatically added, and
* don't need to be added explicitly!
*
* * <p>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 Freezable<DateTimePatternGenera
* skeleton of "MMMMddhhmm", then the input pattern is adjusted to be
* "dd-MMMM hh:mm". This is used internally to get the best match for the
* input skeleton, but can also be used externally.
*
* <p>Example 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.

184
icu4j/samples/src/com/ibm/icu/samples/text/datetimepatterngenerator/DateTimePatternGeneratorSample.java Normal file
View file

@ -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
}
}