Ferramentas do usuário

Ferramentas do site


minus_date_tube

Diferenças

Aqui você vê as diferenças entre duas revisões dessa página.

Link para esta página de comparações

Ambos lados da revisão anterior Revisão anterior
minus_date_tube [2019/09/04 20:00]
127.0.0.1 edição externa
minus_date_tube [2020/06/19 16:18] (atual)
gabriel_vieira
Linha 1: Linha 1:
-===== MinusDate ​===== +===== Between ​===== 
-Dadas duas datas quaisquer, o tube **minusDate** devolve um número inteiro que corresponde a diferença ​entre estas de acordo com uma unidade de medida temporal especificada ​por argumento.+Dadas duas datas ou duas horas quaisquer, o tube **minusDate** devolve um número inteiro ​positivo correspondente ao intervalo ​que se passou ​entre as duas, segundo ​uma unidade de medida temporal especificada ​(days, hours, minutes etc).
 \\ \\
 === Formato: === === Formato: ===
->  minusDate(//​data1//,//data2//, //unit//) \\+>  minusDate(//​info1//, //info2//, //unit//) \\
 === Parâmetros: ​ === === Parâmetros: ​ ===
-  * //data1//: data a ser processada\\ +  * //info1//: valor inicial, que pode ser uma data, uma variável do tipo Date ou, ainda, um tube que retorne data (como [[today_tube|today]]).\\ 
-  * //data2//: data subtraída\\ +  * //info2//: valor final, que também pode ser uma data, uma variável do tipo Date ou um tube que retorne data.\\ 
-  * //num//: especificação da unidade de medida. Pode ser case "days", "day" ou "d"; "​months"​"month" ou "M"; "years", "year" ou "y"; "​hours",​ "​hour"​ ou "​h";​ "​minutes",​ "​minute"​ ou "​m";​ "​seconds",​ "​second"​ ou "​s"​.\\+  * //unit//: especificação da unidade de medida. Pode ser"years", "year" ou "y"; "​months" ​ou "​month";​ "days", "day" ou "d"; "​hours",​ "​hour"​ ou "​h";​ "​minutes",​ "​minute"​ ou "​m";​ "​seconds",​ "​second"​ ou "​s"​.\\
 === Retorno: ​ === === Retorno: ​ ===
-  * Retorna um número inteiro ​que corresponde a diferença ​entre //data1// e //data2// em //unit//.+  * Retorna um número inteiro ​positivo correspondente ao intervalo de tempo entre //info1// e //info2//, segundo a unidade de medida especificada. Como o retorno é sempre positivo, não importa qual data é anterior, ​//info1// ou //​info2//​. ​  
 +=== Exemplos: ​ === 
 +1. **MinusDate com data.** Podemos comparar uma variável do tipo Date com uma data já definida. Se não soubermos de antemão se a variável indicada pelo usuário é anterior ou posterior à data fixa indicada, podemos combinar seu uso com os tubes [[printf_tube|printIf]] e [[after_tube|after]] no momento do print.
  
-     ​Exemplo: ​minusDate("​05/08/1983", "06/08/1983", "d"​) ​# retorna -1+ print "​Embora o acordado fosse que a escultura de gelo deveria ser entregue no dia 31/12/2019, o escultor 
 + a entregou em " & <​dataEntregaEscultura>​ & ", ou seja, " & minusDate(<​dataEntregaEscultura>, ​"31/12/2019", 
 + "days") & " dias " & printIf(<​dataEntregaEscultura>​.after("​31/12/2019"), "após o", "antes do"​) ​& "  
 + combinado."​ 
 + 
 +2. **MinusDate com variáveis.** Podemos também comparar duas variáveis do tipo Date. Por dar um retorno inteiro, pode ser comparado e operado com outros valores numéricos. Nesse exemplo, é interessante notar que o resultado da combinação de tubes é o uso ou não de um branch de texto. 
 + 
 + if (minusDate(<​dataDeAdmissao>,​ <​dataAjuizamentoDaAcao>,​ “years”) > 4) { 
 +     use BRC_PrescricaoQuinquenal 
 +
 + 
 +3. **MinusDate com today.** Por fim, podemos comparar uma variável com uma data retornada por um tube (como [[today_tube|today]]). 
 + 
 + print "​Faltam " & minusDate(<​contrato.termoFinal>,​ today(), "​months"​) & " meses para o fim do contrato."​
minus_date_tube.1567627247.txt.gz · Última modificação: 2019/09/04 20:00 por 127.0.0.1