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

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 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 pílulas 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 data/hora de entrada, data, data de vencimento ou duração.

    Cápsula de dados de entrada Parâmetros Pílula de dados de saída
    Data/Hora, Data, Prazo ou Duração
    Nota:
    Se a entrada for uma Data ou Prazo, a transformação criará um valor de Data/Hora completo usando valores de hora 0, minuto 0 e segundo 0.
    		 Duration - Quantidade de tempo para adicionar 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

    Subtraia o tempo

    Subtrai dias, horas, minutos e/ou segundos da data/hora de entrada, data, data de vencimento ou duração.

    Cápsula de dados de entrada Parâmetros Pílula de dados de saída
    Data/Hora, Data, Prazo ou Duração
    Nota:
    Se a entrada for uma Data ou Prazo, 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 para subtrair em dias, horas, minutos e segundos Data/Hora - Valor de data/hora transformado após subtrair o 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 de 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 até a data

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

    Cápsula de dados de entrada Parâmetros Pílula 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 ou data válido representado como uma cadeia de caracteres. Necessário somente se Formato personalizado estiver selecionado como Input Date Format.
    		 Data/Hora
    Nota:
    • Se 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 MMM aaaa 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 prazo de entrada 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 Pílula de dados de saída
    Data/Hora, Data ou Prazo
    • Output Date Format - Formato de data/hora ou data da cadeia de caracteres de saída
    • Custom Format - Formato de data/hora ou data válido representado como uma cadeia de caracteres. Necessário somente se for selecionado 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 'às' hh:mm a.
    • Saída: "Em 31 de dezembro de 1969, às 2:23 PM"

    Neste exemplo, o fluxo recupera um registro de 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 a data, hora e 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 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 de dia da data/hora especificada.

    Cápsula de dados de entrada Pílula de dados de saída
    Data/Hora Número inteiro - 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 Pílula de dados de saída
    Data/Hora Número 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 Pílula de dados de saída
    Data/Hora 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 Pílula de dados de saída
    Data/Hora Inteiro - 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 Pílula de dados de saída
    Data/Hora Componente do mês a partir 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 Pílula de dados de saída
    Data/Hora Número inteiro - Número da semana para a 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 Pílula 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 data

    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 da diferença ao Tempo de época (1970-01-01 00:00:00).

    Cápsula de dados de entrada Parâmetros Pílula de dados de saída
    Data/Hora, Data ou Prazo Data/Hora, Data ou Prazo 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 após adicionar o número especificado de meses à data especificada.

    Cápsula de dados de entrada Parâmetros Pílula de dados de saída
    Data Número de meses - meses a serem adicionados à data especificada. Número inteiro - ú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