Formatação de valores de campo e uso de padrões

Dependendo das exigências da situação, é possível especificar um ou mais dos padrões a seguir para controlar como os valores de campos (por exemplo, campos de texto, campos numéricos e campos de data/hora) são formatados em tempo de execução:

  • Um padrão de exibição, que descreve como os dados serão exibidos no formulário. Se um valor padrão inicial for definido, ele é formatado de acordo com o padrão de exibição. O padrão de exibição também é responsável pela formatação da entrada do usuário e de qualquer valor vinculado recuperado em tempo de execução.

  • Um padrão de edição, que descreve a sintaxe para a inserção de dados em um campo de data/hora, em um campo numérico, em um campo de texto ou em um campo de senha em tempo de execução.

  • Um padrão de validação, que é usado par validar a entrada do usuário em tempo de execução.

  • Um padrão de dados, que descreve a sintaxe dos dados vinculados ou salvos.

As opções de formatação escolhidas dependerão da finalidade do formulário. Por exemplo, se um formulário interativo estiver sendo projetado, será necessário definir em cada campo um padrão de edição para processar a entrada do usuário e um padrão de validação para validar essa entrada. Um padrão de dados apenas deverá ser definido se os campos estiverem vinculados a uma fonte de dados.

Lembre-se de que se você especificar somente um padrão de edição para um objeto de campo numérico ou campos decimais, os preenchedores de formulário ainda poderão inserir caracteres alfabéticos no campo. Para evitar esse comportamento, realize uma destas ações:

  • Não especifique apenas um Padrão de edição. Certifique-se de que o Acrobat e o Adobe Reader filtrem caracteres alfabéticos indesejados.

  • Especifique os padrões de edição e exibição. Certifique-se de que os dados sejam formatados corretamente de acordo com o padrão de exibição.

  • Especifique os padrões de edição e validação. Certifique-se que o valor seja rejeitado e que o campo seja apagado quando um preenchedor de formulário inserir um caractere alfabético.

    Quando usar padrões

    Use padrões para controlar como os valores de campos são processados em tempo de execução. Por exemplo, os usuários podem digitar letras e números em um campo de texto, e qualquer sinal de pontuação ou espaçamento especial pode ser aplicado automaticamente de acordo com um padrão predefinido antes que o valor seja exibido.

    Como capturar e exibir a entrada do usuário

    Se você estiver criando um formulário para capturar dados, será possível especificar como os dados devem ser formatados. Especifique como os dados devem ser exibidos usando um padrão de exibição. Se um padrão de exibição não for especificado, os dados aparecerão de acordo com os padrões do Designer.

    Especifique um padrão de edição se os usuários forem digitar dados que não correspondem aos padrões do Designer. O padrão de edição descreve a sintaxe da entrada do usuário. Quando o padrão é estabelecido, o aplicativo de tempo de execução converte a entrada do usuário em um valor bruto e, em seguida, formata esse valor de acordo com o padrão de exibição.

    Ao projetar um formulário interativo, considere qual entrada do usuário deve ser validada. Por exemplo, um campo de texto pode exigir ou não validação, dependendo do seu uso. Um campo de texto de várias linhas que permite ao usuário do formulário a inserção de um comentário não necessita de validação. De modo semelhante, um campo numérico impedirá automaticamente que o usuário do formulário insira quaisquer dados não numéricos. No entanto, se os dados devem ser restritos a um intervalo de números específico, convém validar a entrada do usuário. É possível optar por exibir uma mensagem personalizada para solicitar aos usuários um valor correto em tempo de execução. Se nenhuma mensagem personalizada for especificada, o sistema gerará uma automaticamente.

    Lembre-se de que, usando as opções da guia Validações de formulário na caixa de diálogo Propriedades do formulário, você pode configurar como o Acrobat exibe as mensagens de validações, realça campos falhos ou obrigatórios que contenham dados inválidos ou nenhum dado, e configurar o foco no primeiro campo que falhar na validação. Consulte Exibir erros de validação no Acrobat.

    Nota: A entrada do usuário pode ser processada por meio de fórmulas FormCalc e scripts JavaScript (por exemplo, um script pode solicitar o valor bruto de um campo). Como fórmulas e scripts operam em valores brutos e formatados, é importante validar esses campos onde a entrada é restrita.

    Um exemplo de como padrões de edição e validação podem ser usados juntamente é uma entrada de cartão de crédito ou de número da Previdência Social. É possível definir um campo de texto com os seguintes padrões de edição:

    text{9999-9999-9999-9999}|text{9999 9999 9999 9999} for credit cards

    ou

    text{999-99-9999}|text{999 99 9999} for a US social security number

    Em ambos os casos, o usuário pode inserir o número com hífen (-), espaço ( ) ou somente os números de 16 ou 9 dígitos. A forma canônica ou mais simples do número é o número de 16 ou 9 dígitos.

    É possível também escolher a adição do seguinte padrão de validação:

    text{9999999999999999}

    ou

    text{999999999}

    Nesse caso, somente o número é armazenado e a validação verifica pelo número correto de dígitos. No entanto, nesse caso, talvez seja mais útil especificar um script de validação em vez de um padrão. Existem algoritmos que calculam a soma de verificação de um número de cartão de crédito para garantir que seja um número de cartão de crédito válido e não somente um número de 16 dígitos aleatório. Um exemplo é o Luhn Algorith para cartões de crédito.

    O resultado é um formulário com um campo de texto onde o padrão de edição permite a entrada do usuário em uma das maneiras típicas para a digitação de um número de cartão de crédito e a validação executa um script que valida o número como sendo um número de cartão de crédito válido.

    Como recuperar e exibir dados vinculados

    Se dados vinculados forem ser unidos a um formulário, será possível especificar como esses dados devem ser formatados para exibição usando um padrão de exibição. Quando não é especificado um padrão de exibição, os dados são exibidos de acordo com os padrões do Designer.

    Especifique um padrão de dados se os dados vinculados não correspondem aos padrões do Designer. O padrão de dados descreve a sintaxe desses dados vinculados. Quando o padrão é especificado, o aplicativo de tempo de execução converte os dados recuperados em valores brutos que, em seguida, são formatados para exibição.

    Padrões para formatação de valores

    Os valores padrão devem estar de acordo com as regras a seguir, dependendo do tipo de campo.

    Campo

    Regra

    Campo de data/hora

    Um valor padrão de data/hora deve estar de acordo com o formato abreviado para a localidade especificada para o campo data/hora. No entanto, por padrão, o Designer exibe o valor padrão no formato médio de localidade durante a elaboração do projeto e no tempo de execução.

    Por exemplo, considere um formulário com um Campo de data/hora definido para usar a localidade Alemão (Alemanha). Você insere o valor padrão para a data no formato abreviado DD.MM.AA. Depois de alterar o foco para outro campo, o valor especificado no campo da página é exibido no formato médio DD.MM.AAAA. O valor formatado também aparecerá no formato médio se você exibir o formulário na guia Visualizar PDF.

    Nota: Por padrão, durante a execução os usuários devem editar o valor dos campos de data/hora usando o formato abreviado para a localidade especificada para o campo. Quando é especificado um Padrão de edição na guia Editar da caixa de diálogo Padrões (guia Campo > Padrões), esse padrão substitui o formato abreviado e os usuários devem inserir dados que estejam de acordo com o Padrão de edição.

    Campo numérico ou Campo decimal

    Um valor numérico padrão pode ser um número inteiro ou um número decimal contendo um único ponto de radix. O caractere de radix pode ser um “.” (ponto) ou “,” (vírgula) dependendo da localidade selecionada. Separadores de milhares (ou símbolos de agrupamento) e símbolos de moedas não são válidos como parte do valor padrão.

    Por exemplo, se um campo numérico estiver configurado para a localidade Inglês (EUA) e você especificar o valor padrão $1,234.56, nem o símbolo de moeda “$” (cifrão) nem o separador de milhar “,” (vírgula) serão válidos.

    Campo de texto

    Um valor de texto padrão (incluindo senhas) pode ser qualquer string de texto alfanumérico, incluindo espaços.
    Nota: Somente os campos listados na tabela têm valores padrão que devem estar de acordo com a formatação específica da localidade.

    Especificar um valor padrão

    Campos de data/hora, campos numéricos e campos de texto podem exibir um valor inicial (padrão) quando o formulário é aberto. Esse valor pode ser derivado de uma propriedade de tempo de execução ou ser explicitamente especificado no Designer. Ele também pode ser derivado de uma fonte externa de dados por meio de um vínculo. No tempo de execução, o Designer formata os valores padrão dos campos de acordo com a localidade especificada para cada campo.

    1. Selecione um campo de data/hora, um campo decimal, um campo numérico ou um campo de texto.

    2. Na paleta Objeto, clique na guia Campo. Selecione uma localidade na lista Local.

    3. Na paleta Objeto, clique na guia Valor. Digite o valor na caixa Padrão.

      O valor padrão deve ser especificado em um formato que considere a localidade.

      Nota: Se os dados estiverem vinculados e um padrão de dados tiver sido especificado, o valor deverá corresponder ao padrão de dados especificado na guia Vínculo.

    Especificação de um padrão de exibição

    No tempo de execução, o Designer exibe valores de campos numéricos, de data e de hora em um formato que leva em consideração a localidade. Para exibir um valor de campo em um formato diferente do padrão, é possível especificar o padrão personalizado clicando no botão Padrões da guia Campo.

    Nota: Listas suspensas oferecem suporte para entradas personalizadas do usuário, mas não é possível especificar um padrão de exibição para essas entradas. Se necessário, um script pode ser gravado para formatar a entrada do usuário.

    Como o padrão de exibição descreve como os dados serão exibidos no formulário, todos os valores padrões, todos valores digitados pelo usuário e todos os valores recuperados de um banco de dados são convertidos no formato descrito por esse padrão de exibição.

    Nota: Datas anteriores a 1° de janeiro de 1900 não são formatadas pelo padrão de exibição.

    1. Selecione o campo de data/hora, o campo numérico ou o campo de texto.

    2. Na paleta Objeto, clique na guia Campo.

    3. Clique em Padrões e selecione um dos padrões de exibição predefinidos na lista Selecionar tipo ou digite um padrão personalizado na caixa Padrão.

    Solicitar que os usuários digitem dados

    Prompts são úteis para situações em que os usuários devem digitar dados ou fazer uma seleção. É possível escrever uma mensagem para solicitar que os usuários digitem um valor em um campo de data/hora, em um campo numérico, em um campo de texto, em um campo de senha ou em uma lista suspensa ou ainda para solicitar que esses usuários selecionem uma opção em uma lista suspensa, em uma caixa de listagem ou em um grupo de botões de opção.

    Como recomendar que os usuários digitem os dados

    Você pode recomendar que os usuários digitem dados em um campo, mas permita que eles enviem o formulário mesmo que não digitem os dados. Se um usuário digitar os dados no campo, sair do campo e o limpar, uma caixa de mensagem será exibida. Uma mensagem personalizada aparece se foi escrita na caixa Mensagem vazia. Uma mensagem de campo vazio padrão aparece, se você não digitar uma mensagem personalizada. Uma mensagem é exibida somente se havia dados no campo, o dado foi excluído e o usuário saiu do campo sem inserir um dado novamente. Se o usuário nunca tiver tentado inserir um dado no campo e tentar enviar o formulário, uma mensagem de que o campo é obrigatório será exibida. O usuário pode optar por ignorar a mensagem e enviar o formulário. Escolha Digitado pelo usuário – recomendado para sugerir que os usuários digitem dados em um campo.

    Como solicitar que os usuários digitem os dados

    Você pode tornar obrigatório que os usuários digitem dados em um campo, antes que possam enviar um formulário. Se um usuário digita os dados no campo, usa a tabulação e depois retorna para limpá-lo, uma caixa de mensagem aparece. Uma mensagem personalizada aparece se foi escrita na caixa Mensagem vazia. Uma mensagem de campo vazio padrão aparece, se você não digitar uma mensagem personalizada. Uma mensagem é exibida somente se havia dados no campo, o dado foi excluído e o usuário saiu do campo sem inserir um dado novamente. Se o usuário nunca tiver tentado inserir um dado no campo e tentar enviar o formulário, uma mensagem de que o campo é obrigatório será exibida. Escolha Digitado pelo usuário – necessário para tornar obrigatório que os usuários digitem dados em um campo.

    Lembre-se de que, usando as opções da guia Validações de formulário na caixa de diálogo Propriedades do formulário, você pode configurar como o Acrobat exibe as mensagens de validações, realça campos falhos ou obrigatórios que contenham dados inválidos ou nenhum dado, e configurar o foco no primeiro campo que falhar na validação. Consulte Exibir erros de validação no Acrobat.

    Nota: Se os usuários não inserirem um valor no campo e tentarem enviar o formulário, a mensagem de erro campo obrigatório aparecerá. Entretanto, podem salvar e fechar um formulário PDF sem fornecer valores recomendados ou obrigatórios. Nesse caso, nenhuma mensagem é exibida para solicitar a entrada do usuário.

    1. Selecione o campo, a lista suspensa, a caixa de listagem ou o grupo de botões de opção.

    2. Na paleta Objeto, clique na guia Valor. Na lista Tipo, selecione uma destas opções:

      • Digitado pelo usuário - recomendado

      • Digitado pelo usuário - obrigatório

    3. Na caixa Mensagem vazia, digite o prompt. Se aplicável, o prompt deverá especificar o formato de entrada obrigatório. Por exemplo, se você tiver definido um padrão de edição, a entrada do usuário deverá corresponder a esse padrão.

    Especificação de um padrão de edição

    No tempo de execução, o Designer exibe valores de campos numéricos, decimais, de data e de hora em um formato que leva em consideração a localidade. Para que os usuários possam editar valores de campo em um formato diferente do padrão que considera a localidade, especifique o Padrão de edição na guia Campo. Se a entrada do usuário não estiver em conformidade com o padrão de edição, esses dados serão registrados como foram inseridos.

    Se você especificar somente um padrão de edição para um objeto de campo numérico ou campos decimais, os preenchedores de formulário ainda poderão inserir caracteres alfabéticos no campo.

    O padrão de edição pode ser diferente do padrão de exibição. Por exemplo, como é mais fácil para os usuários inserirem datas curtas e lerem datas longas, considere a especificação de uma data curta para um padrão de edição de data/hora e uma data longa como padrão de exibição. Quando os padrões de exibição e de edição são diferentes, o valor é formatado de modo a corresponder ao padrão de exibição assim que o usuário sai do campo.

    Nota: Essa opção não está disponível quando a opção Tipo na guia Valor da paleta Objeto estiver definida como Protegido, Calculado – somente leitura ou Somente leitura.

    1. Selecione o campo de data/hora, o campo numérico, o campo de texto ou o campo de senha.

    2. Na paleta Objeto, clique na guia Campo.

    3. Clique em Padrões, clique na guia Editar e selecione um dos padrões de exibição predefinidos na lista Selecionar tipo ou digite um padrão personalizado na caixa Padrão.

    Validação da entrada do usuário

    Existem três validações possíveis para qualquer campo. A ordem de início dessas validações é a seguinte:

    • Teste o campo para verificar um conteúdo nulo.

    • Verifique o formato do valor do campo com base em um padrão de campo específico. Para obter mais informações sobre padrões de campo, consulte Padrões simples.

    • Chame um script de validação.

    É possível definir um padrão de validação para validar a entrada do usuário para campos de data/hora, campos numéricos, campos de texto e campos de senha. Por padrão, entradas nulas não são aceitas quando um valor é obrigatório. Valores brutos são comparados diretamente ao padrão de validação e, se o valor bruto corresponde ao padrão de validação, ele será formatado para exibição.

    Se o valor digitado pelo usuário não corresponder ao padrão de validação, um erro de programação ou um aviso será exibido. O erro/aviso é capturado pelo Acrobat, Adobe Reader ou Forms, que retorna uma mensagem ao usuário automaticamente. Se um padrão de edição não tiver sido especificado, e a entrada do usuário não corresponder aos padrões do Designer, ocorrerá falha na validação.

    Uma mensagem de validação será exibida se os objetos que exigem valores contiverem valores nulos e o usuário tentar enviar dados para o Forms.

    Nota: Os usuários podem salvar e fechar um formulário PDF sem fornecer os valores obrigatórios. Nesse caso, nenhuma validação é executada.

    Se necessário, é possível escrever uma mensagem de padrão de validação personalizada para substituir a mensagem padrão de erro ou aviso.

    Além de um padrão de validação, ou em casos nos quais um padrão de validação não é suportado (por exemplo, para grupos de botões de opção e caixas de seleção), é possível validar a entrada do usuário usando um script de validação. Validar entradas por meio de um script garante que os dados sejam aceitos no aplicativo. Uma mensagem personalizada e um erro ou aviso de tempo de execução também são suportados nesse caso.

    Lembre-se de que, usando as opções da guia Validações de formulário na caixa de diálogo Propriedades do formulário, você pode configurar como o Acrobat exibe as mensagens de validações, realça campos falhos ou obrigatórios que contenham dados inválidos ou nenhum dado, e configurar o foco no primeiro campo que falhar na validação. (Consulte Exibir erros de validação no Acrobat.)

    É possível preencher uma mensagem de padrão de validação dinamicamente com um valor de uma fonte de dados. Essa opção permite verificar se os usuários inseriram um valor válido no campo.

    Para definir um padrão de validação e uma mensagem personalizada

    1. Selecione o campo de data/hora, o campo numérico, o campo de texto, o campo de senha, a lista suspensa ou a caixa de listagem.

    2. Na paleta Objeto, clique na guia Valor.

    3. Clique em Padrão de validação e selecione um dos padrões de validação predefinidos na lista Selecionar tipo ou digite um padrão personalizado na caixa Padrão.

    4. Na caixa Mensagem de padrão de validação, digite a mensagem para solicitar que os usuários digitem o valor correto. A mensagem deve especificar o formato de entrada obrigatório. Para iniciar uma nova linha na mensagem, pressione Ctrl+Enter.

    5. Para que um erro de programação apareça no lugar de um aviso, selecione a opção Erro.

    Para exibir uma mensagem quando um script anexado detecta uma entrada não aceita

    1. Selecione o campo de data/hora, o campo numérico, o campo de texto, o campo de senha, a lista suspensa, a caixa de listagem, a caixa de seleção ou o grupo de botões de opção.

    2. Na paleta Objeto, clique na guia Valor. Na caixa Mensagem de script de validação, digite a mensagem.

    3. Para que um erro de programação apareça no lugar de um aviso, selecione a opção Erro.

    Especificação de um padrão de dados

    Opções de vínculo de dados permitem criar um formulário que capture dados para infraestruturas empresariais e/ou usar uma fonte externa de dados para preencher um formulário em tempo de execução. Por exemplo, dadas as informações apropriadas de vínculo (consulte Vínculo de campos a uma fonte de dados) e acesso à fonte de dados (consulte Trabalhar com fontes de dados), o Acrobat e o Adobe Reader podem importar e exibir dados de um banco de dados OLEDB no momento em que o formulário é aberto. Os objetos também podem ser vinculados a um esquema XML, a um arquivo XML ou uma fonte de dados WSDL.

    O Acrobat, Adobe Reader e Forms interpretam as propriedades de vínculo de dados para armazenar dados capturados e analisar dados recuperados. Por padrão, os dados de um objeto são armazenados e mesclados de acordo com as regras de mesclagem de dados da Adobe. Quando um formulário é aberto no Acrobat ou no Adobe Reader, ou é renderizado pelo Forms, os valores de campo são preenchidos a partir da fonte de dados. Qualquer alteração no valor de um campo feita pelo usuário é enviada à fonte de dados associada quando o formulário é salvo no Acrobat ou Adobe Reader, ou quando os dados são enviados para o Forms.

    Se os dados não estiverem vinculados a uma fonte de dados (por exemplo, se os dados de formulário forem ser retornados por email), o padrão de dados especificará o formato de gravação desses dados. Se um padrão de dados não for criado, a gravação será feita em formato canônico. Caso um formulário possa ser preenchido pelos usuários finais em várias localidades ou os dados possam ser retornados para mais de uma localidade, o formato canônico ajudará a garantir que esses dados sejam interpretados da mesma maneira por todos os usuários.

    É possível especificar padrões de dados para campos de data/hora, campos numéricos, campos de texto e campos de senha. Se o padrão de dados impedir que o Acrobat, Adobe Reader ou Forms analise um valor recuperado, esse valor aparecerá inalterado no formulário (não é formatado para exibição).

    1. Selecione o campo de data/hora, o campo numérico, o campo de texto ou o campo de senha.

    2. Na paleta Objeto, clique na guia Campo.

    3. Clique em Padrões, clique na guia Dados e selecione um dos padrões de vínculo de dados predefinidos na lista Selecionar tipo ou digite um padrão personalizado na caixa Padrão.

    Padrões simples

    Padrões simples podem ser usados para formatar os valores de campos de data/hora, campos numéricos, campos de texto e campos de senha. Cada um deles possui as suas próprias regras que determinam a formatação válida de padrões. Existe um conjunto limitado de caracteres que pode ser usado em um padrão, e a sintaxe de um padrão válido é diferente entre campos de data/hora, campos numéricos, campos de texto e campos de senha.

    Para obter informações sobre caracteres válidos que podem ser usados em um padrão e exemplos de construções válidas, consulte uma das seções listadas a seguir. Para informações sobre padrões complexos de campo de data/hora, campo numérico ou campo de texto, consulte Padrões de campos complexos.

    Localidades

    Uma localidade é um termo padrão usado ao desenvolver padrões internacionais para identificar uma nação específica (idioma, país ou região). Para fins de FormCalc, um local define o formato de datas, horas, números e valores monetários relevante para uma nação ou região específica para que os usuários possam usar os formatos com os quais estão acostumados.

    Cada localidade é formada por uma string exclusiva de caracteres, chamada de identificador de localidade. A composição dessas strings é controlada pela ISO (International Standards Organization) IETF (Internet Engineering Task Force), um grupo de trabalho da Internet Society (www.isoc.org).

    Os identificadores de localidade consistem em uma parte de idioma, uma parte de país ou região ou ambos. A tabela a seguir lista as localidades válidas para esta versão do Designer.

    Linguagem

    País ou região

    Código ISO

    Arábico

    Algéria

    ar_DZ

    Arábico

    Bahrain

    ar_BH

    Arábico

    Egito

    ar_EG

    Arábico

    Iraque

    ar_IQ

    Arábico

    Jordânia

    ar_JO

    Arábico

    Kuwait

    ar_KW

    Arábico

    Líbano

    ar_LB

    Arábico

    Líbia

    ar_LY

    Arábico

    Marrocos

    ar_MA

    Arábico

    Oman

    ar_OM

    Arábico

    Qatar

    ar_QA

    Arábico

    Arábia Saudita

    ar_SA

    Arábico

    Sudão

    ar_SD

    Arábico

    Síria

    ar_SY

    Arábico

    Tunísia

    ar_TN

    Arábico

    Emirados Árabes Unidos

    ar_AE

    Arábico

    Iêmen

    ar_YE

    Armênio

    Armênia

    hy_AM

    Azerbaijano – Cirílico

    Azerbaijão

    az_Cyrl_AZ

    Azerbaijano – Latim

    Azerbaijão

    az_Latn_AZ

    Basco

    Espanha

    eu_ES

    Bósnio

    Bósnia e Herzegovina

    bs_BA

    Búlgaro

    Bulgária

    bg_BG

    Catalão

    Espanha

    ca_ES

    Chinês

    República Popular da China (simplificado)

    zh_CN

    Chinês

    Hong Kong (RAE), China

    zh_HK

    Chinês

    Taiwan (tradicional)

    zh_TW

    Croata

    Croácia

    hr_HR

    Tcheco

    República Tcheca

    cs_CZ

    Dinamarquês

    Dinamarca

    da_DK

    Holandês

    Bélgica

    nl_BE

    Holandês

    Holanda

    nl_NL

    Inglês

    Austrália

    en_AU

    Inglês

    Bélgica

    en_BE

    Inglês

    Canadá

    en_CA

    Inglês

    Hong Kong (RAE), China

    en_HK

    Inglês

    Índia

    en_IN

    Inglês

    Índia Rupia

    en_IN_RUPEE

    Inglês

    Irlanda

    en_IE

    Inglês

    Nova Zelândia

    en_NZ

    Inglês

    Filipinas

    en_PH

    Inglês

    Cingapura

    en_SG

    Inglês

    África do Sul

    en_ZA

    Inglês

    Reino Unido

    en_GB

    Inglês

    Reino Unido (Europa)

    en_GB_EURO

    Inglês

    Estados Unidos da América

    en_US

    Inglês

    Ilhas Virgens Norte-Americanas

    en_VI

    Estônio

    Estônia

    et_EE

    Finlandês

    Finlândia

    fi_FI

    Francês

    Bélgica

    fr_BE

    Francês

    Canadá

    fr_CA

    Francês

    França

    fr_FR

    Francês

    Luxemburgo

    fr_LU

    Francês

    Suíça

    fr_CH

    Alemão

    Áustria

    de_AT

    Alemão

    Alemanha

    de_DE

    Alemão

    Luxemburgo

    de_LU

    Alemão

    Suíça

    de_CH

    Grego

    Grécia

    el_GR

    Hebraico

    Israel

    he_IL

    Húngaro

    Hungria

    hu_HU

    Indonês

    Indonésia

    id_ID

    Italiano

    Itália

    it_IT

    Italiano

    Suíça

    it_CH

    Japonês

    Japão

    ja_JP

    Cazaque

    Cazaquistão

    kk_KZ

    Khmer

    Camboja

    km_KH

    Coreano

    Coreia

    ko_KR

    Coreano

    Coreia (Hanja)

    ko_KR_HANI

    Lao

    Laos

    lo_LA

    Letão

    Letônia

    lv_LV

    Lituano

    Lituânia

    lt_LT

    Malaio

    Malásia

    ms_MY

    Norueguês (Bokmal)

    Noruega

    nb_NO

    Norueguês (Nynorsk)

    Noruega

    nn_NO

    Persa

    Irã

    fa_IR

    Polaco

    Polônia

    pl_PL

    Português

    Brasil

    pt_BR

    Português

    Portugal

    pt_PT

    Romeno

    Romênia

    ro_RO

    Russo

    Rússia

    ru_RU

    Sérvio – Cirílico

    Sérvia e Montenegro

    sr_Cyrl_CS

    Sérvio - Latim

    Sérvia e Montenegro

    sr_Latn_CS

    Eslovaco

    Eslováquia

    sk_SK

    Esloveno

    Eslovênia

    sl_SI

    Espanhol

    Argentina

    es_AR

    Espanhol

    Bolívia

    es_BO

    Espanhol

    Chile

    es_CL

    Espanhol

    Colômbia

    es_CO

    Espanhol

    Costa Rica

    es_CR

    Espanhol

    República Dominicana

    es_DO

    Espanhol

    Equador

    es_EC

    Espanhol

    El Salvador

    es_SV

    Espanhol

    Guatemala

    es_GT

    Espanhol

    Honduras

    es_HN

    Espanhol

    México

    es_MX

    Espanhol

    Nicarágua

    es_NI

    Espanhol

    Panamá

    es_PA

    Espanhol

    Paraguai

    es_PY

    Espanhol

    Peru

    es_PE

    Espanhol

    Porto Rico

    es_PR

    Espanhol

    Espanha

    es_ES

    Espanhol

    Estados Unidos da América

    es_US

    Espanhol

    Uruguai

    es_UY

    Espanhol

    Venezuela

    es_VE

    Sueco

    Suécia

    sv_SE

    Tagalo

    Filipinas

    tl_PH

    Tailandês

    Tailândia

    th_TH

    Tailandês

    Tailândia (Tradicional)

    th_TH_TH

    Turco

    Turquia

    tr_TR

    Ucraniano

    Ucrânia

    uk_UA

    Vietnamita

    Vietnã

    vi_VN

    Geralmente, os dois elementos do local são importantes. Por exemplo, os nomes dos dias da semana e dos meses em inglês do Canadá e do Reino Unido têm formatos idênticos, mas as datas têm formatos diferentes. Portanto, não basta especificar a localidade do idioma inglês. Além disso, não basta especificar apenas um país como a localidade. Por exemplo, o Canadá possui diferentes formatos de data para os idiomas inglês e francês. Para obter informações sobre como definir o local no Designer, consulte Especificação de uma localidade (idioma e país ou região) para um objeto.

    Em geral, cada aplicativo opera em um ambiente em que uma localidade está presente. Essa localidade é conhecida como localidade de ambiente. Em alguns casos, um aplicativo pode operar em um sistema, ou em um ambiente, no qual uma localidade não está presente. Nesses casos raros, a localidade de ambiente é definida para o padrão Inglês dos Estados Unidos (en_US). Essa localidade é conhecida como localidade padrão.

    Época

    Os valores de data e de hora possuem uma origem ou época associada, que é o momento a partir do qual os eventos começam. Qualquer valor de data e de hora anterior a essa época é inválido.

    A unidade de valor para todas as funções de data é o número de dias desde a época. A unidade de valor para todas as funções de hora é o número de milissegundos desde a época.

    O Designer define o dia 1 para o período referente a todas as funções de data como 1 de janeiro de 1900 e o milissegundo 1 para o período referente a todas as funções de hora como meia-noite, 00:00:00 (GMT). Essa definição significa que valores de hora negativos podem ser retornados aos usuários em fusos horários ao leste do GMT.

    Formatos de data

    Um formato de data é uma especificação simplificada de como uma data é exibida. Ele consiste em vários sinais de pontuação e símbolos que representam a formatação que a data deve usar. A tabela a seguir lista exemplos de formatos de data.

    Formato de data

    Exemplo

    MM/DD/YY

    11/11/78

    DD/MM/YY

    25/07/85

    MMMM DD, YYYY

    10.03.64

    O formato de data é estabelecido pelo padrão ISO. Cada país ou região especifica seus próprios formatos de data. As quatro categorias gerais de formatos de data são: abreviado, médio, longo e completo. A tabela a seguir contém alguns exemplos dos diferentes formatos de data de diferentes locais para cada uma das categorias.

    Identificador de localidade e descrição

    Formato de data (Categoria)

    Exemplo

    en_GB

    Inglês (Reino Unido)

    MM/DD/YY (Abreviado)

    08/12/92

    08/04/05

    fr_CA

    Francês (Canadá)

    YY-MM-DD (Médio)

    92-08-18

    de_DE

    Alemão (Alemanha)

    D. MMMM YYYY (Longo)

    17. Jun 1989

    fr_FR

    Francês (França)

    EEEE, ' le ' D MMMM YYYY (Completo)

    Lundi, le 29 Octobre, 1990

    Formatos de hora

    Um formato de hora é uma especificação simplificada de como formatar uma hora. Ele consiste em pontuações, letras e símbolos de padrões. A tabela a seguir lista exemplos de formatos de hora.

    Formato de hora

    Exemplo

    h:MM A

    7:15 PM

    HH:MM:SS

    21:35:26

    HH:MM:SS 'o''clock' A Z

    14:20:10 o'clock PM EDT

    Formatos de hora são estabelecidos pelo padrão ISO. Cada nação especifica seu formato de hora padrão, abreviado, médio, longo e completo. A localidade identifica o formato das horas em conformidade com os padrões de uma nação específica.

    A tabela a seguir contém alguns exemplos dos diferentes formatos de data de diferentes locais para cada uma das categorias.

    Identificador de localidade e descrição

    Formato de hora (Categoria)

    Exemplo

    en_GB

    Inglês (Reino Unido)

    HH:MM (Abreviado)

    14:13

    fr_CA

    Francês (Canadá)

    HH:MM:SS (Médio)

    12:15:50

    de_DE

    Alemão (Alemanha)

    HH:MM:SS z (Longo)

    14:13:13 -0400

    fr_FR

    Francês (França)

    HH ' h ' MM Z (Completo)

    14 h 13 GMT-04:00

    Padrões de data e hora

    Os símbolos a seguir devem ser usados para criar padrões de data e de hora para os campos de data/hora. Alguns símbolos de dados apenas são usados em localidades referentes aos idiomas chinês, japonês e coreano. Esses símbolos também estão especificados a seguir. Para obter mais informações, consulte Exemplos de padrões de data/hora.

    Nota: A vírgula (,), o hífen (-), os dois pontos (:), a barra (/), o ponto final (.) e o espaço ( ) são tratados como valores literais e podem ser incluídos em qualquer local de um padrão. Para incluir uma expressão em um padrão, delimite a string de texto com aspas simples ('). Por exemplo, 'Seu pagamento deverá ser feito até' MM-DD-YY pode ser especificado como o padrão de exibição.

    Símbolo de data

    Descrição

    Valor formatado para a localidade Inglês (EUA), em que o valor de entrada que considera a localidade é 1/1/08 (ou seja, 1º de janeiro de 2008)

    D

    Dia do mês com 1 ou 2 dígitos (de 1 a 31)

    1

    DD

    Dia do mês com 2 dígitos e 0 incluído (de 01 a 31)

    01

    J

    Dia do ano com 1, 2 ou 3 dígitos (de 1 a 366)

    1

    JJJ

    Dia do ano com 3 dígitos e 0 incluído (de 001 a 366)

    001

    M

    Mês do ano com 1 ou 2 dígitos (de 1 a 12)

    1

    MM

    Mês do ano com 2 dígitos e 0 incluído (de 01 a 12)

    01

    MMM

    Nome de mês abreviado

    Jan

    MMMM

    Nome do mês completo

    Janeiro

    E

    Dia da semana com 1 dígito (de 1 a 7), em que (1=Domingo)

    3 (porque 1º de janeiro de 2008 é uma terça-feira)

    EEE

    Nome do dia da semana abreviado

    Ter (porque 1º de janeiro de 2008 é uma terça-feira)

    EEEE

    Nome do dia da semana completo

    Terça-feira (porque 1º de janeiro de 2008 é uma terça-feira)

    YY

    Ano com 2 dígitos, em que os números menores que 30 são considerados para inclusão após o ano 2000 e os números a partir de 30 são considerados para inclusão antes de 2000. Por exemplo, 00=2000, 29=2029, 30=1930 e 99=1999

    08

    YYYY

    Ano com 4 dígitos

    2008

    G

    Nome da era (AC ou DC)

    DC

    w

    Semana do mês com 1 dígito (de 0 a 5), em que a semana 1 corresponde ao primeiro conjunto de quatro dias consecutivos terminando em um sábado

    1

    WW

    Semana do ano com 2 dígitos (de 01 a 53) ISO-8601, em que a semana 1 é a semana que contém o dia 4 de janeiro

    01

    Estão disponíveis vários padrões de data adicionais que podem ser especificados para localidades nos idiomas chinês, japonês e coreano.

    Eras japonesas podem ser representadas por vários símbolos diferentes. Os quatro símbolos finais de era fornecem símbolos alternativos para representar eras japonesas.

    Símbolo de data CJK

    Descrição

    DDD

    O dia do mês da localidade, com cálculos numéricos simbólicos

    DDDD

    O dia do mês da localidade, com cálculos numéricos simbólicos de acordo com a regra de dígitos 10

    YYY

    O ano da localidade, com cálculos numéricos simbólicos

    YYYYY

    O ano da localidade, com cálculos numéricos simbólicos de acordo com a regra de dígitos 10

    g

    O nome alternativo da era para a localidade. No caso da era japonesa atual (Heisei), esse padrão exibe a letra H no formato ASCII (U+48).

    gg

    O nome alternativo da era para a localidade. No caso da era japonesa atual, esse padrão exibe o ideograma que é representado pelo símbolo Unicode (U+5E73).

    ggg

    O nome alternativo da era para a localidade. No caso da era japonesa atual, esse padrão exibe os ideogramas que são representados pelos símbolos Unicode (U+5E73 U+6210).

    g

    O nome alternativo da era para a localidade. No caso da era japonesa atual, esse padrão exibe a letra H de largura total (U+FF28)

    g g

    O nome alternativo da era para a localidade. No caso da era japonesa atual, esse padrão exibe o ideograma que é representado pelo símbolo Unicode (U+337B).

    Símbolo de hora

    Descrição

    Valor de entrada que considera a localidade

    Valor formatado para a localidade Inglês (EUA)

    h

    Hora do dia com 1 ou 2 dígitos (de 1 a 12) (AM/PM)

    12:08 AM ou 2:08 PM

    12 ou 2

    hh

    Hora do dia com 2 dígitos e 0 incluído (de 01 a 12) (AM/PM)

    12:08 AM ou 2:08 PM

    12 or 02

    k

    Hora do dia com 1 ou 2 dígitos (de 0 a 11) (AM/PM)

    12:08 AM ou 2:08 PM

    0 ou 2

    kk

    Hora do dia com 2 dígitos (de 00 a 11) (AM/PM)

    12:08 AM ou 2:08 PM

    00 or 02

    H

    Hora do dia com 1 ou 2 dígitos (de 0 a 23)

    12:08 AM ou 2:08 PM

    0 ou 14

    HH

    Hora do dia com 2 dígitos e 0 incluído (de 00 a 23)

    12:08 AM ou 2:08 PM

    00 or 14

    K

    Hora do dia com 1 ou 2 dígitos (de 0 a 24)

    12:08 AM ou 2:08 PM

    24 ou 14

    KK

    Hora do dia com 2 dígitos e 0 incluído (de 01 a 24)

    12:08 AM ou 2:08 PM

    24 ou 14

    M

    Minuto da hora com 1 ou 2 dígitos (de 0 a 59)

    Nota: Use este símbolo com um símbolo de hora.

    2:08 PM

    8

    MM

    Minuto da hora com 2 dígitos e 0 incluído (de 00 a 59)

    Nota: Use este símbolo com um símbolo de hora.

    2:08 PM

    08

    S

    Segundo do minuto com 1 ou 2 dígitos (de 0 a 59)

    Nota: Use este símbolo com um símbolo de hora e minuto.

    2:08:09 PM

    9

    SS

    Segundo do minuto com 2 dígitos e 0 incluído (de 00 a 59)

    Nota: Use este símbolo com um símbolo de hora e minuto.

    2:08:09 PM

    09

    FFF

    Centésimo de segundo com 3 dígitos (de 000 a 999)

    Nota: Use este símbolo com um símbolo de hora, minuto e segundo.

    2:08:09 PM

    09

    A

    A parte do dia que vai da meia-noite ao meio-dia (AM) ou do meio-dia à meia-noite (PM)

    2:08:09 PM

    PM

    z

    Formato de fuso horário ISO-8601 (por exemplo, Z, +0500, -0030, -01, +0100)

    Nota: Use este símbolo com um símbolo de hora.

    2:08:09 PM

    -0400

    zz

    Formato alternativo de fuso horário ISO-8601 (por exemplo, Z, +05:00, -00:30, -01, 01:00)

    Nota: Use este símbolo com um símbolo de hora.

    2:08:09 PM

    -04:00

    Z

    Nome abreviado do fuso horário (por exemplo, GMT, GMT+05:00, GMT-00:30, EST, PDT)

    Nota: Use este símbolo com um símbolo de hora.

    2:08:09 PM

    EDT

    Símbolos reservados

    Os seguintes símbolos apresentam significados especiais e não podem ser usados como texto literal.

    Símbolo

    Descrição

    ?

    Quando submetido, o símbolo corresponde a qualquer outro caractere. Quando unido para exibição, ele se torna um espaço.

    *

    Quando submetido, o símbolo corresponde a 0 ou a caracteres de espaço em branco Unicode. Quando unido para exibição, ele se torna um espaço.

    +

    Quando submetido, o símbolo corresponde a um ou mais caracteres de espaço em branco Unicode. Quando unido para exibição, ele se torna um espaço.

    Padrões de campos complexos

    Além de definir padrões simples para campos de data/hora, campos numéricos e campos de texto, é possível definir um padrão específico para localidades ou manipular padrões de variáveis.

    Padrões específicos para o local

    Para forçar uma localidade em um padrão, independentemente de essa localidade já ter sido atribuída a um objeto, é possível definir um padrão específico para localidades. A sintaxe de um padrão específico para localidades é definida desta maneira:

    category_name(locale_name){pattern}

    em que

    • category_name pode ser date, time, num ou text.

    • locale_name é identificado por um código de idioma e/ou de país ou região, conforme definido na RFC 1766 (Marcas para a identificação de idiomas, 1995).

    • pattern é o padrão simples para o processamento de valores.

    Por exemplo, para forçar um campo de data/hora a traduzir uma data no idioma francês de acordo com o código de país da França, seria necessário definir o padrão como segue:

    date(fr_FR){DD MMMM, YYYY}

    Padrões de variáveis

    Nos casos em que entradas do usuário ou dados vinculados estão disponíveis em mais de um formato (por exemplo, números de telefone podem ou não conter um código de área de três dígitos), é possível definir um padrão que considere essas diferenças. A sintaxe para a definição de um número de padrões aceitáveis é a seguinte:

    category_name{pattern}|category_name{pattern}|category_name{pattern}

    em que cada padrão é separado por uma barra vertical (|). É possível especificar um número ilimitado de padrões. Por exemplo, a construção a seguir manipula dois padrões de texto diferentes:

    text{999*9999}|text{999*999*9999}

    Definir fonte padrão de valores em novos formulários

    1. No menu Ferramentas, selecione Opções.

    2. Clique em Fontes padrão.

    3. Em Propriedades de fonte padrão de valores em novos formulários, selecione as opções de face de tipos, tamanho e estilo. conforme necessário.

    Definir fonte padrão de valores em um formulário existente

    1. Clique em Arquivo > Propriedades do formulário.

    2. Clique em Fontes padrão.

    3. Em Propriedades de fonte padrão de valores, selecione as opções de face de tipos, tamanho e estilo. conforme necessário.