Partilhar via

Personalizar ou formatar valores de data e hora num fluxo

Este artigo fornece passos para personalizar ou formatar valores de data e hora num fluxo do Power Automate.

Ao trabalhar com valores de data e hora num fluxo do Power Automate, pode descobrir que o formato de data e hora não é o que esperava, ou poderá querer personalizar o formato da saída. Pode fazê-lo passando as cadeias de formato para a função formatDateTime.

Formatar data e hora

A função formatDateTime() no Power Automate permite-lhe manipular e formatar valores de data e hora em vários formatos de apresentação. Também oferece uma forma fácil de processar valores de data e hora em fusos horários diferentes.

A função formatDateTime() obtém dois parâmetros:

  • Carimbo de data/hora: o carimbo de data/hora é o valor de data e hora que precisa de ser formatado.

    Pode ser uma cadeia manual ou conteúdo dinâmico. Quando introduzido manualmente, espera-se que o carimbo de data/hora siga o formato ISO 8601 ("aaaa-MM-ddTHH:mm:ssZ").

  • Cadeia de formato: a cadeia de formato especifica o formato de saída para a data e hora.

    O parâmetro de cadeia de formato da função formatDateTime() pode ser uma cadeia de formato padrão ou uma cadeia de formato personalizado.

Cadeias de formato padrão

Uma cadeia de formato padrão utiliza um único caráter (por exemplo, d, g ou G) como o especificador de formato.

Exemplos

  • A cadeia de formato g corresponde ao padrão de data/hora Geral (hora abreviada):

    formatDateTime('2009-06-15T13:45:30', 'g') // Devolve o formato 15/06/2009 13:45

  • A cadeia de formato D corresponde ao padrão de data por extenso:

    formatDateTime('2009-06-15T13:45:30', 'D') // Devolve o formato segunda-feira, 15 de junho de 2009

Para mais informações e exemplos de utilização de cadeias de formato de data e hora padrão, aceda a Cadeias de formato de data e hora padrão.

Cadeias de formato personalizado

Uma cadeia de formato personalizado é qualquer cadeia com mais de um caráter (por exemplo, M/dd/yyyy h:mm tt) que pode controlar a visibilidade, o posicionamento e a precisão do mês, dia, ano, hora, segundo, e assim por diante, do valor de data e hora.

Exemplos

  • A cadeia de formato M/dd/yyyy h:mm tt representa o mesmo padrão que a cadeia de formato padrão g, conforme descrito em Cadeias de formato padrão:

    formatDateTime('2009-06-15T13:45:30', 'M/dd/yyyy h:mm tt') // Devolve o formato 15/06/2009 13:45

  • A cadeia de formato HH:mm:ss tt devolve o formato de 24 horas:

    formatDateTime('2009-06-15T13:45:30', 'M/dd/yyyy HH:mm:ss tt') // Devolve o formato 15/06/2009 13:45:30

  • A cadeia de formato hh:mm:ss tt devolve o formato de 12 horas:

    formatDateTime('2009-06-15T13:45:30', 'yyyy/MM/dd hh:mm:ss tt') // Devolve o formato 15/06/2009 1:45:30 PM

  • utcNow() função utilizada como carimbo de data/hora para obter automaticamente a data e hora atuais em UTC, bem como a cadeia de formato dd-MM-yyyy para apresentar a data e a hora:

    formatDateTime(utcNow(), 'MMMM dd, yyyy, HH:mm') //Devolve a hora da data atual no formato 15 de junho de 2009, 16:50

  • utcNow() função utilizada como carimbo de data/hora para obter automaticamente a data e hora atuais em UTC, bem como a cadeia de formato dd-MM-yyyy para apresentar a data mas não a hora:

    formatDateTime(utcNow(), 'dd-MM-yyyy') //Devolve a hora da data atual no formato 15-06-2009

Para mais informações e exemplos de utilização de cadeias de formato de data e hora personalizadas, aceda a Cadeias de formato de data e hora personalizadas.

Utilizar num fluxo

Para utilizar um valor de data e hora num fluxo, siga estes passos.

  1. No fluxo, selecione o campo de entrada onde pretende introduzir o valor formatado de data e hora.

  2. Aceda a Adicionar conteúdo dinâmico e selecione o separador Expressão para abrir o editor de expressões.

  3. Digite formatDateTime().

    Em alternativa, procure-o nas funções Data e hora.

  4. Forneça o valor a ser formatado, entre plicas.

    O conteúdo dinâmico pode ser usado, mas não deve estar entre plicas.

  5. Forneça a cadeia de formato, entre plicas.

  6. A expressão completa deve ser parecida com os seguintes exemplos:

    • formatDateTime('<your-value>', 'dd/MM/yyyy hh:mm tt')
    • formatDateTime('<dynamic-value>', 'dd/MM/yyyy hh:mm tt')

    Captura de ecrã da ligação Adicionar conteúdo dinâmico e do separador Expressão.

  7. Selecione OK.

Exemplo com conteúdo dinâmico

Os conteúdos dinâmicos são variáveis produzidas por acionadores e ações num fluxograma. Permitem que os utilizadores selecionem referências de campo de passos anteriores e escrevam expressões.

Este exemplo acompanha-o num fluxo simples que demonstra a utilização da função formatDateTime() com conteúdo dinâmico. O acionador utilizado neste exemplo é um fluxo acionado manualmente que requer a entrada do utilizador.

  1. Inicie sessão no Power Automate.

  2. Configurar o acionador para o fluxo. Este exemplo usa Data como entrada.

    1. No painel de navegação esquerdo, selecione Criar>Fluxo de cloud instantâneo.

    2. No campo Nome do fluxo, introduza um nome para o fluxo.

    3. Na lista Escolher como acionar este fluxo, selecione Acionar manualmente um fluxo.

    4. Selecione Criar.

    5. Selecione o cartão Acionar manualmente um fluxo.

    6. No separador Parâmetros, selecione + Adicionar uma entrada>Data.

    7. No campo à direita, introduza 2023-10-22.

      Captura de ecrã do formato de data no separador Parâmetros.

  3. Adicione a ação Enviar um e-mail (v2).

    1. Por baixo do cartão Acionar manualmente um fluxo, selecione o sinal de adição (+) >Adicionar uma ação.

    2. No campo Pesquisar, comece a digitar Enviar um e-mail (v2) e selecione-o na lista quando o vir.

    3. Selecione o campo Corpo no e-mail e, em seguida, selecione fx (Inserir Expressão).

    4. Selecione Conteúdo dinâmico.

      O conteúdo dinâmico mostrado aqui está relacionado com o acionador. Associa o acionador e as ações que devem ser tomadas.

    5. No campo acima de Conteúdo dinâmico, comece a escrever formatDateTime e selecione-o no menu pendente quando aparecer.

    6. Desloque-se para baixo na lista Conteúdo dinâmico e selecione Data do acionador. Se não aparecer, selecione Ver Mais.

      O conteúdo dinâmico desta variável provém do campo de data no acionador.

    7. Forneça a cadeia de formato (entre plicas) com base no formato de saída pretendido para a data. Neste exemplo, é usado o formato MM/dd/aaaa.

      A expressão completa tem este aspeto:

      formatDateTime(triggerBody()?['date'], 'MM/dd/yyyy')

      Captura de ecrã da função formatDateTime utilizando conteúdo dinâmico.

    8. Selecione Adicionar.

  4. No separador Parâmetros, introduza um e-mail no campo Para e um assunto no campo Assunto.

  5. Selecione Guardar.

  6. Depois de executar o fluxo, o e-mail recebido mostra a data no formato MM/dd/aaaa especificado.

Exemplo com Converter fuso horário

O Power Automate utiliza a Hora Universal Coordenada (UTC) por predefinição. Para processar valores de data e hora noutros fusos horários, pode utilizar formatDateTime em conjunto com a função convertTimeZone.

Por exemplo, para apresentar a hora atual na Hora Padrão do Leste, pode utilizar a seguinte sintaxe:

formatDateTime(convertTimeZone(utcNow(), 'UTC', 'Eastern Standard Time'), 'yyyy-MM-dd HH:mm:ss') // Devolve a data/hora ajustada à Hora Padrão do Leste

Para mais informações sobre a função de data e hora, selecione os seguintes artigos.