Выбрать формат времени и даты можно двумя способами: с помощью предопределенного шаблона или пользовательского шаблона. Для большинства программ следует использовать стили, предварительно определенные константами класса DateTimeStyle (
Например, следующий код создает строку даты с использованием заданного по умолчанию короткого формата даты.
Если запрашиваемая локаль поддерживается операционной системой, тогда при создании экземпляра этого класса его свойства задаются в соответствии с правилами и значениями по умолчанию для этой локали, а также с параметрами
Этот класс содержит дополнительные методы получения локализованных строк для названий месяцев и дней недели, а также методы извлечения первого дня недели, которые могут использоваться в календарях для выбора даты или в подобных программах.
В результате использования пользовательских настроек, системных шаблонов форматирования и резервной локали (когда запрашиваемая локаль не поддерживается) пользователи могут наблюдать разные результаты форматирования даже при использовании одного и того же идентификатора локали.
В данном примере использованы следующие локали: английская (США), французская (Франция), испанская (Испания).
Для каждой локали в списке выполняются следующие действия.
Для каждой локали в списке выполняются следующие действия.
Этот конструктор определяет, поддерживает ли текущая операционная система запрашиваемое имя идентификатора локали. Если она не поддерживается, будет использована резервная локаль. Резервный идентификатор локали можно получить из свойства
Если для любого из параметров
Чтобы задать форматирование в соответствии с текущими пользовательскими настройками операционной системы, необходимо передать значение
Когда конструктор вызывается и успешно создает объект, свойство
Когда запрашиваемое имя идентификатора языкового стандарта недоступно,
В противном случае в качестве значения свойства
Дополнительные сведения о перечисленных выше предупреждениях и других возможных значениях свойства
Когда этот метод вызывается и успешно выполняется, свойство
В противном случае в качестве значения свойства
Когда этот метод вызывается и успешно выполняется, свойство
В противном случае в качестве значения свойства
Если этот класс не поддерживается текущей операционной системой, данный метод возвращает нулевое значение.
Когда этот метод вызывается и успешно выполняется, свойство
В противном случае в качестве значения свойства
Возможные значения:
Когда этот метод вызывается и успешно выполняется, свойство
В противном случае в качестве значения свойства
Этот шаблон можно задать одним из трех способов:
Дополнительные сведения о синтаксисе шаблона см. в описании метода
Когда этот метод вызывается и успешно выполняется, свойство
В противном случае в качестве значения свойства
Когда этот метод вызывается и успешно выполняется, свойство
В противном случае в качестве значения свойства
Когда этот метод вызывается и успешно выполняется, свойство
В противном случае в качестве значения свойства
Возможные значения:
Когда этот метод вызывается и успешно выполняется, свойство
В противном случае в качестве значения свойства
Когда этот метод вызывается и успешно выполняется, свойство
В противном случае в качестве значения свойства
Шаблон для форматирования дат можно задать одним из трех способов:
В качестве побочного эффекта этот метод переопределяет текущие стили времени и даты для данного объекта DateTimeFormatter и задает им значение
Строка шаблона определяет форматирование даты и времени. Шаблон содержит последовательности букв, которые заменяются на значения даты и времени в отформатированной строке. Например, в шаблоне «yyyy/MM» символы «yyyy» заменяются на четырехзначное представление года, после которого следует символ «/», а символы «MM» заменяются на двухзначное числовое представление месяца.
Многие буквы, используемые в шаблонах, могут неоднократно повторяться для определения разных строк, как показано в таблице ниже.
Если последовательность превышает максимальное число, поддерживаемое шаблоном, она заменяется на самую длинную поддерживаемую последовательность для данной буквы шаблона. Например:
Теоретически, шаблон может содержать до 225 символов, но на некоторых шаблонах это число меньше. Если шаблон превышает максимальный предел, свойству
Операционная система может поддерживать не все возможные шаблоны. Если шаблон не поддерживается на платформе, используется резервный шаблон, а значение свойства
В следующей таблице перечислены допустимые буквы шаблона и их значения.
Шаблон эры может содержать от одного до пяти символов, которые интерпретируются следующим образом.
Пример для грегорианского календаря для операционных систем, поддерживающих данный шаблон:
Примеры:
Примеры:
Примеры:
Примеры:
Примеры для операционных систем, поддерживающих этот шаблон:
Примеры для второй недели года в операционных системах, которые поддерживают этот шаблон:
Примеры для второй недели июля в операционных системах, которые поддерживают этот шаблон:
Примеры для второго дня года в операционных системах, которые поддерживают этот шаблон:
Примеры для второй среды июля в операционных системах, которые поддерживают этот шаблон:
Примеры:
Примеры:
Примеры:
Примеры для операционных систем, поддерживающих этот шаблон:
Примеры для операционных систем, поддерживающих этот шаблон:
Примеры:
Примеры:
Примеры:
Этот шаблон часового пояса должен содержать от одной до четырех букв, которые интерпретируются следующим образом.
Примеры для операционных систем, поддерживающих этот формат:
Этот шаблон часового пояса должен содержать от одной до четырех букв, которые интерпретируются следующим образом.
Примеры для операционных систем, поддерживающих этот формат:
Этот шаблон часового пояса должен содержать одну или четыре буквы, которые интерпретируются следующим образом.
Примеры для операционных систем, поддерживающих этот формат:
Примеры:
Когда этот метод вызывается и успешно выполняется, свойство
В противном случае в качестве значения свойства
Когда этот метод вызывается и успешно выполняется, свойство
В противном случае в качестве значения свойства
В зависимости от операционной системы и значения параметра
Например:
var fmt:DateTimeFormatter = new DateTimeFormatter(LocaleID.DEFAULT); var aliName:String = fmt.actualLocaleIDName; В приведенном выше примере именем локали, соответствующей текущим пользовательским настройкам операционной системы (например, it-IT, если пользователь выбрал локаль «итальянская, Италия») является
aliName , а не"i-default" (имя локалиLocaleID.DEFAULT ).
Например:
var fmt:DateTimeFormatter = new DateTimeFormatter("fr-CA"); var aliName:String = fmt.actualLocaleIDName; Если предположить, что операционная система в приведенном выше примере не поддерживает идентификатор локали fr_CA (французская, Канада), используется резервный вариант. В таком случае резервным идентификатором локали является fr-FR (французская, Франция).
Если использовано значение
Например, в следующем коде состояние указывает на ошибку аргумента, когда свойству
В следующем примере свойству
Например, следующий код отображает значение свойства
Например, следующий код отображает значение свойства
Строка числа может содержать префикс и суффикс до и после числа. В таких случаях свойство
В этом примере демонстрируется использование следующих локалей: арабская (Саудовская Аравия), английская (США), английская (США, вариант POSIX), китайская (КНР), китайская (Тайвань), китайская (упрощенная транскрипция хань), китайская (КНР с разными клавишами и значениями).
Для каждой локали в списке выполняются следующие действия.
Когда конструктор успешно создает объект, свойству
Когда запрашиваемое имя идентификатора языкового стандарта недоступно,
В противном случае в качестве значения свойства
Дополнительные сведения о перечисленных выше предупреждениях и других возможных значениях свойства
Результирующий список сортируется в порядке предпочтения.
Ниже приводится пример типичного использования этого метода.
Если эта возможность не поддерживается текущей операционной системой, данный метод возвращает нулевое значение.
Когда этот метод вызывается и успешно выполняется, свойство
В противном случае в качестве значения свойства
Возвращенный объект имеет структуру хеш-таблицы или ассоциативного массива, где каждое имя свойства представляет клавишу, а значение этого свойства — значение для этой клавиши. Например, следующий код перечисляет все клавиши и значения, полученные из объекта LocaleID с помощью метода
Когда этот метод вызывается и успешно выполняется, свойство
В противном случае в качестве значения свойства
Если имя локали не удается корректно проанализировать, то код языка совпадает с полным именем локали.
Когда этот метод вызывается и успешно выполняется, свойство
В противном случае в качестве значения свойства
Этот метод возвращает пустую строку, если код региона не удается выделить путем анализа или наугад. Такое случается, если используется неизвестное или неполное имя идентификатора локали, например «xy». Код региона не проверяется по фиксированному списку. Например, для имени идентификатора локали xx-YY возвращается код региона YY.
Когда этот метод вызывается и успешно выполняется, свойство
Если регион не указывается в имени локали, «угадывается» наиболее вероятный код региона для локали, а свойству
В противном случае в качестве значения свойства
Этот метод возвращает пустую строку, если код транскрипции не удается выделить путем анализа или наугад. Такое случается, если используется неизвестное или неполное имя идентификатора локали, например «xy». Код транскрипции не проверяется по фиксированному списку. Например, для имени идентификатора локали xx-Abcd-YY возвращается код транскрипции Abcd.
Область, а также язык, могут также влиять на возвращаемое значение. Например для идентификатора локали mn-MN (монгольский, Монголия) возвращается код транскрипции Cyrl (кириллица), а для mn-CN (монгольский, Китай) — Mong (монгольский).
Когда этот метод вызывается и успешно выполняется, свойство
Если код транскрипции не указывается в имени локали, «угадывается» наиболее вероятный код для локали, а свойству
В противном случае в качестве значения свойства
Этот метод возвращает пустую строку, если указанное имя идентификатора локали не содержит кода варианта языка. (Нет необходимости прибегать к угадыванию, так как лишь немногие локали имеют или требуют вариант языка.)
Когда этот метод вызывается и успешно выполняется, свойство
В противном случае в качестве значения свойства
Результат можно использовать для определения направления текста в механизме визуализации текста Flash, а также для определения того, следует ли использовать зеркальное отражение пользовательского интерфейса для обеспечения текущего направления текста.
Когда этот метод вызывается и успешно выполняется, свойство
В противном случае в качестве значения свойства
Использование настройки
Данный идентификатор локали не во всех случаях является самым подходящим для применения. Для приложений, работающих в браузере, лучше использовать локаль, выбранную в установках браузера. Во многих случаях рекомендуется позволить пользователю изменять настройку предпочитаемого имени идентификатора локали и сохранить ее в профиле пользователя, файле cookie или общем объекте.
Этот метод выполняет следующее преобразование в имя идентификатора локали для придания более канонической формы.
Дополнительная обработка не выполняется. Например, псевдонимы не заменяются, элементы не добавляются и не удаляются.
Когда этот метод вызывается и успешно выполняется, свойство
В противном случае в качестве значения свойства
Константу
В некоторых ситуация преобразование между буквами верхнего и нижнего регистра требует не просто замены одного символа на другой, но и особой обработки с учетом языка и контекста. Например:
Методы
В результате использования пользовательских настроек, системных шаблонов форматирования и резервной локали (когда запрашиваемая локаль не поддерживается) пользователи могут наблюдать разные результаты преобразования регистра даже при использовании одного и того же идентификатора локали.
Выполняются следующие действия.
Этот конструктор определяет, поддерживает ли текущая операционная система запрашиваемое имя идентификатора локали. Если она не поддерживается, будет использована резервная локаль. Если использована резервная локаль, свойство
При успешном завершении работы конструктора, свойство
Когда запрашиваемое имя идентификатора языкового стандарта недоступно,
В противном случае в качестве значения свойства
Если этот класс не поддерживается текущей операционной системой, данный метод возвращает нулевое значение.
Когда этот метод вызывается и успешно выполняется, свойство
В противном случае в качестве значения свойства
Когда этот метод вызывается и успешно выполняется, свойство
В противном случае в качестве значения свойства
Когда этот метод вызывается и успешно выполняется, свойство
В противном случае в качестве значения свойства
В зависимости от операционной системы и значения параметра
Например:
var tools:StringTools = new StringTools(LocaleID.DEFAULT); var aliName:String = tools.actualLocaleIDName; В приведенном выше примере именем локали, соответствующей текущим пользовательским настройкам операционной системы (например, it-IT, если пользователь выбрал локаль «итальянская, Италия») является
aliName , а не"i-default" (имя локалиLocaleID.DEFAULT ).
Например:
var tools:StringTools = new StringTools("fr-CA"); var aliName:String = tools.actualLocaleIDName; Если предположить, что операционная система в приведенном выше примере не поддерживает идентификатор локали fr_CA (французская, Канада), используется резервный вариант. В таком случае резервным идентификатором локали является fr-FR (французская, Франция).
Если использовано значение
Класс NumberFormatter использует данные и функции, предоставляемые операционной системой и обеспечивает форматирование чисел в соответствии с правилами конкретной локали, исходя из установок пользователя и функций, поддерживаемых его операционной системой. Позиция отрицательного символа, десятичного разделителя, разделителя группировки, шаблон группировки и другие элементы формата чисел могут варьироваться в зависимости от локали.
Если операционная система поддерживает запрашиваемую локаль, свойства форматирования чисел задаются в соответствии с правилами и значениями по умолчанию запрашиваемой локали. Если запрашиваемая локаль недоступна, то свойства задаются в соответствии с резервной или стандартной локалью, которую можно получить с помощью свойства
В результате использования пользовательских настроек, системных шаблонов форматирования и резервной локали (когда запрашиваемая локаль не поддерживается) пользователи могут наблюдать разные результаты форматирования даже при использовании одного и того же идентификатора локали.
В этом примере используются следующие локали: локаль по умолчанию ОС для форматирования чисел, японская (Япония), английская (США) и французская (Франция). В примере используется статический элемент
Результаты выполнения этого кода могут варьироваться в зависимости от системных и пользовательских настроек.
Для каждой локали в списке выполняются следующие действия.
Результаты выполнения этого кода могут варьироваться в зависимости от системных и пользовательских настроек.
В этом примере выполняются следующие действия.
Этот конструктор определяет, поддерживает ли текущая операционная система запрашиваемое имя идентификатора локали. Если она не поддерживается, будет использована резервная локаль. Если использована резервная локаль, свойство
Чтобы задать форматирование в соответствии с текущими пользовательскими настройками операционной системы, необходимо передать значение
Когда конструктор успешно создает объект, свойству
Когда запрашиваемое имя идентификатора языкового стандарта недоступно,
Если этот класс не поддерживается в текущей операционной системе, свойству
В противном случае в качестве значения свойства
Дополнительные сведения о перечисленных выше предупреждениях и других возможных значениях свойства
Когда этот метод вызывается и успешно выполняется, свойство
В противном случае в качестве значения свойства
Эта функция форматирует число, на основе значений свойств объекта NumberFormatter. Если свойства не меняются после создания объекта numberFormatter, числа форматируются в соответствии с правилами, предоставляемыми операционной системой для локали, указанной в свойстве actualLocaleIDName. Чтобы настроить формат, можно изменить свойства для определения специфических аспектов форматирования числа.
Эта функция позволяет форматировать очень большие и очень малые числа. Однако число знаков ограничивается пределами точности, установленными объектом Number. Экспоненциальное представление не поддерживается.
Когда этот метод вызывается и успешно выполняется, свойство
В противном случае в качестве значения свойства
Когда этот метод вызывается и успешно выполняется, свойство
В противном случае в качестве значения свойства
Если этот класс не поддерживается текущей операционной системой, данный метод возвращает нулевое значение.
Когда этот метод вызывается и успешно выполняется, свойство
В противном случае в качестве значения свойства
Если до или после цифры числа стоит знак «плюс» (+), он рассматривается не как символ пробела. Возвращается значение
См. описание функции анализа для получения дополнительной информации об анализе чисел и признаках допустимого числа.
Когда этот метод вызывается и успешно выполняется, свойство
В противном случае в качестве значения свойства
Объект NumberParseResult содержит значение первого числа, найденного в введенной строке, начальный индекс для числа в строке, а также индекс первого символа после числа в строке.
Если строка не содержит числа, свойству NumberParseResult задается значение
Эта функция использует значение свойства
В следующей таблице перечислены результаты строк, проанализированных для различных значений NegativeNumberFormat.
Обратите внимание, что допускается использование одного пробела между числом и знаком «минус» или круглой скобкой.
При определении допустимого числа остальные свойства игнорируются. В частности, значение свойства
Если до или после числа в строке следует знак «+», он рассматривается как символ, не входящий в состав числа.
Эта функция не анализирует строки, содержащие числа в экспоненциальном представлении (например, 1,23e40).
Когда этот метод вызывается и успешно выполняется, свойство
В противном случае в качестве значения свойства
В зависимости от операционной системы и значения параметра
Например:
var fmt:NumberFormatter = new NumberFormatter(LocaleID.DEFAULT); var aliName:String = fmt.actualLocaleIDName; В приведенном выше примере именем локали, соответствующей текущим пользовательским настройкам операционной системы (например, it-IT, если пользователь выбрал локаль «итальянская, Италия») является
aliName , а не"i-default" (имя локалиLocaleID.DEFAULT ).
Например:
var fmt:NumberFormatter = new NumberFormatter("fr-CA"); var aliName:String = fmt.actualLocaleIDName; Если предположить, что операционная система в приведенном выше примере не поддерживает идентификатор локали fr_CA (французская, Канада), используется резервный вариант. В таком случае резервным идентификатором локали является fr-FR (французская, Франция).
Это свойство изначально задается на основе локали, выбранной при создании объекта NumberFormatter.
Когда этому свойству задано значение и отсутствуют ошибки или предупреждения, свойству
В противном случае в качестве значения свойства
В различных языках и регионах используются разные символы для представления цифр 0—9. Это свойство определяет используемый набор цифр.
Значение этого свойства представляет значение Юникод для обозначения нуля в десятичном наборе цифр. Действительные значения для этого свойства определены в классе NationalDigitsType.
Когда этому свойству задано значение и отсутствуют ошибки или предупреждения, свойству
В противном случае в качестве значения свойства
Числа округляются до указанного в этом свойстве количества знаков. Схема округления варьируется в зависимости от операционной системы пользователя.
Когда свойство
Когда этому свойству задано значение и отсутствуют ошибки или предупреждения, свойству
В противном случае в качестве значения свойства
Когда свойство
Шаблон группировки определяется как строка, содержащая числа, разделенные точкой с запятой и в некоторых случаях может оканчиваться звездочкой. Например:
Первое число в строке соответствует первой группе цифр слева от десятичного разделителя. Последующие числа определяют количество цифр в следующих группах слева. Таким образом строка «3;2;*» обозначает, что разделитель группировки ставится после первой группы из 3 цифр, за которой следует группы из 2 цифр. Например:
В следующей таблице приводятся примеры форматирования числа 123456789,12 с различными шаблонами группировки. В данном случае в качестве разделителя группировки используется запятая, а в качестве десятичного разделителя — точка.
Можно определить лишь ограниченное число размеров группировки. В одних операционных системах шаблоны группировки могут содержать только два числа и звездочку. Другие операционные системы могут поддерживать до четырех чисел и звездочку. Когда речь идет о шаблонах без звездочки, одни операционные системы поддерживают только одно число, а другие до трех чисел. Если превышено максимальное число элементов группировки, то лишние элементы игнорируются, в свойству
Когда этому свойству задано значение и отсутствуют ошибки или предупреждения, свойству
В противном случае в качестве значения свойства
Значение этого свойства используется в качестве разделителя группировки при форматировании числа, когда свойство
Когда этому свойству задано значение и отсутствуют ошибки или предупреждения, свойству
В противном случае в качестве значения свойства
Когда это свойство имеет значение
Например, если форматируется число 0,321 и это свойство имеет значение
В следующей таблице приводятся примеры форматирования чисел на основе значений этого свойства, а также связанных свойств
Когда этому свойству задано значение и отсутствуют ошибки или предупреждения, свойству
В противном случае в качестве значения свойства
В следующей таблице сведены все возможные форматы отрицательных чисел. При форматировании отрицательного числа знак «-» в шаблоне заменяется значением свойства
Когда этому свойству задано значение и отсутствуют ошибки или предупреждения, свойству
В противном случае в качестве значения свойства
Этот символ используется вместе с форматом отрицательных чисел при форматировании чисел, которые меньше нуля. Он не используется в форматах отрицательных чисел, которые не включают отрицательный символ (например, когда отрицательные числа заключены в круглые скобки).
Этому свойству задается значение по умолчанию для фактической локали, выбранной при создании этого объекта NumberFormatter. Ему можно присвоить значение для переопределения настройки по умолчанию.
Когда этому свойству задано значение и отсутствуют ошибки или предупреждения, свойству
В противном случае в качестве значения свойства
Если использовано значение
Когда это свойство имеет значение
Например, если форматируется числовое значение 123,4, это свойство имеет значение true, а свойству
В следующей таблице приводятся примеры форматирования чисел на основе значений этого свойства, а также связанных свойств
Когда этому свойству задано значение и отсутствуют ошибки или предупреждения, свойству
В противном случае в качестве значения свойства
Когда свойство
Когда свойство
Символ, который должен использоваться в качестве разделителя группировки, определяется свойством
Когда этому свойству задано значение и отсутствуют ошибки или предупреждения, свойству
В противном случае в качестве значения свойства
Параметр context изменяет результаты этих методов только для определенных локалей и операционных систем. Для большинства локалей списки названий месяцев и дней недели не изменяются в зависимости от контекста.
Константы
Класс CurrencyFormatter использует данные и функции, предоставляемые операционной системой и форматирует денежные значения в соответствии с правилами для определенной локали и типа валюты. Позиция символа валюты, отрицательного символа, десятичного разделителя, разделителя группировки, десятичного разделителя шаблона группировки и других элементов может варьироваться в зависимости от локали.
Если операционная система поддерживает запрашиваемую локаль, свойства и тип валюты задаются в соответствии с правилами и значениями по умолчанию запрашиваемой локали. Если запрашиваемая локаль недоступна, то свойства задаются в соответствии с резервной или стандартной локалью, которую можно получить с помощью свойства
В результате использования пользовательских настроек, системных шаблонов форматирования и резервной локали (когда запрашиваемая локаль не поддерживается) пользователи могут наблюдать разные результаты форматирования даже при использовании одного и того же идентификатора локали.
В данном примере используются следующие локали:
Для каждой локали в списке выполняются следующие действия.
Выполняются следующие действия.
Этот конструктор определяет, поддерживает ли текущая операционная система запрашиваемое имя идентификатора локали. Если она не поддерживается, будет использована резервная локаль. Если использована резервная локаль, свойство
Значения определенных свойств, такие как
ПРИМЕЧАНИЕ. Когда используется резервная локаль, для свойств валюты задаются значения по умолчанию, в результате чего свойство
Чтобы задать форматирование в соответствии с текущими пользовательскими настройками операционной системы, необходимо передать значение
Когда конструктор вызывается и успешно создает объект, свойство
Когда запрашиваемое имя идентификатора языкового стандарта недоступно,
В противном случае в качестве значения свойства
Дополнительные сведения о перечисленных выше предупреждениях и других возможных значениях свойства
По умолчанию этот метод использует свойство
Во многих странах и регионах одинаковые символы валюты используются для обозначения разных денежных единиц. Например, в Соединенных Штатах, Австралии, Новой Зеландии, Канаде и Мексике используется один и тот же знак доллара ($) для обозначения местной валюты. Когда форматируемая валюта отличается от местной валюты пользователя, лучше использовать код ISO для обозначения валюты Можно вызвать метод
Этот метод позволяет форматировать как очень большие, так и очень малые числа. Однако число знаков ограничивается пределами точности, установленными для типа данных объекта Number.
Во втором примере демонстрируется метод форматирования денежной суммы в канадских долларах с использованием пользовательской локали по умолчанию. Чтобы проверить, является ли канадский доллар пользовательской валютой по умолчанию, используется метод
Во многих регионах и странах используются одинаковые символы валюты. Этот метод помогает предотвратить использование неоднозначного символа валюты либо неожиданного символа или кода ISO валюты в результате использования резервной локали.
Этот метод часто используется для определения того, следует отображать символ местной валюты (если сумма форматируется с использованием пользовательской валюты по умолчанию) или более точный код ISO (если сумма форматируется в валюте, отличной от используемой по умолчанию).
Этот метод сравнивает параметр
Когда этот метод вызывается и успешно выполняется, свойство
В противном случае в качестве значения свойства
Если этот класс не поддерживается текущей операционной системой, данный метод возвращает нулевое значение.
Когда этот метод вызывается и успешно выполняется, свойство
В противном случае в качестве значения свойства
Алгоритм анализа использует значение свойства
Если порядок символа валюты, символа «-» и числа в введенной строке не соответствует шаблону, определенному свойствами
Строка ввода может содержать пробелы, которые игнорируются в ходе анализа.
Анализ может успешно выполняться, даже если не указан символ валюты. Часть строки, соответствующая символу валюты, не проверяется. Если ввод не содержит символа или строки валюты, в качестве значения свойства
Когда этот метод вызывается и успешно выполняется, свойство
В противном случае в качестве значения свойства
Когда этот метод вызывается и успешно выполняется, свойство
В противном случае свойства
В зависимости от операционной системы и значения параметра
Например:
var fmt:CurrencyFormatter = new CurrencyFormatter(LocaleID.DEFAULT); var aliName:String = fmt.actualLocaleIDName; В приведенном выше примере именем локали, соответствующей текущим пользовательским настройкам операционной системы (например, it-IT, если пользователь выбрал локаль «итальянская, Италия») является
aliName , а не"i-default" (имя локалиLocaleID.DEFAULT ).
Например:
var fmt:CurrencyFormatter = new CurrencyFormatter("fr-CA"); var aliName:String = fmt.actualLocaleIDName; Если предположить, что операционная система в приведенном выше примере не поддерживает идентификатор локали fr_CA (французская, Канада), используется резервный вариант. В таком случае резервным идентификатором локали является fr-FR (французская, Франция).
Этот код используется для определения символа ли строки валюты при форматировании денежных сумм с помощью метода
Это свойство инициализируется конструктором, исходя из фактически используемой локали. В случае использования резервной локали это свойство отражает предпочитаемый код валюты по умолчанию для резервной локали.
Это свойство используется для определения символа валюты при форматировании денежных сумм с помощью метода
Это свойство инициализируется конструктором, исходя из фактически используемой локали. В случае использования резервной локали это свойство отражает предпочитаемый символ валюты по умолчанию для резервной локали.
Это свойство изначально задается на основе локали, выбранной при создании объекта NumberFormatter.
Когда этому свойству задано значение и отсутствуют ошибки или предупреждения, свойству
В противном случае в качестве значения свойства
В различных языках и регионах используются разные символы для представления цифр 0—9. Это свойство определяет используемый набор цифр.
Значение этого свойства представляет значение Юникод для обозначения нуля в десятичном наборе цифр. Действительные значения для этого свойства определены в классе NationalDigitsType.
Когда этому свойству задано значение и отсутствуют ошибки или предупреждения, свойству
В противном случае в качестве значения свойства
Числа округляются до указанного в этом свойстве количества знаков. Схема округления варьируется в зависимости от операционной системы пользователя.
Когда свойство
Когда этому свойству задано значение и отсутствуют ошибки или предупреждения, свойству
В противном случае в качестве значения свойства
Когда свойство
Шаблон группировки определяется как строка, содержащая числа, разделенные точкой с запятой и в некоторых случаях может оканчиваться звездочкой. Например:
Первое число в строке соответствует первой группе цифр слева от десятичного разделителя. Последующие числа определяют количество цифр в следующих группах слева. Таким образом строка «3;2;*» обозначает, что разделитель группировки ставится после первой группы из 3 цифр, за которой следует группы из 2 цифр. Например:
В следующей таблице приводятся примеры форматирования денежной суммы 123456789,12 с различными шаблонами группировки. В качестве символа группировки используется запятая, десятичный разделитель — точка, символ валюты — знак доллара ($).
Можно определить лишь ограниченное число размеров группировки. В одних операционных системах шаблоны группировки могут содержать только два числа и звездочку. Другие операционные системы могут поддерживать до четырех чисел и звездочку. Когда речь идет о шаблонах без звездочки, одни операционные системы поддерживают только одно число, а другие до трех чисел. Если превышено максимальное число элементов группировки, то лишние элементы игнорируются, в свойству
Когда этому свойству задано значение и отсутствуют ошибки или предупреждения, свойству
В противном случае в качестве значения свойства
Значение этого свойства используется в качестве разделителя группировки при форматировании денежных сумм, когда свойство
Когда этому свойству задано значение и отсутствуют ошибки или предупреждения, свойству
В противном случае в качестве значения свойства
Когда это свойство имеет значение
Например, если форматируется денежная сумма 0,321 и это свойство имеет значение
В следующей таблице приводятся примеры форматирования денежных сумм на основе значений этого свойства, а также связанных свойств
Когда этому свойству задано значение и отсутствуют ошибки или предупреждения, свойству
В противном случае в качестве значения свойства
В качестве значения этого свойства должна использоваться одна из констант, определенная в таблице ниже.
В приведенной ниже таблице перечислены возможные шаблоны форматирования для отрицательных денежных сумм. Когда денежная сумма форматируется с помощью метода
Когда этому свойству задано значение и отсутствуют ошибки или предупреждения, свойству
В противном случае в качестве значения свойства
Этот символ используется вместе с форматом отрицательных денежных сумм при форматировании сумм, которые меньше нуля. Он не используется в форматах отрицательных денежных сумм, которые не включают отрицательный символ (например, когда отрицательные суммы заключены в круглые скобки).
Когда этому свойству задано значение и отсутствуют ошибки или предупреждения, свойству
В противном случае в качестве значения свойства
В качестве значения этого свойства должна использоваться одна из констант, определенная в таблице ниже.
В приведенной ниже таблице перечислены возможные шаблоны форматирования для положительных денежных сумм. Когда денежная сумма форматируется с помощью метода
Когда этому свойству задано значение и отсутствуют ошибки или предупреждения, свойству
В противном случае в качестве значения свойства
Если использовано значение
Когда это свойство имеет значение
Например, если форматируется денежная сумма 123,4, это свойство имеет значение true, а свойству
В следующей таблице приводятся примеры форматирования денежных сумм на основе значений этого свойства, а также связанных свойств
Когда этому свойству задано значение и отсутствуют ошибки или предупреждения, свойству
В противном случае в качестве значения свойства
Когда свойство
Когда свойство
Свойство
Когда этому свойству задано значение и отсутствуют ошибки или предупреждения, свойству
В противном случае в качестве значения свойства
Этот класс использует службы сравнения строк, предоставляемые операционной системой. Выполнение сравнения варьируется в зависимости от идентификатора локали, переданного при создании экземпляра класса. ActionScript сохраняет строки с использованием набора символов Юникод. Логические операторы сравнения строк (==, !=, <<=,>,> =) используют для сравнения элементы кода Юникод. В большинстве случаев результирующий порядок сортировки не соответствует правилам для определенного языка и региона и поэтому не должен использоваться для сортировки строк, представленных в пользовательском интерфейсе. Методы сравнения этого класса, напротив, выполняют сортировку с учетом этих правил.
Ниже приводятся примеры, в которых порядок сортировки варьируется в зависимости от языка.
Порядок сортировки может отличаться даже в пределах одного языка и региона в зависимости от области использования. Например в немецком языке предусмотрен особый порядок сортировки для имен в телефонной книге, который отличается от порядка сортировки слов в словарях. В китайском и японском языках существуют разные способы сортировки иероглифов: по произношению или по идеографическому корню и числу штрихов в глифе. В испанском и грузинском языках проводится различие между современной и традиционной сортировкой.
Методы сравнения в этом классе обеспечивают два основных режима использования. Этими режимами управляет параметр
Даже когда конструктору передается параметр localID, как показано выше, поведение сравнения может варьироваться для пользователя в зависимости от настроек его операционной системы и использования резервной локали (если запрашиваемая локаль не поддерживается).
Если текущая операционная система не поддерживает идентификатор локали, переданный в параметре
Параметр
Ниже приводится пример сортированного списка, созданного объектом Collator для локали en-US (английская, США) с использованием режима
Как показано выше, все символы рассматриваются как разные значения, но перечислены в порядке лингвистической сортировки.
Ниже приводится пример сортированного списка, созданного объектом Collator для локали en-US (английская, США) с использованием режима
Расшифровка: символы в одной строке рассматриваются как эквивалентные символы в процессе сравнения/сортировки. Например, «a» (U+0040 = LATIN SMALL LETTER A) и «Ä» (U+00C4 = LATIN CAPITAL LETTER A WITH DIAERESIS) рассматриваются как одинаковые буквы.
Как показано выше, некоторые символы находятся в лингвистически правильном порядке и рассматриваются как имеющие одно и то же значение символа.
Для более точного управления порядком сортировки можно изменять значения свойств объекта Collator, таких как
Для сравнения приводится соответствующий пример сортировки с помощью стандартного метода
Как видно, все символы сортируются просто по числовому значению Юникод. Его нельзя считать корректным с лингвистической точки зрения.
Чтобы использовать текущие пользовательские настройки операционной системы, необходимо передать статическое значение
Для некоторых локалей предусмотрено несколько вариантов порядка сортировки. Например, в немецком языке для телефонных книг и словарей используются разный порядок сортировки. В китайском языке слова обычно поддерживаются путем транслитерации символов в систему пиньинь. Разные порядки сортировки можно выбирать путем добавления ключевого слова collation в строку, передаваемую в параметре
Ниже перечислены возможные значения для строки сопоставления, в скобках перечислены затрагиваемые языки.
Если платформа хоста не поддерживает запрашиваемый тип сравнения, используется резервный вариант, и свойству
Когда конструктор успешно создает объект, свойству
Когда запрашиваемый идентификатора локали недоступен, свойство
В противном случае в качестве значения свойства
Дополнительные сведения о перечисленных выше предупреждениях и других возможных значениях свойства
Когда этот метод вызывается и успешно выполняется, свойство
В противном случае в качестве значения свойства
Когда этот метод вызывается и успешно выполняется, свойство
В противном случае в качестве значения свойства
Если этот класс совсем не поддерживается текущей операционной системой, данный метод возвращает нулевое значение.
В зависимости от операционной системы и значения параметра
Например:
var fmt:Collator = new Collator(LocaleID.DEFAULT); var aliName:String = fmt.actualLocaleIDName; В приведенном выше примере именем локали, соответствующей текущим пользовательским настройкам операционной системы (например, it-IT, если пользователь выбрал локаль «итальянская, Италия») является
aliName , а не"i-default" (имя локалиLocaleID.DEFAULT ).
Например:
var fmt:Collator = new Collator("fr-CA"); var aliName:String = fmt.actualLocaleIDName; Если предположить, что операционная система в приведенном выше примере не поддерживает идентификатор локали fr_CA (французская, Канада), используется резервный вариант. В этом случае переменная
aliName содержит идентификатор резервной локали fr-FR (французская, Франция).
Преобразование регистра строки выполняется по правилам для указанной локали.
Когда свойство
Когда этому свойству задано значение и отсутствуют ошибки или предупреждения, свойству
В противном случае в качестве значения свойства
Для обеспечения совместимости с существующими стандартами для китайских и японских наборов символов Юникод обеспечивает коды символов для полноширинных и полуширинных форм некоторых символов. Например, когда свойство
Если свойство
Когда этому свойству задано значение и отсутствуют ошибки или предупреждения, свойству
В противном случае в качестве значения свойства
Когда свойство
Когда этому свойству задано значение и отсутствуют ошибки или предупреждения, свойству
В противном случае в качестве значения свойства
Если
Когда этому свойству задано значение и отсутствуют ошибки или предупреждения, свойству
В противном случае в качестве значения свойства
Если свойство
Когда этому свойству задано значение и отсутствуют ошибки или предупреждения, свойству
В противном случае в качестве значения свойства
Когда свойство
Когда это свойство имеет значение
Например, когда это свойство имеет значение true для идентификатора локали en-US, строки «version1», «version10» и «version2» сортируются в следующем порядке: version1 < version2 < version10.
Когда это свойство имеет значение false для локали en-US, эти же строки сортируются по-другому: version1 < version10 < version2.
Когда этому свойству задано значение и отсутствуют ошибки или предупреждения, свойству
В противном случае в качестве значения свойства
Если использовано значение