Funções de data e hora em Adobe Workfront Fusion

Requisitos de acesso

Você deve ter o seguinte acesso para usar a funcionalidade neste artigo:

Para obter mais detalhes sobre as informações nesta tabela, consulte Requisitos de acesso na documentação do Workfront.

Para obter informações sobre Adobe Workfront Fusion licenças, consulte Adobe Workfront Fusion licenças.

Variáveis

now

carimbo de data e hora

Funções

addSeconds (data; número)

Retorna uma nova data como resultado da adição de um determinado número de segundos a uma data. Para subtrair segundos, informe um número negativo.

addMinutes (data; número) addminutes-date-number

Retorna uma nova data como resultado da adição de um determinado número de minutos a uma data. Para subtrair minutos, informe um número negativo.

addHours (data; número) addhours-date-number

Retorna uma nova data como resultado da adição de um determinado número de horas a uma data. Para subtrair horas, informe um número negativo.

addDays (data; número) adddays-date-number

Retorna uma nova data como resultado da adição de um determinado número de dias a uma data. Para subtrair dias, informe um número negativo.

addMonths (data; número)

Retorna uma nova data como resultado da adição de um determinado número de meses a uma data. Para subtrair meses, informe um número negativo.

addYears (data; número)

Retorna uma nova data como resultado da adição de um determinado número de anos a uma data. Para subtrair anos, informe um número negativo.

setSecond (data; número)

Esta função retorna uma nova data com os segundos especificados em parâmetros.

Especifique um número de 0 a 59. Se o número estiver fora desse intervalo, a função retornará um segundo do minuto anterior (para um número negativo) ou do minuto subsequente (para um número positivo).

Se você precisar especificar um número fora do intervalo, recomendamos usar ​ addSeconds, conforme descrito acima na seção addSeconds (date; number).

setMinute (data; número)

Esta função retorna uma nova data com os minutos especificados em parâmetros.

Especifique um número de 0 a 59. Se o número estiver fora desse intervalo, a função retornará um minuto da hora anterior (para um número negativo) ou da hora subsequente (para um número positivo).

Se você precisar especificar um número fora do intervalo, recomendamos usar addMinutes, conforme descrito acima em addMinutes (date; number).

setHour (data; número)

Esta função retorna uma nova data com a hora especificada nos parâmetros.

Especifique um número de 0 a 23. Se o número estiver fora desse intervalo, a função retornará uma hora do dia anterior (para um número negativo) ou do dia subsequente (para um número positivo).

Se você precisar especificar um número fora do intervalo, recomendamos usar addHours, conforme descrito acima em addHours (date; number).

setDay (data; número/nome do dia em inglês)

Esta função retorna uma nova data com o dia especificado nos parâmetros.

Você pode usar essa função para definir o dia da semana, com Domingo como 1 e Sábado como 7. Se você especificar um número de 1 a 7, a data resultante estará na semana atual (de domingo a sábado). Se o número estiver fora desse intervalo, a função retornará um dia da semana anterior (para um número negativo) ou da semana subsequente (para um número positivo).

Se você precisar especificar um número fora do intervalo, recomendamos usar addDays, conforme descrito acima em addDays (date; number).

setDate (data; número)

Esta função retorna uma nova data com o dia do mês especificado em parâmetros.

Especifique um número de 1 a 31. Se o número estiver fora desse intervalo, a função retornará um dia do mês anterior (para um número negativo) ou do mês seguinte (para um número positivo).

setMonth (data; número/nome do mês em inglês)

Esta função retorna uma nova data com o mês especificado em parâmetros.

Especifique um número de 1 a 12. Se o número estiver fora desse intervalo, a função retornará o mês do ano anterior (para um número negativo) ou o ano subsequente (para um número positivo).

setYear (data; número)

Retorna uma nova data com o ano especificado em parâmetros.

formatDate (data; formato; [fuso horário])

Use esta função quando tiver um valor Date, como 12-10-2021 20:30, que você deseja formatar como um valor Text, como Dec 10, 2021 8:30 PM.

Isso é útil, por exemplo, quando é necessário alterar o formato de data de um aplicativo ou serviço da Web para o de um aplicativo ou serviço da Web conectado no mesmo cenário.

Para obter mais informações, consulte Data e Texto no artigo Tipos de dados de item no Adobe Workfront Fusion.

Parâmetros

Se um tipo diferente for fornecido, a coerção de tipo será aplicada. Para obter mais informações, consulte Coerção de tipo em Adobe Workfront Fusion.

Valor e tipo de retorno

A função formatDate retorna uma representação de texto do valor de Data especificado de acordo com o formato e o fuso horário especificados. O tipo de dados é Texto.

INFO

Exemplos: O Cenário e o fuso horário da Web foram definidos como Europe/Prague nesses exemplos.

• formatDate(1. Date created;MM/DD/YYYY)

  Devoluções em 01/10/2018

• formatDate(1. Date created; YYYY-MM-DD hh:mm A)

  Devoluções 2018-10-01 09:32 AM

• formatDate(1. Date created;DD.MM.YYYY HH:mm;UTC)

  Retorna 01.10.2018 07:32

• formatDate(now;DD.MM.YYYY HH:mm)

  Retorna 19.03.2019 15:30

parseDate (texto; formato; [fuso horário])

Use esta função quando tiver um valor de Texto representando uma data (como 12-10-2019 20:30 ou Aug 18, 2019 10:00 AM) e quiser convertê-lo (analisar) em um valor de Data (uma representação binária legível por máquina). Para obter mais informações, consulte Data e Texto no artigo Tipos de dados do item no Adobe Workfront Fusion.

Parâmetros

A segunda coluna indica o tipo esperado. Se um tipo diferente for fornecido, a coerção de tipo será aplicada. Para obter mais informações, consulte Coerção de tipo em Adobe Workfront Fusion.

Se um tipo diferente for fornecido, a coerção de tipo será aplicada. Para obter mais informações, consulte Coerção de tipo em Adobe Workfront Fusion.

Valor e tipo de retorno

Essa função converte uma sequência de caracteres de texto em uma data, de acordo com o formato e o fuso horário especificados. O tipo de dados do valor é Data.

diferençaData (Data1; Data2; Unidade)

Retorna um número que representa a diferença nas duas datas, expressas na unidade especificada.

A Data2 é subtraída da Data1.

Use um dos seguintes valores de tempo para o parâmetro unit:

Se nenhuma unidade for especificada, a função retornará a diferença em milissegundos.

Exemplos adicionais

Como calcular o n-ésimo dia da semana no mês

Esta seção é adaptada para Workfront Fusion a partir da página da Web Exceljet, que explica como obter o n-ésimo dia da semana em um mês.

Se você precisar calcular uma data correspondente ao n-ésimo dia da semana no mês (por exemplo, primeira terça-feira, terceira sexta-feira e assim por diante), poderá usar a seguinte fórmula:

{{addDays(setDate(1.date; 1); 1.n * 7 - formatDate(addDays(setDate(1.date; 1); "-" + 1.dow); "E"))}}

A fórmula contém os seguintes itens:

Caso queira calcular apenas um caso específico, por exemplo, a cada segunda quarta-feira, você pode substituir os itens 1.n e 2.dow na fórmula por números correspondentes. Para a segunda quarta-feira do mês atual, você usaria os seguintes valores:

Explicação:

Como calcular dias entre datas

Uma possibilidade é empregar a seguinte expressão:

{{round((2.value - 1.value) / 1000 / 60 / 60 / 24)}}

Como calcular o último dia/milissegundo do mês

Ao especificar um intervalo de datas, por exemplo, em um módulo de pesquisa, se o intervalo abranger todo o mês anterior como um intervalo fechado (o intervalo que inclui ambos os pontos de limite), será necessário calcular o último dia do mês.

2019-09-01 ≤ D ≤ 2019-09-30

A fórmula abaixo mostra uma maneira de calcular o último dia do mês anterior:

{{addDays(setDate(now; 1); -1)}}

Em alguns casos, é necessário calcular não apenas o último dia do mês, mas literalmente seu último milissegundo:

2019-09-01T00:00:00.000Z ≤ D ≤ 2019-09-30T23:59:59.999Z

Esta fórmula mostra uma maneira de calcular o último milissegundo do mês anterior:

{{parseDate(parseDate(formatDate(now; "YYYYMM01"); "YYYYMMDD"; "UTC") - 1; "x")}}

Se precisar que o resultado use a configuração de fuso horário, omita o argumento UTC:

{{parseDate(parseDate(formatDate(now; "YYYYMM01"); "YYYYMMDD") - 1; "x")}}

No entanto, é preferível usar o intervalo de meia abertura (o intervalo que exclui um de seus pontos de limite), especificando o primeiro dia do mês seguinte e substituindo o operador "less or equal than" por "less than", da seguinte maneira:

2019-09-01 ≤ D < 2019-10-01

2019-09-01T00:00:00.000Z ≤ D < 2019-10-01T00:00:00.000Z