IDataObject 界面
IDataObject 界面
提供了一般数据转换机制的界面。
package com.ms.wfc.app
public interface IdataObject
说明IDataObject界面被Clipboard类使用以从剪贴板或拖放操作中检取或存储数据。DataObject类提供这个界面的基本实现。
方法
IDataObject.getData
检取与指定数据格式相关的数据。
语法
public Object getData ( String format );
public Object getData ( Class format );
参数
format
代表要检取的数据格式的String对象或类。
返回值
返回一个代表与指定格式相关的数据的对象。
说明
用getData方法可以检取存储在Data对象中的数据。你可以定义数据存储的格式,此格式即可以是定义数据类型的String对象,也可以是数据格式的类。你可以用DataFormats类的字段定义恰当的数据格式。
在决定使用何种数据格式调用此方法前,请使用getDataPresent方法。
请参阅:DataObject, setData
IDataObject.getDataPresent
确定Data对象中是否存储了指定的格式的数据。
语法
public boolean getDataPresnet ( Class format );
public boolean getDataPresent ( String format );
参数
format
代表将要被检测的数据的格式的String对象或类
返回值
如果存储在Data对象中的数据的类型与指定的format的类型相符,返回true,否则,返回false。
说明
使用getDataPresent方法来确定当前存储在Data对象中的数据的类型。你可以用这个方法在从Data对象中检取数据前确保要检取的数据的数据格式是正确的。
请参阅:DataObject, getData
IDataObject.getFormats
检取Data对象中存储的数据所支持的所有数据格式类型的数组。
语法
public String [ ] getFromats ();
返回值
返回一个String对象的数组,此数组描述了Data对象中存储的数
据所支持的所有格式的列表。
说明
此方法可以帮助你调试你的程序,DataFormats类中的字段可以用来定义要检取的数据的格式。
请参阅:DataObject
IDataObject.setData
设置将要存储在Data对象中的数据。
语法
public void setData ( String format, Object data );
public void setData ( Class format, Object data );
public void setData ( Object data );
参数
format
代表将要存储的数据的格式的String对象或类。
Data
代表将要存储的数据的对象。
说明
用此方法的第一种或第二种格式去定义将要存储在Data对象中的数据的格式,用此方法的第三种格式在不提供格式信息的情况下指定存储对象。DataFormats类中的字段可以用来定义要存储的数据的格式。
请参阅:DataObject, getData
IMessageFilter界面
定义了消息过滤器界面。
package com.ms.wfc.app
public interface ImessageFilter
说明
一个实现了IMessageFilter界面的类可以被加入应用程序的消息泵中,以过滤出特定消息,或者在消息分发给框架或控件前后执行其他的操作。为了给应用程序的消息泵加入一个消息过滤器,你可以在Application类中使用addMessageFilter方法。
方法
IMessageFilter.postFilterMessage
在消息被分发后过滤出此消息。
语法
public void postFilterMessage ( Message m );
参数
m
刚刚被处理过的消息。
说明
postFilterMessage方法在消息被分发给框架或要处理的控件后被调用。用这个方法去执行那些一定要在消息被框架或控件处理后执行的操作。举个例子,当paint事件被传送给框架或控件,那么你可以用postFilterMessage方法去执行那些附加的工作。如果想要防止消息被分
发出去,你可以使用preFilterMessage方法。
IMessageFilter.preFilterMessage
在消息被分发前过滤出此消息。
语法
public boolean preFilterMessage ( Message m );
参数
m
即将被分发的消息。此消息不能被修改。
说明
preFilterMessage方法在消息被分发给框架或要处理的控件前被调用。举个例子,为了防止属于Button控件的click事件被分发给控件,你可以实现preFilterMessage方法并在click消息发生时返回true值,你一样可以用这个方法执行那些需要在消息被分发前执行的工作。想要在消息被分发后处理这个消息,可以使用postFilterMessage方法。
Locale类
封装Win32 Locale Identifier ( LCID )。
package com.ms.wfc.app
public final class Locale
说明
该类允许你检取和保存给定线程的场所信息。你应该总是使用当前线程的场所来执行与场所有关的操作。如果由于某些原因你不能使用线程场所,则必须使用用户场所。
请参阅:getCountry, getCountryCode, getDefaultCountry,getNativeCountry, getEng-lishCountry, getISO3116CountryName
构造器
Locale.Locale
用调用线程的当前场所创建一个新的Locale对象。
语法
public Locale ();
public Locale ( Locale locale );
public Locale ( int lcid );
public Locale ( int language, int sublanguage );
public Locale ( int language, int sublanguage, int sort );
参数
locale
用来定义此Locale对象的值的当前存在的Locale对象。
Lcid
此Locale对象代表的Win32 Locale ID。
Language
代表此Locale对象的LanguageId字段的整数值。
Sublanguage
代表此Locale对象的SubLanguageId字段的整数值。
Sort
代表此Locale对象的SortId字段的整数值。
说明
这个类提供了五个用来生成Locale对象的构造方法。为了定义language, sublanguage, sort等参数的值,可以从Locale.Language,Locale.SubLanguage,Locale.Sort等类的相关字段获取信息。
方法
Locale.compareString
比较此场所中的两个String。
语法
public int compareString ( String string1, String string2 );
参数
string1
要比较的第一个String对象。
string2
要比较的第二个String对象。
返回值
如果两个String对象相等,则返回0,如果string1小于string2,返回-1;当string1大于string2时,返回1。
说明
用此方法比较当前场所中的String对象。可以通过调整此类的不同setCompareIgnoreXXX方法来控制字符串比较。
请参阅:setCompareIgnoreCase,setCompareIgnoreKana,setCompareIgnoreNon-Space,setCompareIgnoreSymbols,setCompareIgnoreWidth,setCompareIgnore-Kashida
Locale.equals
比较当前Locale对象和作为参数传入的Locale对象。
语法
public boolean equals ( Object obj );
参数
obj
与当前Locale对象相比较的对象。
返回值
如果两个Locale对象合理地相等(logically equivalent),则返回true,否则返回false。
说明
用这个方法比较当前Locale对象和作为参数传入的Locale对象。如果两个Locale对象描述的是同一个场所,则返回true。
Locale.getAbbrevCountry
检取符合ISO标准3166格式的国家名字的缩写。
语法
public String getAbbrevCountry ( );
返回值
返回代表当前场所国家名字缩写的String对象。
说明
用此方法可以获取代表当前场所国家名字缩写的String对象。返回的国家名缩写符合ISO 3166国名转换标准。
请参阅:getCountry, getCountryCode, getDefaultCountry,getNativeCountry, get-EnglishCountry, getISO3116CountryName
Locale.getAbbrevDayName
检取某天的星期缩写(即星期几的缩写)。
语法
public String getAbbrevDayName ( int day );
参数
day
一个整数,表示要查询的天数,星期几。
返回值
返回一个String对象,此String对象给出了查询的日子的本地缩写。
说明
用这个方法去取得day参数所指定的日子的当前场所的星期缩写。
以0值作为day参数调用此方法返回当前场所的星期一缩写。
请参阅:getDayName, getFirstDayOfWeek, Days
Locale.getAbbrevLanguage
检取当前场所语言的缩写。
语法
public String getAbbrevLanguage ()
返回值
返回一个String对象,此String对象给出了当前场所语言缩略名。
说明
用此方法可以获取当前线程所使用的语言缩略名。语言缩略名占用两个字母,符合ISO 639标准,适当地加上第三个字母,就可以表示子语种的缩写了。
请参阅:getDefaultLanguage, getNativeLanguage, getLanguage,getEnglishLanguage, getISO639LanguageName, getLanguageId
Locale.getAbbrevMonthName
检取指定月份的名的缩写。
语法
public String getAbbrevMonthName ( int month );
参数
month
一个整数值,代表要检取名字的月份数。
返回值
返回一个String对象,此对象给出了代表月份的缩写名称。
说明
用这个方法,你可以获取一month参数指定的当前场所下月份的缩写名。当1作为参数调用此方法,返回当前场所下一月份的缩写名。
请参阅:getMonthName
Locale.getAMTimeMark
检取表示AM(上午)的标识符。
语法
public String getAMTimeMark ( );
返回值
返回一个String对象,此对象包含了当前场所下的AM标识符。
说明
用此方法,你就可以在需要显示当前场所下非军事格式的时间时,取得AM标识符。
请参阅:setAMTimeMark
Locale.getCalendarType
检取当前日历类型。
语法
public int getCalendarType ( );
返回值
返回一个代表当前日历类型的整数值。
说明
用这个方法,你可以获取当前场所中使用的日历类型。此方法的返回值可以是如下诸值之一:
值 | 日历种类 |
1 | Gregorian 罗马日历(美国格式) |
2 | Gregorin 罗马日历(英国格式) |
3 | Era:Year of the Emperor 君主日历(日本格式) |
4 | Era:Year of the Taiwan Region(台湾地区格式) |
5 | Tangun Era(韩国格式) |
使用Locale.CalendarType类中的字段去判断此方法返回的日历类型。
请参阅:setCalendarType
Locale.getCenturyFormat
决定采用何种世纪表达方式,四位数字或两位数字。
语法
public boolean getCenturyFormat ( )
返回值
如果当前场所中采用的是四位数字表达方式,返回true;否则返回false,说明当前场所中采用的是两位缩写格式。
Locale.getCharacterSet
检取当前场所所使用的字符集。
语法
public int getCharacterSet ( );
返回值
返回一个整数值,表示当前场所所使用的字符集。
请参阅:CharacterSet
Locale.getCompareIgnoreCase
决定是否在字符串比较时忽略大小写。
语法
public boolean getCompareIgnoreCase ( );
返回值
如果在字符串比较时忽略大小写,返回true;否则,返回false。
说明
用此方法去确定当前Locale对象是否在进行字符串比较操作中忽略大小写。缺省情况下,此返回值为true,除非用setCompareIgnoreCase方法进行了设置。
请参阅:setCompareIgnoreCase,setCompareIgnoreKana,
setCompareIgnoreNon-Space,setCompareIgnoreSymbols,
setCompareIgnoreWidth,setCompareIgnoreKa-shida,
getCompareIgnoreKana,getCompareIgnoreNonSpace,
getCompareIgnoreSym-bols,getCompareIgnoreWidth,
getCompareIgnoreKashida
Locale.getCompareIgnoreKana
决定是否在字符串比较时忽略kana。
语法
public boolean getCompareIgnoreKana ( );
返回值
如果在字符串比较时忽略kana,返回true;否则,返回false。
说明
用此方法去确定当前Locale对象是否在进行字符串比较操作中忽略kana。缺省情况下,此返回值为true,除非用setCompareIgnoreKana方法进行了设置。
请参阅:setCompareIgnoreKashida,setCompareIgnoreCase,
setCompareIgnoreKana,setCompareIgnoreNonSpace,
setCompareIgnoreSymbols,setCompareIgnoreWidth,
getCompareIgnoreCase,getCompareIgnoreNonSpace,
getCompareIgnoreSym-bols,getCompareIgnoreWidth,
getCompareIgnoreKashida
Locale.getCompareIgnoreNonSpace
决定是否在字符串比较时忽略非空格字符。
语法
public boolean getCompareIgnoreNonSpace ( );
返回值
如果在字符串比较时忽略非空格字符,返回true;否则,返回false。
说明
用此方法去确定当前Locale对象是否在进行字符串比较操作中忽略非空格字符。缺省情况下,此返回值为true,除非用setCompareIgnoreNonSpace方法进行了设置。
请参阅:setCompareIgnoreCase, setCompareIgnoreKana,
setCompareIgnoreNon-Space, setCompareIgnoreSymbols,
setCompareIgnoreWidth, setCompareIgnoreKa-shida,
getCompareIgnoreKana, getCompareIgnoreCase,
getCompareIgnoreSym-bols, getCompareIgnoreWidth,
getCompareIgnoreKashida
Locale.getcompareIgnoreKashida
决定是否在字符串比较时忽略Kashida。
语法
public boolean getCompareIgnoreKashida()
返回值
如果在字符串比较时忽略Kashida,返回true;否则返回false。
说明
用此方法去确定当前Locale对象是否在进行字符串比较操作中忽略Kashida。缺省情况下,此值返回true,除非用setCompareIgnoreKashida方法进行了设置。
请参阅:setCompareIgnoreKashida, getCompareIgnoreCase,
setCompareIgnoreCase, getCompareIgnoreKana,
setCompareIgnoreKana,getCompareIgnoreNonSpace,
set-CompareIgnoreNonSpace,getCompareIgnoreSymbols,
setCompareIgnoreSymbols,getCompareIgnoreWidth,
setCompareIgnoreWidth
Locale.getCompareIgnoreSymbols
决定是否在字符串比较时忽略符号。
语法
public boolean getCompareIgnoreSymbols ( );
返回值
如果在字符串比较时忽略符号,返回true;否则,返回false。
说明
用此方法去确定当前Locale对象是否在进行字符串比较操作中忽略符号。缺省情况下,此返回值为true,除非用setCompareIgnoreSymbols方法进行了设置。
请参阅:setCompareIgnoreCase, setCompareIgnoreKana,
setCompareIgnoreNon-Space, setCompareIgnoreSymbols,
setCompareIgnoreWidth, setCompareIgnoreKa-shida,
getCompareIgnoreKana, getCompareIgnoreCase,
getCompareIgnoreCase,get-CompareIgnoreWidth,
getCompareIgnoreKashida
Locale.getCompareIgnoreWidth
决定是否在字符串比较时忽略字符宽度。
语法
public boolean getCompareIgnoreWidth ( );
返回值
如果在字符串比较时忽略字符宽度,返回true;否则,返回false。
说明
用此方法去确定当前Locale对象是否在进行字符串比较操作中忽略字符宽度。缺省情况下,此返回值为true,除非用setCompareIgnoreWidth方法进行了设置。
请参阅:setCompareIgnoreCase, setCompareIgnoreKana,
setCompareIgnoreNon-Space, setCompareIgnoreSymbols,
setCompareIgnoreWidth, setCompareIgnoreKa-shida,
getCompareIgnoreKana, getCompareIgnoreNonSpace,
getCompareIgnoreCase, getCompareIgnoreSymbols,
getCompareIgnoreKashida
Locale.getCountry
检取当前场所下的国家全名。
语法
public String getCountry ( );
返回值
返回一个String对象,此对象指出了当前场所下的国家全名。
请参阅:getDefaultCountry, getNativeCountry, getCountryCode,getEnglishCountry, getAbbrevCountry, getISO3116CountryName
Locale.getCountryCode
检取基于国际电话编码的国家代码。
语法
public int getCountryCode ( );
返回值
返回一个整数值,此值指出了当前场所下的国家代码。
请参阅:getDefaultCountry, getNativeCountry, getCountry,getEnglishCountry, getAbbrevCountry, getISO3116CountryName
Locale.getCountryCode
检取基于国际电话编码的国家代码。
语法
public int getCountryCode ( );
返回值
返回一个整数值,此值指出了当前场所下的国家代码。
说明用这个方法,你可以检取当前场所下的国家代码,你可以通过国家编码判断当前场所用的是哪个国家参数,这样,当应用程序需要查询电话号码信息并显示正确的国家编码时,你可以调用此方法来获取正确参数。
请参阅:getDefaultCountry, getNativeCountry, getCountry,getEnglishCountry, getAbbrevCountry, getISO3116CountryName
Locale.getCurrencyDecimalGrouping
检取小数点左边的货币数字的分组大小。
语法
public String getCurrencyDecimalGrouping ( );
返回值
返回一个String对象,此对象代表了货币的十进制分组信息。
说明
用此方法,你可以检取一个特殊的场所的货币分组信息。每个组都需要一个清楚的大小。组大小被分号分开。如果最后的值是0,那么前面的值是重复的次数。举个例子,如果值要被以“千”为组分开,那么此方法的返回值会是“3;0”。
请参阅:SetCurrencyDecimalGrouping, getCurrencyDecimalSeparator,getDecimal-Grouping
Locale.getCurrencyDecimalSeparator
检取用来当作货币小数点分隔符的字符。
语法
public String getCurrencyDecimalSeparator ( );
返回值
返回一个String大小,此对象包含了当作货币小数点分隔符的字符。
请参阅:setCurrencyDecimalSeparator, getCurrencyDecimalGrouping,getCurrency-DecimalSeparator
Locale.getCurrencyFractionalDigits
检取本地货币格式的零钱的币值。
语法
public int getCurrencyFractionalDigits ( );
返回值
返回一个整数值,此值代表了本地货币格式的零钱币值。
请参阅:setCurrencyFractionalDigits
Locale.getCurrencyNegativePosition
决定表达负钱数时货币符号的位置。
语法
public boolean getCurrencyNegativePosition ( );
返回值
如果负货币符号出现在货币值前面,那么返回true,返回false值意味着负货币符号将出现在货币值后面。
说明
用此方法确保当前场所下的负货币值被正确说明。
请参阅:getCurrencyNegativeSeparation,
getCurrencyPositivePosition, getCurrency-PositiveSeparation
Locale.getCurrencyNegativeSeparation
决定是否在负货币值和表示负货币的符号间加入空格。
语法
public boolean getCurrencyNegativeSeparation ( )
返回值
如果负货币值和表示负货币的符号间用空格分隔,那么返回true,如果二者之间没有空格,返回false。
说明
用此方法确保当前场所下的负货币值被正确说明。
请参阅:getCurrencyNegativePosition, getCurrencyPositivePosition,getCurrency-PositiveSeparation
Locale.getCurrencyPositivePosition
决定表达正货币值时货币符号的位置。
语法
public int getCurrencyPositivePosition ( );
返回值
返回一个整数值,指定了正货币值是货币符号的位置。如果货币符号出现在货币值前面,那么返回1,而返回0值则意味着负货币符号将出现在货币值后面。
说明
用此方法确保当前场所下的正货币值被正确说明。
请参阅:getCurrencyNegativePosition, getCurrencyNegativeSeparation,getCurrency-PositiveSeparation
Locale.getCurrencyPositiveSeparation
决定是否在正货币值和表示正货币的符号间加入空格。
语法
public boolean getCurrencyPositiveSeparation ( )
返回值
如果正货币值和表示正货币的符号间用空格分隔,那么返回true;如果二者之间没有空格,则返回false。
说明
用此方法确保当前场所下的正货币值被正确说明。
请参阅:getCurrencyNegativePosition, getCurrencyPositivePosition,getCurrency-NegativeSeparation
Locale.getCurrencySymbol
检取本地货币符号。
语法
public String getCurrencySymbol ( );
返回值返回一个String对象,此对象包含了用作本地货币符号的符号。
请参阅:setCurrencySymbol
Locale.getCurrencyThousandSeparator
检取小数点左面用于给货币值分组的货币分隔符。
语法
public String getCurrencyThousnadSeparator ();
返回值
返回一个String对象,此对象包含了用于给货币数字分组的符号。
请参阅:setCurrencyThousandSeparator
Locale.getCurrentThreadLocale
检取当前线程的Locale对象。
语法
public static final Locale getCurrentThreadLocale ( );
返回值
返回一个Locale对象,此对象代表了当前线程的场所。
Locale.getDateSeparator
检取当前场所下日期的分隔符。
语法
public String getDateSeparator ( );
返回值
返回一个String对象,此对象包含了用作日期分隔符的符号。
说明
用这个方法确保在当前场所下日期值被正确地指定了。
请参阅:setDateSeparator
Locale.getDayLeadingZero
决定在只有一位日期数字时是否在前面加上前置零。
语法
public boolean getDayleadingZero ( );
返回值
如果在一位数字的日期数前面需要加上前置零,则返回true;否则,返回false(说明不需要前置零)。
说明
用这个方法确保在当前场所下日期值被正确地指定了。
请参阅:Locale.leadingZeros, getMonthLeadingZero
Locale.getDayName
检取指定日期(星期几)的本地名。
语法
public String getDayName ( int day );
参数
day
一个整数值,对应于日期值,并代表要检取本地名的日期数(星期几)。
返回值
返回一个String对象,此对象代表了指定日期数的本地名。
说明
调用此方法时,如果指定0作为day参数,那么此方法将返回当前场所下星期一的本地名。
请参阅:getFirstDayOfWeek, getAbbrevDayName
Locale.getDecimalGrouping
检取小数点左面的数字分组的组大小。
语法
public String getDecimalGrouping ( );
返回值
返回一个String对象,此对象代表分组的描述。
说明
每个组都需要一个清楚的大小。组大小被分号分开。如果最后的值是0,那么前面的值是重复的次数。举个例子,如果值要被以“千”为组分开,那么getDecimalGrouping的返回值会是“3;0”。
请参阅:setDecimalGrouping, getDecimalSeparator
Locale.getDecimalSeparator
检取作为小数点分隔符的字符。
语法
public String getDecimalSeparator ();
返回值
返回一个Stirng对象,此对象包含了作为小数点分隔符的字符。
请参阅:setDecimalSeparator, getDecimalGrouping
Locale.getDefaultAnsiCodePage
检取与当前场所相关的ANSI编码页号(code page)。
语法
public int getDefaultAnsiCodePage ( );
返回值
返回一个整数值,此值代表了当前场所的ANSI编码页号。
说明
用这个方法决定一个场所的ANSI编码页号。一个编码页号就是一个字符集,包括数字、标点符号,以及其他字形信息等等。不同的场所和语言会使用不同的编码页。举个例子,ANSI的1252编码页被美国英语和其他大部分欧洲语言采用,OEM的932编码页被日本汉字采用,0x00-0x7F之间的字符在很多编码页中是相同的。
请参阅:getDefaultOEMCodepage, getDefaultMacCodePage
Locale.getDefaultCountry
检取一个场所下的主要国家编码。
语法
public int getDefaultCountry ( );
返回值
返回一个整数值,此值代表了当前场所下缺省的国家编码。
说明
因为提供了这个方法,所以那些未完全指定的场所可以用缺省值来补充完整。
请参阅:getCountryCode, getISO3116CountryName, getAbbrevCountry,getEnglish-Country, getNativeCountry
Locale.getDefaultLanguage
检取一个场所下主要语言的语种标识符。
语法
public int getDefaultLanguage ( );
返回值
返回一个整数值,此值代表了此场所下的主要语言的语种标识符。
说明
因为提供了这个方法,所以那些未完全指定的场所可以用缺省值来补充完整。
请参阅:getAbbrevLanguage, getNativeLanguage, getLanguage,getEnglishLanguage, getISO639LanguageName, getLanguageId
Locale.getDefaultMacCodePage
检取与一个场所相关的苹果的Macintosh编码页。
语法
public int getDefaultMacCodePage ( );
返回值
返回一个整数值,此值代表了苹果的Macintosh计算机的编码页。
请参阅:getDefaultAnsiCodePage, getDefaultOEMCodePage
Locale.getDefaultOEMCodePage
检取与一个场所相关的OEM编码页。
语法
public int getDefaultOEMCodePage ();
返回值
返回一个整数值,此值代表了这个场所的OEM编码页。
请参阅:getDefaultAnsiCodePage, getDefaultMacCodePage
Locale.getEnglishCountry
检取国家的全英文名。
语法
public String getEnglishCountry ( );
返回值
返回一个String对象,此对象包含了国家的全英文名。
说明
此方法的返回值限制在那些可映射至ASCII 127字符子集的字符。
请参阅:getCountry, getCountryCode, getAbbrevCountry,getISO3116CountryName, getNativeCountry, getDefaultCountry
Locale.getEnglishCurrencyName
检取与一个场所相关的货币系统的英文全名。
语法
public String getEnglishCurrencyName ( );
返回值
返回一个String对象,此对象代表了与场所相关的货币系统的英文全名。
请参阅:getCurrencySymbol, setCurrencySymbol
Locale.getEnglishLanguage
检取符合ISO 639标准的语言的英文全名。
语法
public String getEnglishLanguage ( );
返回值
返回一个String对象,此对象代表了语言的英文全名。
说明
此方法的返回值限制在那些可映射至ASCII 127字符子集的字符。
请参阅:getAbbrevLanguage, getNativeLanguage, getLanguage,getDefaultLanguage, getISO639LanguageName, getLanguageId
Locale.getFirstDayOfWeek
检取当前场所下被认为是一个星期中第一天的天数。
语法
public int getFirstDayOfWeek ( );
返回值返回一个整数值,此值代表了当前场所下被认为是一个星期的第一天的天数。
说明
用此方法可以检取一个场所下一个星期中第一天的天数,getFirstDayOfWeek方法的返回值可以是如下的值之一:
返回值 | 星期几 |
0 | 星期一 |
1 | 星期二 |
2 | 星期三 |
3 | 星期四 |
4 | 星期五 |
5 | 星期六 |
6 | 星期日 |
请参阅:setFristDayOfWeek, getDayName, getAbbrevDayName
Locale.getFirstWeekOfYear
检取当前场所下被认为是一年中第一个星期的星期数。
语法
public int getFirstWeekOfYear ( );
返回值
返回一个整数值,此值代表了当前场所下被认为是一年中第一个星期的星期数。
说明
用此方法可以检取一个场所下一年中第一个星期的星期数,
getFirstWeekOfYear方法的返回值可以是如下的值之一:
返回值 | 说明 |
0 | 把一年中包含一月一日那天的星期作为一年中的第一个星期 |
1 | 把一年中包含一月一日那天的星期后的第一个星期作为一年中的第一个星期 |
2 | 第一个至少包含这一年中的四天的那个星期 |
请参阅:setFirstWeekOfYear
Locale.getFractionalDigits
检取当前场所所指定的小数位数。
语法
public int getFractionaldigits()
返回值
返回一个整数值,代表小数部分位数。
请参阅:setFractionalDigits
Locale.getInstalledLocales
检取一个Locale对象矩阵,包括了计算机上当前安装的所有场所。
语法
public static Locale[] getInstalledLocales()
返回值
返回一个Locale对象矩阵,代表所有已安装的场所。
说明
使用该方法来确定应用程序可利用的场所。
Locale.getIntlCurrencyFractionalDigits
检取本地货币格式中小数部分的位数。
语法
public int getIntlCurrencyFractionalDigits()
返回值
返回一个整数,代表本地货币格式中小数部分的位数。
请参阅:getFrationalDigits, setFractionalDigits
Locale.getIntlCurrencySymbol
检取在ISO 4217中指定的三个字符的货币符号。
语法
public String getIntlCurrencySymbol ( );
返回值
返回一个String对象,此对象包含了国际货币符号。
说明
此方法所返回的国际货币符号是在“Codes for the Representation ofCurrencies and Funds”定义过的,符合ISO4217标准。在表示国际货币符号的三个字符后面的字符定义了用于分隔货币符号和货币数量的字符。
请参阅:getCurrencySymbol, setCurrencySymbol
Locale.getISO3116CountryName
检取在ISO3116标准中指定的国家名。
语法
public String getISO3116CountryName ();
返回值
返回一个String对象,此对象代表了符合ISO3116标准的国家名。
请参阅:getCountry, getCountryCode, getAbbrevCountry,getEnglishCountry, getNativeCountry, getDefaultCountry
Locale.getISO639LanguageName
检取在ISO 639标准中指定的语言名。
语法
public String getISO639LanguageName ( );
返回值
返回一个String对象,此对象代表了符合ISO639标准的语言名。
请参阅:getAbbrevLanguage, getNativeLanguage, getLanguage,getDefaultLanguage, getEnglishLanguage, getLanguageId
Locale.getLanguage
检取语言的本地全名。
语法
public String getLanguage ( );
返回值
返回一个Stirng对象,此对象代表了当前场所下语言的本地全名。
请参阅:getAbbrevLanguage, getNativeLanguage, getEnglishLanguage,getDefault-Language, getISO639LanguageName, getLanguageId
语法
public String getISO639LanguageName ( );
返回值
返回一个String对象,此对象代表了符合ISO639标准的语言名。
请参阅:getAbbrevLanguage, getNativeLanguage, getLanguage,getDefaultLanguage, getEnglishLanguage, getLanguageId
Locale.getLanguage
检取语言的本地全名。
语法
public String getLanguage ( );
返回值
返回一个Stirng对象,此对象代表了当前场所下语言的本地全名。
请参阅:getAbbrevLanguage, getNativeLanguage, getEnglishLanguage,getDefault-Language, getISO639LanguageName, getLanguageId
Locale.getLanguageId
检取当前场所下语言的语种标识符。
语法
public int getLanguageId ( );
返回值
返回一个整数值,此值代表了当前场所下的语种标识符。
请参阅:getAbbrevLanguage, getNativeLanguage, getEnglishLanguage,getDefault-Language, getISO639LanguageName, getLanguage
Locale.getLCID
检取Locale对象代表的LCID。
语法
public int getLCID ( );
返回值
返回一个整数值,此值代表了此场所的Win32 LCID。
说明
用这个方法,你可以获得当前场所的LCID,getLCID方法提供了与Win32 APIs的互操作性。
Locale.getLeadingZero
决定是否在一个指定的小数值前加上前置零。
语法
public boolean getLeadingZero ( );
返回值
如果在所有的小数字段前都加上前置零,那么返回true,否则返回false。
请参阅:setLeadingZeros, Locale.LeadingZeros
Locale.getListSeparator
检取当前场所下由于分隔列表项的字符。
语法
public String getListSeparator ( );
返回值
返回一个String对象,此对象包含了用于分隔列表项的字符。
说明
用这个方法去决定当前场所下在列出一组列表项时用于分隔各列表项的正确字符。举个例子,逗号被许多场所所使用。
请参阅:setListSeparator
Locale.getLongDateFormatString
检取这个场所下的长日期格式字符串。
语法
public String getLongDateFormatString ();
返回值
返回一个String对象,此对象包含了这个场所下的长日期格式字符串。
说明
此方法返回的String对象可以由日、月、年的格式图(将在下表中定义)及包含在单引号内的字符串组成。单引号内的字符串保持不变。
日期值 | 意义 |
d | 月内的日期值,一位数,没有前置零 |
dd | 月内的日期值,一位数,有前置零 |
ddd | 星期内的日期值,三字母的缩写名 |
dddd | 日期名 |
月份值 | 意义 |
m | 数字月份值,一位数,没有前置零 |
mm | 数字月份值,一位数,有前置零 |
mmm | 三字节的月份缩写名 |
mmmm | 月份名 |
年分值 | 意义 |
y | 年份的最后一位数字值 |
yy | 年份的最后两位数字值 |
yyyy | 年份的四位全值 |
请参阅:setLongDateFormatString, setShortDateFormatString,getShortDateFormat-StringLocale.get
LongDateOrder
检取长日期格式顺序。
语法
public int getLongDateOrder ( );
返回值
返回一个整数值,此值代表了长日期格式的顺序
说明
此方法允许你判断长日期格式的日期描述顺序。GetLongDateOrder方法的返回值可以是下列值之一:
值 | 日期描述格式 |
0 | Month-Day-Year |
1 | Day-Month-Year |
2 | Year-Month-Day |
请参阅:Locale.DateFormatOrder
Locale.getMeasurementSystem
检取当前场所下使用的度量系统。
语法
public int getMeasurementSystem ( );
返回值
返回一个整数值,此值代表了当前场所下使用的度量系统。
说明
用此方法可以检取当前场所使用的度量系统,如果返回值是0的话,那么意味着当前场所使用的是公制度量系统,返回1则意味着当前场所使用的是美制度量系统。
请参阅:Locale.MeasurementSystem, setMeasurementSystem
Locale.getMonthLeadingZero
确定是否在日期值的月份字段中使用前置零。
语法
public boolean getMonthLeadingZero ( );
返回值
如果当遇到一位数的月份值时需要加上前置零的话,返回true;否则,返回false。
请参阅:Locale.LeadingZeros, getDayLeadingZero, getLeadingZero,setLeadingZeros
Locale.getMonthName
检取指定的月份的本地全名。
语法
public String getMonthName ( int month );
参数
month
一个整数值,代表了要检取本地全名的月份,举个例子,指定month值为1将会得到的返回值是“January”。
返回值
返回一个String对象,此对象包含了用month参数值指定的月份的本地全名。
请参阅:getAbbrevMonthNam
Locale.getNativeCountry
检取国家的本地全名。
语法
public String getNativeCountry ( );
返回值
返回一个String对象,此对象代表了国家的本地名。
请参阅:getCountry, getCountryCode, getAbbrevCountry,getISO3116CountryName, getNativeCountry, getDefaultCountry
Locale.getNativeCurrencyName检取与当前场所相关的货币系统的本地名。
语法
public String getNativeCurrencyName (
返回值
返回一个String对象,此对象代表了与当前场所相关的货币系统的本地名。
请参阅:getCurrencySymbol, getEnglishCurrencyName,getISO3116CountryName
Locale.getNativeDigits
检取当前场所下对应于ASCII字符0至9的本地对应值。
语法
public String getNativeDigits ( );
返回值
返回一个String对象,此对象包含了对应于ASCII字符0至9的本地对应值。
Locale.getNativeLanguage
检取当前场所下使用的语言的本地名。
语法
public String getNativeLanguage ( );
返回值
返回一个String对象,此对象包含了当前场所下使用的语言的本地名。
请参阅:getAbbrevLanguage, getLanguage, getEnglishLanguage,getDefaultLanguage, getISO639LanguageName, getLanguageId
Locale.getNativeCurrencyMode
检取当前场所下的本地货币格式。
语法
public int getNativeCurrencyMode ( );
返回值
返回一个整数值,此值表示了当前场所下的本地货币格式。
说明
此方法的返回值可以是下列值之一:
值 | 本地货币格式 |
0 | ($1.1) |
1 | -$1.1 |
2 | $-1.1 |
3 | $1.1- |
4 | (1.1$) |
5 | -1.1$ |
6 | 1.1-$ |
7 | 1.1$- |
8 | -1.1 $(在$前有空格) |
9 | -$ 1.1(在$后有空格) |
10 | 1.1 $(在$前有空格) |
11 | $ 1.1-(在$前后空格) |
12 | $ -1.1(在$后有空格) |
13 | 1.1- $(在$前有空格) |
14 | ($ 1.1)(在$后有空格) |
15 | (1.1 $)(在$前有空格) |
请参阅:setNagativeCurrencyMode, getPositiveCurrencyMode,setPositiveCurrency-Mode
Locale.getNegativeNumberMode
检取当前场所下的本地负数格式。
语法
public int getNegativeNumberMode ( );
返回值
返回一个整数值,此值代表了当前场所下的本地负数格式。
说明
此方法的返回值可以是如下值之一:
值 | 本地负数格式 |
0 | (1.1) |
1 | -1.1 |
2 | - 1.1(负号后有空格) |
3 | 1.1- |
4 | 1.1 -(负号前有空格) |
你可以把getNegativeNumberMode方法的返回值和Locale.NegativeNumberMode类的字段相
比较,然后决定当前场所下的本地负数格式。
请参阅:setNegativeNumberMode
Locale.getNegativePosition
检取负值的格式化索引。
语法
public int getNegativePosition ( );
返回值
返回一个整数值,此值代表了负值的格式化索引。
说明
此方法返回的索引值可以是如下所列的值之一:
值 | 意义 |
0 | 用圆括号把值和货币符号扩起来 |
1 | 在值和货币符号之前加上标记字符串 |
2 | 在值和货币符号之后加上标记字符串 |
3 | 在货币符号前直接加上标记字符串 |
4 | 在货币符号后直接加上标记字符串 |
请参阅:getPositivePosition
Locale.getNegativeSign
检取负数标记字符串的值。
语法
public String getNegativeSign ( );
返回值
返回一个String对象,此对象包含了负数标记字符串的值。
请参阅:setNegativeSign, getPositiveSign, setPositiveSign
Locale.getOptionalCalendarType
提供附加的日历类型。
语法
public int getOptionalCalendarType ( );
返回值
返回一个整数值,此值代表了附加的日历类型。
说明
此方法的返回值可以是一个用0分隔的如下所示的一个或多个日历类型值的组合
值 | 意义 |
0 | 没有有效的附加类型 |
1 | Gregorian(公历,如美国所用的日历) |
2 | Gregorian(公历,永远是英文字符串) |
3 | Era: Year of the Emperor (日本日历) |
4 | Era: Year of the Taiwan Region (台湾地区日历,即民国历法) |
5 | Tangun Era (韩国历法) |
用Locale.CalendarType类的字段决定getOptionalCalendarType方法返回的日历类型。
请参阅:Locale.OptionalCalendarType, setCalendarType
Locale.getParentLocale
检取调用此方法的线程的父场所。
语法
public Locale getParentLocale ( );
返回值
返回一个Locale对象,此对象包含了父场所。
说明
用这个方法,你可以检取当前场所的父场所。父场所是一个更"中立"(neutral)的场所版本。
举个例子,U.S.English场所的父场所将是一个中立英语场所(Neutral English locale),此场所
的父场所将是基中立场所(base Neutral locale)。
请参阅:getInstalledLocales
Locale.getPMTimeMark
检取PM(下午)标识符。
语法
public String getPMTimeMark ( );
返回值
返回一个String对象,此对象包含PM(下午)的标识符。
请参阅:setPMTimeMark, getAMTimeMark, setAMTimeMark
Locale.getPositiveCurrencyMode
检取正货币模式。
语法
public int getPositiveCurrencyMode ( );
返回值
返回一个整数值,此值代表了正货币模式。
说明
getPositiveCurrencyMode的返回值可以是如下所列的值之一:
值 | 意义 |
0 | 前缀,没有分隔 |
1 | 后缀,没有分隔 |
2 | 前缀,一个字符分隔 |
3 | 后缀,一个字符分隔 |
请参阅:Locale.PositiveCurrencyMode, setPositiveCurrencyMode,getNegative-CurrencyMode,
setNegativeCurrencyMode
Locale.getPositivePosition
检取正值的格式化索引。
语法
public int getPositivePosition ( );
返回值
返回一个整数值,此值代表了正值的格式化索引。
说明
此方法返回的格式化索引可以是下面所列的值之一:
值 | 意义 |
0 | 用圆括号把值和货币符号扩起来 |
1 | 在值和货币符号之前加上标记字符串 |
2 | 在值和货币符号之后加上标记字符串 |
3 | 在货币符号前直接加上标记字符串 |
4 | 在货币符号后直接加上标记字符串 |
请参阅:TOPRIGHT
Locale.getPositiveSign
检取正数标记字符串的值。
语法
public String getPositiveSign ( );
返回值
返回一个String对象,此对象包含了正数标记字符串的值。
请参阅:setNegativeSign, getNegativeSign, setPositiveSign
Locale.getShortDateFormatString
检取当前场所的短日期格式化字符串。
语法
public String getShortDateFormatString ( );
返回值
返回一个String对象,此对象表示了当前场所下的短日期格式化字符串。
说明
getShortDateFormatString方法返回的String对象可以是在日、月、年和在本地语言所支持的
常量中Era格式图(Era Format Pictures)中定义的日、月、年的格式图的组合。
请参阅:setShortDateFormatString, getLongDateFormatString,setLongDateFormat-String
Locale.getShortDateOrder
检取短日期格式顺序。
语法
public int getShortDateOrder ( );
返回值返回一个整数值,此值代表了短日期格式的顺序。
说明
此方法的返回值可以是下面所列出的值之一:
值 | 意义 |
0 | Month-Day-Year |
1 | Day-Month-Year |
2 | Year-Month-Day |
请参阅:Locale.DateFormatOrder, getLongDateOrder
Locale.getSortId
检取当前场所的SortID。
语法
public int getSortId ( );
返回值
返回一个整数值,此值代表了SortID的值。
请参阅:Locale.Sort
Locale.getSupportedLocales
检取当前系统所支持的所有场所的列表。
语法
public static Locale [ ] getSupportedLocales ( );
返回值
返回一个Locale对象的数组,此数组包含列当前系统所支持的所有场所的列表。
请参阅:getInstalledLocales
Locale.getSystemDefaultLocale
检取当前系统的缺省场所。
语法
public static final Locale getSystemDefaultLocale ( );
返回值
返回一个Locale对象,此对象代表了当前系统的缺省场所。
请参阅:getParentLocale
Locale.getThousandSeparator
检取用于分隔小数点左边的数字组的符号。
语法
public String getThousandSeparator ( );
返回值
返回一个String对象,此对象包含了给分隔数字组的符号。
请参阅:setThousandSeparator
Locale.getTimeFormat
检取当前场所下的时间格式指定符。
语法
public int getTimeFormat ( );
返回值
返回一个整数值,此值代表了当前场所下的时间格式指定符。
说明
此方法的返回值可以是下列的值之一:
值 | 意义 |
0 | A.M/P.M 12-hour format |
1 | 24-hour format |
请参阅:setTimeFormat
Locale.getTimeFormatString
检取一个描述当前线程使用的场所的时间格式的字符串。
语法
public String getTimeFormat ( );
返回值
返回一个String对象,此对象包含了当前线程使用的场所的时间格式的字符串。
说明
getTimeFormat方法返回的String对象可以是在时、分、秒和在本地语言所支持的常量中Era
格式图(Era Format Pictures)中定义的时、分、
秒的格式图的组合。
请参阅:setTimeFormatString
Locale.getTimeLeadingZero
检取指定是否在时间值的小时字段中使用前置零的信息。
语法
public boolean getTimeLeadingZero ( );
返回值
如果当遇到一位数的小时值时需要加上前置零的话,返回true;否则,返回false。
请参阅:Locale.LeadingZeros
Locale.getTimeMarkPosition
检取一个标明在何处放置时间标志(AM/PM)的整数值标志符。
语法
public int getTimeMarkPosition ( );
返回值
返回一个整数值,如果返回值为0,则时间标志要放在时间字符串的最后;如果时间标志要
放在时间字符串的开始,则返回1。
Locale.getTimeSeparator
检取用做时间分隔符的符号。
语法
public String getTimeSeparator ( );
返回值
返回一个String对象,此对象包含了指定用于分隔时间分隔符的符号。
请参阅:setTimeSeparator
Locale.getUserDefaultLocale
检取缺省场所。
语法
public static final Locale getUserDefaultLocale ( );
返回值
返回一个Locale对象,此对象代表了用户的缺省场所。
请参阅:getParentLocale
Locale.getYearMonthFormatString
检取当前用于格式化当前场所下的年月格式的信息。
语法
public String getYearMonthFormatString ( );返回值
返回一个String对象,此对象包含了用于格式化当前场所下的年月格式的信息。
说明
此方法返回的String对象中包含的信息指出了那些只包含年月信息的日期的正确格式。
请参阅:setYearMonthFormatString
Locale.setAMTTimeMark
设置用来标识AM的String标识符。
语法
public void setAMTimeMark ( String value );
参数
value
一个String对象,此对象包含了用来设置AM标识符的字符串。
请参阅:getAMTimeMark
Locale.setCalendarType
设置当前日历格式。
语法
public void setCalendarType ( int value );
参数
value
一个整数值,描述了日历类型。
说明
日历类型可以是下列值之一:
值 | 意义 |
1 | Gregorian 罗马日历(美国格式) |
2 | Gregorian 罗马日历(英国格式) |
3 | Era:Year of the Emperor君主日历(日本格式) |
4 | Era:Year of the Taiwan Region(台湾地区格式) |
5 | Tangun Era(韩国格式) |
你可以用Locale.CalendarType类的字段来决定此方法返回的日历类型。
请参阅:getCalendarType
Locale.setCompareIgnoreCase
设置字符串比较时是否大小写敏感。
语法
public void setCompareIgnoreCase ( boolean value );
参数
value
一个boolean值,指出了新的CompareIgnoreCase的性质
说明
当value值为true时,字符串比较时将处于大小写敏感状态。
请参阅:getCompareIgnoreCase, getCompareIgnoreKana,setCompareIgnoreKana,
getCompareIgnoreKashida,setCompareIgnoreKashida,
getCompareIgnoreNonSpace,setCompareIgnoreNonSpace,
getCompareIgnoreSymbols,setCompareIgnoreSymbols,
getCompareIgnoreWidth,setCompareIgnoreWidth
Locale.setCompareIgnoreKana
设置在字符串比较操作中是否假名(kana)敏感。
语法
public void setCompareIgnoreKana ( boolean value );
参数
value
一个boolean值,指出了新的CompareIgnoreKana的性质。
说明
当value值为true时,字符串比较时将不区分平假名(Hiragana)和片假名(Katakana)。
请参阅:getCompareIgnoreCase, getCompareIgnoreKana,setCompareIgnoreCase,
getCompareIgnoreKashida,setCompareIgnoreKashida,
getCompareIgnoreNonSpace,setCompareIgnoreNonSpace,
getCompareIgnoreSymbols,setCompareIgnoreSymbols,
getCompareIgnoreWidth,setCompareIgnoreWidth
Locale.setCompareIgnoreKashida
设置字符串比较时是否对kashida敏感。
语法
public void setCompareIgnoreKashida ( boolean value );
参数
valu
一个boolean值,指出了新的CompareIgnoreKashida的性质。
说明
当value值为true时,字符串比较时将不区分扩展字符(lengthenedcharacter)和非扩展字符。
请参阅:getCompareIgnoreCase, getCompareIgnoreKana,setCompareIgnoreKana,
getCompareIgnoreKashida, setCompareIgnoreCase,getCompareIgnoreNonSpace,
setCompareIgnoreNonSpace,getCompareIgnoreSymbols,
setCompareIgnoreSymbols,getCompareIgnoreWidth, setCompareIgnoreWidth
Locale.setCompareIgnoreNonSpace
设置字符串比较时是否对空格敏感。
语法
public void setCompareIgnoreNonSpace ( boolean value );
参数
value
一个boolean值,指出了新的CompareIgnoreNonSpace的性质。
说明
当value值为true时,字符串比较时将忽略非空格字符。
请参阅:getCompareIgnoreCase, getCompareIgnoreKana,setCompareIgnoreCase,
getCompareIgnoreKashida,setCompareIgnoreKashida,
getCompareIgnoreNonSpace,setCompareIgnoreKana,
getCompareIgnoreSymbols,setCompareIgnoreSymbols,
get-CompareIgnoreWidth,setCompareIgnoreWidth
Locale.setCompareIgnoreSymbols
设置字符串比较时是否对符号敏感。
语法
public void setCompareIgnoreSymbols ( boolean value );
参数
value
一个boolean值,指出了新的CompareIgnoreSymbols的性质。
说明
当value值为true时,字符串比较时将忽略字符串中的符号。
请参阅:getCompareIgnoreCase, getCompareIgnoreKana,setCompareIgnoreCase,
getCompareIgnoreKashida,setCompareIgnoreKashida,
getCompareIgnoreNonSpace,setCompareIgnoreKana,
getCompareIgnoreSymbols,setCompareIgnoreNonSpaces,
getCompareIgnoreWidth,setCompareIgnoreWidth
Locale.setCompareIgnoreWidth
设置字符串比较时是否对宽度敏感。
语法
public void setCompareIgnoreWidth ( boolean value );
参数
valuv
一个boolean值,指出了新的CompareIgnoreWidth的性质。
说明
当value值为true时,字符串比较时对于单字节字符和双字节字符的处理没有不同。
请参阅:getCompareIgnoreCase, getCompareIgnoreKana,setCompareIgnoreCase,
getCompareIgnoreKashida,setCompareIgnoreKashida,
getCompareIgnoreNonSpace,setCompareIgnoreKana,
getCompareIgnoreSymbols,setCompareIgnoreNonSpaces,
getCompareIgnoreWidth,setCompareIgnoreSymbols
Locale.setCurrencyDecimalGrouping
设置小数点左边的货币数字的分组大小。
语法
public void setCurrencyDecimalGrouping ( String value )
参数
value
一个String对象,指出了货币数字分组大小。
说明
每个组都需要一个清楚的大小。组大小被分号分开。如果最后的值是0,那么前面的值是重
复的次数。举个例子,如果值要被以"千"为组分开,那么此方法的返回值会是"3;0"。
请参阅:getCurrencyDecimalGrouping
Locale.setCurrencyDecimalSeparator
设置用于分隔货币数字的字符。
语法
public void setCurrencySeparator ( String value );
参数
value
一个String对象,定义了货币数字分隔符。
请参阅:getCurrencyDecimalSeparator
Locale.setCurrencyFractionalDigits
设置当前场所下使用的货币零钱币值。
语法
public void setCurrencyFractionalDigits ( int value );
参数
value
一个整数值,此值代表了本地货币格式的零钱币值。
请参阅:getCurrencyFractionalDigits
Locale.setCurrencySymbol
设置用做本地货币符号的字符。
语法
public void setCurrencySymbol ( String value );
参数
value
一个String对象,此对象包含了用作本地货币符号的符号。
请参阅:getCurrencySymbol
Locale.setCurrencyThousandSeparator
设置小数点左面用于给货币值分组的货币分隔符。
语法
public void setCurrencyThousandSeparator ( String value);
参数
value
一个String对象,此对象包含了用于给货币数字分组的符号。
请参阅:getCurrencyThousandSeparatorv
Locale.setDateSeparator
设置当前场所下日期的分隔符。
语法
public void setDateSeparator ( String value );
参数
value
一个String对象,此对象包含了用作日期分隔符的符号。
请参阅:getDateSeparator
Locale.setDecimalGrouping
设置小数点左边的货币数字的分组大小。
语法
public void setDecimalGrouping ( String value );
参数
value
一个String对象,此对象指出了货币的十进制分组信息。
说明
此方法需要显示地指出每个组的清楚的大小。组大小被分号分开。如果最后的值是0,那么
前面的值是重复的次数。举个例子,如果值要被以"千"为组分开,那么此方法的返回值会
是"3;0"。
请参阅:getDecimalGrouping
Locale.setDecimalSeparator
设置用来当作货币小数点分隔符的字符。
语法
public void setDecimalSeparator ( String value );
参数
value
一个String大小,此对象包含了当作货币小数点分隔符的字符。
请参阅:getDecimalSeparator
Locale.setFirstDayOfWeek
设置当前场所下被认为是一个星期中第一天的天数。
语法
public void setFirstDayOfWeek ( int value);
参数
value
一个整数值,此值代表了当前场所下被认为是一个星期的第一天的天数。
说明
用此方法可以设置一个场所下一个星期中第一天的天数,value的值可以是如下的值之一:
返回值 | 描述 |
0 | 星期一 |
1 | 星期二 |
2 | 星期三 |
3 | 星期四 |
4 | 星期五 |
5 | 星期六 |
6 | 星期日 |
请参阅:getFirstDayOfWeek
Locale.setFirstWeekOfYear
设置当前场所下被认为是一年中第一个星期的星期数。
语法
public void setFirstWeekOfYear ( int value );
参数
value
一个整数值,此值代表了当前场所下被认为是一年中第一个星
期的星期数。
说明
用此方法可以设置一个场所下一年中第一个星期的星期数,value的值可以是如下的值之一:
返回值 | 说明 |
0 | 把一年中包含一月一日那天的星期作为一年中的第一个星期 |
1 | 把一年中包含一月一日那天的星期后的第一个星期作为一年中的第一个星期 |
2 | 第一个至少包含这一年中的四天的那个星期 |
请参阅:getFirstWeekOfYear
Locale.setFractionalDigits
设置小数点右边的数字位数,即小数精度。
语法
public void setFractionalDigits ( int value );
参数
value
一个整数值,指出了小数点右边的数字位数,即小数精度。
请参阅:getFractionalDigits
Locale.setLeadingZero
设置是否在一个指定的小数值前加上前置零。
语法
public void setLeadingZero ( boolean value );
参数
value
一个boolean值,决定是否在一个指定的小数值前加上前置零。
请参阅:getLeadingZero, Locale.LeadingZeros
Locale.setListSeparator
设置用于分隔列表项的字符。
语法
public void setListSeparator ( String value );
参数
value
一个String对象,此对象包含了用于分隔列表项的字符。
说明
用这个方法去决定当前场所下在列出一组列表项时用于分隔各列表项的正确字符。举个例
子,逗号被许多场所使用。
请参阅:getListSeparator
Locale.setLongDateFormatString
设置这个场所下的长日期格式字符串。
语法
public void setLongDateFormatString ( String value );
参数
value
一个String对象,此对象包含了这个场所下的长日期格式字符串。
说明
此方法返回的String对象可以由日、月、年的格式图(将在下表中定义)及包含在单引号内
的字符串组成。单引号内的字符串保持不变。
请参阅:getLongDateFormatString
Locale.setMeasurementSystem
设置当前场所下使用的度量系统。
语法
public void setmeasurementSystem ( int value )
参数
value
一个整数值,此值描述了当前场所下使用的度量系统。
说明
用此方法可以设置当前场所使用的度量系统,如果value值是0的话,那么意味着当前场所
使用的是公制度量系统,value值为1则意味着当前场所使用的是美制度量系统。
请参阅:Locale.MeasurementSystem, getMeasurementSystem
Locale.setNegativeCurrencyMode
设置显示负货币值时的模式。
语法
public void setNegativeCurrencyMode ( int value );
参数
valu
一个整数值,指出了显示负货币值时的模式。
说明
此方法采用的值将是下列表格中所列出的值之一:
值 | 说明 |
0 | ($1.1) |
1 | -$1.1 |
2 | $-1.1 |
3 | $1.1- |
4 | (1.1$) |
5 | -1.1$ |
6 | 1.1-$ |
7 | 1.1$- |
8 | -1.1 $(在$前有空格) |
9 | -$ 1.1(在$后有空格) |
10 | 1.1 $-(在$前有空格) |
11 | $ 1.1-(在$后有空格) |
12 | $ -1.1(在$后有空格) |
13 | 1.1- $(在$前有空格) |
14 | ($ 1.1)(在$后有空格) |
15 | (1.1 $)(在$前有空格) |
请参阅:getNegativeCurrencyMode
Locale.setNegativeNumberMode
设置当前场所下的本地负数格式。
语法
public void setNegativeNumberMode ( int value );
参数
value
一个整数值,此值代表了当前场所下的本地负数格式。
说明
此方法的可设置的值可以是如下值之一:
值 | 说明 |
0 | (1.1) |
1 | -1.1 |
2 | - 1.1(负号后有空格) |
3 | 1.1- |
4 | 1.1 -(负号前有空格) |
请参阅:getNegativeNumberMode, Locale.NegativeNumberMode
Locale.setNegativeSign
设置负数标记字符串的值。
语法
public void getNegativeSign (String value );
参数
value
一个String对象,此对象包含了负数标记字符串的值。
请参阅:getNegativeSign
Locale.setPMTimeMark
设置PM(下午)标识符。
语法
public void setPMTimeMark ( String value );
参数
value
一个String对象,此对象包含PM(下午)的标识符的值。
请参阅:getPMTimeMark, getAMTimeMark, setAMTimeMark
Locale.setPositiveCurrencyMode
设置正货币模式。
语法
puvlic void setPositiveCurrencyMode ( int value );
参数
value
一个整数值,此值表示了正货币模式。
说明
setPositiveCurrencyMode设置的值可以是如下所列的值之一:
值 | 意义 |
0 | 前缀,没有分隔 |
1 | 后缀,没有分隔 |
2 | 前缀,一个字符分隔 |
3 | 后缀,一个字符分隔 |
请参阅:Locale.PositiveCurrencyMode, getPositiveCurrencyMode
Locale.setPositiveSign
设置正数标记字符串的值。
语法
public void setPositiveSign ( String value );
参数
value
一个String对象,此对象包含了正数标记字符串的值。
请参阅:getPositiveSign
Locale.setShortDateFormatString
设置当前场所的短日期格式化字符串。
语法
public void setShortDateFormatString ( String value );
参数
value
String对象,此对象表示了当前场所下的短日期格式化字符串。
说明
setShortDateFormatString方法设置的String对象可以是在日、月、年和在本地语言所支持的
常量中Era格式图(Era Format Pictures)中定义的日、月、年的格式图的组合。
请参阅:getShortDateFormatString, getLongDateFormatString,setLongDateFormat-String
Locale.setThousandSeparator
设置小数点左面用于给货币值分组的货币分隔符。
语法
public void setThousandSeparator ( String value );
参数
value
一个String对象,此对象包含了用于给货币数字分组的符号。
请参阅:getThousandSeparator
Locale.setTimeFormat
设置当前场所下的时间格式指定符。
语法
public void setTimeFormat ( int value)
参数
value
一个整数值,此值指出了当前场所下的时间格式指定符。
说明
此方法设置的值可以是下列的值之一:
值 | 意义 |
0 | A.M./P.M.12-hours format |
1 | 24-hours format |
请参阅:getTimeFormat
Locale.setTimeFormatString
设置一个描述当前线程使用的场所的时间格式的字符串。
语法
public void setTimeFormat string( String value );
参数
value
一个String对象,此对象包含了当前线程使用的场所的时间格式的字符串。
说明
setTimeFormat方法设置的String对象可以是在时、分、秒和在本地语言所支持的常量中Era
格式图(Era Format Pictures)中定义的时、分、秒的格式图的组合。
请参阅:getTimeFormatString
Locale.setTimeSeparator
设置用做时间分隔符的符号。
语法
public void setTimeSeparator ( String value );
参数
value
一个String对象,此对象包含了指定用于分隔时间分隔符的符号。
请参阅:setTimeSeparator
Locale.setYearMonthFormatString
设置用于格式化场所下的年月格式的信息。
语法
public void setYearMonthFormatString ( String value );
参数
value
一个String对象,此对象包含了用于格式化当前场所下的年月格式的信息。
说明
此方法设置的Stirng对象中包含的信息指出了那些只包含年月信息的日期的正确格式。
请参阅:getYearMonthFormatString
Locale.CalendarType类
提供用来描述在不同的场所下使用的日历类型的字段。
Enum | +--Locale.CalendarTypepackage com.ms.wfc.app
public static class Locale.CalendarType
extends Enum
说明
在Locale类中使用CalendarType类和其他日历相关方法。
字段
Locale.CalendarType.ERA_EMPEROR
指定Era: Year of Emperor ( Japan ) (日本日历)。
语法
public static final int ERA_EMPEROR;
Locale.CalendarType.ERA_REPUB_CHINA
指定Era: Year of the TaiWan Region Calendar(台湾地区日历)。
语法
public static final int ERA_REPUB_CHINA;
Locale.CalendarType.ERA_TANGUN
指定韩国日历。
语法
public static final int ERA_TANGUN;
Locale.CalendarType.GREGORIAN_ENGLISH
指定公历(英文写法)。
语法
public static final int GREGORIAN_ENGLISH;
Locale.CalendarType.GREGORIAN_US
指定公历(美国写法)。
语法
public static final int GREGORIAN_US;
Locale.DateFormatOrder类
提供用作指定日期格式的字段。
Enum | +--Locale.DateFormatOrder
package com.ms.wfc.app
public static final class Locale.DateFormatOrder
extends Enum
说明
用DateFormatOrder类去评估Locale.getLongDateOrder方法和Locale.getShort-DateOrder方法
的返回值。
字段
Locale.DateFormatOrder.DAY_MONTH_YEAR
指定日-月-年日历格式。
语法
public static final int DAY_MONTH_YEAR;
Locale.DateFormatOrder.MONTH_DAY_YEAR
指定月-日-年日历格式。
语法
public static final int MONTH_DAY_YEAR;
Locale.DateFormatOrder.YEAR_MONTH_DAY
指定年-月-日日历格式。
语法
public static final int YEAR_MONTH_DAY;
Locale.Languages类
提供用来定义Locale对象语言的字段。
Package com.ms.wfc.app
Public static final class Locale.Languages
说明
在Locale类中使用Languages类和与Language相关的方法。
字段
Locale.Languages.ALBANIAN
表示阿尔巴尼亚语。
语法
public static final int ALBANIAN;
Locale.Languages.ARABIC
表示阿拉伯语。
语法
public static final int ARABIC;
Locale.Languages.BAHASA
表示BAHASA语。
语法
public static final int BAHASA;
Locale.Languages.BULGARIAN
表示保加利亚语。
语法
public static final int BULGARIAN;
Locale.Languages.CATALAN
表示加太罗尼亚语(西班牙)。
语法
public static final int CATALAN;
Locale.Languages.CHINESE
表示中文。
语法
public static final int CHINESE;
Locale.Languages.CZECH
表示捷克语。
语法
public static final int 燙ZECH;
Locale.Languages.DANISH
表示丹麦语。
语法
public static final int DANISH;
Locale.Languages.DUTCH
表示荷兰语。
语法
public static final int DUTCH;
Locale.Languages.ENGLISH
表示英语。
语法
public static final int ENGLISH;
Locale.Languages.FINNISH
表示芬兰语。
语法
public static final int FINNISH;
Locale.Languages.FRENCH
表示法语。
语法
public static final int FRENCH;
Locale.Languages.GERMAN
表示德语。
语法
public static final int GERMAN;
Locale.Languages.GREEK
表示希腊语。
语法
public static final int GREEK;
Locale.Languages.HEBREW
表示希伯来语
语法
public static final int HEBREW;
Locale.Languages.HUNGARIAN
表示匈牙利语。
语法
public static final int HUNGARIAN;
Locale.Languages.ICELANDIC
表示冰岛语。
语法
public static final int ICELANDIC;
Locale.Languages.ITALIAN
表示意大利语。
语法
public static final int ITALIAN;
Locale.Languages.JAPANESE
表示日语。
语法
public static final int JAPANESE;
Locale.Languages.KOREAN
表示韩国语。
语法
public static final int KOREAN;
Locale.Languages.NEUTRAL
表示世界语。
语法
public static final int NEUTRAL;
Locale.Languages.NORWEGIAN
表示挪威语。
语法
public static final int NORWEGIAN;
Locale.Languages.POLISH
表示波兰语。
语法
public static final int POLISH;
Locale.Languages.PORTUGUESE
表示葡萄牙语。
语法
public static final int PORTUGUESE;
Locale.Languages.RHAETO_ROMAN
表示罗马语。
语法
public static final int RHAETO_ROMAN;
Locale.Languages.ROMANIAN
表示罗马尼亚语。
语法
public static final int ROMANIAN;
Locale.Languages.RUSSIAN
表示俄语。
语法
public static final int RUSSIAN;
Locale.Languages.SERBO_CROATIAN
表示克罗地亚语。
语法
public static final int SERBO_CROATIAN;
Locale.Languages.SLOVAK
表示斯洛伐克语。
语法
public static final int SLOVAK;
Locale.Languages.SPANISH
表示西班牙语
语法
public static final int SPANISH;
Locale.Languages.SWEDISH
表示瑞典语。
语法
public static final int SWEDISH;
Locale.Languages.THAI
表示泰国语。
语法
public static final int THAI;
Locale.Languages.TURKISH
表示土耳其语。
语法
public static final int TURKISH;
Locale.Languages.URDU
表示乌尔都语。
语法
public static final int URDU;
Locale.LeadingZeros类
提供用来指定和判断Locale类的前置零设置的字段。
Enum | +--Locale.LeadingZeros
package com.ms.wfc.app
public static final class Locale.LeadingZeros
extends Enum
说明
用LeadingZeros类去判断Locale.getDayLeadingZero,
Locale.getMonthLeadingZero, Locale.getLeadingZero,
Locale.getTimeLeadingZero方法的返回值。你也可以用这个类去调用
Locale.setLeadingZero方法去指定当前场所的前置零设置。
字段
Locale.LeadingZeros.LEADING
指定正在使用前置零。
语法
public static final int LEADING;
Locale.LeadingZeros.NOLEADING
指定没有使用前置零。
语法
public static final int NOLEADING;
Locale.MeasurementSystem类
提供用于决定当前场所度量系统的字段。
Enum | +--Locale.Measurement
Systempackage com.ms.wfc.app
public static final class Locale.MeasurementSystem
extends Enum
说明
用MeasurementSystem类去判断Locale.getMeasurementSystem方法的返回值。你也可以在调
用Locale.setMeasurementSystem方法指定一个Locale对象的度量系统时使用
MeasurementSystem类。
字段
Locale.MeasurementSystem.METRIC
表示公制度量系统。
语法
public static final int METRIC;
Locale.MeasurementSystem.US
表示美国度量系统。
语法
public static final int US;
Locale.NegativeNumberMode类
提供指定用不同的方法表示负数的字段。
Enum | +--Locale.NegativeNumberMode
package com.ms.wfc.app
public static final class Locale.NegativeNumberMode
extends Enum
说明
用NegativeNumberMode类去判断Locale.getNegativeNumberMode方法的返回值,并作为
Locale.setNegativeNumberMode方法的参数。
字段
Locale.NegativeNumberMode.PARENS
指定负数显示在括号内。
语法
public static final int PARENS;
Locale.NegativeNumberMode.PREFIX_NOSEP
指定负数显示时没有前置分隔符。
语法
public static final int PREFIX_NOSEP;
Locale.NegativeNumberMode.PREFIX_SEP
指定负数显示时有前置分隔符。
语法
public static final int PREFIX_SEP;
Locale.NegativeNumberMode.SUFFIX_NOSEP
指定负数显示时没有后缀分隔符。
语法
public static final int SUFFIX_NOSEP;
Locale.NegativeNumberMode.SUFFIX_SEP
指定负数显示时有后缀分隔符。
语法
public static final int SUFFIX_SEP;