DateTimeFormatter  - AS3

Namnet på det faktiska språk-ID som används av det här DateTimeFormatter-objektet.

Det finns tre möjliga värden för namnet, beroende på operativsystemet och värdet på den requestedLocaleIDName-parameter som skickas till Collator()-konstruktorn.

1. Om det begärda språket inte var LocaleID.DEFAULT, och operativsystemet har stöd för det begärda språket, är det namn som returneras samma som egenskapen requestedLocaleIDName.
2. Om LocaleID.DEFAULT användes som värdet för parametern requestedLocaleIDName till konstruktorn, används det namn för det aktuella språket som specificeras av användarens operativsystem. Värdet LocaleID.DEFAULT bevarar användarens anpassade inställningar i operativsystemet. Om du skickar ett uttryckligt värde som requestedLocaleIDName-parameter ger det inte nödvändigtvis samma resultat som när du använder LocaleID.DEFAULT, även om de båda språknamnen är samma. Användaren kan ha anpassat språkinställningarna på datorn, och om du begär ett uttryckligt språk-ID i stället för att använda LocaleID.DEFAULT hämtar ditt program inte dessa anpassade inställningar.
3. Om systemet saknar stöd för det requestedLocaleIDName som anges i konstruktorn används ett reservspråk-ID i stället.

Relaterade API-element

Status för den tidigare åtgärden som detta DateTimeFormatter-objekt utförde. Egenskapen lastOperationStatus anges när konstruktorn eller en metod för den här klassen anropas eller när en annan egenskap anges. Beskrivningarna av de olika metoderna innehåller information om möjliga värden.

Relaterade API-element

Namnet på det begärda språk-ID som skickades till konstruktorn för det här DateTimeFormatter-objektet.

Om värdet LocaleID.DEFAULT användes returneras namnet "i-default". Det språk som faktiskt används kan skilja sig från det begärda språket när ett reservspråk används. Namnet på det faktiska språket kan hämtas med egenskapen actualLocaleIDName.

Relaterade API-element

Skapar ett nytt DateTimeFormatter-objekt för att formatera datum och tider i enlighet med det angivna språket och de angivna formaten för datum och tid. Datum- och tidsformat används för att ställa in formateringsmönster för datum och tid på fördefinierade, språkberoende mönster från operativsystemet.

Den här konstruktorn avgör om det aktuella operativsystemet har stöd för det begärda språk-ID:t. Om det inte stöds används ett reservspråk i stället. Namnet på reservspråket kan fastställas med hjälp av egenskapen actualLocaleIDName.

Om ett reservalternativ används för någon av parametrarna requestedLocaleIDName, dateStyle eller timeStyle ställs egenskapen lastOperationStatus in så att den anger vilken typ av reservalternativ som använts.

Om formateringen ska ske baserat på användarens aktuella operativsysteminställningar skickar du värdet LocaleID.DEFAULT i parametern requestedLocaleIDName till konstruktorn.

När konstruktorn anropas och slutförs felfritt ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

När det begärda språk-ID:t inte är tillgängligt ställs lastOperationStatus in på något av följande:

• LastOperationStatus.USING_FALLBACK_WARNING
• LastOperationStatus.USING_DEFAULT_WARNING

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Mer information om de varningsmeddelanden som visas ovan och andra möjliga värden för egenskapen lastOperationStatus finns i beskrivningarna för klassen LastOperationStatus.

Relaterade API-element

Formaterar en visningssträng för ett Date-objekt som tolkas som användarens lokala tid (med hjälp av komponenterna för lokal tid i Date-objektet, som datum, dag, år, timmar, minuter, månad och sekunder). Formateringen utförs i enlighet med det angivna språk-ID:t och det datum- och tidsformat, eller anpassade datum- och tidsmönster, som angetts för den här DateTimeFormatter-instansen.

När den här metoden anropas och slutförs felfritt ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Parametrar

Relaterade API-element

Formaterar en visningssträng för ett Date-objekt som tolkas som UTC-tid (med hjälp av UTC-komponenterna för Date-objektet, som dateUTC, dayUTC, fullYearUTC, hoursUTC, minutesUTC, monthUTC och secondsUTC) i enlighet med dateStyle, timeStyle eller datum-/tidsmönster. Formateringen utförs i enlighet med det angivna språk-ID:t och det datum- och tidsformat, eller anpassade datum- och tidsmönster, som angetts för den här DateTimeFormatter-instansen.

När den här metoden anropas och slutförs felfritt ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Parametrar

Relaterade API-element

Visar alla språk-ID:n som stöds i den här klassen.

Om den här klassen inte stöds på det aktuella operativsystemet returnerar metoden värdet null.

När den här metoden anropas och slutförs felfritt ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Relaterade API-element

Hämtar datumformatet för den här instansen av DateTimeFormatter. Datumformatet används för att hämta ett fördefinierat formateringsmönster för datum från operativsystemet. Värdet för datumformatet kan anges med DateTimeFormatter()-konstruktorn, metoden setDateTimeStyles() eller metoden setDateTimePattern().

När den här metoden anropas och slutförs felfritt ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Relaterade API-element

Returnerar den mönstersträng som används av det här DateTimeFormatter-objektet för att formatera datum och tider.

Det här mönstret kan anges på något av följande tre sätt:

1. Med parametrarna dateStyle och timeStyle i konstruktorn
2. Med metoden setDateTimeStyles()
3. Med metoden setDateTimePattern().

Du hittar en beskrivning av mönstersyntaxen i avsnittet om metoden setDateTimePattern().

När den här metoden anropas och slutförs felfritt ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Relaterade API-element

Returnerar ett heltal som motsvarar den första dagen i veckan för det här språket och kalendersystemet. Värdet 0 motsvarar söndag, 1 motsvarar måndag och så vidare, och slutligen motsvarar 6 lördag.

När den här metoden anropas och slutförs felfritt ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Relaterade API-element

Hämtar en lista med lokaliserade strängar som innehåller månadsnamnen för det aktuella kalendersystemet. Det första elementet i listan är namnet på årets första månad.

När den här metoden anropas och slutförs felfritt ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Parametrar

Relaterade API-element

Hämtar tidsformatet för den här instansen av DateTimeFormatter. Tidsformatet används för att hämta ett fördefinierat formateringsmönster för tid från operativsystemet. Värdet för tidsformatet kan anges med DateTimeFormatter()-konstruktorn, metoden setDateTimeStyles() eller metoden setDateTimePattern().

När den här metoden anropas och slutförs felfritt ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Relaterade API-element

Hämtar en lista med lokaliserade strängar som innehåller namnen på veckodagarna för det aktuella kalendersystemet. Det första elementet i listan är namnet på söndag.

När den här metoden anropas och slutförs felfritt ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Parametrar

Relaterade API-element

Anger den mönstersträng som används av det här DateTimeFormatter-objektet för att formatera datum och tider.

Mönstret för att formatera datum kan anges på något av följande tre sätt:

1. Med parametrarna dateStyle och timeStyle i konstruktorn
2. Med metoden setDateTimeStyles()
3. Med den här setDateTimePattern()-metoden.

En bieffekt är att den här metoden åsidosätter de aktuella tids- och datumformaten för det här DateTimeFormatter-objektet och ställer in dem på värdet DateTimeStyle.CUSTOM.

En mönstersträng definierar hur datum och tid formateras. Mönstret innehåller bokstavssekvenser, som ersätts med datum- och tidsvärden i den formaterade strängen. I mönstret "yyyy/MM" ersätts tecknen "yyyy" med ett fyrsiffrigt årtal, följt av tecknet "/", och tecknen "MM" ersätts med ett tvåsiffrigt månadstal.

Många av de bokstäver som används i mönstren kan upprepas flera gånger för att skapa olika utdata, vilket beskrivs i tabellen nedan.

Om en sekvens överskrider det högsta tillåtna antalet bokstäver som stöds av ett mönster, återförs det till den längsta sekvensen som den mönsterbokstaven accepterar. Till exempel:

• MMMMMM ersätts med MMMM
• dddd ersätts med dd
• EEEEEEE ersätts med EEEE
• aa ersätts med a
• hhh ersätts med hh
• mmmm ersätts med mm

I teorin kan ett mönster innehålla upp till 255 tecken, men vissa plattformar är mer begränsade. Om mönstret överskrider gränsen för tillåtna mönstertecken ställs egenskapen lastOperationStatus in på värdet LastOperationStatus.PATTERN_SYNTAX_ERROR.

Alla operativsystem har inte stöd för alla mönster. Om ett mönster inte stöds på plattformen används ett reservmönster och egenskapen lastOperationStatus ställs in så att den anger att detta har skett. Om det inte finns något lämpligt reservmönster används en tom sträng och egenskapen lastOperationStatus ställs in så att den anger att mönstret saknade stöd.

I följande tabell beskrivs giltiga mönsterbokstäver och deras betydelse.

När den här metoden anropas och slutförs felfritt ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Parametrar

Relaterade API-element

Anger datum- och tidsformat för den här instansen av DateTimeFormatter. Datum- och tidsformat används för att ställa in formateringsmönster för datum och tid på fördefinierade, språkberoende mönster från operativsystemet. Den här metoden ersätter de format som ställdes in med DateTimeFormatter()-konstruktorn eller med metoden setDateTimePattern(). Datum- och tidsmönstret uppdateras även utifrån de format som anges.

När den här metoden anropas och slutförs felfritt ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Parametrar

Relaterade API-element

I det här exemplet används följande språk: engelska (USA), franska (Frankrike) och spanska (Spanien).

I exemplet utförs följande för varje språk i listan:

1. Skapar ett DateTimeFormatter-objekt med standardformatet (långt dateStyle, långt timeStyle).
2. Formaterar aktuellt datum och aktuell tid med standardformatet för långt datum.
3. Ändra till ett kort datumformat för endast tid med konstanterna DateTimeStyle.NONE och DateTimeStyle.SHORT.
4. Formaterar aktuellt datum och aktuell tid med kort datumformat för endast tid.

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() + ")");
            }        
        }
    }
}

I exemplet utförs följande för varje språk i listan:

1. Skapar tre textfält för in- och utdata.
2. Skapar ett DateTimeFormatter-objekt med amerikansk engelska som språk.
3. Anropar funktionen configureTextField(), som anger position och storlek för textfälten och lägger till en händelseavlyssnare i patternField-objektet.
4. När användaren anger mönstret i textfältet patternField formaterar funktionen textInputHandler det aktuella datumet och den aktuella tiden med hjälp av mönstret och visar resultatet och värdet för lastOperationStatus i utdatatextfälten.

 
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();    
        }
    }
}