Converta um fuso horário

Este artigo apresenta as etapas para converter o fuso horário para o fuso horário desejado em um gatilho ou ação do Power Automate.

Ao passar valores de data e hora por meio de gatilhos e ações nos fluxos do Power Automate, você pode perceber que o fuso horário não é o esperado ou pode querer converter o fuso horário (frequentemente no Tempo Universal Coordenado (UTC)) para o seu horário local. Você pode fazer isso usando a ação Converter fuso horário ou a expressão convertTimeZone.

As datas são passadas por serviços em formatos ou fusos horários variados, portanto, cada conector pode usar um formato de data e hora ou fuso horário diferente. Alguns serviços usam estritamente o horário UTC para evitar confusão.

Converter um fuso horário usando uma ação

O Power Automate tem uma operação interna chamada Converter fuso horário.

  1. Entre em Power Automate.

  2. Encontre seu fluxo e selecione Editar para adicionar uma ação.

  3. Na caixa Pesquisar, digite converter fuso horário e escolha a operação integrada Converter fuso horário.

    Captura de tela para pesquisar a ação de conversão de fuso horário em um fluxo.

  4. Adicione as entradas necessárias e opcionais para a operação Converter fuso horário.

    • Data e hora base: a data e hora que você deseja converter.
    • Fuso horário de origem: o fuso horário no qual o datetime está no momento.
    • Fuso horário de destino: o fuso horário para o qual você deseja converter sua data.
    • Cadeia de caracteres de formatoOpcional: a cadeia de caracteres que especifica o formato desejado do tempo convertido.

    Para encontrar maneiras de encontrar o fuso horário atual, vá para a seção Cenários de formato comuns neste artigo.

Converter um fuso horário usando uma expressão

O Power Automate possui uma função de expressão, convertTimeZone, que converte um timestamp do fuso horário de origem para o fuso horário de destino.

A captura de tela mostra que o Power Automate tem uma função de expressão para converter o fuso horário.

Veja um exemplo da função no console:

convertTimeZone(timestamp: string, sourceTimeZone: string, destinationTimeZone: string, format?: string)

A função usa os seguintes parâmetros:

  • timestamp: A data e hora que você deseja converter.
  • sourceTimeZone: o fuso horário no qual o campo datetime é expresso.
  • destinationTimeZone: o fuso horário para o qual você deseja converter sua data.
  • format (opcional): o formato do fuso horário no qual você deseja converter sua data.

Exemplo: converter um fuso horário

Este exemplo converte um fuso horário no fuso horário e no formato especificados.

convertTimeZone('2018-01-01T80:00:00.0000000Z', 'UTC', 'Pacific Standard Time', 'D')

Ele retorna o resultado: Monday, January 1, 2018.

Exemplo: usar conteúdo dinâmico

Este exemplo mostra como usar conteúdo dinâmico na expressão. A triggerBody()?['Date'] marca temporal é o conteúdo dinâmico que você deseja formatar. O fuso horário de origem é UTC. O fuso horário de destino é Eastern Standard Time. O formato é a cadeia de caracteres de formato personalizado HH:mm.

convertTimeZone(triggerBody()?['Date'],'UTC','Eastern Standard Time','HH:mm')

Saiba mais sobre essa função de expressão em convertTimeZone.

Saiba mais sobre o parâmetro de cadeia de caracteres de formato em cadeias de caracteres de formato de data e hora padrão e cadeias de caracteres personalizadas de formato de data e hora.

Cenários de formato comum

Esta seção aborda vários cenários e como aplicar o formato apropriado.

Decodificar uma data e hora

  • Datetimes podem ter formatos diferentes. Se o seu datetime tiver um Z no final, isso significa que está no horário UTC.

    Exemplo: 2020-04-10T01:28:14.0406387Z

  • Você pode receber um erro informando que sua cadeia de caracteres de data e hora não está no formato correto.

    Exemplo: 'a cadeia de caracteres de data e hora deve corresponder ao formato ISO8601.'

Saiba mais sobre como formatar corretamente sua cadeia de caracteres datetime em convertTimeZone.

Verificar o fuso horário de uma saída

Se não tiver certeza em qual formato o fuso horário de datetime está atualmente, você poderá executar seu fluxo e ver o formato de saída de datetime.

Neste exemplo, a operação Obter previsão para hoje retorna a data e hora de quando você obteve a previsão.

A captura de tela mostra um exemplo de verificação do formato de saída de datetime.

Esse datetime usa o formato de datetime ISO-8601. Esta operação retorna a data e hora no fuso horário UTC.

Converter um carimbo de data/hora de ou para UTC

Para converter um carimbo de data/hora do fuso horário de origem em UTC ou de UTC para o fuso horário de destino, use as funções de expressão convertFromUtc e convertToUtc.

Limitações

Alguns conectores têm limitações na forma como o fuso horário é exibido. Para saber mais sobre cada conector, consulte a visão geral da referência dos conectores.

  • Last updated on