DateTimeFormatter  - AS3

O nome de ID de localidade real usado por este objeto de DateTimeFormatter.

Há três possibilidades para o valor de nome, dependendo do sistema operacional e do valor do parâmetro requestedLocaleIDName passado ao construtor Collator().

1. Se o idioma solicitado não for LocaleID.DEFAULT e o sistema operacional oferecer suporte para o idioma solicitado, o nome retornado será o mesmo da propriedade requestedLocaleIDName.
2. Se LocaleID.DEFAULT foi usado como o valor do parâmetro requestedLocaleIDName para o construtor, o nome do idioma atual especificado pelo sistema operacional do usuário será usado. O valor LocaleID.DEFAULT preserva a configuração personalizada do usuário no sistema operacional. Observe que a passagem de um valor explícito como o parâmetrorequestedLocaleIDName não tem necessariamente o mesmo resultado que o uso de LocaleID.DEFAULT, mesmo que os dois nomes de ID de idioma sejam iguais. O usuário poderia ter personalizado as configurações de local na máquina dele e, ao solicitar um nome de ID de local explícito em vez de usar LocaleID.DEFAULT, o aplicativo não recuperaria as configurações personalizadas.
3. Se o sistema não suporta o requestedLocaleIDName especificado no construtor, é fornecido um nome de ID de local de retrocesso.

Elementos da API relacionados

O status da operação anterior que este objeto DateTimeFormatter executou. A propriedade lastOperationStatus é configurada sempre que se invoca o construtor ou um método desta classe ou que outra propriedade é configurada. Para ver os valores possíveis, consulte a descrição de cada método.

Elementos da API relacionados

O nome do ID de local solicitado que foi passado ao construtor deste objeto de DateTimeFormatter.

Se o valor LocaleID.DEFAULT tiver sido usado, então o nome retornado será "i-default". A localidade real usada pode diferenciar-se da localidade solicitada quando uma localidade de retorno é aplicada. É possível recuperar nome do local real pode ser recuperado usando o actualLocaleIDName propriedade.

Elementos da API relacionados

Constrói um novo objeto de DateTimeFormatter para formatar datas e horas segundo as convenções do local especificado e os estilos de formatação de data e hora fornecidos. Os estilos de data e hora são usados para configurar padrões de formatação de data e hora de acordo com padrões predefinidos, dependentes do local, provenientes do sistema operacional.

Este construtor determinará se o sistema operacional atual suporta o local o nome de ID de localidade solicitado. Se não suportar, será usado um idioma de retorno. O nome do ID de localidade de retorno pode ser determinado a partir da propriedade actualLocaleIDName.

Se um retorno for usado para qualquer requestedLocaleIDName,os parâmetros dateStyle ou timeStyle e depois a propriedade lastOperationStatus serão definidos para indicar o tipo de retorno.

Para formatar de acordo com as preferências de sistema operacional atuais do usuário, passe o valor LocaleID.DEFAULT no parâmetro requestedLocaleIDName para o construtor.

Quando o construtor é invocado e conclui com sucesso, a propriedade lastOperationStatus é configurada como:

• LastOperationStatus.NO_ERROR

Quando o nome de ID de local solicitado não está disponível, lastOperationStatus é configurado como uma das alternativas a seguir:

• LastOperationStatus. USING_FALLBACK_WARNING
• LastOperationStatus. USING_DEFAULT_WARNING

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

Para ver detalhes sobre os avisos citados acima e outros valores possíveis da propriedade lastOperationStatus, consulte as descrições na classe LastOperationStatus.

Elementos da API relacionados

Formata uma string de exibição de um objeto de Data que é interpretado como se estivesse na hora local do usuário (usando os componentes de hora local do objeto de Data, tais como: data, dia, fullYear, horas, minutos, mês e segundos). A formatação será feita usando as convenções de ID de local, o estilo de data, o estilo de hora ou o padrão de data e hora personalizado especificado para essa ocorrência de DateTimeFormatter.

Quando este método é invocado e conclui com sucesso, a propriedade lastOperationStatus é configurada como:

• LastOperationStatus.NO_ERROR

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

Parâmetros

Elementos da API relacionados

Formata uma string de exibição de um objeto de Data que é interpretado como se estivesse no horário UTC (usando os componentes UTC do objeto de Data, tais como: dateUTC, dayUTC, fullYearUTC, hoursUTC, minutesUTC, monthUTC, e secondsUTC), segundo o dateStyle, timeStyle ou o padrão de hora de data. A formatação será feita usando as convenções de ID de local, o estilo de data, o estilo de hora ou o padrão de data e hora personalizado especificado para essa ocorrência de DateTimeFormatter.

Quando este método é invocado e conclui com sucesso, a propriedade lastOperationStatus é configurada como:

• LastOperationStatus.NO_ERROR

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

Parâmetros

Elementos da API relacionados

Lista todos os nomes de ID de local suportados por essa classe.

Se esta classe não for suportada no sistema operacional atual, este método retornará um valor nulo.

Quando este método é invocado e conclui com sucesso, a propriedade lastOperationStatus é configurada como:

• LastOperationStatus.NO_ERROR

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

Elementos da API relacionados

Adquire o estilo de data desta ocorrência do DateTimeFormatter. O estilo de data é usado para recuperar um padrão de formatação de data predefinido do sistema operacional. O valor de estilo de data pode ser estabelecido pelo construtor DateTimeFormatter(), o método setDateTimeStyles() ou setDateTimePattern().

Quando este método é invocado e conclui com sucesso, a propriedade lastOperationStatus é configurada como:

• LastOperationStatus.NO_ERROR

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

Elementos da API relacionados

Retorna a string padrão usada por este objeto de DateTimeFormatter para formatar datas e horas.

Este padrão pode ser estabelecido de um deste três modos:

1. Pelos parâmetros dateStyle e timeStyle usados no construtor
2. Pelo método setDateTimeStyles()
3. Pelo método setDateTimePattern().

Para uma descrição da sintaxe padrão, consulte o método setDateTimePattern().

Quando este método é invocado e conclui com sucesso, a propriedade lastOperationStatus é configurada como:

• LastOperationStatus.NO_ERROR

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

Elementos da API relacionados

Retorna um número inteiro correspondente ao primeiro dia da semana desta localidade e sistema de calendário. O valor 0 corresponde a domingo, 1 corresponde a segunda-feira, etc., com 6 correspondendo a sábado.

Quando este método é invocado e conclui com sucesso, a propriedade lastOperationStatus é configurada como:

• LastOperationStatus.NO_ERROR

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

Elementos da API relacionados

Recupera uma lista de strings localizadas que contêm os nomes de mês do sistema de calendário atual. O primeiro elemento na lista é o nome do primeiro mês do ano.

Quando este método é invocado e conclui com sucesso, a propriedade lastOperationStatus é configurada como:

• LastOperationStatus.NO_ERROR

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

Parâmetros

Elementos da API relacionados

Adquire o estilo de hora desta ocorrência do DateTimeFormatter. O estilo de hora é usado para recuperar um padrão de formatação de hora predefinido do sistema operacional. O valor de estilo de hora pode ser estabelecido pelo construtor DateTimeFormatter(), o método setDateTimeStyles()ou setDateTimePattern().

Quando este método é invocado e conclui com sucesso, a propriedade lastOperationStatus é configurada como:

• LastOperationStatus.NO_ERROR

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

Elementos da API relacionados

Recupera uma lista de strings localizadas que contêm os nomes de dias úteis do sistema de calendário atual. O primeiro elemento na lista representa o nome para o domingo.

Quando este método é invocado e conclui com sucesso, a propriedade lastOperationStatus é configurada como:

• LastOperationStatus.NO_ERROR

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

Parâmetros

Elementos da API relacionados

Configura a string de padrão usada por este objeto de DateTimeFormatter para formatar datas e horas.

O padrão usado para formatar datas pode ser estabelecido de um deste três modos:

1. Pelos parâmetros dateStyle e timeStyle usados no construtor
2. Pelo método setDateTimeStyles()
3. Por este método setDateTimePattern().

Como um efeito colateral, este método sobrescreverá a hora atual e os estilos de data deste objeto DateTimeFormatter e os definirá com o valor DateTimeStyle.COSTUM.

Uma cadeia padrão define como a data e hora são formatadas. O padrão contém sequências de letras que serão substituídas com valores de data e hora na string formatada. Por exemplo, no padrão "yyyy/MM", os caracteres "yyyy" serão substituídos por um ano de quatro dígitos, seguido pelo caractere "/", e os caracteres "MM" serão substituídos por um mês de dois dígitos.

Muitas das letras usadas em padrões podem ser repetidas mais de uma vez para produzir saídas diferentes, como descrito na tabela abaixo.

Se uma sequência exceder o número máximo de letras suportadas por um padrão, esse será mapeado novamente para a sequência mais longa suportada para essa letra padrão. Por exemplo:

• MMMMMM é substituído por MMMM
• o dddd é substituído por dd
• EEEEEEE é substituído por EEEE
• o aa é substituído por a
• o hhh é substituído por hh
• o mmmm é substituído por mm

Teoricamente, um padrão pode conter até 255 caracteres, mas algumas plataformas têm o limite mais restrito. Se o padrão exceder o limite de caracteres de padrão, a propriedade lastOperationStatus será definida como o valor LastOperationStatus.PATTERN_SYNTAX_ERROR.

Nem todos os padrões possíveis são suportados em cada sistema operacional. Se um padrão não for suportado na plataforma, um padrão de retorno será usado, e a propriedade lastOperationStatus será definida para indicar o uso de um retorno. Se nenhum padrão de retorno razoável puder ser fornecido, uma string vazia será usada, e a propriedade lastOperationStatus será definida para indicar que o padrão não foi suportado.

A seguinte tabela descreve as letras de padrão válidas e a sua significação.

Quando este método é invocado e conclui com sucesso, a propriedade lastOperationStatus é configurada como:

• LastOperationStatus.NO_ERROR

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

Parâmetros

Elementos da API relacionados

Configura os estilos de data e hora desta ocorrência do DateTimeFormatter. Os estilos de data e hora são usados para configurar padrões de formatação de data e hora de acordo com padrões predefinidos, dependentes do local, provenientes do sistema operacional. Este método substitui os estilos que foram estabelecidos usando o construtor DateTimeFormatter() ou usando o método setDateTimePattern(). O padrão de data e hora também será atualizado com base nos estilos que forem definidos.

Quando este método é invocado e conclui com sucesso, a propriedade lastOperationStatus é configurada como:

• LastOperationStatus.NO_ERROR

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

Parâmetros

Elementos da API relacionados

Este exemplo usa os seguintes idiomas: inglês (EUA), francês (França), espanhol (Espanha).

O exemplo realiza o seguinte para cada idioma na lista:

1. Um objeto DateTimeFormatter é criado usando o estilo padrão (dateStyle longo, timeStyle longo)
2. Formata a data atual e a hora usando o estilo de data longo padrão.
3. Mudança em um estilo de data curto só de hora que usa as constantes DateTimeStyle.NONE e DateTimeStyle.SHORT.
4. Formata a data e a hora atuais usando o estilo de data curto só de hora.

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

O exemplo realiza o seguinte para cada idioma na lista:

1. Cria três campos de texto de saída e entrada.
2. Cria um objeto de DateTimeFormatter que usa a idioma inglês americano.
3. Invoca a funçãoconfigureTextField(), que estabelece a posição e o tamanho dos campos de texto e adiciona um evento do ouvinte ao objeto patternField.
4. Quando o usuário insere o padrão no campo de textopatternField, a função textInputHandler formata a data e a hora atuais usando o padrão e exibe o resultado e o valor lastOperationStatus nos campos de texto de saída.

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