Ler em inglês

Compartilhar via

Converter um fuso horário

  • Artigo
  • 08/02/2024

Este artigo fornece etapas para converter o fuso horário no fuso horário pretendido em um gatilho ou ação do Power Automate.

Ao passar data/hora por gatilhos e ações nos fluxos do Power Automate, você pode descobrir que o fuso horário não é o esperado ou talvez queira converter o fuso horário (frequentemente no Tempo Universal Coordenado (UTC)) para a hora 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 no 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.

    • Horário base: o datetime 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 tem uma função de expressão convertTimeZone que converte um carimbo de data/hora 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: o datetime 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 para o 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 é um exemplo de uso de conteúdo dinâmico na expressão. Aqui, o carimbo de data/hora é o triggerBody()?['Date'] 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')

Para saber mais sobre essa função de expressão, acesse convertTimeZone.

Para saber mais sobre o parâmetro de cadeia de caracteres de formato, acesse strings de formato de data e hora padrão e strings de formato de data e hora personalizado.

Cenários de formato comum

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

Decifrar um datetime

  • 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.'

    Para saber mais sobre como formatar corretamente sua cadeia de caracteres de datetime, acesse 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 produz o carimbo de data/hora de quando você tem 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 gera o datetime 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

Pode haver limitações em alguns conectores quanto à forma como o fuso horário é exibido. Para saber mais sobre cada conector, consulte Visão geral da referência de conectores.

Recursos adicionais