Controlo Seletor de datas no Power Apps

  • Artigo

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).

Year( DateTimeValue )

Exemplos

Seletor de data básico

  1. Adicione um controlo Seletor de datas e dê-lhe o nome "Prazo".

    Não sabe como adicionar, atribuir um nome e configurar um controlo?

  2. 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?

  3. 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.

  4. Para voltar à área de trabalho predefinida, prima Esc.

Redefinir o selecionador de datas para a data padrão

  1. Adicione um controlo Seletor de datas e dê-lhe o nome "DateTimeReset".

    Não sabe como adicionar, atribuir um nome e configurar um controlo?

  2. Adicione um controlo Botão e defina a respetiva propriedade OnChange para a seguinte fórmula:

    Reset(DateTimeReset)

  3. Prima F5, escolha uma nova data em DateTimeReset, e, em seguida, clique ou toque em OK.

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

  5. Para voltar à área de trabalho predefinida, prima Esc.

Diretrizes de acessibilidade

Contraste de cor

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

Gorjeta

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).