DateTimeFormatter  - AS3

De naam van de werkelijke landinstellings-id die door dit DateTimeFormatter-object wordt gebruikt.

Er zijn drie mogelijke waarden voor de naam, afhankelijk van het besturingssysteem en de waarde van de requestedLocaleIDName-parameter die wordt doorgegeven aan de Collator()-constructor.

1. Als de aangevraagde landinstelling niet gelijk is aan LocaleID.DEFAULT en het besturingssysteem ondersteuning voor de aangevraagde landinstelling biedt, is de geretourneerde naam gelijk aan de eigenschap requestedLocaleIDName.
2. Als LocaleID.DEFAULT is gebruikt als waarde voor de parameter requestedLocaleIDName aan de constructor, wordt de naam van de huidige landinstelling zoals opgegeven door het besturingssysteem van de gebruiker gebruikt. Met de waarde LocaleID.DEFAULT blijft de aangepaste gebruikersinstelling in het besturingssysteem behouden. Als u een expliciete waarde doorgeeft als parameter requestedLocaleIDName, krijgt u niet noodzakelijkerwijs hetzelfde resultaat als wanneer u LocaleID.DEFAULT gebruikt, ook al zijn beide namen voor de landinstellings-id's gelijk. Misschien heeft de gebruiker de landinstellingen op zijn computer aangepast. Doordat u een expliciete naam van een landinstellings-id aanvraagt (en niet LocaleID.DEFAULT gebruikt), worden deze aangepaste instellingen niet door uw toepassing opgehaald.
3. Als het systeem geen ondersteuning biedt voor derequestedLocaleIDName die in de constructor is opgegeven, wordt een fallback-landinstellings-id gebruikt.

Verwante API-elementen

De status van de voorgaande bewerking die door dit object DateTimeFormatter is uitgevoerd. De eigenschap lastOperationStatus wordt ingesteld wanneer de constructor of een methode van deze klasse wordt aangeroepen of wanneer een andere eigenschap wordt ingesteld. Zie de beschrijving van de verschillende methoden voor de mogelijke waarden.

Verwante API-elementen

De naam van de aangevraagde landinstellings-id die is doorgegeven aan de constructor van dit DateTimeFormatter-object.

Als u de waarde LocaleID.DEFAULT hebt gebruikt, is de geretourneerde naam 'i-default'. Als een fallback-landinstelling wordt toegepast, kan de werkelijk gebruikte landinstelling afwijken van de aangevraagde landinstelling. De naam van de werkelijke landinstelling kan worden opgehaald met de eigenschap actualLocaleIDName.

Verwante API-elementen

Maakt een nieuw DateTimeFormatter-object waarmee de datum en tijd worden opgemaakt volgens de conventies van de opgegeven landinstelling en opmaakstijl voor de datum en tijd. Met stijlen voor de datum en tijd worden de datum- en tijdnotatiepatronen ingesteld op de vooraf gedefinieerde landinstellingpatronen van het besturingssysteem.

Deze constructor bepaalt of het huidige besturingssysteem ondersteuning biedt voor de aangevraagde naam van de landinstellings-id. Als er geen ondersteuning is, wordt een fallback-landinstelling gebruikt. De naam van de fallback-landinstellings-id kan worden bepaald aan de hand van de eigenschap actualLocaleIDName.

Als een fallback wordt gebruikt voor een van de parameters requestedLocaleIDName, dateStyle of timeStyle, geeft de instelling van de eigenschap lastOperationStatus het type fallback aan.

Als u een opmaak wilt toepassen die is gebaseerd op de huidige voorkeuren van het besturingssysteem, geeft u de waarde LocaleID.DEFAULT in de parameter requestedLocaleIDName door aan de constructor.

Wanneer de constructor wordt aangeroepen en succesvol wordt afgerond, is de eigenschap lastOperationStatus ingesteld op:

• LastOperationStatus.NO_ERROR

Wanneer de aangevraagde naam voor de landinstellings-id niet beschikbaar is, wordt lastOperationStatus ingesteld op een van de volgende waarden:

• LastOperationStatus.USING_FALLBACK_WARNING
• LastOperationStatus.USING_DEFAULT_WARNING

In het andere geval wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die in de LastOperationStatus-klasse worden gedefinieerd.

Meer informatie over de bovenstaande waarschuwingen en andere mogelijke waarden voor de eigenschap lastOperationStatus vindt u in de beschrijvingen in de LastOperationStatus-klasse.

Verwante API-elementen

Bepaalt de opmaak van een weergavetekenreeks voor een Date-object waarvan wordt aangenomen dat het in de lokale tijd van de gebruiker staat, dat wil zeggen: met de lokale tijdcomponenten van het Date-object (date, day, fullYear, hours, minutes, month en seconds). De opmaak wordt gebaseerd op de conventies van de landinstellings-id en op de opmaakstijl voor de datum en tijd. De opmaak kan ook worden gebaseerd op het aangepaste datum- en tijdpatroon dat voor deze instantie DateTimeFormatter is opgegeven.

Wanneer deze methode wordt aangeroepen en met succes wordt voltooid, wordt de eigenschap lastOperationStatus ingesteld op:

• LastOperationStatus.NO_ERROR

Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.

Parameters

Verwante API-elementen

Bepaalt de opmaak van een weergavetekenreeks voor een Date-object waarvan wordt aangenomen dat het in UTC-tijd staat, dat wil zeggen: met de UTC-tijdcomponenten van het Date-object (dateUTC, dayUTC, fullYearUTC, hoursUTC, minutesUTC, monthUTC en secondsUTC), volgens het dateStyle-, timeStyle- of datumtijdpatroon. De opmaak wordt gebaseerd op de conventies van de landinstellings-id en op de opmaakstijl voor de datum en tijd. De opmaak kan ook worden gebaseerd op het aangepaste datum- en tijdpatroon dat voor deze instantie DateTimeFormatter is opgegeven.

Wanneer deze methode wordt aangeroepen en met succes wordt voltooid, wordt de eigenschap lastOperationStatus ingesteld op:

• LastOperationStatus.NO_ERROR

Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.

Parameters

Verwante API-elementen

Biedt een overzicht van alle namen van landinstellings-id's die door deze klasse worden ondersteund.

Als deze klasse niet word ondersteund op het huidige besturingssysteem, retourneert deze methode de waarde null.

Wanneer deze methode wordt aangeroepen en met succes wordt voltooid, wordt de eigenschap lastOperationStatus ingesteld op:

• LastOperationStatus.NO_ERROR

Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.

Verwante API-elementen

Haalt de datumstijl op voor deze DateTimeFormatter-instantie. De datumstijl wordt gebruikt om een vooraf gedefinieerd datumnotatiepatroon op te halen uit het besturingssysteem. De datumstijlwaarde kan worden ingesteld door de constructor DateTimeFormatter(), de methode setDateTimeStyles() of de methode setDateTimePattern().

Wanneer deze methode wordt aangeroepen en met succes wordt voltooid, wordt de eigenschap lastOperationStatus ingesteld op:

• LastOperationStatus.NO_ERROR

Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.

Verwante API-elementen

Retourneert de tekenreeks voor het patroon waarmee de datum en tijd wordt opgemaakt door dit DateTimeFormatter-object.

Dit patroon kan op een van de volgende drie manieren worden ingesteld:

1. Door de parameters dateStyle en timeStyle die in de constructor worden gebruikt
2. Door de setDateTimeStyles()-methode
3. Door de methode setDateTimePattern().

Raadpleeg de methode setDateTimePattern() voor een omschrijving van de patroonsyntaxis.

Wanneer deze methode wordt aangeroepen en met succes wordt voltooid, wordt de eigenschap lastOperationStatus ingesteld op:

• LastOperationStatus.NO_ERROR

Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.

Verwante API-elementen

Retourneert een geheel getal dat overeenkomt met de eerste dag van de week voor dit landinstelling- en tijdsysteem. De waarde 0 komt overeen met zondag, 1 komt overeen met maandag enzovoort, en 6 komt overeen met zaterdag.

Wanneer deze methode wordt aangeroepen en met succes wordt voltooid, wordt de eigenschap lastOperationStatus ingesteld op:

• LastOperationStatus.NO_ERROR

Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.

Verwante API-elementen

Haalt een lijst op met de gelokaliseerde tekenreeksen voor de namen van de maanden van het huidige kalendersysteem. Het eerste element in de lijst is de naam voor de eerste maand van het jaar.

Wanneer deze methode wordt aangeroepen en met succes wordt voltooid, wordt de eigenschap lastOperationStatus ingesteld op:

• LastOperationStatus.NO_ERROR

Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.

Parameters

Verwante API-elementen

Haalt de tijdstijl op voor deze DateTimeFormatter-instantie. De tijdstijl wordt gebruikt om een vooraf gedefinieerd tijdnotatiepatroon op te halen uit het besturingssysteem. De tijdstijlwaarde kan worden ingesteld door de constructor DateTimeFormatter(), de methode setDateTimeStyles() of de methode setDateTimePattern().

Wanneer deze methode wordt aangeroepen en met succes wordt voltooid, wordt de eigenschap lastOperationStatus ingesteld op:

• LastOperationStatus.NO_ERROR

Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.

Verwante API-elementen

Haalt een lijst op met gelokaliseerde tekenreeksen voor de namen van de weekdagen van het huidige kalendersysteem. Het eerste element in de lijst is de naam voor zondag.

Wanneer deze methode wordt aangeroepen en met succes wordt voltooid, wordt de eigenschap lastOperationStatus ingesteld op:

• LastOperationStatus.NO_ERROR

Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.

Parameters

Verwante API-elementen

Haalt de tekenreeks op voor het patroon waarmee de datum en tijd wordt opgemaakt door dit DateTimeFormatter-object.

Het patroon voor de datumnotatie kan op een van de volgende drie manieren worden ingesteld:

1. Door de parameters dateStyle en timeStyle die in de constructor worden gebruikt
2. Door de setDateTimeStyles()-methode
3. Door deze setDateTimePattern()-methode.

Deze methode heeft als neveneffect dat de huidige datum- en tijdstijlen voor dit object DateTimeFormatter worden genegeerd en worden ingesteld op de waarde DateTimeStyle.CUSTOM.

Een patroontekenreeks definieert de opmaak van de datum- en tijdnotatie. Het patroon bevat letterreeksen die worden vervangen met datum- en tijdwaarden in de opgemaakte tekenreeks. In het patroon 'yyyy/MM' worden de letters 'yyyy' bijvoorbeeld vervangen door een viercijferig jaar. Dan volgt het teken '/'. De letters 'MM' worden vervangen door een tweecijferige maand.

Veel van de in patronen gebruikte letters kunnen meer dan eens worden herhaald, zodat er verschillende typen uitvoer worden gegenereerd. Raadpleeg de onderstaande tabel voor een omschrijving.

Als een reeks het maximumaantal letters overschrijdt dat door een patroon wordt ondersteund, wordt de reeks gekoppeld aan de langste ondersteunde reeks voor de desbetreffende patroonletter. Bijvoorbeeld:

• MMMMMM wordt vervangen door MMMM
• dddd wordt vervangen door dd
• EEEEEEE wordt vervangen door EEEE
• aa wordt vervangen door a
• hhh wordt vervangen door hh
• mmmm wordt vervangen door mm

In theorie kan een patroon maximaal 255 tekens bevatten, maar bij sommige platformen ligt deze limiet lager. Als de tekenlimiet van een patroon wordt overschreden, wordt de eigenschap lastOperationStatus ingesteld op de waarde LastOperationStatus.PATTERN_SYNTAX_ERROR.

Niet alle besturingssystemen bieden ondersteuning voor alle mogelijke patronen. Als een besturingssysteem geen ondersteuning voor een patroon biedt, wordt er een fallback-patroon gebruikt. De instelling van de eigenschap lastOperationStatus geeft dan aan dat er een fallback-patroon wordt gebruikt. Als er geen redelijk fallback-patroon kan worden geleverd, wordt een lege tekenreeks gebruikt. De instelling van de eigenschap lastOperationStatus geeft dan aan dat het patroon niet wordt ondersteund.

In de volgende tabel vindt u een omschrijving van de geldige patroonletters en hun betekenis.

Wanneer deze methode wordt aangeroepen en met succes wordt voltooid, wordt de eigenschap lastOperationStatus ingesteld op:

• LastOperationStatus.NO_ERROR

Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.

Parameters

Verwante API-elementen

Stelt de datum- en tijdstijlen in voor deze DateTimeFormatter-instantie. Met stijlen voor de datum en tijd worden de datum- en tijdnotatiepatronen ingesteld op de vooraf gedefinieerde landinstellingpatronen van het besturingssysteem. Met deze methode worden de stijlen vervangen die zijn ingesteld met de constructor DateTimeFormatter() of met de methode setDateTimePattern(). Het datum- en tijdpatroon wordt eveneens bijgewerkt op basis van de ingestelde stijlen.

Wanneer deze methode wordt aangeroepen en met succes wordt voltooid, wordt de eigenschap lastOperationStatus ingesteld op:

• LastOperationStatus.NO_ERROR

Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.

Parameters

Verwante API-elementen

In dit voorbeeld worden de volgende landinstellingen gebruikt: Engels (Verenigde Staten), Frans (Frankrijk) en Spaans (Spanje).

In het voorbeeld wordt voor elke landinstelling in de lijst het volgende uitgevoerd:

1. Er wordt een DateTimeFormatter-object gemaakt in de standaardstijl (lange dateStyle, lange timeStyle).
2. Hiermee wordt de huidige datum en tijd opgemaakt met de standaard lange datumstijl.
3. Schakel over naar een korte datumstijl met alleen de tijd, met behulp van de constanten DateTimeStyle.NONE en DateTimeStyle.SHORT.
4. Hiermee wordt de huidige datum en tijd opgemaakt met de korte datumstijl met alleen de tijd.

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

In het voorbeeld wordt voor elke landinstelling in de lijst het volgende uitgevoerd:

1. Hiermee worden drie invoer- en uitvoer-tekstvelden gemaakt.
2. Hiermee wordt een DateTimeFormatter-object gemaakt met behulp van de Amerikaans-Engelse landinstelling.
3. Roept de configureTextField()-functie op. Door deze functie worden de positie en grootte van tekstvelden ingesteld en wordt een gebeurtenislistener aan het object patternField toegevoegd.
4. Wanneer de gebruiker een patroon in het patternField-tekstveld invoert, maakt de textInputHandler-functie de huidige datum en tijd op met het patroon en wordt het resultaat en de lastOperationStatus-waarde in de uitvoertekstvelden weergegeven.

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