DateTimeFormatter  - AS3

Il nome dell'ID di impostazioni internazionali effettivamente utilizzato da questo oggetto DateTimeFormatter.

Esistono tre possibilità per il nome del valore, a seconda del sistema operativo e del valore del parametro requestedLocaleIDName passato alla funzione di costruzione Collator().

1. Se le impostazioni internazionali richieste non corrispondevano al valore LocaleID.DEFAULT e il sistema operativo fornisce il supporto per tali impostazioni internazionali, il nome restituito corrisponde alla proprietà requestedLocaleIDName.
2. Se è stato utilizzato LocaleID.DEFAULT come valore del parametro requestedLocaleIDName passato alla funzione di costruzione, viene utilizzato il nome delle impostazioni internazionali correnti specificato dal sistema operativo dell'utente. Il valore LocaleID.DEFAULT mantiene l'impostazione personalizzata dell'utente nel sistema operativo. Se passate un valore esplicito come parametro requestedLocaleIDName, non viene necessariamente restituito lo stesso risultato fornito da LocaleID.DEFAULT, anche se i nomi dei due ID di impostazioni internazionali sono gli stessi. L'utente potrebbe avere personalizzato le impostazioni internazionali del computer e la richiesta di un nome esplicito dell'ID di impostazioni internazionali, anziché l'utilizzo di LocaleID.DEFAULT, può impedire all'applicazione di rilevare tali impostazioni personalizzate.
3. Se il sistema operativo non supporta il parametro requestedLocaleIDName specificato nella funzione di costruzione, viene fornito un nome dell'ID di impostazioni internazionali di riserva.

Elementi API correlati

Lo stato della precedente operazione eseguita da questo oggetto DateTimeFormatter. La proprietà lastOperationStatus viene impostata ogni volta che chiamate una funzione di costruzione o un metodo di questa classe oppure impostate un'altra proprietà. Per i valori possibili, fate riferimento alla descrizione dei singoli metodi.

Elementi API correlati

Il nome dell'ID di impostazioni internazionali richiesto che è stato passato alla funzione di costruzione di questo oggetto DateTimeFormatter.

Se è stato utilizzato il valore LocaleID.DEFAULT, il nome restituito è "i-default". Quando vengono applicate impostazioni internazionali di riserva, le impostazioni internazionali effettivamente utilizzate possono essere diverse da quelle richieste. Il nome delle impostazioni internazionali effettive può essere recuperato utilizzando la proprietà actualLocaleIDName.

Elementi API correlati

Costruisce un nuovo oggetto DateTimeFormatter per formattare le date e le ore in base alle convenzioni delle impostazioni internazionali specificate e agli stili di formattazione di data e ora forniti. Gli stili di data e ora vengono utilizzati per impostare gli schemi di formattazione di data e ora in base agli schemi predefiniti e dipendenti dalle impostazioni internazionali del sistema operativo.

Questa funzione di costruzione determina se il sistema operativo corrente supporta il nome dell'ID di impostazioni internazionali richiesto. Se non è supportato, vengono utilizzate delle impostazioni internazionali di riserva. Il nome dell'ID di impostazioni internazionali di riserva può essere determinato dalla proprietà actualLocaleIDName.

Se vengono utilizzate le impostazioni internazionali di riserva per un parametro requestedLocaleIDName, dateStyle o timeStyle qualsiasi, la proprietà lastOperationStatus viene impostata di conseguenza, in modo da indicare tali impostazioni internazionali di riserva.

Per applicare la formattazione in base alle preferenze del sistema operativo corrente dell'utente, passate alla funzione di costruzione il valore LocaleID.DEFAULT nel parametro requestedLocaleIDName.

Quando la funzione di costruzione viene chiamata e completata correttamente, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Quando il nome dell'ID di impostazioni internazionali richiesto non è disponibile, lastOperationStatus è impostata su uno dei valori seguenti:

• LastOperationStatus.USING_FALLBACK_WARNING
• LastOperationStatus.USING_DEFAULT_WARNING

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Per informazioni dettagliate sugli avvisi sopra indicati e altri possibili valori della proprietà lastOperationStatus, fate riferimento alle descrizioni disponibili nella classe LastOperationStatus.

Elementi API correlati

Formatta una stringa di visualizzazione per un oggetto Date che viene interpretato come l'ora locale dell'utente (utilizzando i componenti dell'ora locale dell'oggetto Date quali: date, day, fullYear, hours, minutes, month e seconds). La formattazione viene applicata in base alle convenzioni dell'ID di importazioni internazionali e allo stile di data e di ora, oppure in base a uno schema personalizzato per la data e per l'ora, specificati per questa istanza DateTimeFormatter.

Quando questo metodo viene chiamato e completato correttamente, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Parametri

Elementi API correlati

Formatta una stringa di visualizzazione per un oggetto Date che viene interpretato come ora universale (UTC) (utilizzando i componenti UTC dell'oggetto Date quali: dateUTC, dayUTC, fullYearUTC, hoursUTC, minutesUTC, monthUTC e secondsUTC), in base allo schema dateStyle, timeStyle o data/ora. La formattazione viene applicata in base alle convenzioni dell'ID di importazioni internazionali e allo stile di data e di ora, oppure in base a uno schema personalizzato per la data e per l'ora, specificati per questa istanza DateTimeFormatter.

Quando questo metodo viene chiamato e completato correttamente, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Parametri

Elementi API correlati

Elenca tutti i nomi degli ID di impostazioni internazionali supportati da questa classe.

Se questa classe non è supportata dal sistema operativo corrente, il metodo restituisce un valore null.

Quando questo metodo viene chiamato e completato correttamente, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Elementi API correlati

Ottiene lo stile della data per questa istanza di DateTimeFormatter. Lo stile della data viene utilizzato per recuperare dal sistema operativo uno schema di formattazione della data predefinito. Il valore dello stile della data può essere impostato dalla funzione di costruzione DateTimeFormatter(), dal metodo setDateTimeStyles() o dal metodo setDateTimePattern().

Quando questo metodo viene chiamato e completato correttamente, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Elementi API correlati

Restituisce la stringa di schema utilizzata da questo oggetto DateTimeFormatter per formattare date e ore.

Potete impostare questo schema in uno dei tre modi seguenti:

1. Tramite i parametri dateStyle e timeStyle utilizzati nella funzione di costruzione.
2. Tramite il metodo setDateTimeStyles().
3. Tramite il metodo setDateTimePattern().

Per una descrizione della sintassi dello schema, fate riferimento al metodo setDateTimePattern().

Quando questo metodo viene chiamato e completato correttamente, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Elementi API correlati

Restituisce un numero intero corrispondente al primo giorno della settimana per questo contesto locale e sistema di calendario. Un valore 0 corrisponde a domenica, 1 corrisponde a lunedì e così via; 6 corrisponde a sabato.

Quando questo metodo viene chiamato e completato correttamente, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Elementi API correlati

Recupera un elenco di stringhe localizzate contenenti i nomi dei mesi del sistema di calendario corrente. Il primo elemento nell'elenco rappresenta il nome del primo mese dell'anno.

Quando questo metodo viene chiamato e completato correttamente, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Parametri

Elementi API correlati

Ottiene lo stile dell'ora per questa istanza di DateTimeFormatter. Lo stile dell'ora viene utilizzato per recuperare dal sistema operativo uno schema di formattazione dell'ora predefinito. Il valore dello stile dell'ora può essere impostato dalla funzione di costruzione DateTimeFormatter(), dal metodo setDateTimeStyles() o dal metodo setDateTimePattern().

Quando questo metodo viene chiamato e completato correttamente, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Elementi API correlati

Recupera un elenco di stringhe localizzate contenenti i nomi dei giorni della settimana del sistema di calendario corrente. Il primo elemento nell'elenco rappresenta il nome per domenica.

Quando questo metodo viene chiamato e completato correttamente, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Parametri

Elementi API correlati

Imposta la stringa di schema utilizzata da questo oggetto DateTimeFormatter per formattare date e ore.

Potete impostare lo schema utilizzato per formattare le date in uno dei tre modi seguenti:

1. Tramite i parametri dateStyle e timeStyle utilizzati nella funzione di costruzione.
2. Tramite il metodo setDateTimeStyles().
3. Tramite questo metodo setDateTimePattern().

come effetto collaterale, questo metodo ignora gli stili di data e ora correnti per questo oggetto DateTimeFormatter e imposta il relativo valore su DateTimeStyle.CUSTOM.

Una stringa di schema consente di definire la formattazione di date e ore. Lo schema contiene sequenze di lettere che vengono sostituite con valori di data e di ora nella stringa formattata. Nello schema "yyyy/MM", ad esempio, i caratteri "yyyy" vengono sostituiti con un anno a quattro cifre, seguito dal carattere "/", e i caratteri "MM" vengono sostituiti da un mese a due cifre.

Molte delle lettere utilizzate in uno schema possono essere ripetute più volte per produrre output diversi, come descritto nella tabella seguente.

Se una sequenza eccede il numero massimo di lettere supportato da uno schema, viene associata automaticamente alla sequenza più lunga supportata per tale lettera nello schema. Ad esempio:

• MMMMMM viene sostituito con MMMM;
• dddd viene sostituito con dd;
• EEEEEEE viene sostituito con EEEE;
• aa viene sostituito con a;
• hhh viene sostituito con hh;
• mmmm viene sostituito con mm.

Teoricamente, uno schema può contenere fino a 255 caratteri, ma alcune piattaforme presentano limiti più restrittivi. Se lo schema eccede il limite di caratteri supportato, la proprietà lastOperationStatus viene impostato sul valore LastOperationStatus.PATTERN_SYNTAX_ERROR.

Non tutti i possibili schemi sono supportati su tutti i sistemi operativi. Se un dato schema non è supportato sulla piattaforma in uso, viene utilizzato uno schema di riserva e la proprietà lastOperationStatus viene impostata in modo da indicare l'uso di uno schema di riserva. Se non è possibile fornire uno schema di riserva adeguato, viene utilizzata una stringa vuota e la proprietà lastOperationStatus viene impostata in modo da indicare che lo schema non è supportato.

Nella seguente tabella sono descritte le lettere valide per lo schema e il relativo significato.

Quando questo metodo viene chiamato e completato correttamente, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Parametri

Elementi API correlati

Imposta gli stili di data e ora per questa istanza di DateTimeFormatter. Gli stili di data e ora vengono utilizzati per impostare gli schemi di formattazione di data e ora in base agli schemi predefiniti e dipendenti dalle impostazioni internazionali del sistema operativo. Questo metodo sostituisce gli stili che sono stati impostati utilizzando la funzione di costruzione DateTimeFormatter() o il metodo setDateTimePattern(). In base agli stili impostati, viene aggiornato anche lo schema di data e ora.

Quando questo metodo viene chiamato e completato correttamente, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Parametri

Elementi API correlati

In questo esempio vengono utilizzate le seguenti impostazioni internazionali: inglese (Stati Uniti), francese (Francia), spagnolo (Spagna).

Nell'esempio vengono effettuate le seguenti operazioni per ogni contesto di impostazioni internazionali incluso nell'elenco:

1. Crea un oggetto DateTimeFormatter utilizzando lo stile predefinito (dateStyle lungo, timeStyle lungo)
2. Formatta la data e l'ora correnti utilizzando lo stile data lungo.
3. Commuta su uno stile di data con indicazione esclusivamente dell'orario utilizzando le costanti DateTimeStyle.NONE e DateTimeStyle.SHORT.
4. Formatta la data e l'ora correnti utilizzando lo stile data corto con indicazione solo dell'ora.

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

Nell'esempio vengono effettuate le seguenti operazioni per ogni contesto di impostazioni internazionali incluso nell'elenco:

1. Crea tre campi di testo di input e output.
2. Crea un oggetto DateTimeFormatter utilizzando le impostazioni internazionali per la lingua inglese americana.
3. Chiama la funzione configureTextField(), che imposta la posizione e le dimensioni dei campi di testo e aggiunge un listener di eventi all'oggetto patternField.
4. Quando l'utente immette lo schema nel campo di testo patternField, la funzione textInputHandler formatta la data e l'ora correnti utilizzando lo schema e visualizza il risultato e il valore lastOperationStatus nei campi di testo di output.

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