Controle Seletor de data no Power Apps
Um controle que o usuário pode selecionar para especificar uma data.
Descrição
Se você adicionar um controle Seletor de data, em vez de um controle Entrada de texto, ajudará a garantir que o usuário especificará uma data no formato correto.
Principais propriedades
DefaultDate – o valor inicial de um controle de data, a menos que o usuário o altere.
SelectedDate – a data selecionada no momento em um controle de data. Esta data é representada na hora local.
Format – o formato de texto no qual o controle mostra a data e o usuário a especifica. É possível definir essa propriedade como ShortDate (padrão) ou LongDate para formatar datas baseadas na propriedade Language desse controle. Também é possível definir essa propriedade como uma expressão, como aaaa/mm/dd, se você deseja o mesmo formato, independentemente do idioma. Por exemplo:
- O controle mostrará 12/31/2017 se o usuário clicar ou tocar no último dia de 2017, a propriedade Format estiver definida como ShortDate e a propriedade Language estiver definida como en-us.
- O controle mostrará dimanche 31 decembre 2017 se o usuário clicar ou tocar no último dia de 2017, a propriedade Format estiver definida como LongDate e a propriedade Language estiver definida como fr-fr.
Language – 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 – rótulo para leitores de tela.
BorderColor – a cor da borda do controle.
BorderStyle – se a borda do controle é Sólida, Tracejada, Pontilhada ou Nenhuma.
BorderThickness – a espessura da borda do controle.
Color – a cor do texto em um controle.
DateTimeZone - Se a data deve ser exibida UTC ou o tempo Local do usuário.
DisplayMode – se o controle permite entrada do usuário (Edição), apenas exibe dados (Exibição) ou está desabilitado (Desabilitado).
DisabledBorderColor – a cor da borda de um controle se a propriedade DisplayMode do controle estiver definida como Desabilitado.
DisabledColor – a cor do texto em um controle se sua propriedade DisplayMode estiver definida como Desabilitado.
DisabledFill – a cor da tela de fundo de um controle se sua propriedade DisplayMode estiver definida como Desabilitado.
EndYear – o ano mais recente para o qual o usuário pode definir o valor de um controle de Seletor de data.
Fill – a cor da tela de fundo de um controle.
FocusedBorderColor – a cor da borda do controle quando ele está focalizado.
FocusedBorderThickness – A espessura da borda de um controle quando ele está focalizado.
Font – o nome da família de fontes em que o texto é exibido.
FontWeight – o peso do texto em um controle: Negrito , Seminegrito, Normal ou Mais claro.
Height – a distância entre a parte superior do controle e as bordas inferiores.
IconFill – a cor de primeiro plano de um ícone seletor de data.
IconBackground – a cor da tela de fundo do ícone seletor de data.
InputTextPlaceholder - Texto instrutivo que aparece se nenhuma data for inserida.
IsEditable - Se o texto do selecionador de data pode ser editado. Se falsa, a data só pode ser alterada usando o calendário.
Italic – se o texto em um controle está em itálico.
OnSelect – Ações a serem executadas quando o usuário tocar ou clicar em um controle.
OnChange – Ações a realizar quando o usuário altera o valor de um controle.
Diferença entre OnChange e OnSelect : OnSelect e OnChange são acionados na mesma ação do usuário se o usuário clicar causa a mudança.Nesse caso, o OnSelect dispara antes 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.
Reset - Se o controle Seletor de data deve ser redefinido com o valor DefaultDate.
Size – 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 de Seletor de data.
StartYear – o ano mais recente 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.
Visible – se um controle é exibido ou está oculto.
Width – a distância entre as bordas esquerda e direita de um controle.
X – a distância entre a borda esquerda de um controle e a borda esquerda de seu contêiner pai (ou a tela, se não houver contêiner pai).
Y – a distância entre a borda superior de um controle e a borda superior de seu contêiner pai (ou a tela, se não houver contêiner pai).
Funções relacionadas
Year( DateTimeValue )
Exemplos
Seletor de data básico
Adicione um controle Seletor de data e nomeie-o como "Prazo".
Não sabe como adicionar, nomear e configurar um controle?
Adicione um controle Rótulo e defina sua propriedade Text como a seguinte fórmula:
DateDiff(Today(), Deadline.SelectedDate) & " days to go!"
Deseja obter mais informações sobre a função DateDiff ou outras funções?
Pressione F5, escolha uma data no Prazo e, em seguida, clique ou toque em OK.
O controle Rótulo mostra o número de dias entre hoje e a data escolhida.
Para retornar ao espaço de trabalho padrão, pressione Esc.
Redefinir o selecionador de data como a data padrão
Adicione um controle Seletor de Data e nomeie-o como "DateTimeReset".
Não sabe como adicionar, nomear e configurar um controle?
Adicione um controle Botão e defina sua propriedade OnChange como a seguinte fórmula:
Reset(DateTimeReset)
Pressione F5, escolha uma nova data em DateTimeReset, em seguida, clique ou toque em OK.
Pressione o botão. A data será redefinida como DefaultDate (Hoje).
Para retornar ao espaço de trabalho padrão, pressione Esc.
Diretrizes de acessibilidade
Contraste de cores
- Os requisitos de contraste de cores padrão se aplicam.
Suporte ao leitor de tela
- AccessibleLabel precisa estar presente.
- Se IsEditable for verdadeiro e Format não for o que os usuários esperam, adicione um Rótulo para explicar os formatos de data aceitos.
Suporte de teclado
- TabIndex deve ser zero ou maior para que os usuários de teclado possam navegar para ela.
- Os indicadores de foco precisam ser evidentes. Use FocusedBorderColor e FocusedBorderThickness para fazer isso.
Dica
Quando o calendário estiver aberto, pressione Page up e Page down para navegar entre os meses e Shift + Page up e Shift + Page down para navegar entre os anos.
Observação
Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)
A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).