Módulo:Data/doc

Origem: Wikipédia, a enciclopédia livre.
Saltar para a navegação Saltar para a pesquisa



Descrição[editar código-fonte]

Este módulo tem funções auxiliares para criar infocaixas onde se mostra uma ligação para artigos sobre eventos com datas.

Ver módulo de dados Módulo:Data/Dados

Uso[editar código-fonte]

Funções que podem ser usadas de uma predefinição[editar código-fonte]

  • modeloData (frame) - exibe uma data com os links mais relevantes (definições abaixo).
  • templateInscriptionDate (frame) - exibe uma data não relacionada corretamente formatada. O ano é obrigatório. Parâmetros nomeados ano, mês, dia.
  • dateISO (frame) - semelhante a templateInscriptionDate, mas a data está no formato aaaa-mm-dd. Parâmetros nomeados ano, mês, dia. Para respeitar a ISO 8601, que define a data apenas de acordo com o calendário gregoriano, essa função não retorna nada para datas anteriores a 1583.
  • dateInfobox (frame) exibe uma data com os links relevantes, manipula corretamente os parâmetros que já contêm um modelo de data ou com o texto após a data (precisions below ). Projetado para ser usado em Infobox.
  • erroModuleData () - retorna uma mensagem de erro se o módulo: Data / Data não for carregado corretamente.
  • checkDataCat (frame) - retorna uma lista anual e mensal de páginas para facilitar atualizações de Data / Data. Parâmetros 1 = cat, month = lista de meses se 'yes', alias = listar todos os aliases se 'yes'

Funções que podem ser usadas de outro módulo[editar código-fonte]

  • validMonth (month) - retorna o nome em português e o número do mês (nome em portuguÊs, abreviado, inglês ou número entre 1 e 12).
  • determinationMes (mês, frame) - semelhante a validMonth, mas o número do mês não é limitado (14 → fevereiro) e pode até ser uma expressão se um objeto de quadro for fornecido (6 + 3 → setembro)
  • do_dayRank (argumentos) - Rank do dia no ano. Argumentos de parâmetro = {ano, mês, dia} ou {ano = ano, mês = mês, dia = dia}
  • isLeapYear (year) - retorna true se year for um ano bissexto no calendário gregoriano.
  • toRoman (number) - transforma o número em uma string representando-o em "algarismos romanos".
  • idade (an, mn, jn, ac, mc, jc) - semelhante ao modelAge, mas os parâmetros não estão em uma tabela
  • <Código>julianday (ano, mês, dia, hora, minuto, segundo) - retorna a Julian Day a data passou, de acordo com a calendário astronômico gregoriano ( com o ano 0)
  • <Código>julianDayJulian (ano, mês, dia, hora, minuto, segundo) - retorna a Julian dia um datado de Astronomical Julian calendário (com ano 0)
  • <Código>julianDayToGregorian (JD) - retorna três variáveis ​​ano, mês, dia representando a data do calendário gregoriano astronômico correspondente ao dia Julian.
  • julianDayToJulian (jd) - retorna três variáveis ​​ano, mês, dia representando a data de Julian calendar correspondente a este dia juliano.
  • julianToGregorian (ano, mês, dia) - transforma uma data do calendário juliano na data do calendário gregoriano.
  • gregorianToJulian (ano, mês, dia) - transforma uma data do calendário gregoriano para o calendário juliano.

Módulos externos que este módulo precisa para funcionar[editar código-fonte]

modeloData( frame )[editar código-fonte]

Parâmetros[editar código-fonte]

  • 1 - dia ou em branco - numérico, possível exceção para 1º.
  • 2 - mês ou dia - nome numérico ou português ou inglês, possivelmente uma abreviação atual.
  • 3 - ano ou mês - Um número será considerado ano. Os anos são considerados como seguindo o calendário gregoriano depois de 14 de outubro de 1582 (a menos que Juliano = 'sim') e o calendário juliano antes, sem o ano 0.
  • 4 - qualificador ou ano - texto correspondente a uma página típica "em fotografia" para "2008 na fotografia"
  • 5 - qualificador
  • age ou age - não está vazio para exibir a idade (nenhuma idade é exibida para datas no futuro)
  • juliano - 'sim' para a data a ser considerada como seguindo o calendário juliano depois de 14 de outubro de 1582. A data gregoriana com links é exibida, seguida pela data juliana entre parênteses.
  • a.C. - 'não' para não exibir 'a.C. ' depois do ano se representa um ano antes de Cristo. Útil para evitar repetições.
  • Página de parâmetros - Se um template {{data}} contém este parâmetro, os parâmetros juliano, a.C. e qualifier < / code> será aplicado a todas as datas na página, a menos que outro valor desses parâmetros seja especificado. O modelo de data que contém esse parâmetro não precisa ser exibido pelo módulo Data e pode ser comentado na página. A página deve ser limpa para que esse parâmetro seja levado em consideração.
  • qualifier - o qualificador para aplicar em toda a página. Funciona somente em conjunto com o parâmetro page parameters

Funcionamento[editar código-fonte]

  • o modelo procura exibir a data com links para as páginas dos qualificadores. Se não houver uma página vinculada ao qualificador, um link será feito para a página geral.
  • o primeiro parâmetro está vazio e o terceiro é um mês (somente texto), todos os parâmetros são considerados offset e o ano não será exibido.
  • Se não houver uma página específica para este mês-ano, o mês será exibido vinculado ao dia das efemérides. A prioridade é dada às efemérides do qualificador no link mês-ano sem qualificador.
  • o modelo usa o banco de dados Data/Dados para evitar o uso da função mw.title (equivalente do parser #ifexist :).
  • esta base permite substituir o qualificador por uma categoria mais genérica. Se o qualificador estiver "no tênis", as efemérides e a página mensal serão vinculadas ao qualificador "no esporte".
  • para evitar repetir o mesmo qualificador em todas as datas da página, basta ter em algum lugar no texto da página, mesmo em comentários, mas não trazido por um modelo, o texto {{Data|parâmetros page =|qualifier = meu qualificador}}. O modelo pode conter outros parâmetros. Somente o primeiro modelo de data contendo esse parâmetro será levado em consideração.

Função modeloData[editar código-fonte]

Motif testado Cadeia testada Módulo Funções custosas
modelo de antes / módulo
data recente 14|outubro|2001 1 / 0
date antiga (1700 - 1943), jour =1 1|outubro|1842 1 / 1
date muito antiga (<1700), dia = 1º 1|janeiro|537 1 / 0
qualificador que não está na base 14|outubro|2010|na animação ásiatica 4 / 1
data antiga, qualificador que não está na base 14|outubro|1842|na animação ásiatica 4 / 2
com qualificativo 14|Outubro|2001|na astronomia 3 / 0
com qualificador com efemérides 14|outubro|2005|nas ferrovias 4 / 0
sem dia |outubro|2001 1 / 0
sem dia com qualificativo |Outubro|2001|na astronomia 3 / 0
qualificador com página anual que poderia existir 14|outubro|2006|no Egito 4 / 1
qualificador com página mensal existente 14|outubro|2017|em Portugal 3 / 0
qualificador com página mensal que poderá existir 14|outubro|2012|em Portugal 4 / 1
qualificador com página anual e mensal que poderá existir 14|outubro|2012|na economia 4 / 2
date ancienne avec qualificativo 14|outubro|1845|en aéronautique 4 / 1
data negativa 13|outubro|-63 1 / 0
data a.C. 1|outubro|63 a.C. 1 / 0
data a.C. 13|outubro|63 a.C. 1 / 0
data negativa, parâmetro para esconder a.C. 13|outubro|-63|aC=não 1 / 0
année invalide 14|outubro|2001 en sport Ano inválido (2001 en sport) 1 / 0
dia + mês com maíscula 14|Outubro|2001 1 / 0
mês abreviado 14|oct.|2001 Mês inválido (oct.) 1 / 0
mês em numeros 14|10|2001 1 / 0
mês inválido 14|outubre|2001 Mês inválido (outubre) 1 / 0
dia inválido quinta-feira 14|outubro|2001 Dia inválido (quinta-feira 14) 1 / 0
dia inválido (muito grande para o mês) 31|setembro|2001 Dia inválido (31 setembro) 1 / 0
só o ano ||2001 1 / 0
só o ano com qualificador ||2001|na literatura 1 / 0
sem ano 14|outubro 0 / 0
só o dia 14 0 / 0
só o mês |Outubro outubro 0 / 0
sem argumento 0 / 0
data do calendário juliano 1|outubro|2001|juliano=sim 1 outubro 2001 ( dentro do calendário gregoriano)
Data do calendário juliano (mudança do mês) 25|outubro|2001|juliano=sim 25 outubro 2001 ( dentro do calendário gregoriano)
Data do calendário juliano (mudança do ano) 25|dezembro|2001|juliano=sim 25 dezembro 2001 ( dentro do calendário gregoriano)
data de nascimento 14|outubro|2001|idade=sim (18 anos)

Comparação com {{ani}}[editar código-fonte]

  • as funções caras são as mesmas que as do modelo Data
  • sem idade, veja a comparação com {{Date}}
Motivo testado Cadeia testada Predefinição Idade em anos e meses e Ani Módulo
simples 1|8|2006|idade=sim 2009 de agosto de 1 (2018 anos) (13 anos)
com qualificativo 1|agosto|2006|na Suíça|idade=sim 1 de agosto de 2006 (13 anos) (13 anos)
data antiga 2|1|598|idade=sim 2 de janeiro de 598 (1422 anos) (1422 anos)
o ano anterior 2|1|2012|idade=sim 1 de fevereiro de 2012 (8 anos) (8 anos)
este ano 2|1|2013|idade=sim 7 anos e 6 meses (7 anos)
ano que vem 2|1|2014|age=sim (6 anos)
sem dia |8|2006|idade=sim agosto de 2009 (10 anos) (13 anos)
ano único ||2006|idade=sim 2006 (13–14 anos)

Comparação com date sport[editar código-fonte]

  • quando não há qualificador, "in sport" é adicionado para testar o módulo.
Motivo testado Cadeia testada Predefinição date sport Módulo Funções custosas
predefinição / módulo
simples 1|2|1980 1|2|1980}} 1 / 0
com qualificativo 12|2|1980|na ginástica 12|2|1980|na ginástica}} 2 / 0
qualificador com possível página para este ano 12|2|1977|na ginástica 12|2|1977|na ginástica}} 3 / 1
com qualificativo e idade 12|2|1980|na ginástica|age=sim 12|2|1980|na ginástica|age=sim}} 2 / 0
data antiga 12|2|1843 12|2|1843}} 1 / 0
data muito recente com página mensal 12|2|2006 12|2|2006}} 1 / 0
data muito recente sem página mensal e qualif 12|2|2006|na ginástica 12|2|2006|na ginástica}} 2 / 0
data muito recente sem página mensal 1|8|2013 1|8|2013}} 1 / 1
data muito recente sem página mensal
e qualificado com a página anual possível
1|8|2013|na ginástica 1|8|2013|na ginástica 3 / 2

dataInfobox( frame )[editar código-fonte]

Função destinada a infoboxes, especialmente para exibir as datas de nascimento e morte, os links presentes nas datas fornecidas são automaticamente excluídos para gerenciar casos em que o parâmetro já contenha um modelo de data. O conteúdo do parâmetro após a data (por exemplo, um local, uma referência) é mantido.

Parâmetros[editar código-fonte]

  • 1: tipo de data a exibir (nascimento / n, morte / m ou data / d)
  • 2: data ou data de nascimento
  • 3: Data da morte, se o tipo n ou m
  • qualifier: sufixo das páginas de data para link (exemplo: na música)
  • nolinks: não mostra link
  • prefixo : prefixo a ser exibido se houver um dia (padrão vazio)
  • prefixo sem dia: prefixo a ser exibido se não houver dia (padrão vazio)

Esses parâmetros devem estar diretamente na função de chamada #invoke.

Exemplos[editar código-fonte]

  • {{#invoke:Data|dataInfobox|data|13 de julho de 1927}}→ 13 de julho de 1927
  • {{#invoke:Data|dataInfobox|nascimento|13 de julho de 1927|}}→ 13 de julho de 1927
  • {{#invoke:Data|dataInfobox|nascimento|13 de julho de 1927|14 mai 2017}}→ 13 de julho de 1927
  • {{#invoke:Data|dataInfobox|nascimento|30 de junho de 2017-}}→ 30 de junho de 2017-
  • {{#invoke:Data|dataInfobox|morte|13 de julho de 1927|30 de junho de 2017}}→ 30 de junho de 2017
  • {{#invoke:Data|dataInfobox|morte||30 de junho de 2017}}→ 30 de junho de 2017
  • {{#invoke:Data|dataInfobox|morte|13 de julho de 1927|}}
  • {{#invoke:Data|dataInfobox|data|13 de julho de 1927| qualificativo = na França}}→ 13 de julho de 1927
  • {{#invoke:Data|dataInfobox|data|13 de julho de 1927| préfixe = le}}→ 13 de julho de 1927
  • {{#invoke:Data|dataInfobox|data|13 de julho de 1927| préfixe = le|préfixe sans jour = en}}→ 13 de julho de 1927
  • {{#invoke:Data|dataInfobox|data|julho de 1927| préfixe = le}}→ julho
  • {{#invoke:Data|dataInfobox|data|julho de 1927| préfixe = le | préfixe sans jour = en}}→ julho
  • {{#invoke:Data|dataInfobox|data|13 de julho de [[1927]]}}→ 13 de julho de 1927
  • {{#invoke:Data|dataInfobox|data|13 de julho de [[1927 na França|1927]]}}→ 13 de julho 1927
  • {{#invoke:Data|dataInfobox|data|{{data|13 de julho de 1927|na França}}}}O primeiro parâmetro é necessário, mas foi fornecido incorretamente! de 13 de julho de 1927

Outra documentação: