DateTimeFormatter  - AS3

此 DateTimeFormatter 对象使用的实际区域设置 ID 的名称。

根据操作系统和传递给 Collator() 构造函数的 requestedLocaleIDName 参数的值，该名称有三种可能的值。

1. 如果请求的区域设置不是 LocaleID.DEFAULT 且操作系统支持该请求的区域设置，则返回的名称与 requestedLocaleIDName 属性相同。
2. 如果将 LocaleID.DEFAULT 用作构造函数的 requestedLocaleIDName 参数的值，则使用由用户操作系统指定的当前区域设置的名称。LocaleID.DEFAULT 值保留用户在操作系统中的自定义设置。显式值作为 requestedLocaleIDName 参数传递与使用 LocaleID.DEFAULT 所产生的结果不一定相同，即使两个区域设置 ID 名称相同，也是如此。用户可能已在他们的计算机上对区域设置进行了自定义，通过请求显式区域设置 ID 名称（而不是使用 LocaleID.DEFAULT），您的应用程序将不会检索这些自定义设置。
3. 如果系统不支持在构造函数中指定的 requestedLocaleIDName，则会提供回退区域设置 ID 名称。

相关 API 元素

此 DateTimeFormatter 对象执行的前一操作的状态。只要调用构造函数或此类的方法或设置另一个属性，就会设置 lastOperationStatus 属性。有关可能的值，请参阅每种方法的说明。

相关 API 元素

传递到此 DateTimeFormatter 对象的构造函数的请求区域设置 ID 的名称。

如果使用了 LocaleID.DEFAULT 值，则返回的名称将是“i-default”。如果应用了回退区域设置，则实际使用的区域设置可能与请求的区域设置不同。可以使用 actualLocaleIDName 属性检索实际区域设置的名称。

相关 API 元素

构造新 DateTimeFormatter 对象，以根据指定区域设置的约定以及提供的日期和时间格式设置样式来设置日期和时间的格式。日期和时间样式用于将日期和时间格式设置模式设置为操作系统中预定义的与区域设置相关的模式。

此构造函数确定当前操作系统是否支持请求的区域设置 ID 名称。如果不支持，则使用回退区域设置。回退区域设置 ID 的名称可通过 actualLocaleIDName 属性确定。

如果回退用于任何 requestedLocaleIDName、dateStyle 或 timeStyle 参数，则会设置 lastOperationStatus 属性来表示回退类型。

要根据用户的当前操作系统首选项进行格式设置，请将 requestedLocaleIDName 参数中的值 LocaleID.DEFAULT 传递给构造函数。

调用构造函数并成功完成后，将 lastOperationStatus 属性设置为：

• LastOperationStatus.NO_ERROR

如果请求的区域设置 ID 名称不可用，则将 lastOperationStatus 属性设置为下列属性之一：

• LastOperationStatus.USING_FALLBACK_WARNING
• LastOperationStatus.USING_DEFAULT_WARNING

否则，将 lastOperationStatus 属性设置为 LastOperationStatus 类中定义的其中一个常量。

有关以上列出的警告和 lastOperationStatus 属性其他可能值的详细信息，请参阅 LastOperationStatus 类中的说明。

相关 API 元素

设置解释为以用户本地时间表示（使用 Date 对象的本地时间组件，如 date、day、fullYear、hours、minutes、month 和 seconds）的 Date 对象的显示字符串的格式。将使用为此 DateTimeFormatter 实例指定的区域设置 ID 的约定和日期样式及时间样式或者自定义的日期模式和时间模式来完成格式设置。

调用此方法并成功完成后，将 lastOperationStatus 属性设置为：

• LastOperationStatus.NO_ERROR

否则，将 lastOperationStatus 属性设置为 LastOperationStatus 类中定义的一个常量。

参数

相关 API 元素

根据 dateStyle、timeStyle 或日期时间模式，设置解释为以 UTC 时间表示（使用 Date 对象的 UTC 组成组件，如 dateUTC、dayUTC、fullYearUTC、hoursUTC、minutesUTC、monthUTC 和 secondsUTC）的 Date 对象的显示字符串的格式。将使用为此 DateTimeFormatter 实例指定的区域设置 ID 的约定和日期样式及时间样式或者自定义的日期模式和时间模式来完成格式设置。

调用此方法并成功完成后，将 lastOperationStatus 属性设置为：

• LastOperationStatus.NO_ERROR

否则，将 lastOperationStatus 属性设置为 LastOperationStatus 类中定义的一个常量。

参数

相关 API 元素

列出此类支持的所有区域设置 ID 名称。

如果当前操作系统不支持此类，此方法返回 null 值。

调用此方法并成功完成后，将 lastOperationStatus 属性设置为：

• LastOperationStatus.NO_ERROR

否则，将 lastOperationStatus 属性设置为 LastOperationStatus 类中定义的一个常量。

相关 API 元素

获取此实例 DateTimeFormatter 的日期样式。日期样式用于从操作系统检索预定义的日期格式设置模式。可通过 DateTimeFormatter() 构造函数、setDateTimeStyles() 方法或 setDateTimePattern() 方法设置日期样式值。

调用此方法并成功完成后，将 lastOperationStatus 属性设置为：

• LastOperationStatus.NO_ERROR

否则，将 lastOperationStatus 属性设置为 LastOperationStatus 类中定义的一个常量。

相关 API 元素

返回此 DateTimeFormatter 对象设置日期和时间格式所用的模式字符串。

可以使用以下三种方法之一设置此模式：

1. 通过构造函数中使用的 dateStyle 和 timeStyle 参数。
2. 通过 setDateTimeStyles() 方法。
3. 通过 setDateTimePattern() 方法。

有关模式语法的说明，请参阅 setDateTimePattern() 方法。

调用此方法并成功完成后，将 lastOperationStatus 属性设置为：

• LastOperationStatus.NO_ERROR

否则，将 lastOperationStatus 属性设置为 LastOperationStatus 类中定义的一个常量。

相关 API 元素

返回一个整数，它对应于此区域设置和日历系统的每周第一天。值 0 对应于星期日，1 对应于星期一，依此类推，6 对应于星期六。

调用此方法并成功完成后，将 lastOperationStatus 属性设置为：

• LastOperationStatus.NO_ERROR

否则，将 lastOperationStatus 属性设置为 LastOperationStatus 类中定义的一个常量。

相关 API 元素

检索包含当前日历系统的月名称的本地化字符串列表。列表中的第一个元素表示一年中第一个月的名称。

调用此方法并成功完成后，将 lastOperationStatus 属性设置为：

• LastOperationStatus.NO_ERROR

否则，将 lastOperationStatus 属性设置为 LastOperationStatus 类中定义的一个常量。

参数

相关 API 元素

获取此实例 DateTimeFormatter 的时间样式。时间样式用于从操作系统检索预定义的时间格式设置模式。可通过 DateTimeFormatter() 构造函数、setDateTimeStyles() 方法或 setDateTimePattern() 方法设置时间样式值。

调用此方法并成功完成后，将 lastOperationStatus 属性设置为：

• LastOperationStatus.NO_ERROR

否则，将 lastOperationStatus 属性设置为 LastOperationStatus 类中定义的一个常量。

相关 API 元素

检索包含当前日历系统的工作日名称的本地化字符串列表。列表中的第一个元素表示星期日的名称。

调用此方法并成功完成后，将 lastOperationStatus 属性设置为：

• LastOperationStatus.NO_ERROR

否则，将 lastOperationStatus 属性设置为 LastOperationStatus 类中定义的一个常量。

参数

相关 API 元素

设置此 DateTimeFormatter 对象设置日期和时间格式所用的模式字符串。

可通过以下三种方法之一设置用于对日期进行格式设置的模式：

1. 通过构造函数中使用的 dateStyle 和 timeStyle 参数。
2. 通过 setDateTimeStyles() 方法。
3. 通过 setDateTimePattern() 方法。

使用此方法的另一结果是：将覆盖此 DateTimeFormatter 对象的当前时间和日期样式，并将其值设置为 DateTimeStyle.CUSTOM。

用于定义如何设置日期和时间格式的模式字符串。模式包含一系列将设置了格式的字符串中的日期和时间值替换的字母。例如，在“yyyy/MM”模式中，字符“yyyy”被四位数字的年份替换，它后面跟“/”字符，字符“MM”被两位数字的月份替换。

模式中所用的许多字符都可以重复使用多次以产生不同的输出，如下表所示。

如果序列超过了模式支持的最大字母数，则会将该序列映射回所支持的该模式字母的最长序列。例如：

• MMMMMM 被替换为 MMMM
• dddd 被替换为 dd
• EEEEEEE 被替换为 EEEE
• aa 被替换为 a
• hhh 被替换为 hh
• mmmm 被替换为 mm

从理论上说，一个模式最多可包含 255 个字符，但某些平台具有更严格的限制。如果模式超过了模式字符限制，则 lastOperationStatus 属性的值将被设置为 LastOperationStatus.PATTERN_SYNTAX_ERROR。

并不是每一个操作系统都支持所有可能的模式。如果平台不支持某一种模式，则使用回退模式，并设置 lastOperationStatus 属性表示使用回退模式。如果未提供合理的回退模式，则使用空字符串，并设置 lastOperationStatus 属性表示不支持该模式。

下表列出了有效的模式字母以及它们的含义。

调用此方法并成功完成后，将 lastOperationStatus 属性设置为：

• LastOperationStatus.NO_ERROR

否则，将 lastOperationStatus 属性设置为 LastOperationStatus 类中定义的一个常量。

参数

相关 API 元素

设置此 DateTimeFormatter 实例的日期和时间样式。日期和时间样式用于将日期和时间格式设置模式设置为操作系统中预定义的、与区域设置相关的模式。此方法可替换使用 DateTimeFormatter() 构造函数或使用 setDateTimePattern() 方法设置的样式。日期和时间模式还根据设置的样式更新。

调用此方法并成功完成后，将 lastOperationStatus 属性设置为：

• LastOperationStatus.NO_ERROR

否则，将 lastOperationStatus 属性设置为 LastOperationStatus 类中定义的一个常量。

参数

相关 API 元素

此示例使用下列区域设置：英语（美国）、法语（法国）和西班牙语（西班牙）。

此示例为该列表中的每个区域设置执行下列操作：

1. 使用默认样式（长日期样式和长时间样式）创建 DateTimeFormatter 对象
2. 使用默认的长日期样式设置当前日期和时间的格式。
3. 使用 DateTimeStyle.NONE 和 DateTimeStyle.SHORT 常量更改为仅时间的短日期样式。
4. 使用仅时间的短日期样式设置当前日期和时间的格式。

package {
    import flash.display.Sprite;
    import flash.globalization.DateTimeFormatter;
    import flash.globalization.DateTimeStyle;
    
    public class DateTimeFormatterExample extends Sprite
    {    
        private var localeList:Array = new Array("en-US", "fr-FR", "es-ES");
    
        public function DateTimeFormatterExample()
        {
            var date:Date = new Date();
            
            for each (var locale:String in localeList) {
                var dtf:DateTimeFormatter = new DateTimeFormatter(locale);
                trace('\n' + "LocaleID requested=" + dtf.requestedLocaleIDName 
                    + "; actual=" + dtf.actualLocaleIDName);
            
                var longDate:String = dtf.format(date);
                trace(longDate + " (" + dtf.getDateTimePattern() + ")");
            
                dtf.setDateTimeStyles(DateTimeStyle.NONE, DateTimeStyle.SHORT);
                var shortDate:String = dtf.format(date);
                trace(shortDate + " (" + dtf.getDateTimePattern() + ")");
            }        
        }
    }
}

此示例为该列表中的每个区域设置执行下列操作：

1. 创建 3 个输入和输出文本字段。
2. 使用美国英语区域设置创建 DateTimeFormatter 对象。
3. 调用 configureTextField() 函数，该函数将设置文本字段的位置和大小，并向 patternField 对象添加事件侦听器。
4. 用户在 patternField 文本字段中输入模式后，textInputHandler 函数将使用该模式设置当前日期和时间的格式，并在输出文本字段中显示结果和 lastOperationStatus 值。

 
package {  
    import flash.display.Sprite;
    import flash.events.Event;
    import flash.globalization.DateTimeFormatter;
    import flash.text.*;
    
    public class DateTimePatternExample extends Sprite
    {    
        private var patternField:TextField = new TextField();
        private var resultField:TextField = new TextField();
        private var statusField:TextField = new TextField();
           private var date:Date = new Date();
         private var dtf:DateTimeFormatter = new DateTimeFormatter("en-US");           
         
        private function configureTextField():void
        {
            patternField.type = TextFieldType.INPUT;
            patternField.width = 300;
            patternField.height = 20;
            patternField.background = true;
            patternField.border = true;
            
            resultField.y = 40;
            resultField.width = 300;
            resultField.height = 20;
            
            statusField.y = 80;
            statusField.width = 300;
            statusField.height = 20;

            addChild(patternField);
            addChild(resultField);
            addChild(statusField);
            patternField.addEventListener(Event.CHANGE,textInputHandler);
        }

        private function textInputHandler(event:Event):void
        {                 
            dtf.setDateTimePattern(patternField.text);
            statusField.text = dtf.lastOperationStatus;
            resultField.text = dtf.format(date);
        }

        public function DateTimePatternExample()
        {
            configureTextField();    
        }
    }
}