There are two ways to select a date time format: using a predefined pattern
or a custom pattern. For most applications the predefined styles specified by the
DateTimeStyle constants (
For example the following code creates a date string using the default short date format:
When an instance of this class is created, if the requested locale is supported by the
operating system then the properties of the instance are set according to the conventions and
defaults of the requested locale and the constructor's
This class contains additional methods to get localized strings for month names and weekday names, and to retrieve the first day of the week that can be used in a calendar picker or other similar application.
Due to the use of the user's settings, the use of formatting patterns provided by the operating system, and the use of a fallback locale when a requested locale is not supported, different users can see different formatting results even when using the same locale ID.
This example uses the following locales: English (US), French (France), Spanish (Spain).
The example does the following for each locale in the list:
The example does the following for each locale in the list:
This constructor determines if the current operating system supports the requested locale ID name.
If it is not supported then a fallback locale is used instead.
The name of the fallback locale ID can be determined from the
If a fallback is used for any of the
To format based on the user's current operating system preferences, pass the value
When the constructor is called and it completes successfully, the
When the requested locale ID name is not available then the
Otherwise the
For details on the warnings listed above and other possible values of the
When this method is called and it completes successfully, the
Otherwise the
When this method is called and it completes successfully, the
Otherwise the
If this class is not supported on the current operating system, this method returns a null value.
When this method is called and it completes successfully, the
Otherwise the
Possible values:
When this method is called and it completes successfully, the
Otherwise the
This pattern can be set in one of three ways:
For a description of the pattern syntax, see the
When this method is called and it completes successfully, the
Otherwise the
When this method is called and it completes successfully, the
Otherwise the
When this method is called and it completes successfully, the
Otherwise the
Possible values:
When this method is called and it completes successfully, the
Otherwise the
When this method is called and it completes successfully, the
Otherwise the
The pattern used to format dates can be set in one of three ways:
As a side effect this method overrides the current time and date styles for this DateTimeFormatter object and set them
to the value
A pattern string defines how date and times are formatted. The pattern contains sequences of letters that are replaced with date and time values in the formatted string. For example, in the pattern "yyyy/MM" the characters "yyyy" are replaced with a four-digit year, followed by a "/" character, and the characters "MM" are replaced with a two-digit month.
Many of the letters used in patterns can be repeated more than once to produce different outputs, as described in the table below.
If a sequence exceeds the maximum number of letters supported by a pattern, it is mapped back to the longest supported sequence for that pattern letter. For example:
In theory a pattern can contain up to 255 characters, but some platforms have stricter limit.
If the pattern exceeds the pattern character limit, the
Not all possible patterns are supported on each operating system. If a pattern is not supported on the platform
then a fallback pattern is used
and the
The following table describes the valid pattern letters and their meaning.
There can be one to five letters in era patterns that are interpreted as follows:
Examples with the Gregorian Calendar(for operating systems that support this pattern):
Examples:
Examples:
Examples:
Examples:
Examples (for operating systems that support this pattern):
Examples for the second week of the year (for operating systems that support this pattern):
Examples for the second week of July (for operating systems that support this pattern):
Examples for the second day of the year (for operating systems that support this pattern):
Examples for the second Wednesday in July (for operating systems that support this pattern):
Examples:
Examples:
Examples:
Examples (for operating systems that support this pattern):
Examples (for operating systems that support this pattern):
Examples:
Examples:
Examples:
There must be one to four letters in this time zone pattern, interpreted as follows:
Examples for operating systems that support this format:
There must be one to four letters in this time zone pattern, interpreted as follows:
Examples for operating systems that support this format:
There must be one or four letters in this time zone pattern, interpreted as follows:
Examples for operating systems that support this format:
Examples:
When this method is called and it completes successfully, the
Otherwise the
When this method is called and it completes successfully, the
Otherwise the
There are three possibilities for the value of the name, depending on operating system and the
value of the
For example:
var fmt:DateTimeFormatter = new DateTimeFormatter(LocaleID.DEFAULT); var aliName:String = fmt.actualLocaleIDName; In the above example,
aliName is the name of the locale corresponding to the user's current operating systems settings (e.g. "it-IT" if the user's locale is set to Italian-Italy), and not"i-default" (the name of theLocaleID.DEFAULT locale).
For Example:
var fmt:DateTimeFormatter = new DateTimeFormatter("fr-CA"); var aliName:String = fmt.actualLocaleIDName; Assuming that the operating system in the example above does not support the "fr-CA" (French-Canada) locale ID, a fallback is used. In this case the fallback locale ID is "fr-FR" (French-France).
If the
For example, the following code shows that an invalid argument error status is set
when
The following example shows that setting the
For example, the following code shows the value of the
For example, the following code shows the value of the
The number string can contain a prefix and suffix surrounding a number. In such
cases the
This example uses the following locales: Arabic (Saudi Arabia), English (US), English (US, POSIX variant), Chinese (PRC), Chinese (Taiwan), Chinese (Simplified Han Script), Chinese (PRC with several keys and values)
The example does the following for each locale in the list:
When the constructor completes successfully the
When the requested locale ID name is not available then the
Otherwise the
For details on the warnings listed above and other possible values of the
The resulting list is sorted according in order of preference.
Here is a typical use case for this method:
If this feature is not supported on the current operating system, this method returns a null value.
When this method is called and it completes successfully, the
Otherwise the
The returned object is structured as a hash table or associative array, where each property name represents a key
and the value of the property is value for that key. For example, the following code lists all of the keys and values
obtained from the LocaleID object using the
When this method is called and it completes successfully, the
Otherwise the
If the locale name cannot be properly parsed then the language code is the same as the full locale name.
When this method is called and it completes successfully, the
Otherwise the
This method returns an empty string if the region code cannot be parsed or guessed This could occur if an unknown or incomplete locale ID name like "xy" is used. The region code is not validated against a fixed list. For example, the region code returned for a locale ID name of "xx-YY" is "YY".
When this method is called and it completes successfully, the
If the region is not part of the specified locale name, the most likely region code for the locale is "guessed" and
Otherwise the
This method returns an empty string if the script code cannot be parsed or guessed This could occur if an unknown or incomplete locale ID name like "xy" is used. The script code is not validated against a fixed list. For example, the script code returned for a locale ID name of "xx-Abcd-YY" is "Abcd".
The region, as well as the language, can also affect the return value. For example, the script code for "mn-MN" (Mongolian-Mongolia) is "Cyrl" (Cyrillic), while the script code for "mn-CN" (Mongolian-China) is "Mong" (Mongolian).
When this method is called and it completes successfully, the
If the script code is not part of the specified locale name, the most likely script code is "guessed" and
Otherwise the
This method returns an empty string if there is no language variant code in the given locale ID name. (No guessing is necessary because few locales have or need a language variant.)
When this method is called and it completes successfully, the
Otherwise the
The result can be used to determine the direction of the text in the Flash text engine, and to decide whether to mirror the user interface to support the current text direction.
When this method is called and it completes successfully, the
Otherwise the
Using the
This locale identifier is not always the most appropriate one to use. For applications running in the browser, the browser's preferred locale could be a better choice. It is often a good idea to let the user alter the preferred locale ID name setting and preserve that preference in a user profile, cookie, or shared object.
This method performs the following conversion to the locale ID name to give it a more canonical form.
No additional processing is performed. For example, aliases are not replaced, and no elements are added or removed.
When this method is called and it completes successfully, the
Otherwise the
The
In some situations the conversion between uppercase and lowercase letters is not a simple mapping from one character to another and instead requires language- or context-specific processing. For example:
The
Due to the use of the user's settings, the use of case conversion rules provided by the operating system, and the use of a fallback locale when a requested locale is not supported, different users can see different case conversion results even when using the same locale ID.
This example takes the following steps:
This constructor determines if the current operating system supports the requested locale ID name.
If it is not supported then a fallback locale is used instead.
If a fallback locale is used then the
When this constructor completes successfully the
When the requested locale ID name is not available then the
Otherwise the
If this class is not supported on the current operating system, this method returns a null value.
When this method is called and it completes successfully, the
Otherwise the
When this method is called and it completes successfully, the
Otherwise the
When this method is called and it completes successfully, the
Otherwise the
There are three possibilities for the value of the name, depending on operating system and the
value of the
For example:
var tools:StringTools = new StringTools(LocaleID.DEFAULT); var aliName:String = tools.actualLocaleIDName; In the above example,
aliName is the name of the locale corresponding to the user's current operating systems settings (e.g. "it-IT" if the user's locale is set to Italian-Italy), and not"i-default" (the name of theLocaleID.DEFAULT locale).
For Example:
var tools:StringTools = new StringTools("fr-CA"); var aliName:String = tools.actualLocaleIDName; Assuming that the operating system in the example above does not support the "fr-CA" (French-Canada) locale ID, a fallback is used. In this case the fallback locale ID is "fr-FR" (French-France).
If the
The NumberFormatter class uses the data and functionality provided by the operating system and is designed to format numbers according to the conventions of a specific locale, based on the user's preferences and features supported by the user's operating system. The position of the negative symbol, the decimal separator, the grouping separator, the grouping pattern, and other elements within the number format can vary depending on the locale.
If the operating system supports the requested locale, the number formatting properties
are set according to the conventions and defaults of the requested locale.
If the requested locale is not available, then the properties are set according to
a fallback or default system locale, which can be retrieved using the
Due to the use of the user's settings, the use of formatting patterns provided by the operating system, and the use of a fallback locale when a requested locale is not supported, different users can see different formatting results, even when using the same locale ID.
This example uses the following locales: default operating system locale for number formatting, Japanese (Japan), English (US), and
French (France). The example uses the static member
The results from this example might differ based on your operating system and user preferences.
This example does the following for each locale in the list:
The results from this example might differ based on your operating system and user preferences.
This example does the following:
This constructor determines if the current operating system supports the requested locale ID name.
If it is not supported then a fallback locale is used instead.
If a fallback locale is used then the the
To format based on the user's current operating system preferences, pass the value
When the constructor completes successfully, the
When the requested locale ID name is not available then the
If this class is not supported on the current operating system, then the
Otherwise the
For details on the warnings listed above and other possible values of the
When this method is called and it completes successfully, the
Otherwise the
This function formats the number based on the property values of the formatter. If the properties are not modified after the the numberFormatter object is created, the numbers are formatted according to the locale specific conventions provided by the operating system for the locale identified by actualLocaleIDName. To customize the format, the properties can be altered to control specific aspects of formatting a number.
Very large numbers and very small magnitude numbers can be formatted with this function. However, the number of significant digits is limited to the precision provided by the Number object. Scientific notation is not supported.
When this method is called and it completes successfully, the
Otherwise the
When this method is called and it completes successfully, the
Otherwise the
If this class is not supported on the current operating system, this method returns a null value.
When this method is called and it completes successfully, the
Otherwise the
If the numeric digit is preceded or followed by a plus sign '+' it is treated as a non-whitespace character.
The return value is
See the description of the parse function for more information about number parsing and what constitutes a valid number.
When this method is called and it completes successfully, the
Otherwise the
The NumberParseResult object contains the value of the first number found in the input string, the starting index for the number within the string, and the index of the first character after the number in the string.
If the string does not contain a number, the value property of the NumberParseResult is set to
This function uses the value of the
The following table identifies the result of strings parsed for the various NegativeNumberFormat values:
A single white space is allowed between the number and the minus sign or parenthesis.
Other properties are ignored when determining a valid number. Specifically the value of the
If numbers are preceded or followed in the string by a plus sign '+', the plus sign is treated as a character that is not part of the number.
This function does not parse strings containing numbers in scientific notation (e.g. 1.23e40).
When this method is called and it completes successfully, the
Otherwise the
There are three possibilities for the value of the name, depending on operating system and the
value of the
For example:
var fmt:NumberFormatter = new NumberFormatter(LocaleID.DEFAULT); var aliName:String = fmt.actualLocaleIDName; In the above example,
aliName is the name of the locale corresponding to the user's current operating systems settings (e.g. "it-IT" if the user's locale is set to Italian-Italy), and not"i-default" (the name of theLocaleID.DEFAULT locale).
For Example:
var fmt:NumberFormatter = new NumberFormatter("fr-CA"); var aliName:String = fmt.actualLocaleIDName; Assuming that the operating system in the example above does not support the "fr-CA" (French-Canada) locale ID, a fallback is used. In this case the fallback locale ID is "fr-FR" (French-France).
This property is initially set based on the locale that is selected when the formatter object is constructed.
When this property is assigned a value and there are no errors or warnings, the
Otherwise the
Different languages and regions use different sets of characters to represent the digits 0 through 9. This property defines the set of digits to be used.
The value of this property represents the Unicode value for the zero digit of a decimal digit set. The valid values for this property are defined in the NationalDigitsType class.
When this property is assigned a value and there are no errors or warnings, the
Otherwise the
Numbers are rounded to the number of digits specified by this property. The rounding scheme varies depending on the user's operating system.
When the
When this property is assigned a value and there are no errors or warnings, the
Otherwise the
When the
The grouping pattern is defined as a string containing numbers separated by semicolons and optionally may end
with an asterisk. For example:
The first number in the string corresponds to the first group of digits to the left of the decimal separator.
Subsequent numbers define the number of digits in subsequent groups to the left. Thus the string "3;2;*"
indicates that a grouping separator is placed after the first group of 3 digits, followed by groups of 2 digits.
For example:
The following table shows examples of formatting the number 123456789.12 with various grouping patterns. The grouping separator is a comma and the decimal separator is a period.
Only a limited number of grouping sizes can be defined. On some operating systems, grouping patterns can only contain
two numbers plus an asterisk. Other operating systems can support up to four numbers and an asterisk.
For patterns without an asterisk, some operating systems only support one number while others support up to three numbers.
If the maximum number of grouping pattern elements is exceeded, then additional elements
are ignored and the
When this property is assigned a value and there are no errors or warnings, the
Otherwise the
The value of this property is used as the grouping separator when formatting numbers with the
When this property is assigned a value and there are no errors or warnings, the
Otherwise the
When this property is set to
For example if the number is 0.321 and this property is set
The following table shows examples of how numbers are formatted based on the values of this property and
the related
When this property is assigned a value and there are no errors or warnings, the
Otherwise the
The following table summarizes the possible formats for negative numbers. When a negative number is formatted,
the minus sign in the format is replaced with the value of
the
When this property is assigned a value and there are no errors or warnings, the
Otherwise the
This symbol is used with the negative number format when formatting a number that is less than zero. It is not used in negative number formats that do not include a negative sign (e.g. when negative numbers are enclosed in parentheses).
This property is set to a default value for the actual locale selected when this formatter is constructed. It can be set with a value to override the default setting.
When this property is assigned a value and there are no errors or warnings, the
Otherwise the
If the
When this property is set to
For example if the numeric value is 123.4, and this property is set true, and the
The following table shows examples of how numeric values are formatted based on the values of this property and
the related
When this property is assigned a value and there are no errors or warnings, the
Otherwise the
When the
When the
The symbol to be used as a grouping separator is defined by the
When this property is assigned a value and there are no errors or warnings, the
Otherwise the
The context parameter only changes the results of those methods for certain locales and operating systems. For most locales the lists of month names and weekday names do not differ by context.
The
The CurrencyFormatter class uses the data and functionality provided by the operating system and is designed to format currency values according to the conventions of a specific locale and type of currency. The position of the currency symbol, the negative symbol, the decimal separator, the grouping separator, the grouping pattern decimal separator, and other elements can vary depending on the locale.
If the operating system supports the requested locale, the properties and
currency type are set according to the conventions and defaults of the requested locale.
If the requested locale is not available, then the properties are set according to
a fallback or default system locale, which can be retrieved using the
Due to the use of the user's settings, the use of formatting patterns provided by the operating system, and the use of a fallback locale when a requested locale is not supported, different users can see different formatting results, even when using the same locale ID.
This example uses the following locales:
The example does the following for each locale in the list:
This example takes the following steps:
This constructor determines if the current operating system supports the requested locale ID name.
If it is not supported then a fallback locale is used instead.
If a fallback locale is used then the
Certain properties such as the
NOTE: When a fallback locale is used the currency properties are set to default values,
and therefore the
To format based on the user's current operating system preferences, pass the value
When the constructor is called and it completes successfully, the
When the requested locale ID name is not available then the
Otherwise the
For details on the warnings listed above and other possible values of the
By default this method uses the
Many countries and regions use the same currency symbols for different currencies.
For example the United States, Australia, New Zealand, Canada,
and Mexico all use the same dollar sign symbol ($) for local currency values. When the formatting currency differs
from the user's local currency it is best to use the ISO code as the currency string.
You can use the
This method can format numbers of very large and very small magnitudes. However the number of significant digits is limited to the precision provided by the Number data type.
The second example shows a method of formatting a currency amount in Canadian dollars using the default user's locale.
The
Many regions and countries use the same currency symbols. This method can be used to safeguard against the use of an ambiguous currency symbol, or a currency symbol or ISO code that is different than expected due to the use of a fallback locale.
A common use case for this method is to determine whether to show a local currency symbol (if the amount is formatted in the user's default currency), or a more specific ISO code string (if the amount is formatted in a currency different from the user's default).
This method compares the
When this method is called and it completes successfully, the
Otherwise the
If this class is not supported on the current operating system, this method returns a null value.
When this method is called and it completes successfully, the
Otherwise the
The parsing algorithm uses the value of the
If the order of the currency symbol, minus sign, and number in the input string does not match the pattern identified by the
The input string may include space characters, which are ignored during the parsing.
Parsing can succeed even if there is no currency symbol. No validation is done of the portion of the string
corresponding to the currency symbol. If there is no currency symbol or string, the
When this method is called and it completes successfully, the
Otherwise the
When this method is called and it completes successfully, the
Otherwise the the
There are three possibilities for the value of the name, depending on operating system and the
value of the
For example:
var fmt:CurrencyFormatter = new CurrencyFormatter(LocaleID.DEFAULT); var aliName:String = fmt.actualLocaleIDName; In the above example,
aliName is the name of the locale corresponding to the user's current operating systems settings (for example, "it-IT" if the user's locale is set to Italian-Italy), and not"i-default" (the name of theLocaleID.DEFAULT locale).
For Example:
var fmt:CurrencyFormatter = new CurrencyFormatter("fr-CA"); var aliName:String = fmt.actualLocaleIDName; Assuming that the operating system in the example above does not support the "fr-CA" (French-Canada) locale ID, a fallback is used. In this case the fallback locale ID is "fr-FR" (French-France).
This code is used to determine the currency symbol or string when formatting currency amounts
using the
This property is initialized by the constructor based on the actual locale that is used. When a fallback locale is used this property reflects the preferred, default currency code for the fallback locale.
This property is used as the currency symbol when formatting currency amounts
using the
This property is initialized by the constructor based on the actual locale that is used. When a fallback locale is used this property reflects the preferred, default currency symbol for the fallback locale.
This property is initially set based on the locale that is selected when the formatter object is constructed.
When this property is assigned a value and there are no errors or warnings, the
Otherwise the
Different languages and regions use different sets of characters to represent the digits 0 through 9. This property defines the set of digits to be used.
The value of this property represents the Unicode value for the zero digit of a decimal digit set. The valid values for this property are defined in the NationalDigitsType class.
When this property is assigned a value and there are no errors or warnings, the
Otherwise the
Numbers are rounded to the number of digits specified by this property. The rounding scheme varies depending on the user's operating system.
When the
When this property is assigned a value and there are no errors or warnings, the
Otherwise the
When the
The grouping pattern is defined as a string containing numbers separated by semicolons and optionally may end
with an asterisk. For example:
The first number in the string corresponds to the first group of digits to the left of the decimal separator.
Subsequent numbers define the number of digits in subsequent groups to the left. Thus the string "3;2;*"
indicates that a grouping separator is placed after the first group of 3 digits, followed by groups of 2 digits.
For example:
The following table shows examples of formatting the currency amount 123456789.12 with various grouping patterns. The grouping separator is a comma, the decimal separator is a period, and a dollar sign ($) is the currency symbol.
Only a limited number of grouping sizes can be defined. On some operating systems, grouping patterns can only contain
two numbers plus an asterisk. Other operating systems can support up to four numbers and an asterisk.
For patterns without an asterisk, some operating systems only support one number while others support up to three numbers.
If the maximum number of grouping pattern elements is exceeded, then additional elements
are ignored, and the
When this property is assigned a value and there are no errors or warnings, the
Otherwise the
The value of this property is used as the grouping separator when formatting currency amounts when the
When this property is assigned a value and there are no errors or warnings, the
Otherwise the
When this property is set to
For example if the currency amount is 0.321 and this property is set
The following table shows examples of how currency amounts are formatted based on the values of this property and
the related
When this property is assigned a value and there are no errors or warnings, the
Otherwise the
The value of this property must be one of the constants defined in the table below.
The table below summarizes the possible formatting patterns for negative currency amounts.
When a currency amount is formatted with the
When this property is assigned a value and there are no errors or warnings, the
Otherwise the
This symbol is used with the negative currency format when formatting a currency amount that is less than zero. It is not used in negative currency formats that do not include a negative sign (for example, when negative currency amounts are enclosed in parentheses).
When this property is assigned a value and there are no errors or warnings, the
Otherwise the
The value of this property must be one of the constants defined in the table below.
The table below summarizes the possible formatting patterns for positive currency amounts.
When a currency amount is formatted with the
When this property is assigned a value and there are no errors or warnings, the
Otherwise the
If the
When this property is set to
For example if the currency amount is 123.4, and this property is set true, and the
The following table shows examples of how currency amounts are formatted based on the values of this property and
the related
When this property is assigned a value and there are no errors or warnings, the
Otherwise the
When the
When the
The
When this property is assigned a value and there are no errors or warnings, the
Otherwise the
This class uses the string comparison services provided by the operating system. The comparisons differ according to the locale identifier that is provided when the class instance is created. ActionScript stores strings using the Unicode character set. The Boolean string comparison operators (==, !=, <, <=, >, >=) use Unicode code points for comparison. In most cases the resulting sort order doesn't match the conventions of a particular language and region, and thus should not be used to sort strings that are presented in a user interface. In contrast the comparison methods in this class provide an order that adheres to these conventions.
Here are some examples where the sort order differs depending on the language:
Sort orders can even differ within the same language and region depending on the usage. For example, in German there is a different sort order used for names in a phone book versus words in a dictionary. In Chinese and Japanese there are different ways of sorting the ideographic characters: by pronunciation or by the ideographic radical and the number of strokes uses in the glyph. In Spanish and Georgian, there is a difference between modern and traditional sorting.
The comparison methods in this class provide two main usage modes. The
Even when providing a locale ID parameter to the constructor as shown above, collation behavior can differ by user based on the user's operating system settings and whether a fallback locale is used when the requested locale is not supported.
If the current operating system does not support the locale ID that is passed in the
The
Here is an example of a sorted list created using a Collator with the locale ID "en-US" (English in US)
and the
As shown above, all characters are treated as if they have different values, but in linguistic order.
Here is an example of a sorted list created using Collator with the locale ID "en-US" (English in US) and the
Legend: Characters in a same row are treated as equivalent characters during comparison/sorting. For example, "a" (U+0040 = LATIN SMALL LETTER A) and "Ä" (U+00C4 = LATIN CAPITAL LETTER A WITH DIAERESIS) are considered to be equal.
As shown above, some characters are in linguistic order and are treated as if they have the same character value.
For finer control over sorting order, you can change collator properties such as
For reference, here is a corresponding sorting example done using the standard
As you can see above, all characters are sorted simply in Unicode numeric value order. It does not make much sense linguistically.
To use the user's current operating system preferences, pass the static value
Some locales have several sort order variants. For example, in German
one sort order is used for phone books and another sort order is used for dictionaries.
In Chinese, words are commonly supported by transliteration of the characters
into the pinyin. These different sort orders can be selected by including the "collation" keyword
in the string that is passed in the
Possible values for the collation string are as follows, with the affected languages shown in parentheses:
If the host platform does not support the requested collation type, then a fallback is used
and the
When the constructor completes successfully, then
the
When the requested locale ID is not available, then the
Otherwise the
For details on the warnings listed above and other possible values of
When this method is called and it completes successfully, the
Otherwise the
When this method is called and it completes successfully, the
Otherwise the
If this class is not supported at all on the current operating system, this method returns a null value.
There are three possibilities for the value of the name, depending on operating system and the
value of the
For example:
var fmt:Collator = new Collator(LocaleID.DEFAULT); var aliName:String = fmt.actualLocaleIDName; In the above example,
aliName is the name of the locale corresponding to the user's current operating systems settings (e.g. "it-IT" if the user's locale is set to Italian-Italy), and not"i-default" (the name of theLocaleID.DEFAULT locale).
For Example:
var fmt:Collator = new Collator("fr-CA"); var aliName:String = fmt.actualLocaleIDName; Assuming that the operating system in the example above does not support the "fr-CA" (French-Canada) locale ID, a fallback is used. In that case the
aliName variable contains the fallback locale ID "fr-FR" (French-France).
The case conversion of the string follows the rules for the specified locale.
When the
When this property is assigned a value and there are no errors or warnings,
the
Otherwise, the
For compatibility with existing standards for Chinese and Japanese character sets, Unicode provides character codes
for both full-width and half width-forms of some characters.
For example, when the
If the
When this property is assigned a value and there are no errors or warnings,
the
Otherwise the
When the
When this property is assigned a value and there are no errors or warnings,
the
Otherwise the
If the
When this property is assigned a value and there are no errors or warnings,
the
Otherwise the
If the
When this property is assigned a value and there are no errors or warnings,
the
Otherwise the
When the
When this property is set to
For example, when this property is true for the locale ID "en-US", then the strings "version1", "version10", and "version2" are sorted into the following order: version1 < version2 < version10.
When this property is false for "en-US", those same strings are sorted into the following order: version1 < version10 < version2.
When this property is assigned a value and there are no errors or warnings,
the
Otherwise the
If the