Ler em inglês

Compartilhar via


Personalizar ou formatar valores de data e hora em um fluxo

Este artigo fornece etapas para personalizar ou formatar valores de data e hora em um fluxo do Power Automate.

Ao trabalhar com valores de data e hora em um fluxo do Power Automate, você pode descobrir que o formato de data e hora não é o esperado ou pode querer personalizar o formato da saída. Você pode fazer isso passando cadeias de caracteres de formato para a função formatDateTime.

Formato de data e hora

A função formatDateTime() no Power Automate permite manipular e formatar valores de data e hora em vários formatos de exibição. Ele também oferece uma maneira fácil de lidar com dados e horas em diferentes fusos horários.

A função formatDateTime() usa dois parâmetros:

  • Carimbo de data/hora: o carimbo de data/hora é o valor de data e hora que precisa de formatação.

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

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

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

Cadeias de caracteres de formato padrão

Uma cadeia de caracteres de formato padrão usa um único caractere (por exemplo, d, g ou G) como o especificador de formato.

Exemplos

  • A cadeia de caracteres de formato g corresponde ao padrão de data/hora Geral (período curto):

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

  • A cadeia de caracteres de formato D corresponde ao padrão de data Longo:

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

Para obter mais informações e exemplos de como usar cadeias de caracteres de formato de data e hora padrão, acesse Cadeias de caracteres de formato de data e hora padrão.

Cadeias de caracteres de formato personalizadas

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

Exemplos

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

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

  • A cadeia de caracteres de formato HH:mm:ss tt retorna o formato de hora de 24 horas:

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

  • A cadeia de caracteres de formato hh:mm:ss tt retorna o formato de hora de 12 horas:

    formatDateTime('2009-06-15T13:45:30', 'yyyy/MM/dd hh:mm:ss tt') // Retorna o formato 15/06/2009 13h45min30s

  • A função utcNow() usada como carimbo de data/hora para buscar automaticamente a data e hora atuais em UTC, e a cadeia de caracteres de formato dd-MM-yyyy para exibir a data e hora:

    formatDateTime(utcNow(), 'MMMM dd, yyyy, HH:mm') Retorna a data e hora atual no formato 15 de junho de 2009, 16h50

  • A função utcNow() usada como carimbo de data/hora para buscar automaticamente a data e hora atuais em UTC, e a cadeia de caracteres de formato dd-MM-yyyy para exibir a data, mas não a hora:

    formatDateTime(utcNow(), 'dd-MM-yyyy') //Retorna a data e hora atual no formato 15 de junho de 2009

Para obter mais informações e exemplos de como usar cadeias de caracteres de formato de data e hora personalizado, acesse Cadeias de caracteres de formato de data e hora personalizado.

Usar em um fluxo

Para usar um valor de data e hora em um fluxo, siga estas etapas.

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

  2. Acesse Adicionar conteúdo dinâmico e selecione a guia Expressão para abrir o editor de expressão.

  3. Digite formatDateTime().

    Como alternativa, procure-o nas funções de Data e Hora.

  4. Forneça o valor a ser formatado, entre aspas simples.

    O conteúdo dinâmico pode ser usado, mas não deve ser cercado por aspas simples.

  5. Forneça a cadeia de caracteres de formato, entre aspas simples.

  6. A expressão completa deve parecer com os exemplos a seguir:

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

    Captura de tela do link Adicionar conteúdo dinâmico e a guia Expressão.

  7. Selecione OK.

Exemplo com conteúdo dinâmico

Conteúdos dinâmicos são variáveis produzidas por gatilhos e ações dentro de um fluxograma. Elas permitem que os usuários selecionem referências de campo de etapas anteriores e escrevam expressões.

Este exemplo percorre um fluxo simples que demonstra o uso da função formatDateTime() com conteúdo dinâmico. O gatilho usado neste exemplo é um fluxo disparado manualmente que requer a entrada do usuário.

  1. Entre no Power Automate.

  2. Configurar o gatilho para o fluxo. Este exemplo usa Date como entrada.

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

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

    3. Na lista Escolher como disparar este fluxo, selecione Disparar um fluxo manualmente.

    4. Selecione Criar.

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

    6. Na guia Parâmetros, selecione + Adicionar uma entrada>Data.

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

      Captura de tela do formato de data na guia Parâmetros.

  3. Adicione a ação Enviar um email (v2).

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

    2. No campo Pesquisar, comece digitando Enviar um email (v2) e selecione-o da lista quando visualizá-lo.

    3. Selecione o campo Corpo no email e selecione fx (Inserir Expressão).

    4. Selecione Conteúdo dinâmico.

      O conteúdo dinâmico mostrado aqui está relacionado ao gatilho. Ele vincula o gatilho e as ações que precisam ser tomadas.

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

    6. Role para baixo na lista de Conteúdo dinâmico e selecione Data do gatilho. Se não aparecer, selecione Ver mais.

      O conteúdo dinâmico dessa variável se origina do campo de data no gatilho.

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

      A expressão completa parece com essa:

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

      Captura de tela da função formatDatTime usando o conteúdo dinâmico.

    8. Selecione Adicionar.

  4. Na guia Parâmetros, insira um email no campo Para e um assunto no campo Assunto.

  5. Selecione Salvar.

  6. Depois de executar o fluxo, o email recebido mostra a data no formato MM/dd/aaaa.

Exemplo com Converter fuso horário

O Power Automate usa o Tempo Universal Coordenado (UTC), por padrão. Para manipular valores de data e hora em outros fusos horários, você pode usar formatDateTime em conjunto com a função convertTimeZone.

Por exemplo, para exibir a hora atual na hora padrão do leste, você pode usar a seguinte sintaxe:

formatDateTime(convertTimeZone(utcNow(), 'UTC', 'Eastern Standard Time'), 'yyyy-MM-dd HH:mm:ss') // Retorna a data e hora ajustada para a hora padrão do leste

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