Módulo:Data/doc

Descrição

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

Funções que podem ser usadas de uma predefinição

• 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

• 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

• Data/Dados - banco de dados que permite não testar as páginas que sabemos que existem ou não existem.
• Data complexa - para adicionar links nas datas que existem ou não existem.
• TableBuilder - fr:Module:TableBuilder - Utilizar .insert e .concat para simplificar a sintaxe.

modeloData( frame )

Parâmetros

• 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

• 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

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

Comparação com {{ani}}

• 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 (2022 anos)	1 de agosto de 2006
com qualificativo	1|agosto|2006|na Suíça|idade=sim	1 de agosto de 2006 (17 anos)	1 de agosto de 2006
data antiga	2|1|598|idade=sim	2 de janeiro de 598 (1426 anos)	2 de janeiro de 598
o ano anterior	2|1|2012|idade=sim	1 de fevereiro de 2012 (12 anos)	2 de janeiro de 2012
este ano	2|1|2013|idade=sim	11 anos e 3 meses	2 de janeiro de 2013
ano que vem	2|1|2014|age=sim		2 de janeiro de 2014
sem dia	|8|2006|idade=sim	agosto de 2009 (14 anos)	de 2006
ano único	||2006|idade=sim	2006 (17–18 anos)	2006

Comparação com date sport

• 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 de fevereiro de 1980	1 / 0
com qualificativo	12|2|1980|na ginástica	12|2|1980|na ginástica}}	12 de fevereiro de 1980	2 / 0
qualificador com possível página para este ano	12|2|1977|na ginástica	12|2|1977|na ginástica}}	12 de fevereiro de 1977	3 / 1
com qualificativo e idade	12|2|1980|na ginástica|age=sim	12|2|1980|na ginástica|age=sim}}	12 de fevereiro de 1980	2 / 0
data antiga	12|2|1843	12|2|1843}}	12 de fevereiro de 1843	1 / 0
data muito recente com página mensal	12|2|2006	12|2|2006}}	12 fevereiro de 2006	1 / 0
data muito recente sem página mensal e qualif	12|2|2006|na ginástica	12|2|2006|na ginástica}}	12 fevereiro de 2006	2 / 0
data muito recente sem página mensal	1|8|2013	1|8|2013}}	1 agosto de 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	1 agosto de 2013	3 / 2

dataInfobox( frame )

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

• 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

• {{#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:

• Wikipédia:Lua