Controle do Seletor de Data no Power Apps

Um controle que o usuário pode selecionar para especificar uma data.

Description

Se você adicionar um controle Seletor de Data em vez de um controle de entrada de texto , ajudará a garantir que o usuário especifique uma data no formato correto.

Propriedades chave

DefaultDate – O valor inicial de um controle de data, a menos que o usuário o altere.

SelectedDate – A data atualmente selecionada em um controle de data. Esta data é representada na hora local.

Formato – O formato de texto no qual o controle mostra a data e o usuário especifica a data. Você pode definir essa propriedade como ShortDate (padrão) ou LongDate para formatar datas com base na propriedade Language desse controle. Você também pode definir essa propriedade como uma expressão, como aaaa/mm/dd se quiser o mesmo formato, independentemente do idioma. Por exemplo:

• O controle mostra 31/12/2017 se o usuário clicar ou tocar no último dia de 2017, a propriedade Format será definida como ShortDate e a propriedade Language será definida como en-us.
• O controle mostra dimanche 31 decembre 2017 se o usuário clicar ou tocar no último dia de 2017, a propriedade Format será definida como LongDate e a propriedade Language será definida como fr-fr.

Idioma – Determina o idioma usado para formatar datas, incluindo nomes de meses. Se essa propriedade não for especificada, a configuração do dispositivo do usuário determinará o idioma. Os valores suportados incluem "EN-us" e "FR".

Propriedades adicionais

AccessibleLabel – Etiqueta para leitores de tela.

BorderColor – A cor da borda de um controle.

BorderStyle – Se a borda de um controle é Sólida, Tracejada, Pontilhada ou Nenhuma.

BorderThickness – A espessura da borda de um controle.

Cor – A cor do texto em um controle.

DateTimeZone – Se deseja exibir a data em UTC ou a hora local do usuário.

DisplayMode – Se o controle permite a entrada do usuário (Editar), exibe apenas dados (View) ou está desativado (Disabled).

DisabledBorderColor – A cor da borda de um controle se a propriedade DisplayMode do controle estiver definida como Disabled.

DisabledColor – A cor do texto em um controle se sua propriedade DisplayMode estiver definida como Disabled.

DisabledFill – A cor de plano de fundo de um controle se sua propriedade DisplayMode estiver definida como Disabled.

EndYear – O último ano para o qual o usuário pode definir o valor de um controle de seletor de data.

Preenchimento – A cor de fundo de um controlo.

FocusedBorderColor – A cor da borda de um controle quando o controle está focado.

FocusedBorderThickness – A espessura da borda de um controle quando o controle está focado.

Fonte – O nome da família de fontes na qual o texto aparece.

FontWeight – O peso do texto em um controle: negrito, seminegrito, normal ou mais leve.

Altura – A distância entre as bordas superior e inferior de um controle.

IconFill – A cor de primeiro plano de um ícone do seletor de data.

IconBackground – A cor de fundo de um ícone do seletor de data.

InputTextPlaceholder – Texto instrucional que aparece se nenhuma data for inserida.

IsEditable – Se o texto do Seletor de Data pode ser editado. Se false, a data só pode ser alterada usando o calendário.

Itálico – Se o texto em um controle está em itálico.

OnSelect – Ações a serem executadas quando o usuário toca ou clica em um controle.

OnChange – Ações a serem executadas quando o usuário altera o valor de um controle.

Diferença entre OnChange e OnSelect: OnSelect e OnChange disparam na mesma ação do usuário se o clique do usuário causar a alteração. Nesse caso, OnSelect é acionado antes de OnChange.

PaddingBottom – A distância entre o texto em um controle e a borda inferior desse controle.

PaddingLeft – A distância entre o texto em um controle e a borda esquerda desse controle.

PaddingRight – A distância entre o texto em um controle e a borda direita desse controle.

PaddingTop – A distância entre o texto em um controle e a borda superior desse controle.

Redefinir - Se o controle Seletor de Data deve ser redefinido para o valor DefaultDate .

Tamanho – O tamanho da fonte do texto que aparece em um controle.

StartOfWeek – O dia da semana a ser exibido na coluna do primeiro dia do controle seletor de data.

StartYear – O primeiro ano para o qual o usuário pode definir o valor de um controle de seletor de data.

TabIndex – Ordem de navegação do teclado em relação a outros controles.

Visível – Se um controle aparece ou está oculto.

Largura – A distância entre as bordas esquerda e direita de um controle.

X – a distância entre o limite esquerdo de um controlo e o limite esquerdo do respetivo recipiente principal (do ecrã, se não existir um recipiente principal).

Y – a distância entre o limite superior de um controlo e o limite superior do recipiente principal (do ecrã, se não existir um recipiente principal).

Funções relacionadas

Ano( DateTimeValue )

Examples

Seletor de data básico

1. Adicione um controle do Seletor de Data e nomeie-o como "Prazo".

   Não sabe como adicionar, nomear e configurar um controle?

2. Adicione um controle Label e defina sua propriedade Text para a seguinte fórmula:

    DateDiff(Today(), Deadline.SelectedDate) & " days to go!"
   

   Quer obter mais informações sobre a função DateDiff ou outras funções?

3. Prima F5, escolha uma data em Deadline e, em seguida, selecione OK.

   O controle Label mostra o número de dias entre hoje e a data escolhida.

4. Para retornar ao espaço de trabalho padrão, pressione Esc.

Redefinir o seletor de data para a data padrão

1. Adicione um controle do Seletor de Data e nomeie-o como "DateTimeReset".

   Não sabe como adicionar, nomear e configurar um controle?

2. Adicione um controle Button e defina sua propriedade OnChange para a seguinte fórmula:

   Reset(DateTimeReset)
   

3. Prima F5, escolha uma nova data em DateTimeReset e, em seguida, selecione OK.

4. Prima o botão. A data será redefinida para DefaultDate (Hoje).

5. Para retornar ao espaço de trabalho padrão, pressione Esc.

Diretrizes de acessibilidade

Contraste de cor

• Aplicam-se requisitos de contraste de cor padrão .

Suporte a leitor de ecrã

• AccessibleLabel deve estar presente.
• Se IsEditable for true e Format não for o que os usuários esperam, adicione um Label para explicar os formatos de data aceitos.

Suporte de teclado

• TabIndex deve ser zero ou maior para que os usuários do teclado possam navegar até ele.
• Os indicadores de focalização devem ser claramente visíveis. Use FocusedBorderColor e FocusedBorderThickness para conseguir isso.