Predefinição:Tempo decorrido/doc
Esta é uma subpágina de documentação para a Predefinição:Tempo decorrido. Ela contém informações sobre o seu uso, categorias, bem como todo o conteúdo que não faz parte da predefinição original. |
Descrição
editarEsta predefinição analisa uma data dia/mês/ano qualquer, fornecida pelo usuário, e então informa quantos anos, meses e dias decorreram desde aquela data até hoje ou até à data indicada.
Parâmetros
editar- dia: o dia da data a partir da qual será iniciada a contagem do tempo. Deve ser um número inteiro entre 1 e 31, grafado com 1 ou 2 algarismos.
- mês: o mês da data a partir da qual será iniciada a contagem do tempo. Deve ser um número inteiro entre 1 e 12, grafado com 1 ou 2 algarismos
- ano: o ano da data a partir da qual será iniciada a contagem do tempo. Deve ser um número inteiro entre 1 e o ano atual, grafado com 4 algarismos (exceto zeros à esquerda, que são desnecessários e serão ignorados).
Se não forem indicados mais parâmetros será contado o tempo até hoje. Para indicar outra data usar os seguintes parâmetros, da mesma forma que os anteriores:
- dia2
- mês2
- ano2
Um parâmetro adicional prec (precisão) aceita como valores "ano" e "mês" (quaisquer outros valores serão ignorados). A sua utilização permite reduzir a precisão da contagem exibida, mostrando apenas anos completos (com |prec=ano
), ou não indicando dias (com |prec=mês
), arredondando para baixo.
Formato dos parâmetros
editar- Os zeros posicionados à esquerda dos parâmetros serão ignorados. Exemplo: 01 será tratado como 1, assim como 001 também será tratado como 1, e assim sucessivamente para 0001, 00001 etc.. Esta regra aplica-se aos três parâmetros.
- Os parâmetros dia e mês deverão ter 1 ou 2 dígitos. O parâmetro ano deverá ter de 1 a 4 dígitos, dependendo do ano informado. Exemplo: para o ano 1, informar 1; para o ano 1950, informar 1950; para o ano 250, informar 250 (ao invés de 0250).
Uso
editarCom parâmetros
editarSe os parâmetros forem declarados explicitamente, o resultado será o mesmo independentemente da ordem em que os parâmetros forem declarados. Exemplos:
Data de início da contagem | Código | Resultado |
---|---|---|
10 de março de 2004 | {{Tempo decorrido |ano=2004 |mês=3 |dia=10}} | 20 anos, 5 meses e 6 dias |
10 de março de 2004 | {{Tempo decorrido |ano=2004 |dia=10 |mês=3}} | 20 anos, 5 meses e 6 dias |
2 de setembro de 2006 | {{Tempo decorrido |mês=09 |dia=02 |ano=2006}} | 17 anos, 11 meses e 14 dias |
2 de setembro de 2006 | {{Tempo decorrido |mês=09 |ano=2006 |dia=02}} | 17 anos, 11 meses e 14 dias |
16 de agosto de 2023 | {{Tempo decorrido |dia=16 |ano=2023 |mês=08}} | 1 ano |
16 de agosto de 2023 | {{Tempo decorrido |dia=16 |mês=08 |ano=2023}} | 1 ano |
15 de maio de 1904 — 20 de dezembro de 1958 | {{Tempo decorrido |ano=1904 |mês=5 |dia=15 |ano2=1958 |mês2=12 |dia2=20}} | 54 anos, 7 meses e 5 dias |
Sem parâmetros
editarSe os parâmetros forem declarados implicitamente, a ordem deverá obrigatoriamente ser dia, mês, ano, caso contrário o resultado será diferente e em função da ordem em que cada valor foi declarado. Exemplos:
Data de início da contagem | Código | Resultado |
---|---|---|
10 de março de 2004 | {{Tempo decorrido |10 |3 |2004}} | 20 anos, 5 meses e 6 dias |
3 de outubro de 2004 | {{Tempo decorrido |3 |10 |2004}} | 19 anos, 10 meses e 13 dias |
2 de setembro de 2006 | {{Tempo decorrido |2 |9 |2006}} | 17 anos, 11 meses e 14 dias |
9 de fevereiro de 2006 | {{Tempo decorrido |9 |2 |2006}} | 18 anos, 6 meses e 7 dias |
12 de agosto de 2023 | {{Tempo decorrido |12 |08 |2023}} | 1 ano e 4 dias |
08 de dezembro de 2023 | {{Tempo decorrido |08 |12 |2023}} | 8 meses e 8 dias |
25 de agosto de 1091 — 23 de abril de 1453 | {{Tempo decorrido |25 |8 |1091 |23 |4 |1453}} | 361 anos, 7 meses e 29 dias |
Restrições
editarEsta predefinição não verifica se o dia, o mês e o ano informados são possíveis ou estão corretos, portanto valores "estranhos" tais como "dia=111", "mês=88" e "ano=-1000" ou "ano=9999" serão aceitos pela predefinição, apesar de que retornarão resultados errados e/ou sem nexo. Exemplo:
- O código:
{{Tempo decorrido |dia=111 |mês=88 |ano=9999}}
- Resultará em: -7976 anos, -69 meses e -64 dias
Ver também
editar{{Idade em dias}}