DateTimeFormatter  - AS3 Flex

Имя фактического идентификатора локали, используемое этим объектом класса. Эта локаль используется для доступа к форматированию данных и функциональным возможностям операционной системы.

Если локаль, установленная стилем locale, недоступна, то значение actualLocaleIDName будет отличаться от значения стиля locale. Значение будет указывать резервную используемую локаль. Если стиль локали установлен как LocaleID.DEFAULT, будет использоваться имя локали, определенное операционной системой пользователя.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие change .

Связанные элементы API

Стиль даты для данного экземпляра DateTimeFormatter. Стиль даты служит для получения шаблона форматирования времени и локали, предварительно определенного в операционной системе. При форматировании даты стиль locale и свойства timeStyle и dateStyle определяют формат даты. Значение стиля даты можно установить с помощью присвоения значения свойству dateStyle или свойству dateTimePattern.

Возможные значения данного свойства определены в классе flash.globalization.DateTimeStyle. Допустимые значения для свойства dateStyle:

• DateTimeStyle.LONG
• DateTimeStyle.MEDIUM
• DateTimeStyle.SHORT
• DateTimeStyle.NONE
• DateTimeStyle.CUSTOM

Если для свойства dateTimePattern указано значение, дополнительным эффектом этого является то, что для свойства dateStyle устанавливается значение DateTimeStyle.CUSTOM.

Значением по умолчанию является DateTimeStyle.LONG.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие change .

Связанные элементы API

Строка образца, используемая объектом DateTimeFormatter для форматирования дат и времени.

Этот шаблон можно установить одним из двух способов:

1. При установке свойств dateStyle и timeStyle.
2. При установке свойства dateTimePattern.

Если значение присваивается свойству непосредственно, то дополнительным эффектом этого будет переопределение текущего стиля времени и даты, для которых устанавливается значение DateTimeStyle.CUSTOM.

Дополнительные сведения о синтаксисе шаблона см. в описании метода flash.globalization.DateTimeFormatter.setDateTimePattern().

Значением по умолчанию является "EEEE, MMMM dd, yyyy h:mm:ss a".

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие change .

Связанные элементы API

Строка, возвращенная методом format() при возникновении ошибки.

Если errorText не является null и ошибка возникает при форматировании даты, метод формата возвратит строку, присвоенную этому свойству.

      var dtf:DateTimeFormatter = new DateTimeFormatter();
      dtf.setStyle("locale", "en-US");
      dtf.errorText = "----"
      trace(dtf.format("abc"));  // ----
      

Значением по умолчанию является null.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие change .

Связанные элементы API

Состояние самой последней операции, выполненной этим объектом класса. Свойство lastOperationStatus задается каждый раз при вызове конструктора или метода этого класса или при задании значения для другого свойства. Другие возможные значения см. в описании соответствующего метода.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие change .

Стиль времени для данного экземпляра DateTimeFormatter. Стиль времени служит для получения шаблона форматирования времени и локали, предварительно определенного в операционной системе. При форматировании даты стиль locale и свойства timeStyle и dateStyle определяют формат даты. Значение стиля времени можно установить с помощью присвоения значения свойству timeStyle или свойству dateTimePattern.

Значения данного свойства определены в классе flash.globalization.DateTimeStyle. Допустимые значения для свойства timeStyle:

• DateTimeStyle.LONG
• DateTimeStyle.MEDIUM
• DateTimeStyle.SHORT
• DateTimeStyle.NONE
• DateTimeStyle.CUSTOM

Если для свойства dateTimePattern указано значение, дополнительным эффектом этого является то, что для свойства dateStyle устанавливается значение DateTimeStyle.CUSTOM .

Значением по умолчанию является DateTimeStyle.LONG.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие change .

Связанные элементы API

Логический флаг, определяющий использование значений даты и времени в локальном формате или в формате UTC при форматировании даты. Если для useUTC установлено значение true, то используются значения UTC. Если установлено значениеfalse, то используются значения даты и времени, выбранные в текущем часовом поясе операционной системы.

Значением по умолчанию является false.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие change .

Связанные элементы API

Создает новый объект DateTimeFormatter, чтобы отформатировать даты и время в соответствии с условиями указанной локали и заданных стилей форматирования даты и времени.

Стиль локали определяет локаль для этого класса. Стиль локали можно установить следующими способами:

• С использованием класса в объявлении MXML и наследованием локали из документа, содержащего объявление.
Пример:

      <fx:Declarations> 
             <s:DateTimeFormatter id="df" />
      </fx:Declarations>

• С использованием объявления MXML и указанием значения локали в списке назначений.
Пример:

      <fx:Declarations> 
          <s:DateTimeFormatter id="df_Japanese" locale="ja-JP" />
      </fx:Declarations>

• Вызов метода setStyle. Например:

        df.setStyle("locale", "ja-JP")

• Наследование стиля из UIComponent путем вызова метода addStyleClient() UIComponent.

Если стиль locale не установлен одним из вышеперечисленных способов, экземпляр этого класса добавляется как StyleClient в topLevelApplication и наследует стиль locale из объекта topLevelApplication при вызове получателя свойств, зависящего от locale, или метода, зависящего от locale.

Многие свойства этого класса автоматически устанавливаются на основе стиля локали. При изменении стиля локали все свойства, которые не были явно указаны, будут обновлены в соответствии с новой локалью. Обратите внимание, что фактическая используемая локаль определяется в свойстве actualLocaleIDName.

Связанные элементы API

Форматирует строку отображения для объекта, который указывает дату в локальном формате времени пользователя или в формате UTC.

Объект Date содержит два набора значений даты и времени: в формате времени пользователя (date, day, fullYear, hours, minutes, month и seconds) и в формате UTC (dateUTC, dayUTC, fullYearUTC, hoursUTC, minutesUTC, monthUTC и secondsUTC). Логическое свойство useUTC определяет набор компонентов даты и времени, который следует использовать при форматировании даты. Форматирование будет выполнено с использованием условий локали, установленных свойством стиля locale и свойствами dateStyle и timeStyle или dateTimePattern, указанными для этого экземпляра DateTimeFormatter.

Если возникла ошибка при форматировании вследствие указания недопустимого входного значения или других причин, метод format() по умолчанию возвратит null. Но если для свойства errorText указано ненулевое значение, то будет возвращено значение свойства errorText. Для свойства lastOperationStatus будет установлено значение, указывающее на возникновение ошибки.

Параметры

Связанные элементы API

Перечисляет все имена идентификаторов локалей, поддерживаемые этим классом. В этом списке представлены локали, поддерживаемые операционной системой, но не локали, для которых присутствуют ресурсы в ResourceManager.

Возвращает целое число, соответствующее первому дню недели для данной локали и календарной системы. 0 обозначает воскресенье, 1— понедельник и т. д. Последнее значение 6 соответствует субботе.

Получает список локализованных строк, содержащий названия месяцев для текущей календарной системы. Первый элемент списка содержит название первого месяца в году.

Параметры

Связанные элементы API

Получает список локализованных строк, содержащий названия дней недели для текущей календарной системы. Первый элемент списка представляет название для воскресенья.

Параметры

Связанные элементы API