Controlo Seletor de datas no Power Apps
Um controlo que o utilizador pode selecionar para especificar uma data.
Descrição
Se adicionar um controlo Seletor de datas em vez de um controlo Introdução de texto, pode ajudar a garantir que o utilizador especifique uma data no formato correto.
Propriedades principais
DefaultDate – o valor inicial de um controlo de data, a menos que o utilizador o altere.
SelectedDate – a data atualmente selecionada num controlo de data. Esta data é representada na hora local.
Format – o formato de texto no qual o controlo mostra a data e o utilizador especifica a data. Pode definir esta propriedade para ShortDate (predefinição) ou LongDate para formatar datas com base na propriedade Language deste controlo. Também pode definir esta propriedade para uma expressão, como aaaa/mm/dd, se pretender o mesmo formato, independentemente do idioma. Por exemplo:
- O controlo mostra 12/31/2017 se o utilizador 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 controlo mostra dimanche 31 decembre 2017 se o utilizador 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 que é utilizado para formatar datas, incluindo os nomes dos meses. Se esta propriedade não estiver especificada, o idioma é determinado pela definição do dispositivo do utilizador. Os valores suportados incluem "EN-US" e "FR".
Propriedades adicionais
AccessibleLabel – a etiqueta para os leitores de ecrãs.
BorderColor – a cor do limite de um controlo.
BorderStyle – se o limite do controlo é Sólido, Tracejado, Com pontos ou Nenhum.
BorderThickness – a espessura do limite de um controlo.
Color – a cor do texto num controlo.
DateTimeZone -se deve apresentar a data em UTC ou a hora Local do utilizador.
DisplayMode – se o controlo permite a intervenção do utilizador (Editar), apenas apresenta os dados (Visualizar), ou está desativado (Desativado).
DisabledBorderColor – a cor do limite de um controlo se a propriedade DisplayMode do controlo estiver definida como Desativada.
DisabledColor – a cor do texto num controlo se a respetiva propriedade DisplayMode estiver definida como Desativada.
DisabledFill – a cor de fundo de um controlo se a respetiva propriedade DisplayMode estiver definida como Desativada.
EndYear – o ano mais recente para o qual o utilizador pode definir o valor de um controlo de seletor de datas.
Fill – a cor de fundo de um controlo.
FocusedBorderColor – a cor do limite de um controlo quando o controlo é destacado.
FocusedBorderThickness – a espessura do limite de um controlo quando o controlo é destacado.
Font – o nome da família dos tipos de letra que aparecem no texto.
FontWeight – a espessura do texto num controlo: Negrito, Seminegrito, Normal ou Mais leve.
Height – a distância entre as margens superiores e inferiores de um controlo.
IconFill – a cor de primeiro plano de um ícone de seletor de datas.
IconBackground – a cor de fundo de um ícone de seletor de datas.
InputTextPlaceholder - texto informativo que aparece se não forem introduzidas datas.
IsEditable – Se o texto do Apanhador de Datas pode ser editado. Se for falso, a data só poderá ser alterada utilizando o calendário.
Italic – se o texto num controlo estiver em itálico.
OnSelect– Ações a realizar quando o utilizador toca ou clica num controlo.
OnChange – Ações a executar quando o utilizador muda o valor de um controlo.
Diferença entre onChange e OnSelect: OnSelect e OnChange Trigger acionam na mesma ação do utilizador, se o clique do utilizador causar a alteração. Neste caso, OnSelect é acionado antes de OnChange.
PaddingBottom – a distância entre o texto num controlo e o limite inferior desse controlo.
PaddingLeft – a distância entre o texto num controlo e o limite esquerdo desse controlo.
PaddingRight – a distância entre o texto num controlo e o limite direito desse controlo.
PaddingTop – a distância entre o texto num controlo e o limite superior desse controlo.
Reset – Se o controlo Seletor de datas deve ser reposto para o valor DefaultDate.
Size – o tamanho do tipo de letra do texto que é apresentado num controlo.
StartOfWeek – o dia da semana a apresentar na coluna do primeiro dia do controlo date-picker.
StartYear – o ano mais antigo para o qual o utilizador pode definir o valor de um controlo date-picker.
TabIndex – a ordem de navegação no teclado em relação a outros controlos.
Visible – se um controlo é apresentado ou está oculto.
Width – a distância entre as margens esquerda e direita de um controlo.
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
Year( DateTimeValue )
Exemplos
Seletor de data básico
Adicione um controlo Seletor de datas e dê-lhe o nome "Prazo".
Não sabe como adicionar, atribuir um nome e configurar um controlo?
Adicione um controlo Etiqueta e defina a respetiva propriedade Text para a seguinte fórmula:
DateDiff(Today(), Deadline.SelectedDate) & " days to go!"Pretende obter mais informações sobre a função DateDiff ou outras funções?
Prima F5, escolha uma data em Prazo, e, em seguida, clique ou toque em OK.
O controlo Etiqueta mostra o número de dias entre hoje e a data que escolheu.
Para voltar à área de trabalho predefinida, prima Esc.
Redefinir o selecionador de datas para a data padrão
Adicione um controlo Seletor de datas e dê-lhe o nome "DateTimeReset".
Não sabe como adicionar, atribuir um nome e configurar um controlo?
Adicione um controlo Botão e defina a respetiva propriedade OnChange para a seguinte fórmula:
Reset(DateTimeReset)Prima F5, escolha uma nova data em DateTimeReset, e, em seguida, clique ou toque em OK.
Prima o botão. A data será reposta para o DefaultDate (Hoje).
Para voltar à área de trabalho predefinida, prima Esc.
Diretrizes de acessibilidade
Contraste de cor
- Aplicam-se os requisitos de contraste de cor padrão.
Suporte a leitor de ecrã
- AccessibleLabel tem de estar presente.
- Se IsEditable for verdadeiro e Format não for o que os utilizadores esperam, adicione uma Etiqueta para explicar os formatos de datas aceites.
Suporte de teclado
- TabIndex tem de ser zero ou superior para que os utilizadores do teclado possam navegar nele.
- Os indicadores de foco têm de estar claramente visíveis. Utilize FocusedBorderColor e FocusedBorderThickness para o conseguir.
Dica
Quando o calendário estiver aberto, prima Página para cima e Página para baixo para navegar entre meses e Shift + Page up e Shift + Page Down para navegar entre anos.
Nota
Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)
O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).