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

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 7 min. de leitura

    • Use 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 oferecem suporte a cápsulas de dados de duração. Certifique-se de usar o tipo de cápsula de dados de entrada correto 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 impróprio, 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 Testar um fluxo.

    Nota:
    Os valores de data/hora de tempo de execução não sã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, data, data de vencimento ou duração de entrada.

    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 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 data/hora, data, data de vencimento ou duração de entrada.

    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 de hora 0, minuto 0 e segundo 0.
    		 Duration - Insira uma quantidade de tempo a ser subtraída 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 hora, 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. A função de transformação Subtrair tempo localiza o valor do campo Criado subtraindo três horas da data/hora de entrada.

    Figura 3. Localizar 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 válido de data/hora ou data 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 da entrada Formato Personalizado estiver incompleto, a transformação criará um valor de Data/Hora completo usando datas e horas padrão. Nesse caso, os padrões de transformação são o ano atual, o mês atual, o dia 1 do 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 yyyy produz uma saída de 2019-10-01 00:00:00.
    • Se você usar um tipo de cápsula de dados incorreto ou um formato personalizadoinválido, o fluxo será 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 válido de data/hora ou data representado como uma cadeia de caracteres. Obrigatório somente se o Formato personalizado for selecionado como o 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 um formato personalizadoinválido, o fluxo será cancelado durante o tempo de execução.
    Figura 5. Exemplo
    • Entrada: 1969-12-31 14:23:57
    • Formato da data de saída: personalizado (inserir abaixo)
    • Formato personalizado: 'On' MMM dd, yyyy 'at' hh:mm a
    • Saída: "Em 31 de dezembro de 1969 às 14h23"

    Neste exemplo, o fluxo recupera um registro de Usuário [sys_user] de um banco de dados de terceiros. A função de transformação Data em cadeia de caracteres converte o formato do campo Criado e registra 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
    Concatena 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 na 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 a partir da data/hora especificada.

    Cápsula de dados de entrada Cápsula de dados de saída
    Data/Hora 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 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 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 Inteiro — Segundo componente a partir 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 do mês a partir da data/hora especificada.

    Cápsula de dados de entrada Cápsula de dados de saída
    Data/Hora Inteiro — 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 Cápsula de dados de saída
    Data/Hora 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 de ano a partir da data/hora especificada.
    Cápsula de dados de entrada Cápsula de dados de saída
    Data/Hora Inteiro — 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 diferença de duração de tempo à hora do período (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 adicionada ao horário do período (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 Cápsula de dados de saída
    Data Número de meses — Meses a serem adicionados à data especificada. 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: 28/02/2022