Funções de transformação de data e hora

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 7 min. de leitura

    • Use as funções de transformação de data e hora para recalcular ou reformatar cápsulas de dados para valores de data/hora.

    As funções de transformação de data e hora exigem uma cápsula de dados de entrada de data/hora ou cadeia de caracteres. Algumas funções também são compatíveis com cápsulas de dados de duração. Certifique-se de usar a entrada correta tipo de cápsula de dados ao aplicar funções de transformação de data e hora. Se uma função de transformação de data e hora for aplicada a um tipo de cápsula de dados inadequado, os dados não serão transformados no tempo de execução e o valor de entrada será retornado. Para obter mais informações sobre como confirmar os valores de tempo de execução do fluxo, consulte Teste um fluxo .

    Nota:
    Os valores de data/hora de tempo de execução não estão localizados e aparecem no fuso horário UTC (Tempo universal coordenado). Para obter mais informações, consulte Fusos horários e. representação de fuso horário .

    Adicionar Tempo

    Adiciona dias, horas, minutos ou segundos a uma entrada Data/Hora, Data, Data de Vencimento ou Duração.

    Cápsula de dados de entrada Parâmetros Cápsula de dados de saída
    Data/Hora, Data, Data de vencimento ou Duração
    Nota:
    Se a entrada for uma Data ou Data de vencimento, a transformação criará um valor de Data/Hora completo usando valores de hora 0, minuto 0 e segundo 0.
    		 Duration - Quantidade de tempo a ser adicionada em dias, horas, minutos e segundos Data/Hora - Valor de data/hora transformado após adicionar o especificado Duration
    Figura 1. Exemplo
    • Entrada: 2019-09-12 11:00:00
    • Duração: 3 horas
    • Saída: 2019-09-12 14:00:00

    Subtrair tempo

    Subtrai dias, horas, minutos e/ou segundos da entrada Data/Hora, Data, Data de Vencimento ou Duração.

    Cápsula de dados de entrada Parâmetros Cápsula de dados de saída
    Data/Hora, Data, Data de vencimento ou Duração
    Nota:
    Se a entrada for uma Data ou Data de vencimento, a transformação criará um valor de Data/Hora completo usando valores de hora 0, minuto 0 e segundo 0.
    		 Duration - Insira uma quantidade de tempo a subtrair em dias, horas, minutos e segundos Data/Hora - Valor de data/hora transformado após a subtração do especificado Duration
    Figura 2. Exemplo
    • Entrada: 2019-09-12 11:00:00
    • Duração: 2 dias, 1 horas, 5 minutos, 10 segundos
    • Saída: 2019-09-10 09:54:50

    Neste exemplo, o fluxo recupera um registro de Item de configuração do CMDB de uma instância remota. Em seguida, a função Subtrair transformação de tempo localiza o valor do Criado Subtraindo três horas da data/hora de entrada.

    Figura 3. Localize o fuso horário de um valor de campo
    Localize o fuso horário de um valor de campo.

    Cadeia de caracteres para data

    Converte a cadeia de caracteres de entrada em uma data/hora.

    Cápsula de dados de entrada Parâmetros Cápsula de dados de saída
    Cadeia de caracteres formatada conforme especificado em Input Date Format
    • Input Date Format - Formato de data/hora ou data da cadeia de caracteres de entrada
    • Custom Format Formato de data/hora válido ou data representado como uma cadeia de caracteres. Necessário somente se o Formato personalizado estiver selecionado como Input Date Format.
    		 Data/Hora
    Nota:
    • Se for o valor de Data/Hora para Formato personalizado A entrada está incompleta, a transformação cria um valor de Data/Hora completo usando datas e horas padrão. Nesse caso, o padrão de transformação é o ano atual, o mês atual, o dia 1 de um mês, a hora 0, o minuto 0 e o segundo 0. Por exemplo, um valor de cápsula de dados de entrada de Outubro de 2019 e um formato de data personalizado de Aaaa MMM produz uma saída de 2019-10-01 00:00:00 .
    • Se você usar um tipo de cápsula de dados incorreto ou inválido Formato personalizado , o fluxo é cancelado durante o tempo de execução.
    Figura 4. Exemplo
    • Entrada: '1995-11-20'
    • Formato de data de entrada: Data ISO (2004-06-28)
    • Saída: 1995-11-20 00:00:00

    Data para cadeia de caracteres

    Converte a data/hora, data ou data de vencimento em uma cadeia de caracteres. Selecione um Formato de data Para a data/hora de entrada. Como alternativa, insira um Formato personalizado Para a data/hora de entrada.

    Cápsula de dados de entrada Parâmetros Cápsula de dados de saída
    data/hora, data ou data de vencimento.
    • Output Date Format Formato de data/hora ou data da cadeia de caracteres de saída
    • Custom Format Formato de data/hora válido ou data representado como uma cadeia de caracteres. Necessário somente se estiver selecionando Formato personalizado como Formato de data .
    		 Cadeia de caracteres formatada conforme especificado em Output Date Format
    Nota:
    Se você usar um tipo de cápsula de dados de entrada incorreto ou inválido Formato personalizado , o fluxo é cancelado durante o tempo de execução.
    Figura 5. Exemplo
    • Entrada: 1969-12-31 14:23:57
    • Formato da data de saída: Personalizado (insira abaixo)
    • Formato personalizado: MMM dd, aaaa 'at' hh:mm a.
    • Saída: 'Em 31 de dezembro de 1969 às 2:23:00'

    Neste exemplo, o fluxo recupera um registro Usuário [sys_user] de um banco de dados de terceiros. A função Transformação de Data para Cadeia de caracteres converte o formato do Criado e registra em log a data, a hora e o nome associados ao registro.

    Figura 5. Concatenar um valor de data/hora com um valor de cadeia de caracteres
    Concatenar um valor de data/hora com um valor de cadeia de caracteres.

    Formatos de data personalizados

    Você pode especificar um formato de data personalizado com uma sequência de cadeias de caracteres de padrão de data e hora específicas. Uma cadeia de caracteres padrão consiste em uma ou mais letras maiúsculas e minúsculas de A a Z. Qualquer texto entre aspas é ignorado e, em vez disso, copiado para a saída de data.

    Cadeia de caracteres Descrição Formatos de Saída Exemplo
    G Designador de era Texto AD
    y Ano Ano 2019; 19
    Y Semana do ano Ano 2019; 19
    M Mês do ano (na data) Mês Julho; jul; 07
    L Mês do ano (valor autônomo) Mês Julho; jul; 07
    w Semana do ano Número 52
    Sem Semana do mês Número 1
    D Dia do ano Número 365
    D Dia do mês Número 2
    F Dia da semana do mês Número 3
    E Nome do dia na semana Texto Quarta-feira; qua
    u Dia da semana Número 3
    a a.m. ou p.m. Texto p.m.
    H Hora do dia de 0 a 23 Número 0
    k Hora do dia de 1 a 24 Número 24
    mil Hora em am ou pm de 0 a 11 Número 0
    h Hora em am ou pm de 1 a 12 Número 12
    M Minuto da hora Número 59
    s Segundo do minuto Número 1
    S Milissegundo Número 500
    z Fuso horário no formato padrão Fuso horário no formato padrão Horário padrão do Pacífico; PST
    Z Fuso horário no formato RFC 822 Fuso horário no formato RFC 822 -0800
    X Fuso horário no formato ISO 8601 Fuso horário no formato ISO 8601 -08; -0800; -08:00

    Dia

    Recupera o componente do dia da data/hora especificada.

    Cápsula de dados de entrada Cápsula de dados de saída
    Data/Hora Dia a partir da data especificada.
    Figura 7. Exemplo
    • Entrada: 2021-11-20 13:06:12
    • Formato de data de entrada: Data ISO (2004-06-28)
    • Saída: 20

    Hora

    Recupera o componente de hora da data/hora especificada.

    Cápsula de dados de entrada Cápsula de dados de saída
    Data/Hora Inteiro - Hora a partir da data especificada.
    Figura 8. Exemplo
    • Entrada: 2021-11-20 13:06:12
    • Formato de data de entrada: Data ISO (2004-06-28)
    • Saída: 13

    Minuto

    Recupera o componente de minuto da data/hora especificada.

    Cápsula de dados de entrada Cápsula de dados de saída
    Data/Hora Componente inteiro - Componente de minuto a partir da data especificada.
    Figura 9. Exemplo
    • Entrada: 2021-11-20 13:06:12
    • Formato de data de entrada: Data ISO (2004-06-28)
    • Saída: 06

    Segundo

    Recupera o segundo componente da data/hora especificada.

    Cápsula de dados de entrada Cápsula de dados de saída
    Data/Hora Segundo componente da data especificada.
    Figura 10. Exemplo
    • Entrada: 2021-11-20 13:06:12
    • Formato de data de entrada: Data ISO (2004-06-28)
    • Saída: 12

    Mês

    Recupera o componente Mês da data/hora especificada.

    Cápsula de dados de entrada Cápsula de dados de saída
    Data/Hora Componente do mês da data especificada.
    Figura 11. Exemplo
    • Entrada: 2021-11-20 13:06:12
    • Formato de data de entrada: Data ISO (2004-06-28)
    • Saída: 11

    Semana

    Avalia o número da semana para a data/hora especificada.

    Cápsula de dados de entrada Cápsula de dados de saída
    Data/Hora Número inteiro - Número da semana da data especificada.
    Figura 12. Exemplo
    • Entrada: 2021-04-07 12:01:12
    • Formato de data de entrada: Data ISO (2004-06-28)
    • Saída: 15

    Ano

    Recupera o componente Ano da data/hora especificada.
    Cápsula de dados de entrada Cápsula de dados de saída
    Data/Hora Componente do ano a partir da data especificada.
    Figura 13. Exemplo
    • Entrada: 2021-04-07 12:01:12
    • Formato de data de entrada: Data ISO (2004-06-28)
    • Saída: 2021

    Diferença de datas

    Avalia a diferença de duração de tempo entre a data de entrada especificada e a data do parâmetro e, em seguida, adiciona a duração de tempo de diferença ao tempo de época (1970-01-01 00:00:00).

    Cápsula de dados de entrada Parâmetros Cápsula de dados de saída
    data/hora, data ou data de vencimento. data/hora, data ou data de vencimento. Duração - Diferença de duração de tempo adicionada ao tempo de época (1970-01-01 00:00:00).
    Figura 14. Exemplo
    • Entrada: 2021-05-02 09:10:12
    • Formato de data de entrada: Data ISO (2004-06-28)
    • Parâmetros: 2021-04-07 06:02:23
    • Saída: 1970-01-26 03:07:49

    Fim do mês

    Avalia o último dia do mês depois de adicionar o número especificado de meses à data especificada.

    Cápsula de dados de entrada Parâmetros Cápsula de dados de saída
    Data Número de meses - meses a serem adicionados à data especificada. Último dia do mês após adicionar o número de meses à data de entrada especificada.
    Figura 15. Exemplo
    • Entrada: 2021-11-20
    • Formato de data de entrada: Data ISO (2004-06-28)
    • Número de meses: 3
    • Saída: 2022-02-28